COMPOSITE(3)

💖 NAME 💖

Composite — the Composite widget class. Bestie, this is from the Composite(library call) section of the manual, and we're doing it in two parts, so buckle up 🎀

---

✨ SYNOPSIS ✨

#include <Xm/Xm.h>

---

🌸 DESCRIPTION 🌸

okay so. Composite widgets are the containers of the widget world 💅 they're built to hold other widgets, and they can have an arbitrary number of children — like, as many as you want, no cap. Their responsibilities (and these get implemented either directly by the widget class or indirectly by Intrinsics functions, iykyk) include:

• Overall management of children from creation all the way to destruction. the whole life cycle, we're there for it 🫶
• Destruction of descendants when the composite widget is destroyed. if the parent goes down, the whole bloodline goes down 💀
• Physical arrangement (aka geometry management) of a displayable subset of managed children. making it look cute = the job ✨
• Mapping and unmapping of a subset of the managed children.

Instances of composite widgets need to specify the order in which their children are kept. like, for example, an application may want a set of command buttons in some logical order grouped by function — and it may want buttons that represent filenames to be kept in alphabetical order. organization is self-care, periodt 📋

🦋 Classes 🦋

Composite inherits behavior and resources from Core.

• The class pointer is compositeWidgetClass.
• The class name is Composite.

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

Here's the Composite Resource Set, laid out all pretty for you 🎀

• 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

---

• XmNchildren — a read-only list of the children of the widget. just a list. look, don't touch 🙈
• XmNinsertPosition — points to the XtOrderProc function described below.
• XmNnumChildren — a read-only resource specifying the length of the list of children in XmNchildren. it's the headcount fr fr 🔢

The following procedure pointer in a composite widget instance is of type XtOrderProc:

Cardinal (* XtOrderProc) (Widget w);

• w — Specifies the widget.

Composite widgets that allow clients to order their children (usually homogeneous boxes) can call their widget instance's XmNinsertPosition procedure from the class's insert_child procedure to determine where a new child should go in its children array. So like, a client of a composite class can apply different sorting criteria to widget instances of the class, passing in a different XmNinsertPosition procedure when it creates each composite widget instance. custom vibes per instance, we love to see it 💅

The return value of the XmNinsertPosition procedure indicates how many children should go before the widget. A value of 0 (zero) indicates that the widget should go before all other children; returning the value of XmNumChildren indicates that it should go after all other children. By default, unless a subclass or an application provides an XmNinsertPosition procedure, each child is inserted at the end of the XmNchildren list. The XmNinsertPosition procedure can be overridden by a specific composite widget's resource list or by the argument list provided when the composite widget is created.

🌈 Inherited Resources 🌈

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

---

part 2 is coming bestie, don't go anywhere 🫶✨

---

okay bestie, here's the Core Resource Set in all its glory 💅 this is the full roster — every resource comes with its Name, Class, Type, Default and Access, and I am not skipping a single one of them. not one. periodt. 👑

• 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 1 · 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 🦋

There are no translations for Composite. like… none. zero. the void. XmNtranslations is sitting there with nothing to translate, and honestly? iconic of it. 🙈

---

🌈 RELATED 🌈

• Core(3).

---

and that's a wrap on the Core Resource Set bestie 💖 that was the Composite(library call) man page, straight from the library-call section of the manual — read it, love it, go make some widgets. slay. 🎀✨