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)

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)