*** UNIX MANUAL PAGE BROWSER ***

Composite(3X) Composite(3X) NAME Composite - The Composite widget class SYNOPSIS #include <Xm/Xm.h> DESCRIPTION Composite widgets are intended to be containers for other widgets and can have an arbitrary number of children. Their responsibilities (im- plemented either directly by the widget class or indirectly by Intrin- sics functions) include: Overall management of children from creation to destruction. Destruction of descendants when the composite widget is destroyed. Physical arrangement (geometry management) of a dis- playable subset of managed children. Mapping and unmapping of a subset of the managed children. Instances of composite widgets need to spec- ify the order in which their children are kept. For example, an appli- cation 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. 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 pro- grammer to specify data. The programmer can also set the resource val- ues 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). Composite Resource Set Class: XmCReadOnly Default: NULL Type: WidgetList Access: G Class: Xm- CInsertPosition Default: NULL Type: XtOrderProc Access: CSG Class: Xm- CReadOnly Default: 0 Type: Cardinal Access: G A read-only list of the children of the widget. Points to the XtOrder- Proc function described below. A read-only resource specifying the length of the list of children in XmNchildren. The following procedure pointer in a composite widget instance is of type XtOrderProc: Cardinal (* XtOrderProc) (widget) Widget w; Specifies the widget. Composite widgets that allow clients to order their children (usually homogeneous boxes) can call their widget instance's insert_position procedure from the class's insert_child procedure to determine where a new child should go in its children array. Thus, a client of a compos- ite class can apply different sorting criteria to widget instances of the class, passing in a different insert_position procedure when it creates each composite widget instance. The return value of the insert_position procedure indicates how many children should go before the widget. Returning zero indicates that the widget should go before all other children; returning num_children indicates that it should go after all other children. The default in- sert_position function returns num_children and can be overridden by a specific composite widget's resource list or by the argument list pro- vided when the composite widget is created. Inherited Resources Composite inherits behavior and resources from the following super- class. For a complete description of each resource, refer to the man- ual page for that superclass. Core Resource Set Class: XmCAccelerators Default: dynamic Type: XtAccelerators Access: CSG Class: XmCSensitive Default: dynamic Type: Boolean Access: G Class: XmCBackground Default: dynamic Type: Pixel Access: CSG Class: XmCPixmap Default: XmUNSPECIFIED_PIXMAP Type: Pixmap Access: CSG Class: XmCBorderColor Default: XtDefaultForeground Type: Pixel Access: CSG Class: XmCPixmap Default: XmUNSPECIFIED_PIXMAP Type: Pixmap Ac- cess: CSG Class: XmCBorderWidth Default: 1 Type: Dimension Access: CSG Class: XmCColormap Default: dynamic Type: Colormap Access: CG Class: XmCDepth Default: dynamic Type: int Access: CG Class: XmCCallback De- fault: NULL Type: XtCallbackList Access: C Class: XmCHeight Default: dynamic Type: Dimension Access: CSG Class: XmCInitialResourcesPersis- tent Default: True Type: Boolean Access: C Class: XmCMappedWhenManaged Default: True Type: Boolean Access: CSG Class: XmCScreen Default: dy- namic Type: Screen * Access: CG Class: XmCSensitive Default: True Type: Boolean Access: CSG Class: XmCTranslations Default: dynamic Type: XtTranslations Access: CSG Class: XmCWidth Default: dynamic Type: Dimension Access: CSG Class: XmCPosition Default: 0 Type: Posi- tion Access: CSG Class: XmCPosition Default: 0 Type: Position Access: CSG Translations There are no translations for Composite. SEE ALSO Core(3X) Composite(3X)