|
Packit |
b099d7 |
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
|
|
Packit |
b099d7 |
.TH XmMultiList 3x ""
|
|
Packit |
b099d7 |
.SH NAME
|
|
Packit |
b099d7 |
\fBXmMultiList\fP \(em The Multi-column List widget
|
|
Packit |
b099d7 |
.SH SYNOPSIS
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
#include <Xm/MultiList\&.h>
|
|
Packit |
b099d7 |
.fi
|
|
Packit |
b099d7 |
.SH DESCRIPTION
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
This widget contains a multi-column list with headers along the top and a search area
|
|
Packit |
b099d7 |
along the bottom. The list has scrollbars along the right and bottom edges that allow
|
|
Packit |
b099d7 |
vertical and horizontal scrolling both by column and by pixel. The portion of the list
|
|
Packit |
b099d7 |
data that is currently visible can be altered by scrollbar actions, widget resource setting
|
|
Packit |
b099d7 |
and the redisplay of the list data after a string search has been successful. The sorting
|
|
Packit |
b099d7 |
of elements within a particular column is also supported. To sort the list by the elements
|
|
Packit |
b099d7 |
in a given column, select the column's title.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
To search for a particular string in the list, type the string value to be searched for in
|
|
Packit |
b099d7 |
the list's associated text field and then press the "Find" pushbutton. The search for the
|
|
Packit |
b099d7 |
string begins in the currently selected row, after the location of the previously
|
|
Packit |
b099d7 |
searched for string, or at the first column and first row if there is no column selected.
|
|
Packit |
b099d7 |
If the string is not found in that row, then the search continues through all rows after
|
|
Packit |
b099d7 |
and then before, the currently selected row. If the string is found, the display of the
|
|
Packit |
b099d7 |
list is adjusted to make the string visible. If the string was not found, or if the string is
|
|
Packit |
b099d7 |
visible, the application will issue a warning beep.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Pointer button one allows the user to select a row or a column for sorting. The callbacks
|
|
Packit |
b099d7 |
on the doubleClickCallback list are called when the user double clicks pointer
|
|
Packit |
b099d7 |
button one. If the list data can contain a row pixmap to display at the extreme left of
|
|
Packit |
b099d7 |
the row.
|
|
Packit |
b099d7 |
.SS "Classes"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
MultiList inherits behavior, resources, and traits from \fBCore\fP,
|
|
Packit |
b099d7 |
\fBComposite\fP, \fBConstraint\fP, and
|
|
Packit |
b099d7 |
\fBXmManager\fP\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The class pointer is \fBxmMultiListWidgetClass\fP\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The class name is \fBXmMultiList\fP\&.
|
|
Packit |
b099d7 |
.SS "New Resources"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The following table defines a set of widget resources used by the
|
|
Packit |
b099d7 |
programmer to specify data\&. The programmer can also set the resource
|
|
Packit |
b099d7 |
values for the inherited classes to set attributes for this widget\&.
|
|
Packit |
b099d7 |
To reference a resource by name or by class in a \fB\&.Xdefaults\fP file,
|
|
Packit |
b099d7 |
remove the \fBXmN\fP or \fBXmC\fP prefix and use the remaining letters\&.
|
|
Packit |
b099d7 |
To specify one of the defined values for a resource in a \fB\&.Xdefaults\fP
|
|
Packit |
b099d7 |
file, remove the \fBXm\fP prefix and use the remaining letters (in
|
|
Packit |
b099d7 |
either lowercase or uppercase, but include any underscores between
|
|
Packit |
b099d7 |
words)\&. The codes in the access column indicate if the given resource
|
|
Packit |
b099d7 |
can be set at creation time (C), set by using \fBXtSetValues\fP
|
|
Packit |
b099d7 |
(S), retrieved by using \fBXtGetValues\fP (G), or is not
|
|
Packit |
b099d7 |
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 |
\fBXmMultiList Resource Set\fP
|
|
Packit |
b099d7 |
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNcolumnTitles?XmCColumnTitles?XmString *?NULL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNdoubleClickCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNentryData?XmCEntryData?XtPointer?NULL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNfindLabel?XmCFindLabel?XmString?Find?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNfirstColumn?XmCFirstLocation?short?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNfirstColumnPixmaps?XmCFirstColumnPixmaps?Boolean?False?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNfirstRow?XmCFirstLocation?short?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNfontList?XmCFontList?XmFontList?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNheight?XmCHeight?Dimension?300?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNnumColumns?XmCNumColumns?short?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNnumRows?XmCNumRows?short?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNselectedColumn?XmCSelectedColumn?short?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNselectionPolicy?XmCSelectionPolicy?unsigned char?XmEXTENDED_SELECT?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNshowFind?XmCShowFind?Boolean?True?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNsingleSelectionCallback?XmCCallback?XtCallbackList?NULL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNsortFunctions?XmCFunction?XmMultiListSortFunction **?NULL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNtitle?XmCTitle?XmString?NULL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNwidth?XmCWidth?Dimension?300?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.IP "\fBXmNcolumnTitles\fP" 10
|
|
Packit |
b099d7 |
This is an array of length numColumns of strings displayed at the top of each
|
|
Packit |
b099d7 |
column. The data is allocated and maintained by the client.
|
|
Packit |
b099d7 |
.IP "\fBXmNdoubleClickCallback\fP" 10
|
|
Packit |
b099d7 |
All routines in this list will be called whenever the user double clicks on a row in
|
|
Packit |
b099d7 |
the list.
|
|
Packit |
b099d7 |
.IP "\fBXmNentryData\fP" 10
|
|
Packit |
b099d7 |
This resource is the data associated with each row in the list. The data is an array
|
|
Packit |
b099d7 |
of XmMultiListRowInfo structures of length numRows allocated by the client. The data
|
|
Packit |
b099d7 |
is allocated and maintained by the client. The XmMultiListRowInfo structure is defined
|
|
Packit |
b099d7 |
below.
|
|
Packit |
b099d7 |
.IP "\fBXmNfindLabel\fP" 10
|
|
Packit |
b099d7 |
The label to be shown on the find button.
|
|
Packit |
b099d7 |
.IP "\fBXmNfirstColumn\fP" 10
|
|
Packit |
b099d7 |
This resource allows the client to adjust the current view of the list data to have a
|
|
Packit |
b099d7 |
new top left column location. When setting this resource, firstRow should also be
|
|
Packit |
b099d7 |
updated.
|
|
Packit |
b099d7 |
.IP "\fBXmNfirstColumnPixmaps\fP" 10
|
|
Packit |
b099d7 |
This resource specifies that the pixmap stored in the row info structure should be
|
|
Packit |
b099d7 |
used instead of XmMultiListRowInfo values[0]. If pixmaps are present, the rows may be
|
|
Packit |
b099d7 |
dragged by pressing on the pixmap with pointer button three. If this resource is
|
|
Packit |
b099d7 |
True, then values[0] is never referenced. If False, then the XmMultiListRowInfo data
|
|
Packit |
b099d7 |
pixmap is never referenced.
|
|
Packit |
b099d7 |
.IP "\fBXmNfirstRow\fP" 10
|
|
Packit |
b099d7 |
This resource allows the client to adjust the current view of the list data to have a
|
|
Packit |
b099d7 |
new top left row location. When setting this resource, firstColumn should also
|
|
Packit |
b099d7 |
be updated.
|
|
Packit |
b099d7 |
.IP "\fBXmNfontList\fP" 10
|
|
Packit |
b099d7 |
This is an OSF/Motif style font list. The first font in this list will be used to
|
|
Packit |
b099d7 |
display all text in the MultiList widget. The MultiList widget currently
|
|
Packit |
b099d7 |
supports only one font.
|
|
Packit |
b099d7 |
.IP "\fBXmNheight\fP" 10
|
|
Packit |
b099d7 |
This is the overall height value assigned to the MultiList widget. Modifying
|
|
Packit |
b099d7 |
this resource will affect scrollbar size and location.
|
|
Packit |
b099d7 |
.IP "\fBXmNnumColumns\fP" 10
|
|
Packit |
b099d7 |
.IP "\fBXmNnumRows\fP" 10
|
|
Packit |
b099d7 |
These resources specify the number of columns and rows the widget expects to
|
|
Packit |
b099d7 |
display. These resources are used as the maximum indices for many of the other
|
|
Packit |
b099d7 |
resources in this widget. Care should be taken when modifying these resources to
|
|
Packit |
b099d7 |
ensure that the other values have also been modified.
|
|
Packit |
b099d7 |
.IP "\fBXmNselectedColumn\fP" 10
|
|
Packit |
b099d7 |
This is the index of the currently selected column. This also the column by which
|
|
Packit |
b099d7 |
the list is being sorted.
|
|
Packit |
b099d7 |
.IP "\fBXmNselectionPolicy\fP" 10
|
|
Packit |
b099d7 |
Defines the interpretation of the select action. This resource can have the values
|
|
Packit |
b099d7 |
XmSINGLE_SELECT or XmEXTENDED_SELECT. Other values result in
|
|
Packit |
b099d7 |
undefined behavior.
|
|
Packit |
b099d7 |
.IP "\fBXmNshowFind\fP" 10
|
|
Packit |
b099d7 |
This boolean manages and unmanages the find button
|
|
Packit |
b099d7 |
.IP "\fBXmNsingleSelectionCallback\fP" 10
|
|
Packit |
b099d7 |
All routines in this list will be called whenever the user clicks on a line in the list.
|
|
Packit |
b099d7 |
A pointer to the XmMultiListRowInfo structure corresponding to the line selected is passed
|
|
Packit |
b099d7 |
as call_data. If in extended select mode the value of call_data is undefined.
|
|
Packit |
b099d7 |
.IP "\fBXmNsortFunctions\fP" 10
|
|
Packit |
b099d7 |
This is an array of functions, one for each column, called to determine the
|
|
Packit |
b099d7 |
ordering of the rows in the column, similar to qsort.
|
|
Packit |
b099d7 |
.IP "\fBXmNtitle\fP" 10
|
|
Packit |
b099d7 |
This is the title that is displayed at the top of the MultiList widget.
|
|
Packit |
b099d7 |
If this value is NULL, the title area will not be shown.
|
|
Packit |
b099d7 |
.IP "\fBXmNwidth\fP" 10
|
|
Packit |
b099d7 |
This is the overall width value assigned to the MultiList widget. Modifying
|
|
Packit |
b099d7 |
this resource will affect scrollbar size and location.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.SS "Specifying Children Resources"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The MultiList widget is composed of many simple widgets. In order to
|
|
Packit |
b099d7 |
achieve full functionality of the Toolkit, it is sometimes desirable to set attribute
|
|
Packit |
b099d7 |
values directly on those widgets. The widget ids of the sub-widgets can be
|
|
Packit |
b099d7 |
obtained by using the XtNameToWidget() function provided by the Xt
|
|
Packit |
b099d7 |
Intrinsics.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
XmMultiList <named by application>
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
XmLabel title
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
XmScrollbar vertBar
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
XmScrollBar horizBar
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
XmFrame frame
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
XmPushButton find
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
XmText findText
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.SS "Using the Resource Database"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The MultiList widget is actually a collection of pieces. It provides the geometry
|
|
Packit |
b099d7 |
layout for the collection as well as tying together the pieces to form a consistent package.
|
|
Packit |
b099d7 |
Many of the resources that are documented as being part of the MultiList
|
|
Packit |
b099d7 |
widget are really part of the internal list sub-component. The MultiList widget
|
|
Packit |
b099d7 |
will pass these values through to the proper child when they are set at time of creation
|
|
Packit |
b099d7 |
or with XtSetValues or XtGetValues. However, when setting a resource via the resource
|
|
Packit |
b099d7 |
database you must use either the name of the child or the general specification
|
|
Packit |
b099d7 |
(*) rather than the specific one (.).
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.SS "The XmMultiListRowInfo Structure"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The XmMultiListRowInfo structure is used to contain the entryData associated with each
|
|
Packit |
b099d7 |
Row in the List.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
typedef struct {
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
String * values; /* The array of column strings */
|
|
Packit |
b099d7 |
Pixmap pixmap; /* mini-icon pixmaps. */
|
|
Packit |
b099d7 |
Boolean selected; /* row selected. */
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
/*
|
|
Packit |
b099d7 |
* Provided for the convenience of the application programmer
|
|
Packit |
b099d7 |
*/
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
short * sort_id;
|
|
Packit |
b099d7 |
XtPointer data;
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
/*
|
|
Packit |
b099d7 |
* Private to the MultiList widget (do not modify these)
|
|
Packit |
b099d7 |
*/
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
short pix_width; /* of the pixmap. */
|
|
Packit |
b099d7 |
short pix_height; /* of the pixmap. */
|
|
Packit |
b099d7 |
short pix_depth; /* of the pixmap. */
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
Boolean old_sel_state;
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
} XmMultiListRowInfo;
|
|
Packit |
b099d7 |
.fi
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
\fIvalues\fP This is an array of strings of length numColumns which
|
|
Packit |
b099d7 |
represents the strings displayed in each column of this row. The
|
|
Packit |
b099d7 |
data is allocated and maintained by the client. If
|
|
Packit |
b099d7 |
firstColumnPixmaps is True, then value[0] is never referenced.
|
|
Packit |
b099d7 |
\fIpixmap\fP This is the pixmap displayed to the left of this row. If
|
|
Packit |
b099d7 |
firstColumnPixmaps is True then this value is never referenced
|
|
Packit |
b099d7 |
and mayn remain unset. If no pixmap is desired for this row, even
|
|
Packit |
b099d7 |
though firstColumnPixmaps is True, set the value of pixmap to
|
|
Packit |
b099d7 |
None. Color pixmaps may be used.
|
|
Packit |
b099d7 |
\fIsort_id\fP This is provided for the convenience of the client and is expected
|
|
Packit |
b099d7 |
to be used as a sort index for this row. One value should be
|
|
Packit |
b099d7 |
specified for each column of the row. See "sortFunctions" below
|
|
Packit |
b099d7 |
for details.
|
|
Packit |
b099d7 |
\fIdata\fP This is provided for the convenience of the client and may be
|
|
Packit |
b099d7 |
used for any purpose. It is intended to be used as an identifier for
|
|
Packit |
b099d7 |
the object pointed to by this row
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
\fIselected\fP This value is True if this row is selected; may be set by the
|
|
Packit |
b099d7 |
application.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Neither \fIsort_id\fP nor \fIdata\fP are used by the MultiList widget;
|
|
Packit |
b099d7 |
they exist solely for the convenience of the programmer.
|
|
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 |
\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 |
.SS "Translations"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The following are the default translation bindings used by the icon button:
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.TS
|
|
Packit |
b099d7 |
tab (?);
|
|
Packit |
b099d7 |
l l.
|
|
Packit |
b099d7 |
~Ctrl ~Shift <Btn1Down>:?ButtonDown()
|
|
Packit |
b099d7 |
Ctrl ~Shift <Btn1Down>:?ButtonDown(Toggle)
|
|
Packit |
b099d7 |
~Ctrl Shift <Btn1Down>:?ButtonDown(Extend)
|
|
Packit |
b099d7 |
Button1 <Motion>:?Motion()
|
|
Packit |
b099d7 |
<Btn1Up>:?ButtonUpOrLeave()
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The following actions are supported by the MultiList:
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fBButtonDown(type)\fP" 10
|
|
Packit |
b099d7 |
Processes a button press action that may begin with
|
|
Packit |
b099d7 |
either a select or a double click. The type argument can
|
|
Packit |
b099d7 |
be either Toggle or Extend. These values determine
|
|
Packit |
b099d7 |
which mode of an extended select will be initiated on
|
|
Packit |
b099d7 |
this button event. Consult the OSF/Motif Style
|
|
Packit |
b099d7 |
Guide for details.
|
|
Packit |
b099d7 |
.IP "\fBMotion()\fP" 10
|
|
Packit |
b099d7 |
Processes motion events to allow the selection region to
|
|
Packit |
b099d7 |
be modified when in extended selection mode. It is
|
|
Packit |
b099d7 |
assumed that this action is called between a
|
|
Packit |
b099d7 |
ButtonDown() and ButtonUpOrLeave() action.
|
|
Packit |
b099d7 |
.IP "\fBButtonUpOrLeave()\fP" 10
|
|
Packit |
b099d7 |
Cleans up after ButtonDown() and Motion().
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.SH Callback Routines
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
All procedures on the MultiList's singleSelectionCallback and doubleClickCallback
|
|
Packit |
b099d7 |
lists will have a pointer to a XmMultiListRowInfo structure passed to them in the
|
|
Packit |
b099d7 |
call_data field. This structure is defined above.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Note: if a single SelectionCallback is registered on an MultiList in
|
|
Packit |
b099d7 |
extended_select_mode, the value of call_data is undefined.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
\fBvoid\fP (callback)(\fBWidget\fP \fIw\fP, \fBXtPointer\fP \fIclient_data\fP, \fBXtPointer\fP \fIcall_data\fP)
|
|
Packit |
b099d7 |
.IP "\fIw\fP" 10
|
|
Packit |
b099d7 |
the MultiList widget
|
|
Packit |
b099d7 |
.IP "\fIclient_data\fP" 10
|
|
Packit |
b099d7 |
the client data specified by the application
|
|
Packit |
b099d7 |
.IP "\fIcall_data\fP" 10
|
|
Packit |
b099d7 |
a pointer to an XmMultiListRowInfo structure corrsponding the the row selected
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.SH Sort Function
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
typedef \fBint\fP (XmMultiListSortFunction) (\fBshort\fP \fIcolumn\fP, \fBXmMultiRowInfo *\fP \fIrow1\fP, \fBXmMultiRowInfo *\fP \fIrow2\fP);
|
|
Packit |
b099d7 |
.IP "\fIcolumn\fP" 10
|
|
Packit |
b099d7 |
the column currently being sorted
|
|
Packit |
b099d7 |
.IP "\fIrow1\fP, \fIrow2\fP" 10
|
|
Packit |
b099d7 |
the two rows being compared. The return value must be an
|
|
Packit |
b099d7 |
integer less than, equal to, or greater than 0, depending on
|
|
Packit |
b099d7 |
whether the first argument is less than, equal to, or greater than
|
|
Packit |
b099d7 |
the second.
|
|
Packit |
b099d7 |
.SH "RELATED"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
\fBComposite\fP(3), \fBConstraint\fP(3),
|
|
Packit |
b099d7 |
\fBCore\fP(3),
|
|
Packit |
b099d7 |
\fBXmCreateMultiList\fP(3),
|
|
Packit |
b099d7 |
\fBXmManager\fP(3),
|
|
Packit |
b099d7 |
\fBXmMultiListDeselectAllItems\fP(3),
|
|
Packit |
b099d7 |
\fBXmMultiListDeselectItem\fP(3),
|
|
Packit |
b099d7 |
\fBXmMultiListDeselectItems\fP(3),
|
|
Packit |
b099d7 |
\fBXmMultiListDeselectRow\fP(3),
|
|
Packit |
b099d7 |
\fBXmMultiListGetSelectedRowArray\fP(3),
|
|
Packit |
b099d7 |
\fBXmMultiListGetSelectedRows\fP(3),
|
|
Packit |
b099d7 |
\fBXmMultiListMakeRowVisible\fP(3),
|
|
Packit |
b099d7 |
\fBXmMultiListSelectAllItems\fP(3),
|
|
Packit |
b099d7 |
\fBXmMultiListSelectItems\fP(3),
|
|
Packit |
b099d7 |
\fBXmMultiListSelectRow\fP(3),
|
|
Packit |
b099d7 |
and \fBXmMultiListToggleRow\fP(3)\&.
|
|
Packit |
b099d7 |
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.SH COPYRIGHT
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Copyright (c) 1992 by Integrated Computer Solutions, Inc.
|