The XmSimpleSpinBox widget is a user interface control to increment and decrement an arbitrary TextField.
For example, it can be used to cycle through the months of the year or days of the month.
Widget subclassing is not supported for the XmSimpleSpinBox widget class.
Classes
The XmSimpleSpinBox widget inherits behavior and resources from the Core, Composite and XmManager
classes.
The class pointer is XmSimpleSpinBoxWidgetClass.
The class name is XmSimpleSpinBoxWidget.
NewResources
The following table defines a set of widget resources used by the application to specify data. The
application can also set the resource values for the inherited classes to set attributes for this widget.
To reference a resource by name or by class in a .Xdefaults file, the application must remove the XmN or
XmC prefix and use the remaining letters. To specify one of the defined values for a resource in a
.Xdefaults file, the application must remove the Xm prefix and use the remaining letters (in either lower
case or upper case, but including any underscores between words). The codes in the access column indicate
if the given resource can be set at creation time (C), set by using XtSetValues (S), retrieved by using
XtGetValues (G), or is not applicable (N/A).
XmSimpleSpinBoxResourceSetNameClassTypeDefaultAccessXmNarrowLayoutXmCArrowLayoutunsignedchar XmARROWS_END CSG
XmNarrowSensitivityXmCArrowSensitivityunsignedchar XmARROWS-_SENSITIVE CSG
XmNcolumnsXmCColumnshort 20 CSG
XmNdecimalPointsXmCDecimalPointsshort 0 CSG
XmNeditableXmCEditableBoolean True CSG
XmNincrementValueXmCIncrementValueint 1 CSG
XmNinitialDelayXmCInitialDelayunsignedint 250 CSG
XmNmaximumValueXmCMaximumValueint 10 CSG
XmNminimumValueXmCMinimumValueint 0 CSG
XmNmodifyVerifyCallbackXmCCallbackXtCallbackList NULL C
XmNnumValuesXmCNumValuesint 0 CSG
XmNpositionXmCPositionint 0 CSG
XmNrepeatDelayXmCRepeatDelayunsignedint 200 CSG
XmNspinBoxChildTypeXmCSpinBoxChildTypeunsignedchar XmSTRING CG
XmNtextFieldXmCTextFieldWidget dynamic G
XmNvalueChangedCallbackXmCCallbackXtCallbackList NULL C
XmNvaluesXmCValuesXmStringTable NULL CSG
XmNarrowLayout
Specifies the style and position of the SpinBox arrows. The following values are supported:
XmARROWS_FLAT_BEGINNING
The arrows are placed side by side to the right of the TextField.
XmARROWS_FLAT_END
The arrows are placed side by side to the left of the TextField.
XmARROWS_SPLIT
The down arrow is on the left and the up arrow is on the right of the TextField.
XmARROWS_BEGINNING
The arrows are stacked and placed on the left of the TextField.
XmARROWS_END
The arrows are stacked and placed on the right of the TextField.
XmNarrowSensitivity
Specifies the sensitivity of the arrows in the XmSimpleSpinBox. The following values are
supported:
XmARROWS_SENSITIVE
Both arrows are active to user selection.
XmARROWS_DECREMENT_SENSITIVE
The down arrow is active and the up arrow is inactive to user selection.
XmARROWS_INCREMENT_SENSITIVE
The up arrow is active and the down arrow is inactive to user selection.
XmARROWS_INSENSITIVE
Both arrows are inactive to user selection.
XmNcolumns
Specifies the number of columns of the text field.
XmNdecimalPoints
Specifies the position of the radix character within the numeric value when XmNspinBoxChildType
is XmNUMERIC. This resource is used to allow for floating point values in the XmSimpleSpinBox
widget.
XmNeditable
Specifies whether the text field can take input.
When XmNeditable is used on a widget it sets the dropsite to XmDROP_SITE_ACTIVE.
XmNincrementValue
Specifies the amount to increment or decrement the XmNposition when the XmNspinBoxChildType is
XmNUMERIC. When the Up action is activated, the XmNincrementValue is added to the XmNposition
value; when the Down action is activated, the XmNincrementValue is subtracted from the
XmNposition value. When XmNspinBoxChildType is XmSTRING, this resource is ignored.
XmNinitialDelay
Specifies the amount of time in milliseconds before the Arrow buttons will begin to spin
continuously.
XmNnumValues
Specifies the number of items in the XmNvalues list when the XmNspinBoxChildType resource is
XmSTRING. The value of this resource must be a positive integer. The XmNnumValues is
maintained by the XmSimpleSpinBox widget when items are added or deleted from the XmNvalues
list. When XmNspinBoxChildType is not XmSTRING, this resource is ignored.
XmNvalues Supplies the list of strings to cycle through when the XmNspinButtonChildType resource is
XmSTRING. When XmNspinBoxChildType is not XmSTRING, this resource is ignored.
XmNmaximumValue
Specifies the upper bound on the XmSimpleSpinBox's range when XmNspinBoxChildType is XmNUMERIC.
XmNminimumValue
Specifies the lower bound on the XmSimpleSpinBox's range when XmNspinBoxChildType is XmNUMERIC.
XmNmodifyVerifyCallback
Specifies the callback to be invoked just before the XmSimpleSpinBox position changes. The
application can use this callback to implement new application-related logic (including setting
new position spinning to, or canceling the impending action). For example, this callback can be
used to stop the spinning just before wrapping at the upper and lower position boundaries. If
the application sets the doit member of the XmSimpleSpinBoxCallbackStruct to False, nothing
happens. Otherwise, the position changes. Reasons sent by the callback are XmCR_SPIN_NEXT, or
XmCR_SPIN_PRIOR.
XmNposition
The XmNposition resource has a different value based on the XmNspinBoxChildType resource. When
XmNspinBoxChildType is XmSTRING, the XmNposition is the index into the XmNvalues list for the
current item. When the XmNspinBoxChildType resource is XmNUMERIC, the XmNposition is the
integer value of the XmSimpleSpinBox that falls within the range of XmNmaximumValue and
XmNminimumValue.
XmNrepeatDelay
Specifies the number of milliseconds between repeated calls to the XmNvalueChangedCallback
while the user is spinning the XmSimpleSpinBox.
XmNspinBoxChildType
Specifies the style of the XmSimpleSpinBox. The following values are supported:
XmSTRING The child is a string value that is specified through the XmNvalues resource and
incremented and decremented by changing the XmNposition resource.
XmNUMERIC The child is a numeric value that is specified through the XmNposition resource and
incremented according to the XmNincrementValue resource.
XmtextField
Specifies the textfield widget.
XmNvalueChangedCallback
Specifies the callback to be invoked whenever the value of the XmNposition resource is changed
through the use of the spinner arrows. The XmNvalueChangedCallback passes the
XmSimpleSpinBoxCallbackStructcall_data structure.
InheritedResources
The XmSimpleSpinBox widget inherits behavior and resources from the following named superclasses. For a
complete description of each resource, see the man page for that superclass.
XmManagerResourceSetNameClassTypeDefaultAccessXmNbottomShadowColorXmCBottomShadowColorPixel dynamic CSG
XmNbottomShadowPixmapXmCBottomShadowPixmapPixmapXmUNSPECIFIED_PIXMAP CSG
XmNforegroundXmCForegroundPixel dynamic CSG
XmNhelpCallbackXmCCallbackXtCallbackList NULL C
XmNhighlightColorXmCHighlightColorPixel dynamic CSG
XmNhighlightPixmapXmCHighlightPixmapPixmap dynamic CSG
XmNinitialFocusXmCInitialFocusWidget NULL CSG
XmNnavigationTypeXmCNavigationTypeXmNavigationType dynamic CSG
XmNshadowThicknessXmCShadowThicknessDimension dynamic CSG
XmNstringDirectionXmCStringDirectionXmStringDirection dynamic CG
XmNtopShadowColorXmCTopShadowColorPixel dynamic CSG
XmNtopShadowPixmapXmCTopShadowPixmapPixmap dynamic CSG
XmNtraversalOnXmCTraversalOnBoolean dynamic CSG
XmNunitTypeXmCUnitTypeunsignedchar dynamic CSG
XmNuserDataXmCUserDataXtPointer NULL CSG
CompositeResourceSetNameClassTypeDefaultAccessXmNchildrenXmCReadOnlyWidgetList NULL G
XmNinsertPositionXmCInsertPositionXtOrderProc default procedure CSG
XmNnumChildrenXmCReadOnlyCardinal 0 G
CoreResourceSetNameClassTypeDefaultAccessXmNacceleratorsXmCAcceleratorsXtAccelerators dynamic CSG
XmNancestorSensitiveXmCSensitiveBoolean dynamic G
XmNbackgroundXmCBackgroundPixel dynamic CSG
XmNbackgroundPixmapXmCPixmapPixmapXmUNSPECIFIED_PIXMAP CSG
XmNborderColorXmCBorderColorPixel XtDefaultForeground CSG
XmNborderPixmapXmCPixmapPixmapXmUNSPECIFIED_PIXMAP CSG
XmNborderWidthXmCBorderWidthDimension 0 CSG
XmNcolormapXmCColormapColormap dynamic CG
XmNdepthXmCDepthint dynamic CG
XmNdestroyCallbackXmCCallbackXtCallbackList NULL C
XmNheightXmCHeightDimension dynamic CSG
XmNinitialResourcesPersistentXmCInitialResourcesPersistentBoolean True C
XmNmappedWhenManagedXmCMappedWhenManagedBoolean True CSG
XmNscreenXmCScreenScreen* dynamic CG
XmNsensitiveXmCSensitiveBoolean True CSG
XmNtranslationsXmCTranslationsXtTranslations dynamic CSG
XmNwidthXmCWidthDimension dynamic CSG
XmNxXmCPositionPosition 0 CSG
XmNyXmCPositionPosition 0 CSG
CallbackInformation
A pointer to the following structure is passed to each XmSimpleSpinBox callback:
typedef struct {
int reason;
XEvent *event;
Widget widget;
Boolean doit;
int position;
XmString value;
Boolean crossed_boundary;
} XmSimpleSpinBoxCallbackStruct;
The reason argument indicates why the callback was invoked. There are three possible reasons for this
callback to be issued. The reason is XmCR_OK when this is the first call to the callback at the beginning
of a spin or if it is a single activation of the spin arrows. If the XmSimpleSpinBox is in the process of
being continuously spun, then the reason will be XmCR_SPIN_NEXT or XmCR_SPIN_PRIOR, depending on the
arrow that is spinning.
The event argument points to the XEvent that triggered the callback. It can be NULL when the
XmSimpleSpinBox is continuously spinning.
The widget argument is the widget identifier for the simple spin box widget that has been affected by
this callback.
The doit argument is set only when the call_data comes from the XmNmodifyVerifyCallback. It indicates
that the action that caused the callback to be called should be performed. The action is not performed if
doit is set to False.
The position argument is the new value of the XmNposition resource as a result of the spin.
The value argument is the new XmString value displayed in the Text widget as a result of the spin. The
application must copy this string if it is used beyond the scope of the call_data structure.
The crossed_boundary argument is True when the spinbox cycles. This is the case when a
XmNspinBoxChildType of XmSTRING wraps from the first item to the last or the last item to the first. In
the case of the XmNspinBoxChildType of XmNUMERIC, the boundary is crossed when the XmSimpleSpinBox cycles
from the maximum value to the minimum or vice versa.
Install Now
PNG Icons
