XmButtonBox(3X)

💅 XmButtonBox(3X) 💅

okay bestie, welcome to the XmButtonBox(3X) manual page. This is the Button Box class, and it's lowkey iconic for making rows or columns of buttons behave. Periodt. ✨

✨ NAME ✨

XmButtonBox — The Button Box class

✨ SYNOPSIS ✨

#include <Xm/ButtonBox.h>

✨ DESCRIPTION ✨

The Button Box widget manages children (usually buttons) in a single row or single column layout. No cap, it's giving group-chat organizer energy: everyone lined up, nobody crowding anyone. 💅

The Button Box maintains equal spacing between its children at all times and attempts to adjust its height and width as necessary so that all children will fit. If this is not possible, due to parent or application programmer constraints, the Button Box will resize its children as necessary to fit within the available space. Highkey it's doing the most so everything fits. 🫶

Note: in what follows, major direction refers to the direction of orientation, and minor direction refers to the perpendicular direction. iykyk 🧚

---

🎀 Classes 🎀

Button Box inherits behavior, resources, and traits from Core, Composite, Constraint, and XmManager. iykyk 💖

The class pointer is xmButtonBoxWidgetClass.

The class name is XmButtonBox.

---

🦋 New Resources 🦋

The following table defines a set of widget resources used by the programmer to specify data. The programmer 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, 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, remove the Xm prefix and use the remaining letters (in either lowercase or uppercase, but include 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).

• XmNequalSize — Name: XmNequalSize · Class: XmCEqualSize · Type: Boolean · Default: False · Access: CSG
• XmNfillOption — Name: XmNfillOption · Class: XmCFillOption · Type: unsigned char · Default: XmFillNone · Access: CSG
• XmNmarginHeight — Name: XmNmarginHeight · Class: XmCMargin · Type: VerticalDimension · Default: 0 · Access: CSG
• XmNmarginWidth — Name: XmNmarginWidth · Class: XmCMargin · Type: HorizontalDimension · Default: 0 · Access: CSG
• XmNorientation — Name: XmNorientation · Class: XmCOrientation · Type: unsigned char · Default: XmHORIZONTAL · Access: CSG
• XmNdefaultButton — Name: XmNdefaultButton · Class: XmCWidget · Type: Widget · Default: NULL · Access: SG

💖 XmNequalSize 💖

Specifies whether the children are to be maintained with equal sized heights and widths. The chosen height and width for the children is found by asking each child for its preferred size and taking the largest value in each direction. So demure, so mindful. ✨

💖 XmNfillOption 💖

Specifies how to use any extra space left over once all children have been sized according to either their preference or equalSize. There are four options:

• XmFillNone — No automatic filling is performed. Center the children in the minor direction and place the children with equal padding between them in the major direction.
• XmFillMinor — Place the children with equal padding between them in the major direction, but force all the children to take on the Button Box minor dimension as their minor direction.
• XmFillMajor — Center the children in the minor direction, but expand all the children in their major direction so that there is no padding between them. Expand the children such that their relative sizes remain constant.
• XmFillAll — This option combines the placement actions and sizing actions of XmFillMinor and XmFillMajor.

Regardless of the fill mode, the ButtonBox widget will always leave the specified margin between its edge and the nearest child. A new String to fillOption resource converter has been registered to convert the following strings to fill options: "none", "major", "minor", "all." This resource can therefore be set in an application defaults file. Obsessed. 🌈

💖 XmNmarginHeight and XmNmarginWidth 💖

Specifies the number of pixels to use as a margin around the entire group of children. The marginHeight value applies to both the top and bottom margins, while the marginWidth applies to the left and right margins. Personal space matters, fr fr. 💅

💖 XmNorientation 💖

Specifies whether children are to be placed in a row or a column. The orientation may be either XmHORIZONTAL or XmVERTICAL. If the orientation is XmHORIZONTAL, the children are placed in a row with the major dimension being width and the minor dimension being height. If the value is XmVERTICAL, the children are placed in a column with the major dimension being height and the minor dimension being width. The default value is XmHORIZONTAL. Main character energy, honestly. 👑

---

🌈 Inherited Resources 🌈

Button Box inherits behavior and resources from the superclasses described in the following tables. For a complete description of each resource, refer to the reference page for that superclass.

🌸 XmManager Resource Set 🌸

Every XmButtonBox inherits this whole stack from XmManager, bestie. Name, class, type, default, access — all of it, right here, no skips. 💖

• 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 dynamic, access CSG
• XmNlayoutDirection — class XmCLayoutDirection, type XmDirection, default dynamic, access CG
• XmNnavigationType — class XmCNavigationType, type XmNavigationType, default XmTAB_GROUP, access CSG
• XmNpopupHandlerCallback — class XmCCallback, type XtCallbackList, default NULL, access C
• 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 True, access CSG
• XmNunitType — class XmCUnitType, type unsigned char, default dynamic, access CSG
• XmNuserData — class XmCUserData, type XtPointer, default NULL, access CSG

---

🦋 Composite Resource Set 🦋

And because XmButtonBox is also a Composite widget, you get this little trio on top of everything else. Three (3) resources, no more, no less, and yes the third one is genuinely just a count. 💅

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

Ngl, those access codes are doing a lot of heavy lifting and the page just hands them to you raw — CSG, CG, C, G. It's giving "iykyk" energy. Take them exactly as written, bestie, don't go improvising. 🙈

✨ Core Resource Set ✨

okay bestie, here's every single knob, dial, and vibe setting on this thing. no skipping, no summarizing — all of them, periodt. 💖

• XmNaccelerators — class: XmCAccelerators · type: XtAccelerators · default: dynamic · access: N/A
• 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

---

Translations 💅

XmButtonBox inherits translations from XmManager. that's the whole tea, bestie. ✨

---

RELATED 🫶

• Composite(3)
• Constraint(3)
• Core(3)
• XmCreateButtonBox(3)
• XmManager(3)
• XmVaCreateButtonBox(3)
• XmVaCreateManagedButtonBox(3)

---

COPYRIGHT 🌸

Copyright (c) 1992 by Integrated Computer Solutions, Inc.

---

XmButtonBox(3X) — that's the source/version, and the date is whatever your local manpage footer says, bestie. mwah. 💖✨