Unix/Linux Go Back    


CentOS 7.0 - man page for composite (centos section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


Composite(library call) 						  Composite(library call)

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 arbi-
       trary number of children. Their responsibilities (implemented either directly by the  wid-
       get class or indirectly by Intrinsics functions) include:

	  o  Overall management of children from creation to destruction.

	  o  Destruction of descendants when the composite widget is destroyed.

	  o  Physical  arrangement (geometry management) of a displayable subset of managed chil-
	     dren.

	  o  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 func-
	     tion,  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  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  cre-
       ation  time  (C),  set by using XtSetValues (S), retrieved by using XtGetValues (G), or is
       not applicable (N/A).

       +-----------------------------------------------------------------------+
       |		  |	Composite Resource Set	    |	      |        |
       |Name		  | Class	      | Type	    | Default | Access |
       +------------------+-------------------+-------------+---------+--------+
       |XmNchildren	  | XmCReadOnly       | WidgetList  | NULL    | G      |
       +------------------+-------------------+-------------+---------+--------+
       |XmNinsertPosition | XmCInsertPosition | XtOrderProc | NULL    | CSG    |
       +------------------+-------------------+-------------+---------+--------+
       |XmNnumChildren	  | XmCReadOnly       | Cardinal    | 0       | G      |
       +------------------+-------------------+-------------+---------+--------+
       +------------------+-------------------+-------------+---------+--------+
       XmNchildren
		 A read-only list of the children of the widget.

       XmNinsertPosition
		 Points to the XtOrderProc function described below.

       XmNnumChildren
		 A read-only resource specifying the length of the list of children  in  XmNchil-
		 dren.

       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. Thus, 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.

       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 XmNinsertPo-
       sition procedure, each child is inserted at the end of the XmNchildren list.   The  XmNin-
       sertPosition 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.

       +---------------------------------------------------------------------------------------------------------------+
       |			      | 	      Core Resource Set 	       |		      |        |
       |Name			      | Class			      | Type	       | Default	      | Access |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNaccelerators 	      | XmCAccelerators 	      | XtAccelerators | dynamic	      | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNancestorSensitive	      | XmCSensitive		      | Boolean        | dynamic	      | G      |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNbackground		      | XmCBackground		      | Pixel	       | dynamic	      | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNbackgroundPixmap	      | XmCPixmap		      | Pixmap	       | XmUNSPECIFIED_PIXMAP | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNborderColor		      | XmCBorderColor		      | Pixel	       | XtDefaultForeground  | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNborderPixmap 	      | XmCPixmap		      | Pixmap	       | XmUNSPECIFIED_PIXMAP | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNborderWidth		      | XmCBorderWidth		      | Dimension      | 1		      | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNcolormap		      | XmCColormap		      | Colormap       | dynamic	      | CG     |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNdepth		      | XmCDepth		      | int	       | dynamic	      | CG     |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNdestroyCallback	      | XmCCallback		      | XtCallbackList | NULL		      | C      |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNheight		      | XmCHeight		      | Dimension      | dynamic	      | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNinitialResourcesPersistent | XmCInitialResourcesPersistent | Boolean        | True		      | C      |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNmappedWhenManaged	      | XmCMappedWhenManaged	      | Boolean        | True		      | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNscreen		      | XmCScreen		      | Screen *       | dynamic	      | CG     |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNsensitive		      | XmCSensitive		      | Boolean        | True		      | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNtranslations 	      | XmCTranslations 	      | XtTranslations | dynamic	      | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNwidth		      | XmCWidth		      | Dimension      | dynamic	      | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNx			      | XmCPosition		      | Position       | 0		      | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNy			      | XmCPosition		      | Position       | 0		      | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       +------------------------------+-------------------------------+----------------+----------------------+--------+
   Translations
       There are no translations for Composite.

RELATED
       Core(3).

									  Composite(library call)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 03:17 PM.