Specifications

Athena Widget Set libXaw 1.0.7
screen The screen on which this widget is displayed. This is not a settable
resource.
sensitive Whether or not the toolkit should pass user events to this widget. The
widget will not get input events if either ancestorSensitive or sensitive is
False.
translations The ev e nt bindings associated with this widget.
verticalList If this resource is set to True then the list elements will be presented in
column major order.
x
yThe location of the upper left outside corner of this widget in its parent.
3.4.2. List Actions
The List widget supports the following actions:
•Highlighting and unhighlighting the list element under the pointer with Set and Unset
•Processing application callbacks with Notify
The following is the default translation table used by the List Widget:
<Btn1Down>,<Btn1Up>: Set( )Notify( )
The full list of actions supported by List widget is:
Set() Sets the list element that is currently under the pointer.Toinform the
user that this element is currently set, it is drawn with foreground and
background colors reversed. If this action is called when there is no list
element under the cursor,the currently set element will be unset.
Unset() Cancels the set state of the element under the pointer,and redraws it with
normal foreground and background colors.
Notify() Calls all callbacks on the List widget’scallback list. Information about
the currently selected list element is passed in the call_data argument
(see List Callbacks below).
3.4.3. List Callbacks
All procedures on the List widget’scallback list will have a XawListReturnStruct passed to
them as call_data.The structure is defined in the List widget’sapplication header file.
typedef struct _XawListReturnStruct {
String string; /* string shown in the list. */
int list_index; /* indexofthe item selected. */
}XawListReturnStruct;
Note
The list_index item used to be called simply index.
Unfortunately,this name collided with a global name defined on some
operating systems, and had to be changed.
3.4.4. Changing the List
To change the list that is displayed, use XawListChange.
31