Q3ComboTableItem Class Reference
[Qt3Support module]

Detailed Description

The Q3ComboTableItem class provides a means of using comboboxes in Q3Tables.

A Q3ComboTableItem is a table item which looks and behaves like a combobox. The advantage of using Q3ComboTableItems rather than real comboboxes is that a Q3ComboTableItem uses far less resources than real comboboxes in Q3Tables. When the cell has the focus it displays a real combobox which the user can interact with. When the cell does not have the focus the cell looks like a combobox. Only text items (i.e. no pixmaps) may be used in Q3ComboTableItems.

Q3ComboTableItem items have the edit type WhenCurrent (see EditType). The Q3ComboTableItem's list of items is provided by a QStringList passed to the constructor.

The list of items may be changed using setStringList(). The current item can be set with setCurrentItem() and retrieved with currentItem(). The text of the current item can be obtained with currentText(), and the text of a particular item can be retrieved with text().

If isEditable() is true the Q3ComboTableItem will permit the user to either choose an existing list item, or create a new list item by entering their own text; otherwise the user may only choose one of the existing list items.

To populate a table cell with a Q3ComboTableItem use Q3Table::setItem().

Q3ComboTableItems may be deleted with Q3Table::clearCell().

Q3ComboTableItems can be distinguished from Q3TableItems and Q3CheckTableItems using their Run Time Type Identification number (see rtti()).

See also Q3CheckTableItem, Q3TableItem, and Q3ComboBox.

Member Function Documentation