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

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。