NAME    [Toc]    [Back]

       Composite - The Composite widget class

SYNOPSIS    [Toc]    [Back]

       #include <Xm/Xm.h>

DESCRIPTION    [Toc]    [Back]

       Composite  widgets are intended to be containers for other
       widgets and can have  an  arbitrary  number  of  children.
       Their responsibilities (implemented either directly by the
       widget  class  or  indirectly  by  Intrinsics   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 displayable subset of  managed  children.
       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.  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.

   Classes    [Toc]    [Back]
       Composite inherits behavior and resources from Core.

       The class pointer is compositeWidgetClass.

       The class name is Composite.

   New Resources    [Toc]    [Back]
       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).

       Composite Resource Set    [Toc]    [Back]

       Class: XmCReadOnly
       Default: NULL
       Type:  WidgetList
       Access: G
       Class: XmCInsertPosition
       Default: NULL
       Type:  XtOrderProc
       Access: CSG
       Class: XmCReadOnly
       Default: 0
       Type:  Cardinal
       Access: G


       A read-only list of the children of the widget.  Points to
       the  XtOrderProc  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 composite
  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
       insert_position  function  returns num_children and 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    [Toc]    [Back]
       Composite inherits behavior and resources from the following
  superclass.   For  a  complete  description  of  each
       resource, refer to the manual page for that superclass.

       Core Resource Set    [Toc]    [Back]

       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
       Access: 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
       Default: NULL
       Type:  XtCallbackList
       Access: C
       Class: XmCHeight
       Default: dynamic
       Type:  Dimension
       Access: CSG
       Class: XmCInitialResourcesPersistent
       Default: True
       Type:  Boolean
       Access: C
       Class: XmCMappedWhenManaged
       Default: True
       Type:  Boolean
       Access: CSG
       Class: XmCScreen
       Default: dynamic
       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:  Position
       Access: CSG
       Class: XmCPosition
       Default: 0
       Type:  Position
       Access: CSG


   Translations    [Toc]    [Back]
       There are no translations for Composite.

SEE ALSO    [Toc]    [Back]

       Core(3X)



                                                    Composite(3X)