Volume 6A: Motif Programming Manual

Output of search_list.c

13.4 Positioning the List

The items within a List can be positioned such that an arbitrary element is placed at the top or bottom of the List. If

the List is being used as part of a ScrolledList, the item is placed at the top or bottom of the viewport of the

ScrolledWindow. To position a particular item at the top or bottom of the window, use either XmListSetItem() or

XmListSetBottomItem(). These routines take the following form:

void

XmListSetItem(list_w, item)

Widget list_w;

XmString item;

void

XmListBottomItem(list_w, item)

Widget list_w;

XmString item;

Both of these functions require an XmString parameter to reference a particular item in the list. However, if you

know the position of the item, you can use XmListSetPos() or XmListSetBottomPos() instead. These

functions take the following form:

void

XmListSetPos(list_w, position)

13 The List Widget 13.4 Positioning the List

359

Widget list_w;

int position;

void

XmListSetBottomPos(list_w, position)

Widget list_w;

int position;

The position parameter can be set to 0 to specify that the last item be positioned at the bottom of the viewport.

Through a mixture of resource values and simple calculations, you can position any particular item anywhere in the

list. For example, if you have an item that you want to be sure is visible, but you are not concerned about where in the

viewport it is displayed, you can write a function ...