QComboTableItem类参考
[表格模块]

QComboTableItem类提供了QTable中使用组合框的一种方式。详见……

#include <qtable.h>

继承了QTableItem。

所有成员函数的列表。

公共成员

QComboTableItem ( QTable * table, const QStringList & list, bool editable = FALSE )
virtual void setCurrentItem ( int i )
virtual void setCurrentItem ( const QString & s )
int currentItem () const
QString currentText () const
int count () const
QString text ( int i ) const
virtual void setEditable ( bool b )
bool isEditable () const
virtual void setStringList ( const QStringList & l )
virtual int rtti () const

详细描述

QComboTableItem类提供了QTable中使用组合框的一种方式。

一个QComboTableItem是一个表项，其外观和行为如同组合框。使用QComboTableItem而不是真实的组合框的好处在于，在QTable中QComboTableItem要比真实的多选框节省很多资源。当单元格具有焦点时，QComboTableItem显示一个与用户交互的真实组合框。当单元格没有焦点时，单元格看起来像是一个组合框。只有文本表项（就是说没有象素映射）能用于QComboTableItem。

QComboTableItem表项具有编辑类型WhenCurrent（参见EditType）。QComboTableItem的条目列表由传递给构造器的QStringList提供。

条目列表可以使用setStringList()来改变。用setCurrentItem()设置当前条目，用currentItem()来得到当前条目。当前条目的文本用currentText()获得，具体某个条目的文本用text()获得。

如果isEditable()未TRUE，QComboTableItem允许用户要么选择一个已存在的条目，要么输入自己的文本以生成新的条目；否则，用户只能选择一个已有的条目。

使用QTable::setItem以把QComboTableItem填充进一个表格单元格。

QComboTableItems may be deleted with QTable::clearCell()。

使用运行时类型判别（参见rtti()）值，可以辨别QComboTableItem与QTableItem和QCheckTableItem。

也参见QCheckTableItem、QTableItem和高级部件。

成员函数文档

QComboTableItem::QComboTableItem ( QTable * table, const QStringList & list, bool editable = FALSE )

为表格table生成一个组合表项。组合框的条目列表在参数list中传入。如果editable为TRUE，用户可以输入新的条目；如果editable为FALSE，用户只能从提供的条目中选择。

由于isReplaceable()缺省返回FALSE，缺省情况下QComboTableItem不能被其他表项替换。

也参见QTable::clearCell()和EditType。

int QComboTableItem::count () const

返回组合表项中的条目列表总数。

int QComboTableItem::currentItem () const

返回组合表项的当前条目的索引。

也参见setCurrentItem()。

QString QComboTableItem::currentText () const

返回组合表项的当前条目的文本。

也参见currentItem()和text()。

bool QComboTableItem::isEditable () const

返回用户是否可以向组合列表中添加自己的条目。

也参见setEditable()。

int QComboTableItem::rtti () const `[virtual]`

对于QComboTableItem本函数返回的运行时类型判别值为1。

也参见QTableItem::rtti()。

由QTableItem处重新实现。

void QComboTableItem::setCurrentItem ( int i ) `[virtual]`

把条目i设置为组合表项的当前条目。

也参见currentItem()。

例子：table/small-table-demo/main.cpp。

void QComboTableItem::setCurrentItem ( const QString & s ) `[virtual]`

这是重载的成员函数，为便利原因提供。本质上类似上一个函数。

把文本为s的条目设置为组合表项的当前条目。如果没有这样的条目，什么也不做。

也参见currentItem()。

void QComboTableItem::setEditable ( bool b ) `[virtual]`

如果b为TRUE，组合表项可以被编辑，也就是说，用户可以自己输入新的文本条目。如果b为FALSE，用户只能在已有条目中选择。

也参见isEditable()。

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

把本QComboTableItem的条目列表设置为字符串列表l中的字符串。

QString QComboTableItem::text ( int i ) const

返回组合表项中索引为i的条目的文本。

也参见currentText()。

Trademarks

译者:farfareast

Qt 3.0.5版

QComboTableItem类参考[表格模块]