dxmsvninsertcomponent(3x) [osf1 man page]

DXmSvnInsertComponent(3X)												 DXmSvnInsertComponent(3X)

NAME

       DXmSvnInsertComponent - Inserts a new component into each SVN entry.

SYNOPSIS

       void DXmSvnInsertComponent(
	       Widget widget,
	       int comp_number,
	       Dimension width,
	       XtPointer tag );

PARAMETERS

       The  identifier	(widget  ID)  of  the SVN widget.  An integer that represents the component number to insert.  The width of the component.
       This value will be inserted into the widget's component width array.  You can set or examine this value	by  using  the	DXmSvnSetComponen-
       tWidth and DXmSvnGetComponentWidth routines.  The tag for the component. This value will be inserted into the widget's component tag array.
       You can set or examine this value by using the DXmSvnSetComponentTag and DXmSvnGetComponentTag routines.

DESCRIPTION

       The DXmSvnInsertComponent routine inserts a new component for each entry currently recognized by the SVN widget. All entries that are  cur-
       rently valid become invalid during this operation.

       Note the following: A warning message is generated if an attempt is made to insert a component that is not the next in the sequence of com-
       ponents in the entry (for example, you cannot add component 5 if there are only 3 components in the entry; you must add component  4).	An
       entry can hold a maximum of 30 components.

															 DXmSvnInsertComponent(3X)

DXmSvnGetSelections(3X) 												   DXmSvnGetSelections(3X)

NAME

       DXmSvnGetSelections - Retrieves (returns) a list of selected entry numbers.

SYNOPSIS

       void DXmSvnGetSelections(
	       Widget widget,
	       int *entries(),
	       int *comps(),
	       XtPointer *tags(),
	       int len );

PARAMETERS

       The  identifier	(widget  ID) of the SVN widget.  A pointer to an array of integers to receive the selected entry numbers.  A pointer to an
       array of integers to receive the component numbers on which the entry was selected.  A component number of  0  means  that  the	entry  was
       selected  using	range selection and not by directly clicking on the entry.  If components are not needed, a Null pointer may be passed.  A
       pointer to an array of longwords to receive the application tag value for each entry selected.  If tags are not needed, a Null pointer  may
       be passed.  An integer that represents the number of entries allocated in the provided array.

DESCRIPTION

       The  DXmSvnGetSelections  routine  returns  a  list of entries that are currently selected by the user.	Make this call in your application
       between calls to DXmSvnDisableDisplay and DXmSvnEnableDisplay to ensure that the selected list is not changing.

       The application is responsible for managing the memory used to return this list of highlighted entries.	As such, note  the  following:	At
       the minimum, the number of entries in the array should be capable of holding the number of entries indicated by the value returned from the
       DXmSvnGetNumHighlighted 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.

															   DXmSvnGetSelections(3X)