Index for Section 3X

Alphabetical listing for D

Bottom of page

DXmSvnGetHighlighted(3X)
NAME
  DXmSvnGetHighlighted - Retrieves (returns) a list of entries currently
  highlighted by the user.

SYNOPSIS
  void DXmSvnGetHighlighted(
	  Widget widget,
	  int *entries(),
	  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 highlighted entry
      numbers.

  tags
      A pointer to an array of longwords to receive the application's
      entry_tag value for each highlighted entry.  If tags are not required,
      a null pointer may be passed.

  len An integer that represents the number of entries allocated in the
      provided array.

DESCRIPTION
  The DXmSvnGetHighlighted routine returns a list of entries that are
  currently highlighted by the user.  Make this call in your application
  between calls to DXmSvnDisableDisplay and DXmSvnEnableDisplay to ensure
  that the highlighted 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