class Fox::FXList

A List Widget displays a list of items, each with a text and optional icon. When an item’s selected state changes, the list sends a SEL_SELECTED or SEL_DESELECTED message. A change of the current item is signified by the SEL_CHANGED message. The list sends SEL_COMMAND messages when the user clicks on an item, and SEL_CLICKED, SEL_DOUBLECLICKED, and SEL_TRIPLECLICKED when the user clicks once, twice, or thrice, respectively. When items are added, replaced, or removed, the list sends messages of the type SEL_INSERTED, SEL_REPLACED, or SEL_DELETED. In each of these cases, the index to the item, if any, is passed in the 3rd argument of the message.

Events

The following messages are sent by FXList to its target:

SEL_CHANGED

sent when the current list item changes; the message data is an Integer indicating the index of the current item.

SEL_COMMAND

sent when the current list item changes; the message data is an Integer indicating the index of the current item.

SEL_KEYPRESS

sent when a key goes down; the message data is an FXEvent instance.

SEL_KEYRELEASE

sent when a key goes up; the message data is an FXEvent instance.

SEL_LEFTBUTTONPRESS

sent when the left mouse button goes down; the message data is an FXEvent instance.

SEL_LEFTBUTTONRELEASE

sent when the left mouse button goes up; the message data is an FXEvent instance.

SEL_RIGHTBUTTONPRESS

sent when the right mouse button goes down; the message data is an FXEvent instance.

SEL_RIGHTBUTTONRELEASE

sent when the right mouse button goes up; the message data is an FXEvent instance.

SEL_CLICKED

sent when a list item is single-clicked; the message data is an Integer indicating the index of the current item.

SEL_DOUBLECLICKED

sent when a list item is double-clicked; the message data is an Integer indicating the index of the current item.

SEL_TRIPLECLICKED

sent when a list item is triple-clicked; the message data is an Integer indicating the index of the current item.

SEL_SELECTED

sent when a list item is selected; the message data is an Integer indicating the index of the selected item.

SEL_DESELECTED

sent when a list item is deselected; the message data is an Integer indicating the index of the deselected item.

SEL_REPLACED

sent when a list item is about to be replaced; the message data is an Integer indicating the index of the item to be replaced.

SEL_INSERTED

sent after a list item is inserted; the message data is an Integer indicating the index of the item that was inserted.

SEL_DELETED

sent when a list item is about to be removed; the message data is an Integer indicating the index of the item to be removed.

List styles

LIST_EXTENDEDSELECT

Extended selection mode allows for drag-selection of ranges of items

LIST_SINGLESELECT

Single selection mode allows up to one item to be selected

LIST_BROWSESELECT

Browse selection mode enforces one single item to be selected at all times

LIST_MULTIPLESELECT

Multiple selection mode is used for selection of individual items

LIST_AUTOSELECT

Automatically select under cursor

LIST_NORMAL

same as LIST_EXTENDEDSELECT

Message identifiers

ID_TIPTIMER
ID_LOOKUPTIMER