BBjWindow::getControl

Description

Returns a BBjControl object in the BBjWindow.

Syntax

Return Value	Method
BBjControl	getControl(int `ID`)
BBjControl	getControl(string name)

Parameters

Variable	Description
ID	Specifies the ID of the control. A value of 0 may be used to get information about a context's window or dialog rather than an individual control or child window (as defined in the CTRL() function).
name	In BBj 8.00 and higher, specifies the name of the control.

Return Value

Returns a BBjControl object.

Remarks

The getControl(string name) version throws an exception if there are no controls, or if there is more than one control, with the specified name.

Example

rem 'Get a control 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'(101,50,100,90,30,"Red",$$)

rem 'Get the button
myRedButton! = myWindow!.getControl(101)

rem 'Create the BBjColor Object using colorNum constant
myColorRed! = mySysGui!.makeColor(mySysGui!.RED)

rem 'Set the button colors to RED
myRedButton!.setBackColor(myColorRed!)

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