XMCOLUMN(3)

🌸 NAME 🌸

XmColumn — the XmColumn widget class, bestie. That's the whole name section. Short, sweet, iconic.

(also, for the record, this is the page for XmColumn(library call) 💖)

✨ SYNOPSIS ✨

#include <Xm/Column.h>

🦋 DESCRIPTION 🦋

okay so real talk: XmColumn takes all of its children and stacks them in a column, and every single child can have an optional label tagging along with it. 💅 The labels go in one column, the children go in another — two columns, side by side, like you and your bestie walking into a party. It's giving labeled data-entry fields, honestly. That's literally the vibe it was built for.

And if vertical isn't your moment? It can also display all the label-child pairs in a horizontal orientation instead. Versatile. Slay. 🔥

This widget comes with a whole bunch of constraint resources so you can dictate the characteristics of the label — displaying text or a pixmap, alignment of the text, which font to use, all of that good stuff. It also offers several resources for setting defaults for children that specify no specific values of their own. So when a child is like "idk, you choose", XmColumn chooses. Main character energy. 👑

👑 Classes 👑

XmColumn inherits behavior and resources from Core, Composite, Constraint, XmManager, and XmBulletinBoard. Family tree, periodt.

• The class pointer is xmColumnWidgetClass.
• The class name is XmColumn.

🎀 New Resources 🎀

The list below is the set of widget resources the programmer uses to specify data. You 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, drop the XmN or XmC prefix and use the remaining letters (lowercase or uppercase, doesn't matter, but keep any underscores between words).

The codes in the access column flag whether the given resource can be set at creation time (C), or is not applicable (N/A).

💅 XmColumn Resource Set 💅

• XmNdefaultEntryLabelAlignment — Class: XmCAlignment · Type: unsigned char · Default: XmALIGNMENT_BEGINNING · Access: CSG
  • Specifies the default XmNentryLabelAlignment to use when a child specifies no significant value. Resources that specify Alignment have values of XmALIGNMENT_BEGINNING, XmALIGNMENT_CENTER, XmALIGNMENT_END, and XmALIGNMENT_UNSPECIFIED. Valid string values that can be used in a resources file are: alignment_unspecified, unspecified, alignment_beginning, beginning, alignment_center, center, alignment_end, end.
• XmNdefaultEntryLabelFontList — Class: XmCFontList · Type: XmRFontList · Default: dynamic · Access: CGS
  • Specifies the default XmNentryLabelFontList to use when a child specifies no significant value. If unspecified, uses XmNlabelFontList resource of the XmBulletinBoard.
• XmNdefaultEntryLabelRenderTable — Class: XmCRendertable · Type: XmRFontList · Default: dynamic · Access: CGS
  • ngl, the original page only lists this one in the table and never spells out a description for it. No invented tea here — that's all the info it gives. 🙈
• XmNdefaultFillStyle — Class: XmCFillStyle · Type: unsigned char · Default: XmFILL_RAGGED · Access: CGS
  • Specifies the default XmNfillStyle to use when a child specifies no significant value.
• XmNdistribution — Class: XmCDistribution · Type: unsigned char · Default: XmDISTRIBUTE_TIGHT · Access: CGS
  • Specifies whether the spacing between each pair of rows should be increased equally (XmDISTRIBUTE_SPREAD) or remain constant (XmDISTRIBUTE_TIGHT) when the column is resized vertically to be larger than its natural size. This resource has no effect if any child has its XmNstretchable resource set to True. This resource is valid only when the orientation is vertical.
• XmNitemSpacing — Class: XmCItemSpacing · Type: Dimension · Default: 2 · Access: CSG
  • Specifies the spacing between each pair of rows (in vertical orientation) or between pairs of labels and children (in horizontal orientation).
• XmNlabelSpacing — Class: XmCLabelSpacing · Type: Dimentsion · Default: 10 · Access: CSG
  • Specifies the spacing between the column containing the labels and the column containing the XmColumn's children.
  • > 💀 not me pointing out that the type is spelled Dimentsion in the original — copying it character for character because that's the rule, but girl, that typo is right there.
• XmNorientation — Class: XmCOrientation · Type: unsigned char · Default: XmVERTICAL · Access: CSG
  • Specifies the layout direction of the XmColumn. When XmVERTICAL, the widgets and their associated labels are laid out in two vertical columns. When XmHORIZONTAL, the widgets and their associated labels are laid out in a single row.

---

The visual appearance of columns is affected by setting constraint resources on the children of the XmColumn. These resources are derived from those supported by XmLabel; see the manual page for XmLabel for valid values and usage. 🫶

🎀 XmColumn Constraint Resource Set 🎀

okay bestie, this is the whole constraint resource table, and no I did not skip a single row, every one is right here 💖

• XmNentryLabelAlignment — class XmCAlignment, type unsigned char, default XmALIGNMENT_UNSPECIFIED, access CSG
• XmNentryLabelFontList — class XmCFontList, type XmFontList, default dynamic, access CSG
• XmNentryLabelRenderTable — class XmCRenderTable, type XmRenderTable, default dynamic, access CSG
• XmNentryLabelPixmap — class XmCLabelPixmap, type Pixmap, default XmUNPECIFIED_PIXMAP, access CSG
• XmNentryLabelString — class XmCLabelString, type XmString, default NULL, access CSG
• XmNentryLabelType — class XmCLabelType, type unsigned char, default XmSTRING, access CSG
• XmNfillStyle — class XmCFillStyle, type unsigned char, default XmFILL_UNSPECIFIED, access CSG
• XmNshowEntryLabel — class XmCShowLabel, type Boolean, default True, access CSG
• XmNstretchable — class XmCStretchable, type Boolean, default False, access CG

the "Access" column is literally just saying which of the three access modes (get / set / get-set) each one supports, iykyk ✨

---

🌸 the resources, explained 🌸

XmNentryLabelAlignment

Specifies justification of text within the child's associated label. Valid values are the same as those for XmNdefaultEntryLabelAlignment. 🫶

XmNentryLabelFontList

Specifies fontList used to render the text within the child's associated label. (and yes, the source really does spell it mNentryLabelFontList in this spot, we're keeping it 100% verbatim, no editing bestie 💅)

XmNentryLabelPixmap

Specifies the pixmap used in the child's associated label. 🖼️

XmNentryLabelString

Specifies the text used in the child's associated label. ✍️

XmNentryLabelType

Specifies whether to display a string (XmSTRING) or a pixmap (XmPIXMAP) in the child's associated label. it's giving "pick your fighter" 🎀

XmNfillStyle

Specifies whether the child should be displayed at its natural size (XmFILL_RAGGED) or stretched to fill the entire width of the column it is displayed within (XmFILL_FLUSH). XmFILL_UNSPECIFIED uses the value of the XmColumn's XmNdefaultFillStyle. ✨

XmNshowEntryLabel

Specifies whether or not to display the child's associated label. 👀

XmNstretchable

Specifies whether the child should expand in size proportionately when the XmColumn is resized vertically to be larger than its natural size. 📐

---

🔗 RELATED 🔗

the whole friend group, no cap:

• Composite(3)
• Core(3)
• XmBulletinBoard(3)
• XmCreateColumn(3)
• XmManager(3)
• XmVaCreateColumn(3)
• XmVaCreateManagedColumn(3)

---

⭐ VERSION ⭐

This manual page documents the XmColumn widget shipped in Motif version 2.2. periodt 💜

---

and that's the whole page bestie 🫶 this one lives in the library call section as XmColumn, documenting the Motif 2.2 widget — go forth and column responsibly 🌈💖