|
DXmSvnGetSelections(3X)
Contents
|
DXmSvnGetSelections - Retrieves (returns) a list of
selected entry numbers.
void DXmSvnGetSelections(
Widget widget,
int *entries(),
int *comps(),
XtPointer *tags(),
int len );
The identifier (widget ID) of the SVN widget. A pointer
to an array of integers to receive the selected entry numbers.
A pointer to an array of integers to receive the
component numbers on which the entry was selected. A component
number of 0 means that the entry was selected using
range selection and not by directly clicking on the entry.
If components are not needed, a Null pointer may be
passed. A pointer to an array of longwords to receive the
application tag value for each entry selected. If tags
are not needed, a Null pointer may be passed. An integer
that represents the number of entries allocated in the
provided array.
The DXmSvnGetSelections routine returns a list of entries
that are currently selected by the user. Make this call
in your application between calls to DXmSvnDisableDisplay
and DXmSvnEnableDisplay to ensure that the selected list
is not changing.
The application is responsible for managing the memory
used to return this list of highlighted entries. As such,
note the following: At the minimum, the number of entries
in the array should be capable of holding the number of
entries indicated by the value returned from the
DXmSvnGetNumHighlighted routine. If there are more
entries in the array than the application will need, the
SVN widget will set the value for those extra entries to
0. If the capacity of the arrays passed is less than the
number of selected entries, only the number of entries
allocated in the provided array (the value for len) will
be returned.
DXmSvnGetSelections(3X)
[ Back ] |