ButtonBar: Difference between revisions

From NSB App Studio
Jump to navigation Jump to search
No edit summary
No edit summary
Line 5: Line 5:
The ButtonBar is used to display a bar with 2 to 3 buttons. It can either be position at the top of the form, or further down. These are usually used for apps with multiple forms to switch between. Each form will have a buttonbar control on it, with a different button highlighted.
The ButtonBar is used to display a bar with 2 to 3 buttons. It can either be position at the top of the form, or further down. These are usually used for apps with multiple forms to switch between. Each form will have a buttonbar control on it, with a different button highlighted.


The only event that is returned is <control_id>_onbuttonclick(item).
The only event that is returned is <control_id>_onbuttonclick(''item'').


To add a button to your app, choose the ButtonBar icon in the Toolbar, then position it on the Design Screen. Use the Property Editor to set the properties you need, then add an _onbuttonclick(item) function to your code
To add a button to your app, choose the ButtonBar icon in the Toolbar, then position it on the Design Screen. Use the Property Editor to set the properties you need, then add an _onbuttonclick(''item'') function to your code


'''Properties and Methods'''
'''Properties and Methods'''


Standard properties are supported (“Properties”), plus:
Standard [[properties|properties]] are supported, plus:
{| class="wikitable"
{| class="wikitable"
|-
|-
Line 24: Line 24:
{| class="wikitable"
{| class="wikitable"
|-
|-
| _onbuttonclick(item) || Called when a button is clicked. Item contains the name of the button which was clicked.
| _onbuttonclick(''item'') || Called when a button is clicked. Item contains the name of the button which was clicked.
|}
|}



Revision as of 22:00, 24 July 2012

Description

The ButtonBar is used to display a bar with 2 to 3 buttons. It can either be position at the top of the form, or further down. These are usually used for apps with multiple forms to switch between. Each form will have a buttonbar control on it, with a different button highlighted.

The only event that is returned is <control_id>_onbuttonclick(item).

To add a button to your app, choose the ButtonBar icon in the Toolbar, then position it on the Design Screen. Use the Property Editor to set the properties you need, then add an _onbuttonclick(item) function to your code

Properties and Methods

Standard properties are supported, plus:

ButtonNames The names of the buttons, separated by commas. Must be either 2 or 3 names.
DefaultButton Number. The number of the button that is highlighted. Can be 0,1, 2 or 3.
TopBar True/False: Is the button at the top of the screen?

Events

_onbuttonclick(item) Called when a button is clicked. Item contains the name of the button which was clicked.

Example

REM ButtonBar Example
Function ButtonBar1_onbuttonclick(item)
  Msgbox "Button pressed reads " & item
End Function

Output

(A MsgBox showing “Left” if that button is clicked)

Related Items

EVENTS, PROPERTIES