BBjWindow::getControls

Description

In BBj 8.0 and higher, this method returns a BBjVector of all BBjControl objects with a given name in the BBjWindow.

Syntax

Return Value

Method

BBjVector

getControls(string name)

Parameters

Variable

Description

name

Specifies the name of the control(s).

Return Value

Returns a BBjVector object that contains all BBjControls with the specified name.

Remarks

None.

Example

rem 'Get multiple controls from a Window

rem 'Obtain the instance of the BBjAPI object
let myAPI! = BBjAPI()

rem 'Open the SysGui device
SYSGUI = UNT
OPEN (SYSGUI) "X0"

rem 'Obtain the instance of the BBjSysGui object
let mySysGui! = myAPI!.getSysGui()

rem 'Set common addWindow param values
X = 10
Y = 10
WIDTH = 200
HEIGHT = 200

rem 'Create a window with a title in the current context
TITLE$="BBj Window"

rem 'Set the current context
mySysGui!.setContext(0)
myWindow! = mySysGui!.addWindow(X,Y,WIDTH,HEIGHT,TITLE$)

rem 'Add a button on the window using mnemonics
PRINT (SYSGUI)'BUTTON'(1,50,50,90,30,"OK",$$)
PRINT (SYSGUI)'BUTTON'(2,50,100,90,30,"Cancel",$$)

rem 'Name the buttons
okButton! = myWindow!.getControl(1)
okButton!.setName("Button")

cancelButton! = myWindow!.getControl(2)
cancelButton!.setName("Button")

rem 'Get the buttons
buttons! = myWindow!.getControls("Button")

rem 'Register the CALLBACK routines
CALLBACK(ON_CLOSE,APP_CLOSE,mySysGui!.getContext())

rem 'Process Events
process_events

rem 'Callback routine called when the user closes the application window
APP_CLOSE:
release

See Also

BBjAPI

BBjWindow

BBjControl Methods

See the BBj Object Diagram for an illustration of the relationship between BBj Objects.