BBjControl::getName

Description

In BBj 6.0 and higher, this method returns the name of the BBjControl.

Syntax

Return Value

Method

string

getName()

Parameters

None.

Return Value

Returns the name previously set with BBjControl::setName().

Remarks

Returns "" if no value has been explicitly set.

Example

rem 'Get the name property of a control

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
myButton! = myWindow!.addButton(101,50,100,90,30,"OK")

rem 'Get the name of the button, this will return "Button"
myButton!.setName("Button")
BUTTON_TEXT$ = myButton!.getName()

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

BBjSysGui

BBjWindow

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