DTSPINBOX(3)

📦

version 2.5.3 · 2 versions

2.5.3 · nixos 26.05 (latest)
2.5.3 · nixpkgs unstable

🎀 NAME 🎀

okay bestie, this is DtSpinBox(library call) — literally the SpinBox widget class 💅✨

✨ SYNOPSIS ✨

#include &<Dt/SpinBox.h>

💅 DESCRIPTION 💅

⚠️ Note: This widget has been superseded by the equivalent Motif widget XmSimpleSpinBox. Please refer to the Motif Programmer's Reference for more information.

The DtSpinBox widget is a user interface control that increments and decrements an arbitrary TextField — it’s giving “little spinny bestie for your values” 🌀. For example, it can be used to cycle through the months of the year or days of the month. Iconic.

Widget subclassing is not supported for the DtSpinBox widget class. No cap, that’s just the rule 🫶.

🎀 Classes 🎀

The DtSpinBox widget inherits behavior and resources from the Core, Composite and XmManager classes.

🫠 tiny original-text goblin preserved here: Caret1The class pointer is dtSpinBoxWidgetClass. So yes — the class pointer is dtSpinBoxWidgetClass.

The class name is DtSpinBoxWidget.

🧚 New Resources 🧚

The following set of widget resources is 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 DtN or DtC 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 Dt prefix and use the remaining letters (in either lower case or upper case, but including any underscores between words). Slay.

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).

🌈 DtSpinBox Resource Set 🌈

DtNarrowLayout — Class DtCArrowLayout; Type unsigned char; Default DtARROWS_END; Access CSG
DtNarrowSensitivity — Class DtCArrowSensitivity; Type unsigned char; Default DtARROWS-_SENSITIVE; Access CSG
DtNdecimalPoints — Class DtCDecimalPoints; Type short; Default 0; Access CSG
DtNincrementValue — Class DtCIncrementValue; Type int; Default 1; Access CSG
DtNinitialDelay — Class DtCInitialDelay; Type unsigned int; Default 250; Access CSG
DtNmaximumValue — Class DtCMaximumValue; Type int; Default 10; Access CSG
DtNminimumValue — Class DtCMinimumValue; Type int; Default 0; Access CSG
DtNmodifyVerifyCallback — Class DtCCallback; Type XtCallbackList; Default NULL; Access C
DtNnumValues — Class DtCNumValues; Type int; Default 0; Access CSG
DtNposition — Class DtCPosition; Type int; Default 0; Access CSG
DtNrepeatDelay — Class DtCRepeatDelay; Type unsigned int; Default 200; Access CSG
DtNspinBoxChildType — Class DtCSpinBoxChildType; Type unsigned char; Default XmSTRING; Access CG
DtNvalueChangedCallback — Class DtCCallback; Type XtCallbackList; Default NULL; Access C
DtNvalues — Class DtCValues; Type XmStringTable; Default NULL; Access CSG

🧚 little layout artifact from the original, kept exactly because detail gremlins are valid: tgroup dispwid="8.51in"

🌀 `DtNarrowLayout`

Specifies the style and position of the SpinBox arrows. These values are supported:

DtARROWS_FLAT_BEGINNING — The arrows are placed side by side to the right of the TextField.
DtARROWS_FLAT_END — The arrows are placed side by side to the left of the TextField.
DtARROWS_SPLIT — The down arrow is on the left and the up arrow is on the right of the TextField.
DtARROWS_BEGINNING — The arrows are stacked and placed on the left of the TextField.
DtARROWS_END — The arrows are stacked and placed on the right of the TextField.

🌸 `DtNarrowSensitivity`

Specifies the sensitivity of the arrows in the DtSpinBox. These values are supported:

DtARROWS_SENSITIVE — Both arrows are active to user selection.
DtARROWS_DECREMENT_SENSITIVE — The down arrow is active and the up arrow is inactive to user selection.
DtARROWS_INCREMENT_SENSITIVE — The up arrow is active and the down arrow is inactive to user selection.
DtARROWS_INSENSITIVE — Both arrows are inactive to user selection.

💜 `DtNdecimalPoints`

Specifies the position of the radix character within the numeric value when DtNspinBoxChildType is DtNUMERIC. This resource is used to allow for floating point values in the DtSpinBox widget ✨.

🔥 `DtNincrementValue`

Specifies the amount to increment or decrement the DtNposition when the DtNspinBoxChildType is DtNUMERIC. When the Up action is activated, the DtNincrementValue is added to the DtNposition value; when the Down action is activated, the DtNincrementValue is subtracted from the DtNposition value. When DtNspinBoxChildType is DtSTRING, this resource is ignored.

🦋 `DtNinitialDelay`

Specifies the amount of time in milliseconds before the Arrow buttons will begin to spin continuously. Tiny pause, then chaos 💫.

🍓 `DtNnumValues`

Specifies the number of items in the DtNvalues list when the DtNspinBoxChildType resource is DtSTRING. The value of this resource must be a positive integer. The DtNnumValues is maintained by the DtSpinBox widget when items are added or deleted from the DtNvalues list. When DtNspinBoxChildType is not DtSTRING, this resource is ignored.

🌈 `DtNvalues`

Supplies the list of strings to cycle through when the DtNspinButtonChildType resource is DtSTRING. When DtNspinBoxChildType is not DtSTRING, this resource is ignored. Yes, DtNspinButtonChildType is exactly what the original says — copy-paste goblin behavior, preserved 👑.

⭐ `DtNmaximumValue`

Specifies the upper bound on the DtSpinBox's range when DtNspinBoxChildType is DtNUMERIC.

🎀 `DtNminimumValue`

Specifies the lower bound on the DtSpinBox's range when DtNspinBoxChildType is DtNUMERIC.

🫶 `DtNmodifyVerifyCallback`

Specifies the callback to be invoked just before the DtSpinBox 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 DtSpinBoxCallbackStruct to False, nothing happens. Otherwise, the position changes. Reasons sent by the callback are DtCR_SPIN_NEXT, or DtCR_SPIN_PRIOR.

💫 `DtNposition`

The DtNposition resource has a different value based on the DtNspinBoxChildType resource. When DtNspinBoxChildType is DtSTRING, the DtNposition is the index into the DtNvalues list for the current item. When the DtNspinBoxChildType resource is DtNUMERIC, the DtNposition is the integer value of the DtSpinBox that falls within the range of DtNmaximumValue and DtNminimumValue.

🧚 `DtNrepeatDelay`

Specifies the number of milliseconds between repeated calls to the DtNvalueChangedCallback while the user is spinning the DtSpinBox. Spin spin spin, but make it timed 💅.

🌟 `DtNspinBoxChildType`

Specifies the style of the DtSpinBox. These values are supported:

DtSTRING — The child is a string value that is specified through the DtNvalues resource and incremented and decremented by changing the DtNposition resource.
DtNUMERIC — The child is a numeric value that is specified through the DtNposition resource and incremented according to the DtNincrementValue resource.

💖 `DtNvalueChangedCallback`

Specifies the callback to be invoked whenever the value of the DtNposition resource is changed through the use of the spinner arrows. The DtNvalueChangedCallback passes the DtSpinBoxCallbackStruct call_data structure.

💖 Inherited Resources 💖

Okay so the DtSpinBox widget literally inherits behavior and resources from these named superclasses — the whole family tree. For a complete description of each resource, see the man page for that superclass. 🫶

Each row below is Name / Class / Type / Default / Access.

🫶 XmManager Resource Set

XmNbottomShadowColor — class XmCBottomShadowColor, type Pixel, default dynamic, access CSG.
XmNbottomShadowPixmap — class XmCBottomShadowPixmap, type Pixmap, default XmUNSPECIFIED_PIXMAP, access CSG.
XmNforeground — class XmCForeground, type Pixel, default dynamic, access CSG.
XmNhelpCallback — class XmCCallback, type XtCallbackList, default NULL, access C.
XmNhighlightColor — class XmCHighlightColor, type Pixel, default dynamic, access CSG.
XmNhighlightPixmap — class XmCHighlightPixmap, type Pixmap, default dynamic, access CSG.
XmNinitialFocus — class XmCInitialFocus, type Widget, default NULL, access CSG.
XmNnavigationType — class XmCNavigationType, type XmNavigationType, default dynamic, access CSG.
XmNshadowThickness — class XmCShadowThickness, type Dimension, default dynamic, access CSG.
XmNstringDirection — class XmCStringDirection, type XmStringDirection, default dynamic, access CG.
XmNtopShadowColor — class XmCTopShadowColor, type Pixel, default dynamic, access CSG.
XmNtopShadowPixmap — class XmCTopShadowPixmap, type Pixmap, default dynamic, access CSG.
XmNtraversalOn — class XmCTraversalOn, type Boolean, default dynamic, access CSG.
XmNunitType — class XmCUnitType, type unsigned char, default dynamic, access CSG.
XmNuserData — class XmCUserData, type XtPointer, default NULL, access CSG.

🧚 Composite Resource Set

XmNchildren — class XmCReadOnly, type WidgetList, default NULL, access G.
XmNinsertPosition — class XmCInsertPosition, type XtOrderProc, default default procedure, access CSG.
XmNnumChildren — class XmCReadOnly, type Cardinal, default 0, access G.

👑 Core Resource Set

XmNaccelerators — class XmCAccelerators, type XtAccelerators, default dynamic, access CSG.
XmNancestorSensitive — class XmCSensitive, type Boolean, default dynamic, access G.
XmNbackground — class XmCBackground, type Pixel, default dynamic, access CSG.
XmNbackgroundPixmap — class XmCPixmap, type Pixmap, default XmUNSPECIFIED_PIXMAP, access CSG.
XmNborderColor — class XmCBorderColor, type Pixel, default XtDefaultForeground, access CSG.
XmNborderPixmap — class XmCPixmap, type Pixmap, default XmUNSPECIFIED_PIXMAP, access CSG.
XmNborderWidth — class XmCBorderWidth, type Dimension, default 0, access CSG.
XmNcolormap — class XmCColormap, type Colormap, default dynamic, access CG.
XmNdepth — class XmCDepth, type int, default dynamic, access CG.
XmNdestroyCallback — class XmCCallback, type XtCallbackList, default NULL, access C.
XmNheight — class XmCHeight, type Dimension, default dynamic, access CSG.
XmNinitialResourcesPersistent — class XmCInitialResourcesPersistent, type Boolean, default True, access C.
XmNmappedWhenManaged — class XmCMappedWhenManaged, type Boolean, default True, access CSG.
XmNscreen — class XmCScreen, type Screen *, default dynamic, access CG.
XmNsensitive — class XmCSensitive, type Boolean, default True, access CSG.
XmNtranslations — class XmCTranslations, type XtTranslations, default dynamic, access CSG.
XmNwidth — class XmCWidth, type Dimension, default dynamic, access CSG.
XmNx — class XmCPosition, type Position, default 0, access CSG.
XmNy — class XmCPosition, type Position, default 0, access CSG.

😭 Callback Information 😭

A pointer to the following structure is passed to each DtSpinBox callback:

typedef struct {
        int             reason;
        XEvent          *event;
        Widget          widget;
        Boolean         doit;
        int             position;
        XmString        value;
        Boolean         crossed_boundary;
} DtSpinBoxCallbackStruct;

reason — tells you why the callback was invoked, bestie. There are three possible reasons for this callback to be issued. The reason is DtCR_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 DtSpinBox is in the process of being continuously spun, then the reason will be DtCR_SPIN_NEXT or DtCR_SPIN_PRIOR, depending on the arrow that is spinning. ⭐
event — points to the XEvent that triggered the callback. It can be NULL when the DtSpinBox is continuously spinning. 🌀
widget — the widget identifier for the text widget that has been affected by the spin. 🫶
doit — set only when the call_data comes from the DtNmodifyVerifyCallback. 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. 💅
position — the new value of the DtNposition resource as a result of the spin. ✨
value — 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. 📎
crossed_boundary — True when the spinbox cycles. This is the case when a DtNspinBoxChildType of DtSTRING wraps from the first item to the last or the last item to the first. In the case of the DtNspinBoxChildType of DtNUMERIC, the boundary is crossed when the DtSpinBox cycles from the maximum value to the minimum or vice versa. 🎀

🦋 SEE ALSO 🦋

Go bother these pages too, bestie — the whole squad is here:

That’s the whole page, bestie! Source/version footer: DtSpinBox(library call) — no date line was shown, so we’re not inventing one. Periodt. 💅✨

📦 where this page comes from

nixos 26.05: cde 2.5.3
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on 2026-11-04: a language model's rewrite of the original, under its terms

DTSPINBOX(3)

🎀 NAME 🎀

✨ SYNOPSIS ✨

💅 DESCRIPTION 💅

🎀 Classes 🎀

🧚 New Resources 🧚

🌈 DtSpinBox Resource Set 🌈

🌀 DtNarrowLayout

🌸 DtNarrowSensitivity

💜 DtNdecimalPoints

🔥 DtNincrementValue

🦋 DtNinitialDelay

🍓 DtNnumValues

🌈 DtNvalues

⭐ DtNmaximumValue

🎀 DtNminimumValue

🫶 DtNmodifyVerifyCallback

💫 DtNposition

🧚 DtNrepeatDelay

🌟 DtNspinBoxChildType

💖 DtNvalueChangedCallback