QListWidgetItem Class

QListWidgetItemクラスは、QListWidget アイテムビュークラスで使用するアイテムを提供します。詳細...

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

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