Материал из Wiki.crossplatform.ru

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

[править] Q3ComboTableItem Class Reference
^{[ Qt3Support module]}

The Q3ComboTableItem class provides a means of using comboboxes in Q3Tables. Далее...

 #include <Q3ComboTableItem>

This class is part of the Qt 3 support library. It is provided to keep old source code working. Мы настоятельно не рекомендуем использовать этот класс в новом коде. See Porting to Qt 4 for more information.

Note to Qt Desktop Light Edition users: This class is only available in the Qt Desktop Edition.

Inherits Q3TableItem.

• Список всех членов, включая унаследованные

[править] Открытые функции

• Q3ComboTableItem ( Q3Table * table, const QStringList & list, bool editable = false )
• ~Q3ComboTableItem ()
• int count () const
• int currentItem () const
• QString currentText () const
• bool isEditable () const
• virtual int rtti () const
• virtual void setCurrentItem ( int i )
• virtual void setCurrentItem ( const QString & s )
• virtual void setEditable ( bool b )
• virtual void setStringList ( const QStringList & l )
• virtual QString text () const
• QString text ( int i ) const

• 26 public functions inherited from Q3TableItem

[править] Подробное описание

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()).

Файл:Qtableitems.png

See also Q3CheckTableItem, Q3TableItem, and Q3ComboBox.

[править] Описание функций-членов

[править]

Q3ComboTableItem::Q3ComboTableItem ( Q3Table * table, const QStringList & list, bool editable = false )

Creates a combo table item for the table table. The combobox's list of items is passed in the list argument. If editable is true the user may type in new list items; if editable is false the user may only select from the list of items provided.

By default Q3ComboTableItems cannot be replaced by other table items since isReplaceable() returns false by default.

See also Q3Table::clearCell() and EditType.

[править]

Q3ComboTableItem::~Q3ComboTableItem ()

Q3ComboTableItem destructor.

[править]

int Q3ComboTableItem::count () const

Returns the total number of list items in the combo table item.

[править]

int Q3ComboTableItem::currentItem () const

Returns the index of the combo table item's current list item.

See also setCurrentItem().

[править]

QString Q3ComboTableItem::currentText () const

Returns the text of the combo table item's current list item.

See also currentItem() and text().

[править]

bool Q3ComboTableItem::isEditable () const

Returns true if the user can add their own list items to the combobox's list of items; otherwise returns false.

See also setEditable().

[править]

int Q3ComboTableItem::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.

Reimplemented from Q3TableItem.

See also Q3TableItem::rtti().

[править]

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

Sets the list item i to be the combo table item's current list item.

See also currentItem().

[править]

void Q3ComboTableItem::setCurrentItem ( const QString & 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 Q3ComboTableItem::setEditable ( bool b ) [virtual]

If b is true the combo table item can be edited, i.e. the user may enter a new text item themselves. If b is false the user may may only choose one of the existing items.

See also isEditable().

[править]

void Q3ComboTableItem::setStringList ( const QStringList & l ) [virtual]

Sets the list items of this Q3ComboTableItem to the strings in the string list l.

[править]

QString Q3ComboTableItem::text () const [virtual]

Returns the text of the table item or an empty string if there is no text.

Reimplemented from Q3TableItem.

See also Q3TableItem::text().

[править]

QString Q3ComboTableItem::text ( int i ) const

Эта перегруженная функция предоставлена для удобства.

Returns the text of the combo's list item at index i.

See also currentText().