QComboTableItem类

Qt 3.0.5

主页 | 所有的类 | 主要的类 | 注释的类 | 分组的类 | 函数

QComboTableItem类参考
[表格模块]

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

#include <qtable.h>

继承了QTableItem

所有成员函数的列表。

公共成员


详细描述

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与QTableItemQCheckTableItem

Table Items

也参见QCheckTableItemQTableItem高级部件


成员函数文档

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


Copyright © 2002 Trolltech Trademarks 译者:farfareast
Qt 3.0.5版