QTableWidgetItem Class
QTableWidgetItem クラスは、QTableWidget クラスで使用するアイテムを提供します。詳細...
Header: | #include <QTableWidgetItem> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
qmake: | QT += widgets |
パブリック型
enum | ItemType { Type, UserType } |
パブリック関数
QTableWidgetItem(int type = Type) | |
QTableWidgetItem(const QString &text, int type = Type) | |
QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type) | |
QTableWidgetItem(const QTableWidgetItem &other) | |
virtual | ~QTableWidgetItem() |
QBrush | background() const |
Qt::CheckState | checkState() const |
virtual QTableWidgetItem * | clone() const |
int | column() const |
virtual QVariant | data(int role) const |
Qt::ItemFlags | flags() const |
QFont | font() const |
QBrush | foreground() const |
QIcon | icon() const |
bool | isSelected() const |
virtual void | read(QDataStream &in) |
int | row() const |
void | setBackground(const QBrush &brush) |
void | setCheckState(Qt::CheckState state) |
virtual void | setData(int role, const QVariant &value) |
void | setFlags(Qt::ItemFlags flags) |
void | setFont(const QFont &font) |
void | setForeground(const QBrush &brush) |
void | setIcon(const QIcon &icon) |
void | setSelected(bool select) |
void | setSizeHint(const QSize &size) |
void | setStatusTip(const QString &statusTip) |
void | setText(const QString &text) |
(since 6.4) void | setTextAlignment(Qt::Alignment alignment) |
void | setToolTip(const QString &toolTip) |
void | setWhatsThis(const QString &whatsThis) |
QSize | sizeHint() const |
QString | statusTip() const |
QTableWidget * | tableWidget() const |
QString | text() const |
int | textAlignment() const |
QString | toolTip() const |
int | type() const |
QString | whatsThis() const |
virtual void | write(QDataStream &out) const |
virtual bool | operator<(const QTableWidgetItem &other) const |
QTableWidgetItem & | operator=(const QTableWidgetItem &other) |
関連する非メンバー
QDataStream & | operator<<(QDataStream &out, const QTableWidgetItem &item) |
QDataStream & | operator>>(QDataStream &in, QTableWidgetItem &item) |
詳細説明
テーブルアイテムは、テーブルウィジェットの情報の一部を保持するために使用されます。アイテムには通常、テキスト、アイコン、チェックボックスが含まれます。
QTableWidgetItem クラスは、Qt 3 のQTableItem
クラスに代わる便利なクラスです。これは、QTableWidget クラスで使用するアイテムを提供します。
トップレベルのアイテムは親なしで構築され、行番号と列番号の組で指定された位置に挿入されます:
QTableWidgetItem *newItem = new QTableWidgetItem(tr("%1").arg( pow(row, column+1))); tableWidget->setItem(row, column, newItem);
各アイテムは、setBackground() 関数で設定される独自の背景ブラシを持つことができます。現在の背景ブラシはbackground() で取得できます。各項目のテキスト・ラベルは、独自のフォントとブラシでレンダリングできます。これらはsetFont() とsetForeground() 関数で指定し、font() とforeground() で読み込む。
デフォルトでは、アイテムは有効、編集可能、選択可能、チェック可能で、ドラッグ&ドロップ操作のソースとしてもドロップターゲットとしても使用できます。各アイテムのフラグは、適切な値を指定してsetFlags() を呼び出すことで変更できます (Qt::ItemFlags を参照)。チェック可能な項目は、setCheckState() 関数でチェックしたり外したりできます。対応するcheckState() 関数は、その項目が現在チェックされているかどうかを示します。
サブクラス化
カスタム項目を提供するためにQTableWidgetItemをサブクラス化する場合、標準項目と区別できるように、それらのために新しい型を定義することが可能です。この機能を必要とするサブクラスのコンストラクタは、UserType 以上の新しい型の値でベースクラスのコンストラクタを呼び出す必要があります。
QTableWidget 、モデル/ビュー・プログラミング、QListWidgetItem 、およびQTreeWidgetItemも参照してください 。
メンバ型のドキュメント
enum QTableWidgetItem::ItemType
この列挙型は、テーブル・ウィジェットの項目を記述するために使用される型を記述します。
定数 | 値 | 説明 |
---|---|---|
QTableWidgetItem::Type | 0 | テーブルウィジェット項目のデフォルト型。 |
QTableWidgetItem::UserType | 1000 | カスタムタイプの最小値。UserType 以下の値は Qt によって予約されています。 |
カスタム・アイテムが特別に扱われるように、QTableWidgetItem のサブクラスで新しいユーザー・タイプを定義できます。
type()も参照してください 。
メンバ関数 ドキュメント
[explicit]
QTableWidgetItem::QTableWidgetItem(int type = Type)
どのテーブルにも属さない、指定されたtype のテーブル項目を構築します。
type()も参照 。
[explicit]
QTableWidgetItem::QTableWidgetItem(const QString &text, int type = Type)
指定されたtext を持つテーブル項目を構築します。
type() も参照 。
[explicit]
QTableWidgetItem::QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type)
指定されたicon およびtext を持つテーブル項目を構築します。
type()も参照して ください。
QTableWidgetItem::QTableWidgetItem(const QTableWidgetItem &other)
other のコピーを構築します。type() およびtableWidget() はコピーされないことに注意してください。
この関数は、clone() を再実装する場合に便利です。
[virtual noexcept]
QTableWidgetItem::~QTableWidgetItem()
テーブル・アイテムを破棄します。
QBrush QTableWidgetItem::background() const
項目の背景のレンダリングに使用したブラシを返します。
setBackground() およびforeground() も参照して ください。
Qt::CheckState QTableWidgetItem::checkState() const
テーブル項目のチェック状態を返します。
setCheckState() およびflags() も参照して ください。
[virtual]
QTableWidgetItem *QTableWidgetItem::clone() const
項目のコピーを作成します。
int QTableWidgetItem::column() const
テーブル内の項目のカラムを返します。項目がテーブルにない場合、この関数は -1 を返します。
row()も参照 。
[virtual]
QVariant QTableWidgetItem::data(int role) const
指定されたrole に対する項目のデータを返します。
setData() も参照 。
Qt::ItemFlags QTableWidgetItem::flags() const
項目の説明に使用されるフラグを返します。これらは、その項目がチェック可能かどうか、編集可能かどうか、および選択可能かどうかを決定します。
setFlags()も参照して ください。
QFont QTableWidgetItem::font() const
項目のテキストのレンダリングに使用されるフォントを返します。
setFont() も参照して ください。
QBrush QTableWidgetItem::foreground() const
項目の前景(テキストなど)の描画に使用するブラシを返します。
setForeground() およびbackground() も参照 。
QIcon QTableWidgetItem::icon() const
アイテムのアイコンを返します。
bool QTableWidgetItem::isSelected() const
項目が選択されている場合はtrue
を返し、そうでない場合はfalse
を返します。
setSelected() も参照して ください。
[virtual]
void QTableWidgetItem::read(QDataStream &in)
in ストリームから項目を読み取ります。
write() も参照 。
int QTableWidgetItem::row() const
テーブル内の項目の行を返します。項目が表にない場合、この関数は -1 を返します。
column()も参照して ください。
void QTableWidgetItem::setBackground(const QBrush &brush)
項目の背景ブラシを指定されたbrush に設定します。デフォルト構成のブラシを設定すると、ビューはスタイルのデフォルト色を使用するようになります。
background() およびsetForeground() も参照して ください。
void QTableWidgetItem::setCheckState(Qt::CheckState state)
テーブル項目のチェック状態をstate に設定します。
checkState() も参照して ください。
[virtual]
void QTableWidgetItem::setData(int role, const QVariant &value)
指定されたrole に対する項目のデータを、指定されたvalue に設定します。
注意: デフォルトの実装では、Qt::EditRole とQt::DisplayRole は同じデータを参照するものとして扱われます。
Qt::ItemDataRole およびdata()も参照して ください。
void QTableWidgetItem::setFlags(Qt::ItemFlags flags)
項目のフラグを指定されたflags に設定します。これらは、項目を選択または変更できるかどうかを決定します。
flags() も参照して ください。
void QTableWidgetItem::setFont(const QFont &font)
項目のテキスト表示に使用するフォントを指定されたfont に設定します。
font()、setText() およびsetForeground()も 参照。
void QTableWidgetItem::setForeground(const QBrush &brush)
アイテムの前景ブラシを指定されたbrush に設定します。デフォルトのブラシを設定すると、ビューはスタイルのデフォルトの色を使用します。
foreground() およびsetBackground()も参照して ください。
void QTableWidgetItem::setIcon(const QIcon &icon)
アイテムのアイコンを指定されたicon に設定します。
icon()、setText()、iconSize も参照して ください。
void QTableWidgetItem::setSelected(bool select)
アイテムの選択状態をselect に設定します。
isSelected() も参照して ください。
void QTableWidgetItem::setSizeHint(const QSize &size)
テーブル項目のサイズ・ヒントをsize に設定します。サイズ・ヒントが設定されていない場合、またはsize が無効な場合、項目デリゲートは項目データに基づいてサイズ・ヒントを計算します。
sizeHint()も参照してください 。
void QTableWidgetItem::setStatusTip(const QString &statusTip)
テーブルアイテムのステータスヒントをstatusTip で指定されたテキストに設定します。 この機能を動作させるには、QTableWidget マウストラッキングを有効にする必要があります。
statusTip()、setToolTip()、setWhatsThis()も参照 。
void QTableWidgetItem::setText(const QString &text)
項目のテキストを指定されたtext に設定します。
text()、setFont()、setForeground() も参照 。
[since 6.4]
void QTableWidgetItem::setTextAlignment(Qt::Alignment alignment)
アイテムのテキストのアライメントを、指定されたalignment に設定します。
この関数は Qt 6.4 で導入されました。
textAlignment()も参照してください 。
void QTableWidgetItem::setToolTip(const QString &toolTip)
アイテムのツールチップをtoolTip で指定された文字列に設定します。
toolTip()、setStatusTip()、setWhatsThis()も 参照。
void QTableWidgetItem::setWhatsThis(const QString &whatsThis)
項目の "What's This?" ヘルプをwhatsThis で指定された文字列に設定します。
whatsThis()、setStatusTip()、およびsetToolTip() も参照して ください。
QSize QTableWidgetItem::sizeHint() const
テーブル項目に設定されているサイズ・ヒントを返します。
setSizeHint()も参照して ください。
QString QTableWidgetItem::statusTip() const
項目のステータス・ヒントを返します。
setStatusTip() も参照して ください。
QTableWidget *QTableWidgetItem::tableWidget() const
項目が含まれるテーブル・ウィジェットを返します。
QString QTableWidgetItem::text() const
項目のテキストを返します。
setText()も参照して ください。
int QTableWidgetItem::textAlignment() const
項目テキストのテキスト配置を返します。
注釈 この関数は、歴史的な理由により int を返します。Qt 7 ではQt::Alignment を返すように修正されます。
setTextAlignment() およびQt::Alignmentも参照してください 。
QString QTableWidgetItem::toolTip() const
項目のツールチップを返します。
setToolTip()も参照して ください。
int QTableWidgetItem::type() const
QTableWidgetItem コンストラクタに渡された型を返します。
QString QTableWidgetItem::whatsThis() const
項目の "What's This?" ヘルプを返します。
setWhatsThis()も参照して ください。
[virtual]
void QTableWidgetItem::write(QDataStream &out) const
項目をストリームout に書き込みます。
read()も参照して ください。
[virtual]
bool QTableWidgetItem::operator<(const QTableWidgetItem &other) const
項目がother の項目より小さい場合はtrue
を返し、そうでない場合は false を返します。
QTableWidgetItem &QTableWidgetItem::operator=(const QTableWidgetItem &other)
other のデータとフラグをこの項目に割り当てます。type() とtableWidget() はコピーされないことに注意。
この関数は、clone() を再実装するときに便利である。
関連する非メンバ
QDataStream &operator<<(QDataStream &out, const QTableWidgetItem &item)
テーブル・ウィジェット項目item をストリームout に書き込みます。
この演算子はQTableWidgetItem::write() を使用します。
Qt データ型のシリアライズ」も参照して ください。
QDataStream &operator>>(QDataStream &in, QTableWidgetItem &item)
テーブル・ウィジェット項目をストリームin からitem に読み込みます。
この演算子はQTableWidgetItem::read() を使用します。
Qt データ型のシリアライズ」も参照して ください。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。