Index for Section 3X

Alphabetical listing for D

Bottom of page

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
  widget
      The identifier (widget ID) of the SVN widget.

  entries
      A pointer to an array of integers to receive the selected entry
      numbers.

  comps
      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.

  tags
      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.

  len 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.

Index for Section 3X

Alphabetical listing for D

Top of page