GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
XmHierarchy(3) FreeBSD Library Functions Manual XmHierarchy(3)

XmHierarchy — The Hierarchy widget class

#include <Xm/Hierarchy.h>

The Hierarchy widget is not intended to be instantiated itself, but rather should be used as the base class for any widget that would like to present a hierarchy of information to the user that is different for the actual widget instance hierarchy of the application. This base class is currently used for two widgets in the Motif widget set, Tree and Outline, giving those two widgets a very similar API.
Note: The Hierarchy widget assumes that it will be totally responsible for mapping and unmapping its children. Therefore no child of this widget should ever modify its mappedWhenManaged resource. If a child does modify this resource the behavior is undefined.

Hierarchy inherits behaviour, resources, and traits from Core, Composite, Composite, Constraint, and XmManager classes.
The class pointer is xmHierarchyWidgetClass.
The class name is XmHierarchy.

XmHierarchy Resource Set
Name Class Type Default Access
_ _ _ _ _
XmNautoClose XmCAutoClose Boolean True CSG
_ _ _ _ _
XmNcloseFolderPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG
_ _ _ _ _
XmNhorizontalMargin XmCDimension Dimension 2 CSG
_ _ _ _ _
XmNnodeStateCallback XmCNodeStateCallback XtCallbackList NULL C
_ _ _ _ _
XmNopenFolderPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG
_ _ _ _ _
XmNrefigureMode XmCBoolean Boolean True CSG
_ _ _ _ _
XmNverticalMargin XmCDimension Dimension 2 CSG
_ _ _ _ _
XmNautoClose
This resource determines if the hierarchy should automatically restore a parent node's children when the parent node is reopened. If autoClose is False, and the hierarchy is fully expanded when the root node is closed, then the entire hierarchy will be displayed as expanded when the root node is reopened. If autoClose is True, then the root node's children are closed when the root node is reopened.
XmNcloseFolderPixmap
This resource defines a pixmap for the closed representation of the folder pixmap to be used throughout the tree. It can be a color pixmap or bitmap. If the user does not specify a pixmap the default bitmap will be used.
XmNhorizontalMargin
XmNverticalMargin
The exact definition of these resources are left to the subclass of the hierarchy widget that does the geometry layout. They are intended to be used as the amount of space between the object and the edges of the window it is displayed in. They are included here for consistency.
XmNopenFolderPixmap
This resource defines a pixmap for the open representation of the folder pixmap to be used throughout the tree . It can be a color pixmap or bitmap. If the user does not specify a pixmap the default opened folder bitmap.
XmNnodeStateCallback
The list of callback routines called when a folder button is clicked. See "Callback Routine" for more details.
XmNrefigureMode
This resource determines whether the Hierarchy should adjust the sizes of the children after a geometry or resize request, or simply ignore the request. This resource is very useful in improving the performance of an application that is making a large number of geometry changes all at once.
XmHierarchy Constraint Resource Set
Name Class Type Default Access
_ _ _ _ _
XmNinsertBefore XmCInsertbefore Widget NULL CSG
_ _ _ _ _
XmNnodeState XmCNodeState XMHierarchyNodeState XmOpen CSG
_ _ _ _ _
XmNparentNode XmCParentNode Widget NULL CSG
_ _ _ _ _
XmNinsertBefore
Specifies another node that has the same parentNode. This node will then be placed immediately before that node in the hierarchy. If this value is NULL then the node will be inserted at the end of the list. This resource allows the hierarchy's children to be reordered.
XmNnodeState
The state of this node. Acceptable values are: XmOpen, XmClosed, XmAlwaysOpen, and XmHidden. A type converter has been registered that can convert the following strings: "open", "close", "alwaysOpen", and "hidden".
XmNparentNode
The hierarchy parent of this node. The parent node MUST be a widget sibling of the current node.

Hierarchy inherits behavior and resources from the superclasses described in the following tables. For a complete description of each resource, refer to the reference page for that superclass.
XmManager Resource Set
Name Class Type Default Access
_ _ _ _ _
XmNbottomShadowColor XmCBottomShadowColor Pixel dynamic CSG
_ _ _ _ _
XmNbottomShadowPixmap XmCBottomShadowPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG
_ _ _ _ _
XmNforeground XmCForeground Pixel dynamic CSG
_ _ _ _ _
XmNhelpCallback XmCCallback XtCallbackList NULL C
_ _ _ _ _
XmNhighlightColor XmCHighlightColor Pixel dynamic CSG
_ _ _ _ _
XmNhighlightPixmap XmCHighlightPixmap Pixmap dynamic CSG
_ _ _ _ _
XmNinitialFocus XmCInitialFocus Widget dynamic CSG
_ _ _ _ _
XmNlayoutDirection XmCLayoutDirection XmDirection dynamic CG
_ _ _ _ _
XmNnavigationType XmCNavigationType XmNavigationType XmTAB_GROUP CSG
_ _ _ _ _
XmNpopupHandlerCallback XmCCallback XtCallbackList NULL C
_ _ _ _ _
XmNshadowThickness XmCShadowThickness Dimension dynamic CSG
_ _ _ _ _
XmNstringDirection XmCStringDirection XmStringDirection dynamic CG
_ _ _ _ _
XmNtopShadowColor XmCTopShadowColor Pixel dynamic CSG
_ _ _ _ _
XmNtopShadowPixmap XmCTopShadowPixmap Pixmap dynamic CSG
_ _ _ _ _
XmNtraversalOn XmCTraversalOn Boolean True CSG
_ _ _ _ _
XmNunitType XmCUnitType unsigned char dynamic CSG
_ _ _ _ _
XmNuserData XmCUserData XtPointer NULL CSG
_ _ _ _ _
Composite Resource Set
Name Class Type Default Access
_ _ _ _ _
XmNchildren XmCReadOnly WidgetList NULL G
_ _ _ _ _
XmNinsertPosition XmCInsertPosition XtOrderProc NULL CSG
_ _ _ _ _
XmNnumChildren XmCReadOnly Cardinal 0 G
_ _ _ _ _
Core Resource Set
Name Class Type Default Access
_ _ _ _ _
XmNaccelerators XmCAccelerators XtAccelerators dynamic N/A
_ _ _ _ _
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 0 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
_ _ _ _ _

When a folder is clicked, the routines registered on the XmNnodeStateCallback list are passed a pointer to the following structure as client data:
typedef struct _XmHierarchyNodeStateData {
	Widget  widget;
	XmHierarchyNodeState  state;
} XmHierarchyNodeStateData;
widget
the child node of Hierarchy being opened or closed.
    
state
the current XmNnodeState (after the click) of the 
node. Legal values are XmOpen, XmClosed, XmAlwaysOpen, 
and XmHidden.
    

The hierarchy maintains IconButtons for each node in the hierarchy. Setting openFolderPixmap or closeFolderPixmap is done through XtSetValues. IconButtons may only be manipulated by the Hierarchy.

Composite(3), Constraint(3), Core(3), XmCreateHierarchy(3), XmHierarchyGetChildNodes(3), XmHierarchyOpenAllAncestors(3), XmManager(3).

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.