QTableWidgetItem Class

QTableWidgetItem クラスは、QTableWidget クラスで使用するアイテムを提供します。詳細...

ヘッダー #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::Type0テーブル・ウィジェット・アイテムのデフォルト・タイプ。
QTableWidgetItem::UserType1000カスタムタイプの最小値。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)

与えられたicontext でテーブル項目を構築する。

type()も参照してください

QTableWidgetItem::QTableWidgetItem(const QTableWidgetItem &other)

other type() と () はコピーされないことに注意。tableWidget

この関数は、clone() を再実装する場合に便利である。

data() およびflags()も参照

[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

アイテムのアイコンを返します。

setIcon() およびiconSizeも参照

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::EditRoleQt::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() を再実装するときに便利である。

data() およびflags()も参照

関連する非会員

QDataStream &operator<<(QDataStream &out, const QTableWidgetItem &item)

テーブル・ウィジェット項目item をストリームout に書き込む。

この演算子はQTableWidgetItem::write() を使用します。

Qt データ型のシリアライズも参照してください

QDataStream &operator>>(QDataStream &in, QTableWidgetItem &item)

テーブル・ウィジェット項目をストリームin からitem に読み込む。

この演算子はQTableWidgetItem::read() を使用します。

Qt データ型のシリアライズも参照してください

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.