table of contents
XmListGetSelectedPos(3) | Library Functions Manual | XmListGetSelectedPos(3) |
NAME¶
XmListGetSelectedPos — A List function that returns the position of every selected item in the list "XmListGetSelectedPos" "List functions" "XmListGetSelectedPos"
SYNOPSIS¶
#include <Xm/List.h> Boolean XmListGetSelectedPos( Widget widget, int **position_list, int *position_count);
DESCRIPTION¶
This routine is obsolete. It is replaced by calling XtGetValues for the List resources XmNselectedPositions and XmNselectedPositionCount. XmListGetSelectedPos is a Boolean function that returns an array of the positions of the selected items in a List.
- widget
- Specifies the ID of the List widget.
- position_list
- Returns an array of the positions of the selected items in the List. The position of the first item in the list is 1; the position of the second item is 2; and so on. When the return value is True, XmListGetSelectedPos allocates memory for this array. The caller is responsible for freeing this memory. The caller can recover the allocated memory by calling XtFree.
- position_count
- Returns the number of elements in the position_list.
For a complete definition of List and its associated resources, see XmList(3).
RETURN¶
Returns True if the list has any selected items, and False if it does not.