XmContainer(library call) XmContainer(library call)
NAME [Toc] [Back]
XmContainer - The Container widget class
SYNOPSIS [Toc] [Back]
#include <Xm/Container.h>
DESCRIPTION [Toc] [Back]
Container manages child widgets that have the ContainerItem trait.
These child widgets can be viewed in several different layout formats,
selected using different selection types and techniques, and directly
manipulated by the user.
Three different formats or views are supported by the Container. They
are specified via the XmNentryViewType resource:
+ XmLARGE_ICON
+ XmSMALL_ICON
+ XmANY_ICON
Three different layout types are supported by the Container. They are
specified by the XmNlayoutType resource:
+ XmSPATIAL
+ XmOUTLINE
+ XmDETAIL
In the XmSPATIAL layout type, several other resources
(XmNspatialStyle, XmNspatialIncludeModel, XmNspatialSnapModel) control
the positioning of the items within the Container; an application
programmer can specify these resources so that the Container strictly
enforces the position of each item or so that the Container positions
items according to constraint resources specified for each item. The
user, however, can alter the position of an item in the XmSPATIAL
layout type within the Container by direct manipulation; for example,
by pressing BTransfer over the item and then dragging and releasing
BTransfer over some location within the Container.
In the XmOUTLINE layout type, the Container controls the positioning
of the items. Items within the Container can have parent-child
relationships between them. Each item's XmNentryParent resource can
specify another item in the same Container as its parent; items with a
non-NULL value for XmNentryParent can only be displayed in the
XmOUTLINE layout type. In the XmOUTLINE layout type, items are
positioned in a tree configuration with connecting lines drawn to
illustrate the relationships. Items are positioned top to bottom in
the order specified by XmNpositionIndex within their parent.
Container positions a PushButton next to each item that has a parent
- 1 - Formatted: January 24, 2005
XmContainer(library call) XmContainer(library call)
relationship to other items. The PushButton contains a pixmap to
illustrate whether the child items are shown or not; the user can
activate the PushButton to toggle between showing or hiding the child
items. Direct manipulation to alter the position of the item is not
supported in the XmOUTLINE layout type. Note that the XmNtraversalOn
resource of the PushButtons created by Container are set to False.
The XmDETAIL layout type is the same as XmOUTLINE, except that each
item can also display additional information as rows in columns with
column headers specified in the XmNdetailColumnHeading resources. In
each item row, the item's detail information (see the reference page
on XmIconGadget for a description of the XmNentryDetail resource) is
displayed. Items are positioned top to bottom in the order specified
by XmNpositionIndex within the parent.
Selection [Toc] [Back]
When a child widget of the container is selected, the container
specifies that the item should display the appropriate visual
information to the user via the ContainerItem trait. The application
program is notified of selection changes through XmNselectionCallback.
The container uses four selection policies:
+ Single
+ Browse
+ Multiple
+ Extended
In Single Select and Browse Select modes, only one item can be
selected at a time. Pressing BSelect on an item selects it and
deselects any other selected item. Pressing BSelect over an empty
space in the Container deselects all items. In Browse Select, dragging
BSelect moves the selection as the pointer is moved.
In Multiple Select and Extended Select modes, any number of items can
be selected at the same time. In Multiple Select, pressing and
dragging BSelect or BExtend to specify an item, range of items, or
group of discontiguous items causes the selection states of those
items to be toggled. In Extended Select, pressing and dragging BSelect
to indicate an item, range of items, or group of discontiguous items
selects those items and deselects all others. Pressing and dragging
BExtend in Extended Select to indicate an item, range of items, or
discontiguous group of items causes the selection states of those
items to be toggled.
Several techniques are available to indicate an item, range of items,
or group of discontiguous items in the Multiple Select and Extended
Select modes.
- 2 - Formatted: January 24, 2005
XmContainer(library call) XmContainer(library call)
In the XmSPATIAL and XmOUTLINE layout types, the XmNselectionTechnique
resource specifies the techniques to be used to indicate items. The
default specification of XmTOUCH_OVER allows both the Random-Swipe and
Marquee techniques to be used when XmNlayoutStyle is XmSPATIAL. The
default specification of XmTOUCH_OVER allows the Range-Swipe, RangeClick,
and Marquee techniques to be used when XmNlayoutStyle is
XmOUTLINE.
Discontiguous groups of items can be selected using the Random-Swipe
technique. In the Random-Swipe technique, pressing BSelect (or
BExtend) over an item and dragging BSelect over other items selects
all of those items. Only those items that pointer passed over are
selected.
In the Range-Swipe technique, the user presses BSelect (or BExtend)
over the first item and releases BSelect over the last item; all items
within the range between the first and last item are selected whether
the pointer actually passed over them or not. In the Range-Click
technique, the user presses and releases BSelect (or BExtend) over the
first item and then presses and releases BExtend over the last item.
In the Marquee technique, pressing BSelect (or BExtend) over a blank
space within the Container indicates the starting point of a Marquee
rectangle. Dragging BSelect draws a Marquee rectangle (rubberband
line) between the starting point and current pointer. All items
completely within the Marquee rectangle are selected.
Specifying XmTOUCH_ONLY for XmNselectionTechnique enforces the
Random-Swipe technique even when BSelect (or BExtend) is pressed over
a blank space. Similarly, specifying XmMARQUEE enforces the Marquee
technique even when BSelect (or BExtend) is pressed over an item;
since the item over which the press occurs is only partially included
in the Marquee rectangle, it is not selected. XmMARQUEE_EXTEND_START
and XmMARQUEE_EXTEND_BOTH enforce the Marquee technique and also cause
the rectangle to extend automatically around the first item indicated
and, for XmMARQUEE_EXTEND_BOTH, the last item.
In the XmDETAIL layout type, the Range-Swipe and Range-Click
techniques are available to indicate a range of items for selection.
Container uses the XmQTcontainerItem, XmQTscrollFrame, and
XmQTspecifyRenderTable traits and holds the XmQTcontainer and
XmQTtransfer traits.
Data Transfer Behavior [Toc] [Back]
Container supports dragging of selected items from the widget.
Depending on the value of XmNprimaryOwnership, Container can also
support primary selection.
As a source of data, Container supports the following targets and
associated conversions of data to these targets:
- 3 - Formatted: January 24, 2005
XmContainer(library call) XmContainer(library call)
locale If the locale target matches the widget's locale, the widget
transfers the selected items in the encoding of the locale.
The value for each item transferred, except the last,
includes a trailing separator. Each item value is the
XmNlabelString of the item.
COMPOUND_TEXT [Toc] [Back]
The widget transfers the selected items as type
COMPOUND_TEXT. The value for each item transferred, except
the last, includes a trailing separator. Each item value is
the XmNlabelString of the item.
DELETE The widget deletes the selected items.
PIXMAP The widget transfers a list of the pixmap IDs of the
selected items as type DRAWABLE.
STRING The widget transfers the selected items as type STRING. The
value for each item transferred, except the last, includes a
trailing separator. Each item value is the XmNlabelString
of the item.
TEXT If the selected items are fully convertible to the encoding
of the locale, the widget transfers the selected items in
the encoding of the locale. Otherwise, the widget transfers
the selected items as type COMPOUND_TEXT. The value for
each item transferred, except the last, includes a trailing
separator. Each item value is the XmNlabelString of the
item.
_MOTIF_CLIPBOARD_TARGETS
The widget transfers, as type ATOM, a list of the targets it
supports for immediate transfer for the CLIPBOARD selection.
These include _MOTIF_COMPOUND_STRING and PIXMAP. If the
selected items are fully convertible to STRING, these also
include STRING; otherwise, they also include COMPOUND_TEXT.
_MOTIF_COMPOUND_STRING
The widget transfers the selected items as a compound string
in Byte Stream format. The value for each item transferred,
except the last, includes a trailing separator. Each item
value is the XmNlabelString of the item.
_MOTIF_DEFERRED_CLIPBOARD_TARGETS
The widget transfers, as type ATOM, a list of the targets it
supports for delayed transfer for the CLIPBOARD selection.
This widget currently supplies no targets for
_MOTIF_DEFERRED_CLIPBOARD_TARGETS.
_MOTIF_DRAG_OFFSET
The widget transfers a list of two 16-bit numbers, of type
- 4 - Formatted: January 24, 2005
XmContainer(library call) XmContainer(library call)
INTEGER, representing an x and y offset for an item being
dragged. This offset is calculated so that, if the offset
were added to the x and y coordinates at the drop site, and
the dragged pixmap placed at that position, it would
correspond to the position the user would expect the pixmap
to placed at, based on the drag icon used at the drop site.
_MOTIF_EXPORT_TARGETS
The widget transfers, as type ATOM, a list of the targets to
be used as the value of the DragContext's XmNexportTargets
in a drag-and-drop transfer. These include
_MOTIF_COMPOUND_STRING, PIXMAP, COMPOUND_TEXT, the encoding
of the locale, STRING, TEXT, BACKGROUND, and FOREGROUND.
As a source of data, Container also supports the following standard
Motif targets:
BACKGROUND [Toc] [Back]
The widget transfers XmNbackground as type PIXEL.
CLASS The widget finds the first shell in the widget hierarchy
that has a WM_CLASS property and transfers the contents as
text in the current locale.
CLIENT_WINDOW [Toc] [Back]
The widget finds the first shell in the widget hierarchy and
transfers its window as type WINDOW.
COLORMAP The widget transfers XmNcolormap as type COLORMAP.
FOREGROUND [Toc] [Back]
The widget transfers XmNforeground as type PIXEL.
NAME The widget finds the first shell in the widget hierarchy
that has a WM_NAME property and transfers the contents as
text in the current locale.
TARGETS The widget transfers, as type ATOM, a list of the targets it
supports. These include the standard targets in this list.
These also include _MOTIF_COMPOUND_STRING, PIXMAP,
COMPOUND_TEXT, the encoding of the locale, STRING, and TEXT.
TIMESTAMP The widget transfers the timestamp used to acquire the
selection as type INTEGER.
_MOTIF_RENDER_TABLE
The widget transfers XmNrenderTable if it exists, or else
the default text render table, as type STRING.
_MOTIF_ENCODING_REGISTRY
The widget transfers its encoding registry as type STRING.
- 5 - Formatted: January 24, 2005
XmContainer(library call) XmContainer(library call)
The value is a list of NULL separated items in the form of
tag encoding pairs. This target symbolizes the transfer
target for the Motif Segment Encoding Registry. Widgets and
applications can use this Registry to register text encoding
formats for specified render table tags. Applications
access this Registry by calling XmRegisterSegmentEncoding
and XmMapSegmentEncoding.
As a destination for data, Container supports only the dropping of
items being dragged from the same widget. Subclasses and the
XmNdestinationCallback procedures are responsible for any other data
transfers to the widget.
Classes [Toc] [Back]
Container inherits behavior, resources, and traits from the Core,
Composite, Constraint, and XmManager classes.
The class pointer is xmContainerWidgetClass.
The class name is XmContainer.
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 whether 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).
- 6 - Formatted: January 24, 2005
XmContainer(library call) XmContainer(library call)
________________________________________________________________________________________________________________
XmContainer Resource Set
Name Class Type Default Access
________________________________________________________________________________________________________________
XmNautomaticSelection XmCAutomaticSelection unsigned char XmAUTO_SELECT CSG
________________________________________________________________________________________________________________
XmNcollapsedStatePixmap XmCCollapsedStatePixmap Pixmap dynamic CSG
________________________________________________________________________________________________________________
XmNconvertCallback XmCCallback XtCallbackList NULL C
________________________________________________________________________________________________________________
XmNdefaultActionCallback XmCCallback XtCallbackList NULL C
________________________________________________________________________________________________________________
XmNdestinationCallback XmCCallback XtCallbackList NULL C
________________________________________________________________________________________________________________
XmNdetailColumnHeading XmCDetailColumnHeading XmStringTable NULL CSG
________________________________________________________________________________________________________________
XmNdetailColumnHeadingCount XmCDetailColumnHeadingCount Cardinal 0 CSG
________________________________________________________________________________________________________________
XmNdetailOrder XmCDetailOrder Cardinal * NULL CSG
________________________________________________________________________________________________________________
XmNdetailOrderCount XmCDetailOrderCount Cardinal dynamic CSG
________________________________________________________________________________________________________________
XmNdetailTabList XmCDetailTabList XmTabList NULL CSG
________________________________________________________________________________________________________________
XmNentryViewType XmCEntryViewType unsigned char XmANY_ICON CSG
________________________________________________________________________________________________________________
XmNexpandedStatePixmap XmCExpandedStatePixmap Pixmap dynamic CSG
________________________________________________________________________________________________________________
XmNfontList XmCFontList XmFontList NULL CSG
________________________________________________________________________________________________________________
XmNlargeCellHeight XmCCellHeight Dimension dynamic CSG
________________________________________________________________________________________________________________
XmNlargeCellWidth XmCCellWidth Dimension dynamic CSG
________________________________________________________________________________________________________________
XmNlayoutType XmCLayoutType unsigned char XmSPATIAL CSG
________________________________________________________________________________________________________________
XmNmarginHeight XmCMarginHeight Dimension 0 CSG
________________________________________________________________________________________________________________
XmNmarginWidth XmCMarginWidth Dimension 0 CSG
________________________________________________________________________________________________________________
XmNoutlineButtonPolicy XmCOutlineButtonPolicy unsigned char XmOUTLINE_BUTTON_PRESENT CSG
________________________________________________________________________________________________________________
XmNoutlineChangedCallback XmCCallback XtCallbackList NULL C
________________________________________________________________________________________________________________
XmNoutlineColumnWidth XmCOutlineColumnWidth Dimension dynamic CSG
________________________________________________________________________________________________________________
XmNoutlineIndentation XmCOutlineIndentation Dimension 40 CSG
________________________________________________________________________________________________________________
XmNoutlineLineStyle XmCLineStyle unsigned char XmSINGLE CSG
________________________________________________________________________________________________________________
XmNprimaryOwnership XmCprimaryOwnership unsigned char XmOWN_POSSIBLE_MULTIPLE CSG
- 7 - Formatted: January 24, 2005
XmContainer(library call) XmContainer(library call)
________________________________________________________________________________________________________________
|XmNrenderTable XmCRenderTable XmRenderTable dynamic CSG |
|_______________________________________________________________________________________________________________|
|XmNselectColor | XmCSelectColor | Pixel | dynamic | CSG |
|____________________________|_____________________________|________________|__________________________|________|
|XmNselectedObjects | XmCSelectedObjects | WidgetList | NULL | SG |
|____________________________|_____________________________|________________|__________________________|________|
|XmNselectedObjectCount | XmCSelectedObjectCount | unsigned int | 0 | SG |
|____________________________|_____________________________|________________|__________________________|________|
|XmNselectionCallback | XmCCallback | XtCallbackList | NULL | C |
|____________________________|_____________________________|________________|__________________________|________|
|XmNselectionPolicy | XmCSelectionPolicy | unsigned char | XmEXTENDED_SELECT | CSG |
|____________________________|_____________________________|________________|__________________________|________|
|XmNselectionTechnique | XmCSelectionTechnique | unsigned char | XmTOUCH_OVER | CSG |
|____________________________|_____________________________|________________|__________________________|________|
|XmNsmallCellHeight | XmCCellHeight | Dimension | dynamic | CSG |
|____________________________|_____________________________|________________|__________________________|________|
|XmNsmallCellWidth | XmCCellWidth | Dimension | dynamic | CSG |
|____________________________|_____________________________|________________|__________________________|________|
|XmNspatialIncludeModel | XmCSpatialIncludeModel | unsigned char | XmAPPEND | CSG |
|____________________________|_____________________________|________________|__________________________|________|
|XmNspatialResizeModel | XmCSpatialResizeModel | unsigned char | XmGROW_MINOR | CSG |
|____________________________|_____________________________|________________|__________________________|________|
|XmNspatialSnapModel | XmCSpatialSnapModel | unsigned char | XmNONE | CSG |
|____________________________|_____________________________|________________|__________________________|________|
|XmNspatialStyle | XmCSpatialStyle | unsigned char | XmGRID | CSG |
|____________________________|_____________________________|________________|__________________________|________|
|____________________________|_____________________________|________________|__________________________|________|
XmNautomaticSelection [Toc] [Back]
Indicates whether the Container invokes selection callbacks
when each item is selected (or toggled) or whether selection
callbacks are not invoked until the user has completed
selection actions (for example, the user has released the
mouse button). It can have one of the following values:
XmAUTO_SELECT [Toc] [Back]
Makes selection callbacks automatically when each
item is selected or toggled. This may also be the
value TRUE.
XmNO_AUTO_SELECT [Toc] [Back]
Delays selection callbacks until the user has
finished selection actions. This may also be the
value FALSE.
XmNcollapsedStatePixmap [Toc] [Back]
Specifies the pixmap to display on a PushButton next to a
Container item with child items, when XmNoutlineButtonPolicy
is XmOUTLINE_BUTTON_PRESENT. XmNcollapsedStatePixmap
indicates that the child items are not displayed. If set to
- 8 - Formatted: January 24, 2005
XmContainer(library call) XmContainer(library call)
XmUNSPECIFIED_PIXMAP, a default pixmap showing an arrow
pointing up is used.
XmNconvertCallback [Toc] [Back]
Specifies a list of callbacks called when the Container is
asked to convert a selection. The type of the structure
whose address is passed to these callbacks is
XmConvertCallbackStruct. The reason is XmCR_OK.
XmNdefaultActionCallback [Toc] [Back]
Specifies a list of callbacks to call when the user doubleclicks
an item or presses <Enter> or <Return> over an item.
The callback structure is XmContainerSelectCallbackStruct.
The reason is XmCR_DEFAULT_ACTION.
XmNdestinationCallback [Toc] [Back]
Specifies a list of callbacks called when the Container is
the destination of a transfer operation. The type of the
structure whose address is passed to these callbacks is
XmDestinationCallbackStruct. The reason is XmCR_OK.
XmNdetailColumnHeading [Toc] [Back]
Specifies a table of XmStrings to display as the headings to
columns. If NULL, or if XmNlayoutType is not XmDETAIL, no
heading is displayed.
XmNdetailColumnHeadingCount [Toc] [Back]
Specifies a count of XmStrings in the table specified for
XmNdetailColumnHeading.
XmNdetailOrder [Toc] [Back]
Specifies an array of Cardinals that indicate which column
detail information, and in which order, each Container child
will display its detail information. This resource is
ignored if XmNlayoutType is not XmDETAIL. If NULL, the the
default behavior is determined by XmNdetailOrderCount.
XmNdetailOrderCount [Toc] [Back]
Specifies a count of Cardinals in the array specified for
XmNdetailOrder. If XmNdetailOrder is NULL and
XmNdetailOrderCount is not 0, then each Container child
displays its detail information in order from column 1 to
the XmNdetailOrderCount column number. If
XmNdetailOrderCount is 0, then a default is calculated from
the detail order count information of each item accessed via
the ContainerItem trait.
XmNdetailTabList [Toc] [Back]
Indicates an XmTabList specifying the start of each column
in the XmDETAIL layout. If this resource is set to NULL,
then Container calculates an XmTabList. This resource is
- 9 - Formatted: January 24, 2005
XmContainer(library call) XmContainer(library call)
ignored if XmNlayoutType is not XmDETAIL.
XmNentryViewType [Toc] [Back]
Specifies the view type for all Container children. The view
type is specified for each item via the ContainerItem trait.
It can have one of the following values:
XmANY_ICON [Toc] [Back]
No specification is made for Container children.
Children use their own default specifications.
XmLARGE_ICON [Toc] [Back]
The view type for all children is XmLARGE_ICON.
XmSMALL_ICON [Toc] [Back]
The view type for all children is XmSMALL_ICON.
XmNexpandedStatePixmap [Toc] [Back]
Specifies the pixmap to display on a PushButton next to a
Container item with child items, when XmNoutlineButtonPolicy
is XmOUTLINE_BUTTON_PRESENT. XmNexpandedStatePixmap
indicates that the child items are displayed. If set to
XmUNSPECIFIED_PIXMAP, a default pixmap showing an arrow
pointing down is used.
XmNfontList [Toc] [Back]
Specifies the fontlist associated with XmContainer. The
fontlist is an obsolete construct and has been superseded by
the render table. It is included for compatibility with
earlier versions of Motif, and for applications that do not
easily support render tables. The default fontlist is
derived from the default render table; and if both a
fontlist and a render table are specified, the render table
takes precedence.
XmNlargeCellHeight [Toc] [Back]
Specifies the height of a cell for XmGRID or XmCELLS spatial
style when XmNentryViewType is XmLARGE_ICON or XmANY_ICON.
XmNlargeCellWidth [Toc] [Back]
Specifies the width of a cell for XmGRID or XmCELLS spatial
style when XmNentryViewType is XmLARGE_ICON or XmANY_ICON.
XmNlayoutType [Toc] [Back]
Specifies the policy for laying out child widgets within the
Container. It can have one of the following values:
XmDETAIL Displays items in the same manner as when the
resource is XmOUTLINE, except that each item
displays detail information next to it.
- 10 - Formatted: January 24, 2005
XmContainer(library call) XmContainer(library call)
XmOUTLINE Displays items in a tree configuration, in
XmNpositionIndex within XmNentryParent order, with
connecting lines drawn to show their parent-child
relationships.
XmSPATIAL Displays items according to XmNspatialStyle.
Items with XmNentryParent values are not
displayed.
XmNmarginHeight [Toc] [Back]
Specifies the margin spacing at the top and bottom of the
Container.
XmNmarginWidth [Toc] [Back]
Specifies the margin spacing at the left and right sides of
the Container.
XmNoutlineButtonPolicy [Toc] [Back]
Specifies whether or not to display buttons for users to
expand and collapse the display of items. It can have one
of the following values:
XmOUTLINE_BUTTON_ABSENT [Toc] [Back]
Do not display the outline buttons.
XmOUTLINE_BUTTON_PRESENT [Toc] [Back]
Display the outline buttons.
XmNoutlineChangedCallback [Toc] [Back]
Specifies a list of callbacks to call when an item's
XmNoutlineState is changed. The callback structure is
XmContainerOutlineCallbackStruct. The reason is
XmCR_COLLAPSED or XmCR_EXPANDED, depending on the new value
of XmNoutlineState.
XmNoutlineColumnWidth [Toc] [Back]
Specifies the width of the first column displayed when
XmNlayoutType is XmDETAIL. Specifies the preferred width of
the Container (without the margins) when XmNlayoutType is
XmOUTLINE. If not specified, Container will determine a
default value equal to the widest space necessary to display
an item's pixmap and XmNoutlineIndentation.
XmNoutlineIndentation [Toc] [Back]
Specifies the distance to indent for the display of child
items when XmNlayoutType is XmOUTLINE or XmDETAIL.
XmNoutlineLineStyle [Toc] [Back]
Specifies whether to draw lines between items with parentchild
relationships when XmNlayoutType is XmOUTLINE or
XmDETAIL. It can have one of the following values:
- 11 - Formatted: January 24, 2005
XmContainer(library call) XmContainer(library call)
XmNO_LINE Draws no line.
XmSINGLE Draws a line one pixel wide.
XmNprimaryOwnership [Toc] [Back]
Specifies whether Container takes ownership of the primary
selection when a selection is made inside it. This resource
can take the following values:
XmOWN_NEVER [Toc] [Back]
Never takes ownership.
XmOWN_ALWAYS [Toc] [Back]
Always takes ownership.
XmOWN_MULTIPLE [Toc] [Back]
Only takes ownership if more than one element has
been selected.
XmOWN_POSSIBLE_MULTIPLE [Toc] [Back]
Only takes ownership if more than one element can
be selected at a time.
XmNrenderTable [Toc] [Back]
Specifies the XmRenderTable that is inherited by all
children of the Container. The default is implementation
dependent. If both a render table and a fontlist are
specified, the render table will take precedence.
XmNselectColor [Toc] [Back]
Specifies a Pixel that can be accessed by children of the
Container and used to indicate that the child is in a
selected state. In addition to a Pixel value, the following
symbolic values can be specified:
XmDEFAULT_SELECT_COLOR [Toc] [Back]
Specifies a color between the background and the
bottom shadow color.
XmREVERSED_GROUND_COLORS [Toc] [Back]
Forces the select color to the foreground color
and causes the default color of any text rendered
over the select color to be the background color.
HIGHLIGHT_COLOR [Toc] [Back]
Forces the fill color to use the highlight color.
XmNselectedObjectCount [Toc] [Back]
Specifies the number of widgets in the selected items list.
The value must be the number of items in XmNselectedObjects.
- 12 - Formatted: January 24, 2005
XmContainer(library call) XmContainer(library call)
XmNselectedObjects [Toc] [Back]
An array of widgets that represents the Container items that
are currently selected, either by the user or by the
application.
If the application sets XmNselectedObjects to an array of
widgets, those array elements that are valid Container items
are selected.
XmNselectionCallback [Toc] [Back]
Specifies a list of callbacks to call when an item is
selected. The callback structure is
XmContainerSelectCallbackStruct. The reason is
XmCR_SINGLE_SELECT, XmCR_BROWSE_SELECT,
XmCR_MULTIPLE_SELECT, or XmCR_EXTENDED_MULTIPLE, depending
on XmNselectionPolicy.
XmNselectionPolicy [Toc] [Back]
Defines the interpretation of the selection action. This can
be one of the following values:
XmSINGLE_SELECT [Toc] [Back]
Allows only single selections.
XmBROWSE_SELECT [Toc] [Back]
Allows "drag and browse" selections.
XmMULTIPLE_SELECT [Toc] [Back]
Allows multiple selections.
XmEXTENDED_SELECT [Toc] [Back]
Allows extended selections.
XmNselectionTechnique [Toc] [Back]
Specifies the selection technique to use when the Container
displays items in a 2-dimensional layout (XmNentryViewType
is XmLARGE_ICON or XmSMALL_ICON). In the XmDETAIL layout,
the XmNselectionTechnique resource is treated as
XmTOUCH_ONLY. In either case, it can have one of the
following values:
XmMARQUEE Uses the Marquee technique only.
XmMARQUEE_EXTEND_START [Toc] [Back]
Uses the Marquee technique only and extends the
Marquee rectangle around any item under the
Marquee start point.
XmMARQUEE_EXTEND_BOTH [Toc] [Back]
Uses the Marquee technique only and extends the
Marquee rectangle around any items under the
- 13 - Formatted: January 24, 2005
XmContainer(library call) XmContainer(library call)
Marquee start and end points.
XmTOUCH_ONLY [Toc] [Back]
Uses the Random-Swipe technique only if
XmNlayoutType is XmSPATIAL. Otherwise, uses the
Range-Swipe and Range-Click techniques.
XmTOUCH_OVER [Toc] [Back]
If the selection action begins over an item and
XmNlayoutType is XmSPATIAL, uses the Random-Swipe
technique. If the selection action begins over an
item and XmNlayoutType is XmOUTLINE or XmDETAIL,
uses the Range-Swipe and Range-Click techniques.
Uses the Marquee technique if the select action
begins over an unoccupied area in the Container.
XmNsmallCellHeight [Toc] [Back]
Specifies the height of a cell for XmGRID or XmCELLS spatial
style when XmNentryViewType is XmSMALL_ICON.
XmNsmallCellWidth [Toc] [Back]
Specifies the width of a cell for XmGRID or XmCELLS spatial
style when XmNentryViewType is XmSMALL_ICON.
XmNspatialIncludeModel [Toc] [Back]
Specifies the layout of an item when the item is managed in
the Container when XmNlayoutType is XmSPATIAL and
XmNspatialStyle is XmGRID or XmCELLS. It can have one of
the following values:
XmAPPEND Places the item after the last occupied cell
according to XmNlayoutDirection.
XmCLOSEST Places the item in the free cell closest to the
position specified by XmNx and XmNy.
XmFIRST_FIT [Toc] [Back]
Places the item in the first free cell according
to XmNlayoutDirection.
XmNspatialResizeModel [Toc] [Back]
Specifies how Container will attempt to grow its dimensions
when XmNlayoutType is XmSPATIAL and XmNspatialStyle is
XmGRID or XmCELLS and there are not enough cells to contain
a new Container item. It can have one of the following
values:
XmGROW_BALANCED [Toc] [Back]
Container will request both width and height
growth from its parent.
- 14 - Formatted: January 24, 2005
XmContainer(library call) XmContainer(library call)
XmGROW_MAJOR [Toc] [Back]
Container will request growth in its major
dimension from its parent. Container's major
dimension is width when the precedence of
XmNlayoutDirection is horizontal, and height when
vertical.
XmGROW_MINOR [Toc] [Back]
Container will request growth in its minor
dimension from its parent. Container's minor
dimension is height when the precedence of
XmNlayoutDirection is horizontal, and width when
vertical.
XmNspatialSnapModel [Toc] [Back]
Specifies how Container will position an item within the
cell layout when XmNlayoutType is XmSPATIAL and
XmNspatialStyle is XmGRID or XmCELLS. It can have one of
the following values:
XmCENTER Center the items as follows, depending on the
value of XmNentryViewType:
X
|
