このページでは

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)

指定されたicon およびtext を使用して、テーブル項目を作成します。

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::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)

アイテムの「これは何?」ヘルプを、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

その項目の「これは何?」ヘルプを返します。

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 データ型のシリアライズ」も参照してください 。

© 2026 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.