QListWidgetItem Class
QListWidgetItemクラスは、QListWidget アイテムビュークラスで使用するアイテムを提供します。詳細...
ヘッダー | #include <QListWidgetItem> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
qmake: | QT += widgets |
パブリックな型
enum | ItemType { Type, UserType } |
パブリック関数
QListWidgetItem(QListWidget *parent = nullptr, int type = Type) | |
QListWidgetItem(const QString &text, QListWidget *parent = nullptr, int type = Type) | |
QListWidgetItem(const QIcon &icon, const QString &text, QListWidget *parent = nullptr, int type = Type) | |
QListWidgetItem(const QListWidgetItem &other) | |
virtual | ~QListWidgetItem() |
QBrush | background() const |
Qt::CheckState | checkState() const |
virtual QListWidgetItem * | clone() const |
virtual QVariant | data(int role) const |
Qt::ItemFlags | flags() const |
QFont | font() const |
QBrush | foreground() const |
QIcon | icon() const |
bool | isHidden() const |
bool | isSelected() const |
QListWidget * | listWidget() const |
virtual void | read(QDataStream &in) |
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 | setHidden(bool hide) |
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 |
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 QListWidgetItem &other) const |
QListWidgetItem & | operator=(const QListWidgetItem &other) |
関連する非メンバー
QDataStream & | operator<<(QDataStream &out, const QListWidgetItem &item) |
QDataStream & | operator>>(QDataStream &in, QListWidgetItem &item) |
詳細説明
QListWidgetItemは、QListWidget 。各アイテムは、いくつかの情報を保持することができ、それらを適切に表示します。
アイテムビューの便利なクラスは、純粋なモデル/ビューアプローチではなく、古典的なアイテムベースのインターフェースを使用します。より柔軟なリスト・ビュー・ウィジェットには、QListView クラスと標準モデルの使用を検討してください。
リスト項目は、リストウィジェットを指定することで、リストが作成されたときに自動的に挿入されます:
new QListWidgetItem(tr("Hazel"), listWidget);
また、親ウィジェットなしでリスト項目を作成し、QListWidget::insertItem() を使用してリストに挿入することもできます。
リスト・アイテムは通常、text()とicon()を表示するために使用されます。これらはsetText() とsetIcon() 関数で設定します。テキストの外観は、setFont()、setForeground()、setBackground() でカスタマイズできます。リスト・アイテムのテキストは、setTextAlignment() 関数を使用して整列させることができます。setToolTip ()、setStatusTip ()、setWhatsThis ()を使用して、リスト項目にツールチップ、ステータス・チップ、および「これは何ですか」ヘルプを追加できます。
デフォルトでは、項目は有効で、選択可能で、チェック可能で、ドラッグ・アンド・ドロップ操作のソースにすることができます。
各項目のフラグは、適切な値を指定してsetFlags() を呼び出すことで変更できます(Qt::ItemFlags を参照)。チェック可能な項目は、setCheckState() 関数でチェック、チェック解除、部分チェックが可能です。対応するcheckState() 関数は、項目の現在のチェック状態を示します。
isHidden() 関数を使用すると、項目が非表示になっているかどうかを判断できます。項目を非表示にするには、setHidden() を使用します。
サブクラスの作成
カスタム項目を提供するためにQListWidgetItemをサブクラス化する場合、標準項目と区別できるように新しい型を定義することができます。この機能を必要とするサブクラスでは、コンストラクタ内で、UserType と等しいかそれ以上の新しい型の値でベース・クラスのコンストラクタを呼び出すようにしてください。
QListWidget 、モデル/ビュー・プログラミング、QTreeWidgetItem 、およびQTableWidgetItemも参照してください 。
メンバ型のドキュメント
enum QListWidgetItem::ItemType
この列挙型は、リストウィジェットの項目を記述するために使用される型を記述します。
定数 | 値 | 説明 |
---|---|---|
QListWidgetItem::Type | 0 | リストウィジェット項目のデフォルトの型。 |
QListWidgetItem::UserType | 1000 | カスタムタイプの最小値。UserType 以下の値は Qt によって予約されています。 |
カスタムアイテムが特別に扱われるように、QListWidgetItem のサブクラスで新しいユーザータイプを定義できます。
type()も参照してください 。
メンバ関数ドキュメント
[explicit]
QListWidgetItem::QListWidgetItem(QListWidget *parent = nullptr, int type = Type)
指定されたparent で、指定されたtype の空のリスト・ウィジェット項目を構築します。parent が指定されていない場合、アイテムはQListWidget::insertItem() でリストウィジェットに挿入する必要があります。
このコンストラクタは、コンストラクタに渡された親のモデルに項目を挿入します。モデルがソートされている場合、この時点ではまだ構築されていない項目に対して'<'
オペレータメソッドが呼び出されるため、挿入の動作は未確定です。未確定の振る舞いを避けるために、親を指定せず、代わりにQListWidget::insertItem() を使用することをお勧めします。
type()も参照してください 。
[explicit]
QListWidgetItem::QListWidgetItem(const QString &text, QListWidget *parent = nullptr, int type = Type)
指定されたtext とparent で、指定されたtype の空のリストウィジェット項目を構築します。親が指定されていない場合、項目はQListWidget::insertItem() でリストウィジェットに挿入する必要があります。
このコンストラクタは、コンストラクタに渡された親のモデルにアイテムを挿入します。モデルがソートされている場合、この時点ではまだ構築されていない項目に対して'<'
オペレータメソッドが呼び出されるため、挿入の動作は未確定です。未確定の振る舞いを避けるために、親を指定せず、代わりにQListWidget::insertItem() を使用することをお勧めします。
type()も参照してください 。
[explicit]
QListWidgetItem::QListWidgetItem(const QIcon &icon, const QString &text, QListWidget *parent = nullptr, int type = Type)
指定されたicon 、text 、parent で、指定されたtype の空のリストウィジェット項目を構築します。親が指定されていない場合、項目はQListWidget::insertItem() でリストウィジェットに挿入する必要があります。
このコンストラクタは、コンストラクタに渡された親のモデルにアイテムを挿入します。モデルがソートされている場合、この時点ではまだ構築されていない項目に対して'<'
オペレータメソッドが呼び出されるため、挿入の動作は未確定です。未確定の振る舞いを避けるために、親を指定せず、代わりにQListWidget::insertItem() を使用することをお勧めします。
type()も参照してください 。
QListWidgetItem::QListWidgetItem(const QListWidgetItem &other)
other type() と () はコピーされないことに注意。listWidget
この関数は、clone() を再実装する場合に便利である。
[virtual noexcept]
QListWidgetItem::~QListWidgetItem()
リスト項目を破棄する。
QBrush QListWidgetItem::background() const
リスト項目の背景を表示するために使用されるブラシを返します。
setBackground() およびforeground()も参照 ください。
Qt::CheckState QListWidgetItem::checkState() const
リスト項目のチェック状態を返します(Qt::CheckState を参照)。
setCheckState() およびflags()も参照 ください。
[virtual]
QListWidgetItem *QListWidgetItem::clone() const
アイテムの完全なコピーを作成します。
[virtual]
QVariant QListWidgetItem::data(int role) const
指定されたrole に対するアイテムのデータを返します。追加のロールや特定のロールに対する特別な動作が必要な場合は、この関数を再実装してください。
Qt::ItemDataRole およびsetData()も参照して ください。
Qt::ItemFlags QListWidgetItem::flags() const
このアイテムのアイテム・フラグを返します (Qt::ItemFlags を参照)。
setFlags()も参照してください 。
QFont QListWidgetItem::font() const
このリスト項目のテキスト表示に使用されているフォントを返します。
setFont()も参照 ください。
QBrush QListWidgetItem::foreground() const
リスト項目の前景(テキストなど)を表示するために使用するブラシを返します。
setForeground() およびbackground()も参照 ください。
QIcon QListWidgetItem::icon() const
リスト項目のアイコンを返します。
bool QListWidgetItem::isHidden() const
アイテムが非表示の場合はtrue
を返し、そうでない場合はfalse
を返す。
setHidden()も参照 。
bool QListWidgetItem::isSelected() const
項目が選択されていればtrue
を返し、そうでなければfalse
を返す。
setSelected()も参照 。
QListWidget *QListWidgetItem::listWidget() const
アイテムを含むリストウィジェットを返します。
[virtual]
void QListWidgetItem::read(QDataStream &in)
ストリームin からアイテムを読み込む。
write()も参照 。
void QListWidgetItem::setBackground(const QBrush &brush)
リスト項目の背景ブラシを指定されたbrush に設定します。デフォルトのブラシを設定すると、ビューはスタイルからデフォルトの色を使用するようになります。
background() およびsetForeground()も参照して ください。
void QListWidgetItem::setCheckState(Qt::CheckState state)
リスト項目のチェック状態をstate に設定する。
checkState()も参照 。
[virtual]
void QListWidgetItem::setData(int role, const QVariant &value)
与えられたrole のデータを、与えられたvalue に設定します。追加のロールや特定のロールに対する特別な動作が必要な場合は、この関数を再実装してください。
注意: デフォルトの実装では、Qt::EditRole とQt::DisplayRole は同じデータを参照しているものとして扱われます。
Qt::ItemDataRole およびdata()も参照してください 。
void QListWidgetItem::setFlags(Qt::ItemFlags flags)
リスト項目の項目フラグをflags に設定します。
flags() およびQt::ItemFlagsも参照してください 。
void QListWidgetItem::setFont(const QFont &font)
アイテムをペイントする際に使用するフォントを、与えられたfont に設定します。
font()も参照 。
void QListWidgetItem::setForeground(const QBrush &brush)
リスト項目の前景ブラシを指定されたbrush に設定します。デフォルトのブラシを設定すると、ビューはスタイルからデフォルトの色を使用するようになります。
foreground() およびsetBackground()も参照して ください。
void QListWidgetItem::setHidden(bool hide)
hide が true ならアイテムを非表示にし、そうでなければアイテムを表示する。
isHidden()も参照 。
void QListWidgetItem::setIcon(const QIcon &icon)
リスト項目のアイコンを指定されたicon に設定します。
void QListWidgetItem::setSelected(bool select)
アイテムの選択状態をselect に設定する。
isSelected()も参照 。
void QListWidgetItem::setSizeHint(const QSize &size)
リストアイテムのサイズヒントをsize に設定します。サイズヒントが設定されていないか、size が無効な場合、アイテムデリゲートはアイテムデータに基づいてサイズヒントを計算します。
sizeHint()も参照してください 。
void QListWidgetItem::setStatusTip(const QString &statusTip)
リストアイテムのステータスチップをstatusTip で指定されたテキストに設定する。QListWidget この機能を動作させるには、mouseTracking を有効にする必要がある。
statusTip()、setToolTip()、setWhatsThis()、QWidget::setMouseTracking()も参照 。
void QListWidgetItem::setText(const QString &text)
リストウィジェットのアイテムのテキストを指定されたtext に設定します。
text()も参照してください 。
[since 6.4]
void QListWidgetItem::setTextAlignment(Qt::Alignment alignment)
リストアイテムのテキストアライメントをalignment に設定します。
この関数は Qt 6.4 で導入されました。
textAlignment()も参照してください 。
void QListWidgetItem::setToolTip(const QString &toolTip)
リスト項目のツールチップをtoolTip で指定されたテキストに設定します。
toolTip(),setStatusTip(),setWhatsThis()も参照 。
void QListWidgetItem::setWhatsThis(const QString &whatsThis)
リスト項目の "What's This? "ヘルプをwhatsThis で指定されたテキストに設定する。
whatsThis()、setStatusTip()、setToolTip()も参照 。
QSize QListWidgetItem::sizeHint() const
リスト項目に設定されているサイズのヒントを返します。
setSizeHint()も参照 ください。
QString QListWidgetItem::statusTip() const
リスト項目のステータス情報を返します。
setStatusTip()も参照 ください。
QString QListWidgetItem::text() const
リスト項目のテキストを返します。
setText()も参照 ください。
int QListWidgetItem::textAlignment() const
リスト項目のテキスト配置を返します。
注意: この関数は歴史的な理由から int を返します。Qt 7 ではQt::Alignment を返すように修正される予定です。
setTextAlignment() およびQt::Alignmentも参照してください 。
QString QListWidgetItem::toolTip() const
リスト項目のツールチップを返します。
setToolTip()、statusTip() およびwhatsThis()も参照 ください。
int QListWidgetItem::type() const
QListWidgetItem コンストラクタに渡された型を返します。
QString QListWidgetItem::whatsThis() const
リスト項目の "What's This?" ヘルプ・テキストを返します。
setWhatsThis()、statusTip() およびtoolTip()も参照 ください。
[virtual]
void QListWidgetItem::write(QDataStream &out) const
アイテムをストリームout に書き込む。
read()も参照 。
[virtual]
bool QListWidgetItem::operator<(const QListWidgetItem &other) const
このアイテムのテキストがother アイテムのテキストより小さい場合はtrue
を返し、そうでない場合はfalse
を返す。
QListWidgetItem &QListWidgetItem::operator=(const QListWidgetItem &other)
other のデータとフラグをこの項目に割り当てる。type() とlistWidget() はコピーされないことに注意。
この関数は、clone() を再実装するときに便利である。
関連する非会員
QDataStream &operator<<(QDataStream &out, const QListWidgetItem &item)
リスト・ウィジェット項目item をストリームout に書き込む。
この演算子はQListWidgetItem::write() を使用します。
Qt データ型のシリアライズも参照してください 。
QDataStream &operator>>(QDataStream &in, QListWidgetItem &item)
ストリームin からリスト・ウィジェット項目をitem に読み込みます。
この演算子はQListWidgetItem::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.