dxmsvnsetentryposition(3x) [osf1 man page]

DXmSvnSetEntryPosition(3X)												DXmSvnSetEntryPosition(3X)

NAME

       DXmSvnSetEntryPosition - Sets the position of an entry in user-defined tree mode.

SYNOPSIS

       void DXmSvnSetEntryPosition(
	       kidget widget,
	       int entry,
	       Boolean mode,
	       int x,
	       int y );

PARAMETERS

       The  identifier	(widget  ID)  of  the SVN widget.  An integer that represents the number of the entry for which information will be set or
       changed.  A Boolean value that, when True, specifies that position information returned should be interpreted relative  to  the	upper-left
       corner  of  the SVN window.  When False, the position information returned should be interpreted relative internally to the SVN widget.	An
       integer that represents the x position of the entry.  If the value for mode is True, the value for x represents the distance from the  cor-
       ner  of	the SVN window in pixels.  If the value for mode is False, the value for x represents the position in the entire tree, even though
       that position extends beyond the limit of what can currently be displayed in the SVN window.  An integer that represents the y position	of
       the  entry.   If  the  value for mode is True, the value for y represents the distance from the corner of the SVN window in pixels.  If the
       value for mode is False, the value for y represents the position in the entire tree, even though that position extends beyond the limit	of
       what can currently be displayed in the SVN window.

DESCRIPTION

       The DXmSvnSetEntryPosition routine allows an application to implement the layout of the tree when the tree style is DXmSvnKuserDefinedTree.
       The application can explicitly position an entry, whether that entry is currently visible in the display or not.  This call is  valid  only
       if  the display mode is set to DXmSvnKdisplayTree and the tree style to DXmSvnKuserDefinedTree.	Make this call in your application between
       calls to DXmSvnDisableDisplay and DXmSvnEnableDisplay.

															DXmSvnSetEntryPosition(3X)

DXmSvnGetEntryPosition(3X)												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

       The  identifier	(widget  ID)  of  the  SVN  widget.   An integer that represents 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
       position 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  coordi-
       nates 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.

															DXmSvnGetEntryPosition(3X)