class Fox::FXIconList

A Icon List Widget displays a list of items, each with a text and optional icon. Icon List can display its items in essentially three different ways; in big-icon mode, the bigger of the two icons is used for each item, and the text is placed underneath the icon. In mini- icon mode, the icons are listed in rows and columns, with the smaller icon preceding the text. Finally, in detail mode the icons are listed in a single column, and all fields of the text are shown under a header control with one button for each subfield. When an item’s selected state changes, the icon list sends a SEL_SELECTED or SEL_DESELECTED message. A change of the current item is signified by the SEL_CHANGED message. The icon 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 icon 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 FXIconList 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.

Icon list styles

ICONLIST_EXTENDEDSELECT

Extended selection mode

ICONLIST_SINGLESELECT

At most one selected item

ICONLIST_BROWSESELECT

Always exactly one selected item

ICONLIST_MULTIPLESELECT

Multiple selection mode

ICONLIST_AUTOSIZE

Automatically size item spacing

ICONLIST_DETAILED

List mode

ICONLIST_MINI_ICONS

Mini Icon mode

ICONLIST_BIG_ICONS

Big Icon mode

ICONLIST_ROWS

Row-wise mode

ICONLIST_COLUMNS

Column-wise mode

ICONLIST_NORMAL

same as ICONLIST_EXTENDEDSELECT

Message identifiers

ID_SHOW_DETAILS

x

ID_SHOW_MINI_ICONS

x

ID_SHOW_BIG_ICONS

x

ID_ARRANGE_BY_ROWS

x

ID_ARRANGE_BY_COLUMNS

x

ID_HEADER_CHANGE

x

ID_TIPTIMER

x

ID_LOOKUPTIMER

x

ID_SELECT_ALL

x

ID_DESELECT_ALL

x

ID_SELECT_INVERSE

x