DXmSvnGetEntryPosition(3X)DXmSvnGetEntryPosition(3X)NAMEDXmSvnGetEntryPosition - Retrieves (returns) the position of an entry
in the display.
SYNOPSIS
void DXmSvnGetEntryPosition (widget, entry, mode, x, y)
Widget widget;
int entry;
Boolean mode;
int *x;
int *y;
PARAMETERS
The identifier (widget ID) of the SVN widget. An integer that repre‐
sents the number of the entry for which position information is
required. A Boolean value that, when True, specifies that position
information returned is relative to the upper-left corner of the SVN
window. When False, the position information returned is internal SVN
information only (for column and outline mode) or indicates the posi‐
tion of the entry in the entire tree (tree mode). A pointer to the x
position in the tree. A pointer to the y position in the tree.
DESCRIPTION
The DXmSvnGetEntryPosition routine allows an application to determine
the position of entries. The routine interprets the x and y coordinates
differently, depending on the application's mode: Outline and Column
mode
When the application is in outline or column mode (the DXMSvn‐
NdisplayMode resource has been set to either DXMSvnKdisplayOut‐
line or DXMSvnKdisplayColumn ) and mode for the DXmSvnGetEntry‐
Position routine has been set to True, the x and y coordinates
indicate, in pixels, the distance of the displayed entry from
the upper-left corner of the SVN window.
However, if the specified entry is not visible in the SVN win‐
dow, the routine returns -1 (an invalid value) for both the x
and y coordinates, because the SVN widget cannot determine the
position of such an entry when the application is in outline or
column mode.
When mode is False, the values returned for the x and y coordi‐
nates are only meaningful internally to the SVN widget. Tree
mode
When the application is in tree mode (the DXMSvnNdisplayMode
resource is set to DXMSvnKdisplayTree ) and the DXMSvnNtreeStyle
resource is set to DXMSvnKuserDefinedTree (the application con‐
trols the format), the x and y coordinates indicate, in pixels,
the distance of the displayed entry from the upper-left corner
of the SVN window, when mode is True.
If the entry is not visible in the SVN window, the mode is
False. However, in tree mode, the returned x and y coordinates
indicate the position of the entry in the entire tree, even
though that position extends beyond the limit of what can cur‐
rently be displayed in the SVN window.
Note that for position values to be valid, the SVN widget must
have been enabled prior to any changes made to the contents of
the display.
DXmSvnGetEntryPosition(3X)