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
RETURN

See Also

BBjAPI

BBjWindow

BBjControl Methods

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