WkSpinButtonView

The WkSpinButtonView provides a compact editor for choosing one string from a set of choices. This functionality is similar to a list box or combo box, but it uses two small arrows to allow the user to scroll through the possible choices, one at a time. Since a spin button does not display all of the choices at once, it is best suited for sets of choices that have obvious members. And because the choices are stepped through in order, the spin button makes the most sense when the set of choices are familiarly ordered. Examples would be the days of the week or the answers to a survey question (Strongly Agree, Agree, No Opinion, Disagree, Strongly Disagree).

Spin buttons take as their contents an OrderedCollection of strings. The strings can be displayed in the spin button in one of three formats: left justified, right justified, or centered. When a new item is selected by the user, the Value Changed event will occur.

A user can increment or decrement the values using up/down arrow keys or by selecting the up/down buttons. A user can change the value in an editable spin button by typing in the entry field.

Protocol

alignment: anInteger
Specifies the text alignment used by the widget.

Default: XmALIGNMENTEND (Right)

Valid resource values:

XmALIGNMENTBEGINNING (Left) - Causes the left side of the line of text to be vertically aligned with the left edge of the widget window.

XmALIGNMENTCENTER (Center) - Causes the center of the line of text to be vertically aligned in the center of the widget window.

XmALIGNMENTEND (Right) - Causes the right side of the line of text to be vertically aligned with the right edge of the widget window.

 

allowNil: aBoolean
Specifies whether the text field may have a blank (nil) value.

 

editable: aBoolean
Specifies whether a user can edit text in the entry field part of the spin button.

 

items: anOrderedCollection
Specifies the list of Strings being spun over.

 

value: aString
Specifies the initial value of the widget.

 

wrapAround: aBoolean
Specifies whether the spin button should cycle or stop upon reaching the end of the collection, or max or min for a numeric spin button.

Events

Activated
These events are triggered when the user presses the default action key. This is typically a carriage return.

 

Decremented
These events are triggered when the user decreases the spin button value by one step. This can happen either when the down arrow key is pressed or when the down arrow button is selected with the mouse.

 

Getting Focus
These events are triggered before the entry field has accepted input focus.

 

Incremented
These events are triggered when the user increases the spin button value by one step. This can happen either when the up arrow key is pressed or the up arrow button is selected with the mouse.

 

Losing Focus
These events are triggered before the entry field loses input focus.

 

Object Changed
These events are triggered when the part’s vale is changed.