Index for Section 3X

Alphabetical listing for D

Bottom of page

DXmSvnGetEntryPosition(3X)
NAME
  DXmSvnGetEntryPosition - Retrieves (returns) the position of an entry in
  the display.

SYNOPSIS
  void DXmSvnGetEntryPosition(
	  Widget widget,
	  int entry,
	  Boolean mode,
	  int *x,
	  int *y );

PARAMETERS
  widget
      The identifier (widget ID) of the SVN widget.

  entry
      An integer that represents the number of the entry for which position
      information is required.

  mode
      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 position of the
      entry in the entire tree (tree mode).

  x   A pointer to the x position in the tree.

  y   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
       DXMSvnNdisplayMode resource has been set to either
       DXMSvnKdisplayOutline or DXMSvnKdisplayColumn) and mode for the
       DXmSvnGetEntryPosition 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 window, 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 coordinates
       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 controls 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 currently 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.

Index for Section 3X

Alphabetical listing for D

Top of page