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::Type0リストウィジェット項目のデフォルトの型。
QListWidgetItem::UserType1000カスタムタイプの最小値。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)

指定されたtextparent で、指定されたtype の空のリストウィジェット項目を構築します。親が指定されていない場合、項目はQListWidget::insertItem() でリストウィジェットに挿入する必要があります。

このコンストラクタは、コンストラクタに渡された親のモデルにアイテムを挿入します。モデルがソートされている場合、この時点ではまだ構築されていない項目に対して'<' オペレータメソッドが呼び出されるため、挿入の動作は未確定です。未確定の振る舞いを避けるために、親を指定せず、代わりにQListWidget::insertItem() を使用することをお勧めします。

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

[explicit] QListWidgetItem::QListWidgetItem(const QIcon &icon, const QString &text, QListWidget *parent = nullptr, int type = Type)

指定されたicontextparent で、指定されたtype の空のリストウィジェット項目を構築します。親が指定されていない場合、項目はQListWidget::insertItem() でリストウィジェットに挿入する必要があります。

このコンストラクタは、コンストラクタに渡された親のモデルにアイテムを挿入します。モデルがソートされている場合、この時点ではまだ構築されていない項目に対して'<' オペレータメソッドが呼び出されるため、挿入の動作は未確定です。未確定の振る舞いを避けるために、親を指定せず、代わりにQListWidget::insertItem() を使用することをお勧めします。

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

QListWidgetItem::QListWidgetItem(const QListWidgetItem &other)

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

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

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

[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

リスト項目のアイコンを返します。

setIcon() およびiconSizeも参照

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::EditRoleQt::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 に設定します。

icon(),text(),iconSizeも参照

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

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

関連する非会員

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.