DXmSvnGetDisplayed(3X)DXmSvnGetDisplayed(3X)NAMEDXmSvnGetDisplayed - Retrieves (returns) displayed entry numbers and
related information necessary to draw a corresponding display.
void DXmSvnGetDisplayed (widget, entries, tags, ys, len)
The identifier (widget ID) of the SVN widget. A pointer to an array of
integers to receive the entry numbers of the entries being displayed.
A pointer to an array of longwords to receive the application's
entry_tag value for each entry displayed. If tags are not required, a
Null pointer may be passed. A pointer to an array of longwords to
receive the y coordinates for each entry displayed. If y coordinates
are not required, a Null pointer can be passed. The number of entries
allocated in the provided array.
The DXmSvnGetDisplayed routine returns information about the entries
that the SVN widget is currently displaying. This information can then
be used to keep a simultaneous display up to date with the SVN widget
window (in the case of a dialog box, for example, which might contain
totals for the entries being displayed).
The application is responsible for managing the memory used to return
this list of entries. As such, note the following: At the minimum, the
number of entries in the array should be capable of holding at least
the number of entries indicated by the value returned from the
DXmSvnGetNumDisplayed 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 allo‐
cated in the provided array (the value for len) will be returned.