NAME

XmHierarchy — The Hierarchy widget class

SYNOPSIS

#include <Xm/Hierarchy.h>

DESCRIPTION

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.

Classes

Hierarchy inherits behaviour, resources, and traits from Core, Composite, Composite, Constraint, and XmManager classes.

The class pointer is xmHierarchyWidgetClass.

The class name is XmHierarchy.

New Resources

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.

Inherited Resources

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
_	_	_	_	_

Callback Information

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.

Children

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