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