[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

7.12.5.7 List Box

A list box's type is "List Box".

Signals

List boxes send the following signals.

signalListBoxSelectionChanged
Occurs when the currently selected item changes.

Actions

List boxes understand the following actions.

InsertItem
Inserts a new item. See below for parameters. Note that an item does not need to have text or image or state, but it should have one of the above.

Input Parameters

This sections describes the input parameters understood by the list box's `InsertItem' action.

Name Type Description
textX iString* Text for the item in column X.
imageX iString* Pathname of the image in column X.
statefulX bool `true' if the item in column X needs a state box (like a check box or radio button).
stateX bool State of the item in column X.
groupstateX bool If `true', the item in column X will have a radio button-type state box instead of the default check box-style state.
selectableX bool If `false', then the item is not selectable and will never be highlighted. This is useful for items that have state of some sort and aren't intended to be "picked" out of a list.
aligntxtX int Alignment of the text in column X. By default, all text is left-aligned. This can be 0 or 1. Zero is left-align; 1 is right-align. If there is state, it will be aligned with the text.
alignimgX int This is the same as `aligntxtX', except that it operates on the image.
parent int Key that identifies the parent of which this item should be a child. This will turn the new item into a child item.

Output Parameters

This sections describes the output parameters of the list box's `InsertItem' action.

Name Type Description
`key' `int' Unique key of this item. This can be saved and used as the value of a parent when adding children to an item, or it may be saved and used with the `GetState' action.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

This document was generated using texi2html