Projects, Forms, and Controls
2.5.1 Controls
A control is a visual object used by your program. Controls have Properties which can be queried and set, Methods which can be called as FUNCTION or SUB procedures, and Events which can be triggered by user actions, the operating system, or other programs.
A number of controls are included with NS Basic/App Studio. These include checkbox, commandButton, combobox, grid, textbox and other common objects.
2.5.2 Control Events
An event is a call that a control makes to your program, as a result of an action in the control. For instance, if you have a commandbutton in your program, an event will take place when the user taps the button. If your button's name is "MyButton", NS Basic will call the function MyButton_onclick() in your program. If you do not have such a function, the event is ignored.
Another example would be if you were performing an SQL operation. Incoming data will cause the Success_Function event to be sent, which will then call Function Success_Function in your program.
2.5.3 Control Methods
A control can be hidden by using
myControl.hide
A control can be shown by executing
myControl.show
2.5.4 Forms
A Form is a group of controls that are shown and hidden at the same time. Form names should be unique: not used also for a variable or another control. A good convention is to add frm in front as in frmHelp. Forms can be full screen or partial screen. More than one form can show at a time, so it’s possible to have two forms side by side on devices with large screens. Do this by setting the bounds of the form in the form’s properties.
2.5.5 Form Methods
A form can be hidden by using
formName.hide
A form can be shown by executing
formName.show
To go to a new form,
ChangeForm(Form2)
To see the name of the current form
Msgbox NSBCurrentForm