Volume 6A: Motif Programming Manual

Widget list_w;

Boolean

XmListSetKbdItemPos(list_w, position)

Widget list_w;

int position;

XmListGetKbdItemPos() returns the position of the item that has the location cursor, while

XmListSetKbdItemPos() provides a way to specify the position of this item.

The XmListPosToBounds() and XmListYToPos() functions in Motif 1.2 provide a way to translate list items

to x,y coordinates and vice versa. XmListPosToBounds() returns the bounding box of the item at a specified

position in a List. This routine takes the following form:

Boolean

XmListPosToBounds(list_w, position, x, y, width, height)

Widget list_w;

int position;

Position *x;

Position *y;

Dimension *width;

Dimension *height;

This routine returns True if the item at the specified position is visible and False otherwise. If the item is visible,

the return parameters specify the bounding box of the item. This information can be useful if you need to perform

additional event processing or draw special graphics for the item. The XmListYToPos() routine returns the

position of the List item at a specified y−coordinate. This function takes the following form:

int

XmListYToPos(list_w, y)

Widget list_w;

Position y;

The position information returned by this routine can be useful if you are processing events that report a pointer

position and you need to convert the location of the event into an item position.

13.5 List Callback Routines

While the callback routines associated with the List widget are not affected by whether the List is scrollable, they ...