This routine tries to set the string array to the new array <newlist>. <items> is the count of strings. If <items> is 0 and the array is NULL terminated, the num ber of strings will be automatically counted. The <resize> flag indicates if we want the widget to try to resize itself to hold the new array. The <sensi tive_array> parameter (if non-NULL) contains an array of Booleans representing the sensitivity of the list items.
This routine is the primary interface to changing the data. The resources XtNlist, XtNnumberStrings, and XtNsensitiveArray can be changed in parallel, but all three values must be changed within a single SetValues call. It is better, and more flexible, to use this function interface.
void ScrolledListUnhighlightAll(w)
Widget w;
This routine unhighlights all highlighted items in the ScrolledList widget <w>.
void ScrolledListHighlightItem(w,item_index)
Widget w;
int item_index;
This routine highlights the item with index number <item_index>.
ScrolledListReturnStruct *ScrolledListGetHighlighted(sw) ScrolledListWidget sw;
This routine returns the current highlighted items info.
int ScrolledListToggleItem(plw,item_index)
ScrolledListWidget plw;
This routine highlights the item with index <item_index> if it is unhighlighted and unhighlights it if it is already highlighted. The action performed by the toggle is returned (ScrolledList_ACTION_HIGHLIGHT or ScrolledList_ACTION_UNHIGHLIGHT).
Boolean ScrolledListIsHighlighted(w,item_index)
Widget w;
int item_index;
This routine returns a boolean that indicates if the item with index <item_index> was highlighted or not.
Boolean ScrolledListGetItem(w,item_index,str_ptr,high_ptr,sens_ptr)
Widget w;
int item_index;
String *str_ptr;
Boolean *high_ptr,*sens_ptr;
This routine returns information about a numbered item including the name of the item, whether it is high lighted, and its sensitivity. If the item index number does not correspond to an item, False is returned, else True is returned.