BBjProgressBar::setStringPainted

Description

In BBj 3.0 and higher, this method determines whether the BBjProgressBar control will show a label.

Syntax

Return Value

Method

void

setStringPainted(boolean stringPainted)

Parameters

Variable

Description

stringPainted

Specifies whether the progress bar should display a label.

0 = Not painted.

1 = Painted.

Return Value

None.

Remarks

By default, progress bars show a label that indicates the percentage complete.

Example

rem 'Create a vertical progress bar with no label

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 = 100
Y = 100
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 some buttons to the window
startButton! = myWindow!.addButton(1,10,10,90,30,"Start")
stopButton! = myWindow!.addButton(2,10,50,90,30,"Stop",$0001$)
resetButton! = myWindow!.addButton(3,10,90,90,30,"Reset")

rem 'Add a vertical progress bar control to the window
myProgressBar! = myWindow!.addProgressBar(101,150,10,30,180)
myProgressBar!.setOrientation(myProgressBar!.VERTICAL)
myProgressBar!.setStringPainted(0)

rem 'Register the CALLBACK routines
CALLBACK(ON_CLOSE,APP_CLOSE,mySysGui!.getContext())
CALLBACK(ON_BUTTON_PUSH,doStart,mySysGui!.getContext(),startButton!.getID())
CALLBACK(ON_BUTTON_PUSH,doStop,mySysGui!.getContext(),stopButton!.getID())
CALLBACK(ON_BUTTON_PUSH,doReset,mySysGui!.getContext(),resetButton!.getID())

rem 'Process Events
process_events

doStart:
    startButton!.setEnabled(0)
    myAPI!.createTimer("",0.1,"progress")
    stopButton!.setEnabled(1)
return

doStop:
    stopButton!.setEnabled(0)
    myAPI!.removeTimer("")
    startButton!.setEnabled(1)
return

progress:
    myProgressBar!.setValue(myProgressBar!.getValue()+1)
    if myProgressBar!.getValue() >= myProgressBar!.getMaximum()
        gosub doStop
    endif
return

doReset:
    myProgressBar!.setValue(myProgressBar!.getMinimum())
return

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

See Also

BBjAPI

BBjSysGui

BBjControl

BBjWindow

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