plucky (3) XmListGetSelectedPos.3.gz

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.

RELATED

       XmList(3).

                                                                                         XmListGetSelectedPos(3)