dxmsvnaddentries(3x) [osf1 man page]

DXmSvnAddEntries(3X)													      DXmSvnAddEntries(3X)

NAME

       DXmSvnAddEntries - Opens new entries in the structure.

SYNOPSIS

       void DXmSvnAddEntries(
	       Widget widget,
	       int after,
	       int count,
	       int level,
	       XtPointer* tags(),
	       Boolean index );

PARAMETERS

       The  identifier	(widget  ID)  of the SVN widget.  An integer that represents the entry number that the newly opened positions are inserted
       after. (If you want to add an entry before number 1, set this parameter to 0.)  An integer that represents the number of entries to add	to
       the  array.   An  integer  that represents the level number of the entries being added. A level number of 0 indicates top-level entries.  A
       pointer to an array of longwords that contain the tag values for each entry being added.  If the tag values are	not  being  used,  a  Null
       pointer	may  be passed.  This value can also be changed with either the DXmSvnSetEntry or DXmSvnSetEntryTag routine call.  A Boolean value
       that, when True, indicates that all of the entries being added should appear in the scroll index window when the  user  drags  the  slider.
       This  value  can  be  changed with either the DXmSvnSetEntry or DXmSvnSetEntryIndexWindow routine.  Note that the index window is used only
       when the DXmNliveScrolling resource is set to False.

DESCRIPTION

       The DXmSvnAddEntries routine enables an application to process the expansion of an entry.  The value supplied for count determines how many
       entries the application should open.  The actual text of the entry is not passed.

       The  first time an entry is displayed to the user, the SVN widget issues the DXmSvnNgetEntryCallback to obtain information about the entry.
       If the user never positions the window in an area where a particular entry is visible, the callback will never be made.	Make this call	in
       your application between calls to DXmSvnDisableDisplay and DXmSvnEnableDisplay.

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