BBjStatusBar::getBorders

Description

Returns the border widths of the BBjStatusBar control.

Syntax

Return Value

Method

BBjVector

getBorders()

Parameters

None.

Return Value

Returns a vector of three numbers, where element 0 is the width of the vertical border, element 1 is the width of the horizontal border, and element 2 is the width of the inter-segment border.

Remarks

None.

Example

REM Get the border widths of a status bar 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 addWindow param values
X=10
Y=10
WIDTH=200
HEIGHT=200
TITLE$="BBj Window"

REM Set the current context
mySysGui!.setContext(0)

REM Create a window
myWindow! = mySysGui!.addWindow(X,Y,WIDTH,HEIGHT,TITLE$)

REM Add a status bar on the window
myStatusBar! = myWindow!.addStatusBar(1)

REM Create a vector of segments
mySegmentVector! = myApi!.makeVector()

REM Create two segments for the status bar and set a value for the ending point
REM for each of the segments
mySegmentVector!.addItem(100)
mySegmentVector!.addItem(200)

REM Set the segments of the status bar
myStatusBar!.setSegments(mySegmentVector!)

REM Set the text of the two status bar segments
myStatusBar!.setTextAt(0,"Segment1")
myStatusBar!.setTextAt(1,"Segment2")

REM Get the border widths of the status bar. This will return 2, 2 and 4.
myVector! = myStatusBar!.getBorders()

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

BBjSysGui

BBjControl

BBjWindow

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