|
Packit |
b099d7 |
.TH "XmOutline" "library call"
|
|
Packit |
b099d7 |
.SH "NAME"
|
|
Packit |
b099d7 |
\fBXmOutline\fP \(em The Outline widget class
|
|
Packit |
b099d7 |
.iX "XmOutline"
|
|
Packit |
b099d7 |
.iX "widget class" "Outline"
|
|
Packit |
b099d7 |
.SH "SYNOPSIS"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
#include <Xm/Outline\&.h>
|
|
Packit |
b099d7 |
.fi
|
|
Packit |
b099d7 |
.SH "DESCRIPTION"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The Outline widget is a container that shows the relationship of its children in a
|
|
Packit |
b099d7 |
graphical tree-like format. Each child of the Outline widget is a node in the Outline.
|
|
Packit |
b099d7 |
The parent-child relationships between these nodes are completely distinct from the
|
|
Packit |
b099d7 |
widget hierarchy. The hierarchy of nodes is created by specifying the tree "parent" of
|
|
Packit |
b099d7 |
each node as a constraint resource. If a node's parent is NULL then it is assumed to
|
|
Packit |
b099d7 |
be a root of the tree. Although each widget can only have one parent, the Outline widget
|
|
Packit |
b099d7 |
supports adding more than one "root" node to a single Outline.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Note: The Outline widget assumes that it will be totally responsible for mapping
|
|
Packit |
b099d7 |
and unmapping its children. Therefore no child of this widget should ever modify its
|
|
Packit |
b099d7 |
mappedWhenManaged resource. If a child does modify this resource the behavior is
|
|
Packit |
b099d7 |
undefined.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.SS "User Interaction"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Each node in the outline can have one of four states: open, closed, always open, and
|
|
Packit |
b099d7 |
hidden. The state of a node changes how it appears to the user and what actions are
|
|
Packit |
b099d7 |
available to the user.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.ta 15
|
|
Packit |
b099d7 |
.HP 15
|
|
Packit |
b099d7 |
Open This node will have an open folder shown to its left that
|
|
Packit |
b099d7 |
may be selected by the user to close this node. When a
|
|
Packit |
b099d7 |
node is open all of its children will be visible to the user.
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
.ta 15
|
|
Packit |
b099d7 |
.HP 15
|
|
Packit |
b099d7 |
Closed This node will have a closed folder shown to its left that
|
|
Packit |
b099d7 |
may be selected by the user to open this node. When a
|
|
Packit |
b099d7 |
node is closed none of its children will be visible to the
|
|
Packit |
b099d7 |
user.
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
.ta 15
|
|
Packit |
b099d7 |
.HP 15
|
|
Packit |
b099d7 |
Always Open This node will have no folder button associated with it.
|
|
Packit |
b099d7 |
All of its children will be visible to the user.
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
.ta 15
|
|
Packit |
b099d7 |
.HP 15
|
|
Packit |
b099d7 |
Hidden This node will not be shown to the user and all of its
|
|
Packit |
b099d7 |
children will appear and act exactly as if they were
|
|
Packit |
b099d7 |
children of this node's parent. It will appear to the user
|
|
Packit |
b099d7 |
as if this node does not exist.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
To maintain consistency of the user interface we have found that it is best to use the
|
|
Packit |
b099d7 |
node state "Always Open" for nodes with no children. This way the user will only see
|
|
Packit |
b099d7 |
a folder button next to a node that has children to display. A folder button associated
|
|
Packit |
b099d7 |
with a node that has no children has no defined semantics.
|
|
Packit |
b099d7 |
.SS "Classes"
|
|
Packit |
b099d7 |
Outline inherits behavior and resources from the
|
|
Packit |
b099d7 |
\fBCore\fP, \fBComposite\fP, \fBConstraint\fP, \fBXmManager\fP, and
|
|
Packit |
b099d7 |
\fBXmHierarchy\fP classes\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The class pointer is \fBxmOutlineWidgetClass\fP\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The class name is \fBXmOutline\fP\&.
|
|
Packit |
b099d7 |
.SS "New Resources"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The following table defines a set of widget resources used by the programmer
|
|
Packit |
b099d7 |
to specify data\&. The programmer can also set the resource values for the
|
|
Packit |
b099d7 |
inherited classes to set attributes for this widget\&. To reference a
|
|
Packit |
b099d7 |
resource by name or by class in a \fB\&.Xdefaults\fP file, remove the \fBXmN\fP or
|
|
Packit |
b099d7 |
\fBXmC\fP prefix and use the remaining letters\&. To specify one of the defined
|
|
Packit |
b099d7 |
values for a resource in a \fB\&.Xdefaults\fP file, remove the \fBXm\fP prefix and use
|
|
Packit |
b099d7 |
the remaining letters (in either lowercase or uppercase, but include any
|
|
Packit |
b099d7 |
underscores between words)\&.
|
|
Packit |
b099d7 |
The codes in the access column indicate if the given resource can be
|
|
Packit |
b099d7 |
set at creation time (C),
|
|
Packit |
b099d7 |
set by using \fBXtSetValues\fP (S),
|
|
Packit |
b099d7 |
retrieved by using \fBXtGetValues\fP (G), or is not applicable (N/A)\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.TS
|
|
Packit |
b099d7 |
tab(?) box;
|
|
Packit |
b099d7 |
c s s s s
|
|
Packit |
b099d7 |
l| l| l| l| l.
|
|
Packit |
b099d7 |
\fBXmOutline Resource Set\fP
|
|
Packit |
b099d7 |
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNconnectNodes?Boolean?Boolean?False?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNindentSpace?Dimension?Dimension?30?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.IP "\fBXmNconnectNodes\fP" 10
|
|
Packit |
b099d7 |
Specifies whether to draw lines connecting a parent to each of its
|
|
Packit |
b099d7 |
children nodes.
|
|
Packit |
b099d7 |
.IP "\fBXmNindentSpace\fP" 10
|
|
Packit |
b099d7 |
This resource controls how many pixels divide the outline's levels
|
|
Packit |
b099d7 |
.SS "Inherited Resources"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Outline inherits behavior and resources from the
|
|
Packit |
b099d7 |
superclasses described in the following tables\&.
|
|
Packit |
b099d7 |
For a complete description of each resource, refer to the
|
|
Packit |
b099d7 |
reference page for that superclass\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.TS
|
|
Packit |
b099d7 |
tab(?) box;
|
|
Packit |
b099d7 |
c s s s s
|
|
Packit |
b099d7 |
l| l| l| l| l.
|
|
Packit |
b099d7 |
\fBXmHierarchy Resource Set\fP
|
|
Packit |
b099d7 |
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNautoClose?XmCAutoClose?Boolean?True?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNcloseFolderPixmap?XmCPixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNhorizontalMargin?XmCDimension?Dimension?2?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNnodeStateCallback?XmCNodeStateCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNopenFolderPixmap?XmCPixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNrefigureMode?XmCBoolean?Boolean?True?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNverticalMargin?XmCDimension?Dimension?2?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.TS
|
|
Packit |
b099d7 |
tab(?) box;
|
|
Packit |
b099d7 |
c s s s s
|
|
Packit |
b099d7 |
l| l| l| l| l.
|
|
Packit |
b099d7 |
\fBXmManager Resource Set\fP
|
|
Packit |
b099d7 |
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbottomShadowColor?XmCBottomShadowColor?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbottomShadowPixmap?XmCBottomShadowPixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNforeground?XmCForeground?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNhelpCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNhighlightColor?XmCHighlightColor?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNhighlightPixmap?XmCHighlightPixmap?Pixmap?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNinitialFocus?XmCInitialFocus?Widget?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNlayoutDirection?XmCLayoutDirection?XmDirection?dynamic?CG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNnavigationType?XmCNavigationType?XmNavigationType?XmTAB_GROUP?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNpopupHandlerCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNshadowThickness?XmCShadowThickness?Dimension?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNstringDirection?XmCStringDirection?XmStringDirection?dynamic?CG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNtopShadowColor?XmCTopShadowColor?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNtopShadowPixmap?XmCTopShadowPixmap?Pixmap?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNtraversalOn?XmCTraversalOn?Boolean?True?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNunitType?XmCUnitType?unsigned char?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNuserData?XmCUserData?XtPointer?NULL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.TS
|
|
Packit |
b099d7 |
tab(?) box;
|
|
Packit |
b099d7 |
c s s s s
|
|
Packit |
b099d7 |
l| l| l| l| l.
|
|
Packit |
b099d7 |
\fBComposite Resource Set\fP
|
|
Packit |
b099d7 |
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNchildren?XmCReadOnly?WidgetList?NULL?G
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNinsertPosition?XmCInsertPosition?XtOrderProc?NULL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNnumChildren?XmCReadOnly?Cardinal?0?G
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.TS
|
|
Packit |
b099d7 |
tab(?) box;
|
|
Packit |
b099d7 |
c s s s s
|
|
Packit |
b099d7 |
l| l| l| l| l.
|
|
Packit |
b099d7 |
\fBCore Resource Set\fP
|
|
Packit |
b099d7 |
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNaccelerators?XmCAccelerators?XtAccelerators?dynamic?N/A
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNancestorSensitive?XmCSensitive?Boolean?dynamic?G
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbackground?XmCBackground?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbackgroundPixmap?XmCPixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNborderColor?XmCBorderColor?Pixel?XtDefaultForeground?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNborderPixmap?XmCPixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNborderWidth?XmCBorderWidth?Dimension?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNcolormap?XmCColormap?Colormap?dynamic?CG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNdepth?XmCDepth?int?dynamic?CG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNdestroyCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNheight?XmCHeight?Dimension?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNinitialResourcesPersistent?XmCInitialResourcesPersistent?Boolean?True?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNmappedWhenManaged?XmCMappedWhenManaged?Boolean?True?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNscreen?XmCScreen?Screen *?dynamic?CG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNsensitive?XmCSensitive?Boolean?True?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNtranslations?XmCTranslations?XtTranslations?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNwidth?XmCWidth?Dimension?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNx?XmCPosition?Position?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNy?XmCPosition?Position?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.SS "Geometry Management"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The preferred size of the entire outline will be just large enough to contain all nodes
|
|
Packit |
b099d7 |
in the hierarchy. As the node state changes the outline will attempt to resize itself to
|
|
Packit |
b099d7 |
just contain its currently visible children. If the outline is forced away from its desired
|
|
Packit |
b099d7 |
size the children will not be moved and will either be clipped, or appear in the upper
|
|
Packit |
b099d7 |
left hand corner of the window. For this reason it is usually desirable to put the outline
|
|
Packit |
b099d7 |
into a Scrolled Window widget.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.SH RELATED
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
\fBComposite\fP(3),
|
|
Packit |
b099d7 |
\fBConstraint\fP(3),
|
|
Packit |
b099d7 |
\fBCore\fP(3),
|
|
Packit |
b099d7 |
\fBXmCreateHierarchy\fP(3),
|
|
Packit |
b099d7 |
\fBXmHierarchy\fP(3),
|
|
Packit |
b099d7 |
\fBXmManager\fP(3)\&.
|