BBjSlider::setSnapToTicks

Description

In BBj 7.0 and higher, this method sets whether a BBjSlider should snap to the nearest tick when the user drags the thumb.

Syntax

Return Value

Method

void

setSnapToTicks(boolean snap)

Parameters

Variable

Description

snap

Specifies whether the BBjSlider should snap to the nearest tick when the user drags the thumb.

Return Value

None.

Remarks

None.

Example

rem 'Set whether a BBjSlider should snap to the nearest tick

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 vertical slider on the window
mySlider! = myWindow!.addVerticalSlider(101,80,0,40,200,$0000$)
mySlider!.setMajorTickSpacing(25)
mySlider!.setMinorTickSpacing(5)
mySlider!.setPaintTicks(1)
mySlider!.setSnapToTicks(1)
print "Major tick spacing is",mySlider!.getMajorTickSpacing()
print "Minor tick spacing is",mySlider!.getMinorTickSpacing()
print "Paint ticks?",mySlider!.getPaintTicks()
print "Snap to ticks?",mySlider!.getSnapToTicks()

rem 'Register the CALLBACK routines
CALLBACK(ON_CONTROL_SCROLL,SLIDER_SCROLLED,mySysGui!.getContext(),mySlider!.getID())
CALLBACK(ON_CLOSE,APP_CLOSE,mySysGui!.getContext())

rem 'Process Events
process_events

rem 'Callback routine called when the slider is used to scroll
SLIDER_SCROLLED:
    rem 'Get the new value of the slider
    VAL = mySlider!.getValue()
    MIN = mySlider!.getMinimum()
    MAX = mySlider!.getMaximum()
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.