XMSEPARATOR(3)

okay so this is the XmSeparator(library call) manual page, and we're about to make Separator widgets make sense, bestie 💖 No cap, she's a whole vibe.

✨ NAME ✨

XmSeparator — The Separator widget class. Periodt. 👑

🌸 SYNOPSIS 🌸

#include <Xm/Separator.h>

💖 DESCRIPTION 💖

So Separator is a primitive widget that separates items in a display. It's giving divider energy ✨. You get several different line drawing styles, plus horizontal or vertical orientation. Choose your fighter 💅.

The Separator line drawing is automatically centered within the height of the widget for a horizontal orientation, and centered within the width of the widget for a vertical orientation. The way that works? An XtSetValues with a new XmNseparatorType resizes the widget to its minimal height (for horizontal orientation) or its minimal width (for vertical orientation) unless height or width is explicitly set in the XtSetValues call. Lowkey important, highkey useful 🫶.

Separator does not draw shadows around the separator. The Primitive resource XmNshadowThickness is used for the Separator's thickness when XmNseparatorType is XmSHADOW_ETCHED_IN, XmSHADOW_ETCHED_IN_DASH, XmSHADOW_ETCHED_OUT, or XmSHADOW_ETCHED_OUT_DASH. Not me keeping track of every etch variant 😭.

Separator does not highlight and allows no traversing. The primitive resource XmNtraversalOn is forced to False. So don't try to tab into her, she's not about that life 🙈.

The XmNseparatorType of XmNO_LINE provides an escape to the application programmer who needs a different style of drawing. A pixmap the height of the widget can be created and used as the background pixmap by building an argument list using the XmNbackgroundPixmap argument type as defined by Core. Whenever the widget is redrawn, its background is displayed containing the desired separator drawing. Separator holds the XmQTmenuSavvy trait. Iconic behavior, fr fr 💖.

🦋 Classes 🦋

Separator inherits behavior, resources, and traits from Core and XmPrimitive. It's giving nepo baby but make it widget hierarchy 👑.

The class pointer is xmSeparatorWidgetClass.

The class name is XmSeparator.

✨ 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). Got it? Slay 💅.

🎀 XmSeparator Resource Set 🎀

• XmNmargin
  • Class: XmCMargin
  • Type: Dimension
  • Default: 0
  • Access: CSG
• XmNorientation
  • Class: XmCOrientation
  • Type: unsigned char
  • Default: XmHORIZONTAL
  • Access: CSG
• XmNseparatorType
  • Class: XmCSeparatorType
  • Type: unsigned char
  • Default: XmSHADOW_ETCHED_IN
  • Access: CSG

💅 Resource Deets 💅

• XmNmargin — For horizontal orientation, specifies the space on the left and right sides between the border of the Separator and the line drawn. For vertical orientation, specifies the space on the top and bottom between the border of the Separator and the line drawn. Basically she needs her personal space, periodt 🫶.
• XmNorientation — Displays Separator vertically or horizontally. This resource can have values of XmVERTICAL and XmHORIZONTAL. Pick your axis, bestie 🌈.
• XmNseparatorType — Specifies the type of line drawing to be done in the Separator widget. The options are:
  • XmSINGLE_LINE — Single line.
  • XmDOUBLE_LINE — Double line.
  • XmSINGLE_DASHED_LINE — Single-dashed line.
  • XmDOUBLE_DASHED_LINE — Double-dashed line.
  • XmNO_LINE — No line.
  • XmSHADOW_ETCHED_IN — A line whose shadows give the effect of a line etched into the window. The thickness of the line is equal to the value of XmNshadowThickness. For horizontal orientation, the top shadow is drawn in XmNtopShadowColor and the bottom shadow is drawn in XmNbottomShadowColor. For vertical orientation, the left edge is drawn in XmNtopShadowColor and the right edge is drawn in XmNbottomShadowColor.
  • XmSHADOW_ETCHED_OUT — A line whose shadows give the effect of an etched line coming out of the window. The thickness of the line is equal to the value of XmNshadowThickness. For horizontal orientation, the top shadow is drawn in XmNbottomShadowColor and the bottom shadow is drawn in XmNtopShadowColor. For vertical orientation, the left edge is drawn in XmNbottomShadowColor and the right edge is drawn in XmNtopShadowColor.
  • XmSHADOW_ETCHED_IN_DASH — Identical to XmSHADOW_ETCHED_IN except a series of lines creates a dashed line.
  • XmSHADOW_ETCHED_OUT_DASH — Identical to XmSHADOW_ETCHED_OUT except a series of lines creates a dashed line.

🧚 Inherited Resources 🧚

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

🎀 XmPrimitive Resource Set 🎀

Bestie, this is the full roster — every single resource that lives on XmPrimitive, with its Name, Class, Type, Default and Access. Nothing skipped, not one row, we're doing all eighteen and we're doing them right. ✨

The five columns, so you can read along: Name (what you actually type), Class (the fancier name it inherits under), Type (what kind of value it eats), Default (what you get if you say nothing), Access (the lil code telling you what you're allowed to do with it). 🫶

---

• XmNbottomShadowColor — class XmCBottomShadowColor, type Pixel, default dynamic, access CSG. Your bottom shadow's color moment. 💅
• XmNbottomShadowPixmap — class XmCBottomShadowPixmap, type Pixmap, default XmUNSPECIFIED_PIXMAP, access CSG. The pixmap version, and yeah, the default is literally unspecified. She contains multitudes. 🙈
• XmNconvertCallback — class XmCCallback, type XtCallbackList, default NULL, access C. A whole callback list, defaulting to nothing at all.
• XmNforeground — class XmCForeground, type Pixel, default dynamic, access CSG. The foreground, obviously. Main character pixel energy. 👑
• XmNhelpCallback — class XmCCallback, type XtCallbackList, default NULL, access C. Help callback, sitting there as NULL until you give it a purpose.
• XmNhighlightColor — class XmCHighlightColor, type Pixel, default dynamic, access CSG. The highlight color. Glow-up pending.
• XmNhighlightOnEnter — class XmCHighlightOnEnter, type Boolean, default False, access CSG. A boolean, and it starts out as False, so don't come for her. 😭
• XmNhighlightPixmap — class XmCHighlightPixmap, type Pixmap, default dynamic, access CSG. Highlight, but make it a pixmap.
• XmNhighlightThickness — class XmCHighlightThickness, type Dimension, default 0, access CSG. Zero thickness by default — she's got no body, only vibes. 💀
• XmNlayoutDirection — class XmCLayoutDirection, type XmDirection, default dynamic, access CG. Notice the access is CG, not CSG — read it again, bestie, it's CG. 🦋
• XmNnavigationType — class XmCNavigationType, type XmNavigationType, default XmNONE, access CSG. Defaults to XmNONE, so she's not navigating anywhere yet. 🧚
• XmNpopupHandlerCallback — class XmCCallback, type XtCallbackList, default NULL, access C. Popup handler callback, NULL until summoned. 🔥
• XmNshadowThickness — class XmCShadowThickness, type Dimension, default 2, access CSG. Two whole units of shadow. Iconic, honestly. ✨
• XmNtopShadowColor — class XmCTopShadowColor, type Pixel, default dynamic, access CSG. Top shadow color — the bottom one's better half. 💖
• XmNtopShadowPixmap — class XmCTopShadowPixmap, type Pixmap, default dynamic, access CSG. Top shadow, pixmap edition.
• XmNtraversalOn — class XmCTraversalOn, type Boolean, default False, access G. Starts False, and the access here is just G — that's it, one letter, no cap. 🌸
• XmNunitType — class XmCUnitType, type unsigned char, default dynamic, access CSG. Yep, the type is unsigned char. Weird but true, periodt.
• XmNuserData — class XmCUserData, type XtPointer, default NULL, access CSG. Your lil pocket for whatever you want, NULL until you fill it. 🍓

---

That's the entire set, every row accounted for, no crumbs left behind. 🌈

💖 Core Resource Set 💖

okay bestie, here's the whole glow-up menu of resources this widget inherits from Core — every single one, no skips, we don't gatekeep. Each bullet is like: name, class, type, default, access. Slay.

• 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 🌈

---

🧚 Translations 🧚

not to be dramatic but… there are literally no translations for XmSeparator. that's it. that's the tea. 💀

---

🌟 RELATED 🌟

the besties this page is linked to, go read them too fr fr:

• Core(3)
• XmCreateSeparator(3)
• XmVaCreateSeparator(3)
• XmVaCreateManagedSeparator(3)

---

and that's the whole page, you made it to the end 🫶 this is XmSeparator(library call), and yes the footer is giving "source + version + date" energy, so like… remember it's the library-call version of this page. iconic. periodt. 💖✨