Home | All Classes | Main Classes | Annotated | Grouped Classes | Functions

TQComboTableItem Class Reference
[table module]

The TQComboTableItem class provides a means of using comboboxes in TQTables. More...

#include <tqtable.h>

Inherits TQTableItem.

List of all member functions.

Public Members

• TQComboTableItem ( TQTable * table, const TQStringList & list, bool editable = FALSE )
• ~TQComboTableItem ()
• virtual void setCurrentItem ( int i )
• virtual void setCurrentItem ( const TQString & s )
• int currentItem () const
• TQString currentText () const
• int count () const
• TQString text ( int i ) const
• virtual void setEditable ( bool b )
• bool isEditable () const
• virtual void setStringList ( const TQStringList & l )
• virtual int rtti () const

Detailed Description

A TQComboTableItem is a table item which looks and behaves like a combobox. The advantage of using TQComboTableItems rather than real comboboxes is that a TQComboTableItem uses far less resources than real comboboxes in TQTables. 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 TQComboTableItems.

TQComboTableItem items have the edit type WhenCurrent (see EditType). The TQComboTableItem's list of items is provided by a TQStringList 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 TQComboTableItem 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 TQComboTableItem use TQTable::setItem().

TQComboTableItems may be deleted with TQTable::clearCell().

TQComboTableItems can be distinguished from TQTableItems and TQCheckTableItems using their Run Time Type Identification number (see rtti()).

See also TQCheckTableItem, TQTableItem, TQComboBox, and Advanced Widgets.

Member Function Documentation

TQComboTableItem::TQComboTableItem ( TQTable * table, const TQStringList & list, bool editable = FALSE )

By default TQComboTableItems cannot be replaced by other table items since isReplaceable() returns FALSE by default.

See also TQTable::clearCell() and EditType.

TQComboTableItem::~TQComboTableItem ()

int TQComboTableItem::count () const

int TQComboTableItem::currentItem () const

See also setCurrentItem().

TQString TQComboTableItem::currentText () const

See also currentItem() and text().

bool TQComboTableItem::isEditable () const

See also setEditable().

int TQComboTableItem::rtti () const [virtual]

Returns 1.

Make your derived classes return their own values for rtti()to distinguish between different table item subclasses. You should use values greater than 1000, preferably a large random number, to allow for extensions to this class.

See also TQTableItem::rtti().

Reimplemented from TQTableItem.

void TQComboTableItem::setCurrentItem ( int i ) [virtual]

See also currentItem().

Example: table/small-table-demo/main.cpp.

void TQComboTableItem::setCurrentItem ( const TQString & s ) [virtual]

Sets the list item whose text is s to be the combo table item's current list item. Does nothing if no list item has the text s.

See also currentItem().

void TQComboTableItem::setEditable ( bool b ) [virtual]

See also isEditable().

void TQComboTableItem::setStringList ( const TQStringList & l ) [virtual]

TQString TQComboTableItem::text ( int i ) const

See also currentText().

This file is part of the TQt toolkit. Copyright © 1995-2007 Trolltech. All Rights Reserved.