Specifications

Athena Widget Set libXaw 1.0.7

void XawListChange(w, list, nitems, longest, resize)

Widget w;

String * list;

int nitems, longest;

Boolean resize;

w Speciﬁes the List widget.

list Speciﬁes the newlist for the List widget to display.

nitems Speciﬁes the number of items in the list.Ifavalue less than 1 is speciﬁed, list

must be NULL terminated, and the number of items will be calculated by the List

widget.

longest Speciﬁes the length of the longest item in the list in pixels. If avalue less than 1

is speciﬁed, the List widget will calculate the value.

resize Speciﬁes a Boolean value that if True indicates that the List widget should try to

resize itself after making the change. The constraints of the List widget’sparent

are always enforced, regardless of the value speciﬁed here.

XawListChange will unset all list elements that are currently set before the list is actually

changed. The list is used in place, and must remain usable for the lifetime of the List widget, or

until list has been changed again with this function or with XtSetValues.

3.4.5. Highlighting an Item

To highlight an item in the list, use XawListHighlight.

void XawListHighlight(w, item)

Widget w;

int item;

w Speciﬁes the List widget.

item Speciﬁes an indexinto the current list that indicates the item to be highlighted.

Only one item can be highlighted at a time. If an item is already highlighted when

XawListHighlight is called, the highlighted item is unhighlighted before the newitem is high-

lighted.

3.4.6. Unhighlighting an Item

To unhighlight the currently highlighted item in the list, use XawListUnhighlight.

void XawListUnhighlight(w)

Widget w;

w Speciﬁes the List widget.

3.4.7. Retrieving the Currently Selected Item

To retrieve the list element that is currently set,use XawListShowCurrent.

XawListReturnStruct *XawListShowCurrent(w)

Widget w;

w Speciﬁes the List widget.

XawListShowCurrent returns a pointer to an XawListReturnStruct structure, containing the

currently highlighted item. If the value of the indexmember is XAW_LIST_NONE, the string

member is undeﬁned, and no item is currently selected.