Content-type: text/html Man page of DXmSvnGetSelections

DXmSvnGetSelections

Section: Miscellaneous Library Functions (3X)
Index Return to Main Contents
 

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.


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION

This document was created by man2html, using the manual pages.
Time: 02:42:19 GMT, October 02, 2010