dxmsvngetdisplayed(3x) [osf1 man page]

DXmSvnGetDisplayed(3X)													    DXmSvnGetDisplayed(3X)

NAME

       DXmSvnGetDisplayed - Retrieves (returns) displayed entry numbers and related information necessary to draw a corresponding display.

SYNOPSIS

       void DXmSvnGetDisplayed(
	       Widget widget,
	       int *entries(),
	       XtPointer *tags(),
	       int *ys(),
	       int len );

PARAMETERS

       The  identifier	(widget  ID)  of the SVN widget.  A pointer to an array of integers to receive the entry numbers of the entries being dis-
       played.	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.

DESCRIPTION

       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
       allocated in the provided array (the value for len) will be returned.

															    DXmSvnGetDisplayed(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)