QListWidget Class

QListWidget *listWidget = new QListWidget(this);

new QListWidgetItem(tr("Oak"), listWidget);
new QListWidgetItem(tr("Fir"), listWidget);
new QListWidgetItem(tr("Pine"), listWidget);

QListWidgetItem *newItem = new QListWidgetItem;
newItem->setText(itemText);
listWidget->insertItem(row, newItem);

メンバ関数のドキュメント

[explicit] QListWidget::QListWidget(QWidget *parent = nullptr)

指定されたparent を使用して、空のQListWidgetを構築します。

[virtual noexcept] QListWidget::~QListWidget()

リストウィジェットとそのすべての項目を破棄します。

void QListWidget::addItem(QListWidgetItem *item)

リストウィジェットの末尾に「item 」を挿入します。

「insertItem()」も参照してください 。

void QListWidget::addItem(const QString &label)

リストウィジェットの末尾に、「label 」というテキストを含む項目を挿入します。

void QListWidget::addItems(const QStringList &labels)

リストウィジェットの末尾に、「labels 」というテキストを含む項目を挿入します。

「insertItems()」も参照してください 。

[slot] void QListWidget::clear()

ビュー内のすべてのアイテムと選択範囲を削除します。

void QListWidget::closePersistentEditor(QListWidgetItem *item)

指定されたitem の永続エディタを閉じます。

openPersistentEditor() およびisPersistentEditorOpen()も参照してください 。

QListWidgetItem *QListWidget::currentItem() const

現在の項目を返します。

setCurrentItem()も参照してください 。

[signal] void QListWidget::currentItemChanged(QListWidgetItem *current, QListWidgetItem *previous)

このシグナルは、現在の項目が変更されるたびに発火します。

previous は、直前にフォーカスが当たっていた項目です。current は、新しい現在の項目です。

[signal] void QListWidget::currentRowChanged(int currentRow)

この信号は、現在のアイテムが変更されるたびに発生します。

currentRow は現在の項目の行番号です。現在の項目がない場合、currentRow は -1 になります。

[signal] void QListWidget::currentTextChanged(const QString &currentText)

このシグナルは、現在の項目が変更されるたびに発生します。

currentText は、現在の項目のテキストデータです。現在の項目が存在しない場合、currentText は無効となります。

[override virtual protected] void QListWidget::dropEvent(QDropEvent *event)

QListView::dropEvent(QDropEvent *event) を再実装します。

[virtual protected] bool QListWidget::dropMimeData(int index, const QMimeData *data, Qt::DropAction action)

指定されたindex 内で、指定されたaction で終了した外部のドラッグ＆ドロップ操作によって渡されたdata を処理します。data およびaction をモデルが処理できる場合はtrue を返し、そうでない場合はfalse を返します。

supportedDropActions() およびsupportedDragActionsも参照してください 。

void QListWidget::editItem(QListWidgetItem *item)

item が編集可能な場合は、その編集を開始します。

[override virtual protected] bool QListWidget::event(QEvent *e)

QListView::event(QEvent *e) を再実装します。

QList<QListWidgetItem *> QListWidget::findItems(const QString &text, Qt::MatchFlags flags) const

指定されたflags を使用して、文字列text と一致するテキストを含む項目を検索します。

QModelIndex QListWidget::indexFromItem(const QListWidgetItem *item) const

指定されたitem に関連付けられたQModelIndex を返します。

void QListWidget::insertItem(int row, QListWidgetItem *item)

リスト内のrow で指定された位置に、item を挿入します。

addItem()も参照してください 。

void QListWidget::insertItem(int row, const QString &label)

リストウィジェットに、「label 」というテキストを持つ項目を、row で指定された位置に挿入します。

addItem()も参照してください 。

void QListWidget::insertItems(int row, const QStringList &labels)

labels のリストに含まれる項目を、指定されたrow を起点としてリストに挿入します。

insertItem() およびaddItem()も参照してください 。

bool QListWidget::isPersistentEditorOpen(QListWidgetItem *item) const

アイテムitem に対して、永続エディタが開かれているかどうかを返します。

openPersistentEditor() およびclosePersistentEditor()も参照してください 。

QListWidgetItem *QListWidget::item(int row) const

リスト内で指定されたrow を持つ項目が設定されている場合はそれを返し、設定されていない場合はnullptr を返します。

row()も参照してください 。

[signal] void QListWidget::itemActivated(QListWidgetItem *item)

この信号は、item がアクティブになったときに発信されます。item は、システムの設定に応じて、ユーザーがそれをクリックまたはダブルクリックしたときにアクティブになります。また、ユーザーがアクティベーションキーを押したときにもアクティブになります（WindowsおよびX11ではReturn キー、Mac OS XではCommand+O です）。

QListWidgetItem *QListWidget::itemAt(const QPoint &p) const

座標 `p` にある項目へのポインタを返します。この座標は、リストウィジェットの `viewport()` に対する相対座標です。

QListWidgetItem *QListWidget::itemAt(int x, int y) const

座標 (x,y) にある項目へのポインタを返します。座標は、リストウィジェットの `viewport()` に対する相対座標です。

[signal] void QListWidget::itemChanged(QListWidgetItem *item)

この信号は、item のデータが変更されるたびに発信されます。

[signal] void QListWidget::itemClicked(QListWidgetItem *item)

このシグナルは、ウィジェット内のアイテム上でマウスボタンがクリックされた際に、指定されたitem とともに発火します。

itemPressed() およびitemDoubleClicked()も参照してください 。

[signal] void QListWidget::itemDoubleClicked(QListWidgetItem *item)

このシグナルは、ウィジェット内のアイテム上でマウスボタンをダブルクリックした際に、指定されたitem とともに発火します。

itemClicked() およびitemPressed()も参照してください 。

[signal] void QListWidget::itemEntered(QListWidgetItem *item)

このシグナルは、マウスカーソルがアイテムに進入したときに発せられます。item は、進入したアイテムです。このシグナルは、mouseTracking がオンになっている場合、またはアイテムに進入中にマウスボタンが押された場合にのみ発せられます。

QWidget::setMouseTracking()も参照してください 。

QListWidgetItem *QListWidget::itemFromIndex(const QModelIndex &index) const

指定されたindex に関連付けられたQListWidgetItem へのポインタを返します。

[signal] void QListWidget::itemPressed(QListWidgetItem *item)

このシグナルは、ウィジェット内のアイテム上でマウスボタンが押されたときに、指定されたitem とともに発火します。

itemClicked() およびitemDoubleClicked()も参照してください 。

[signal] void QListWidget::itemSelectionChanged()

このシグナルは、選択内容が変更されるたびに発信されます。

selectedItems()、QListWidgetItem::isSelected()、およびcurrentItemChanged()も参照してください 。

QWidget *QListWidget::itemWidget(QListWidgetItem *item) const

指定されたitem に表示されているウィジェットを返します。

setItemWidget() およびremoveItemWidget()も参照してください 。

QList<QListWidgetItem *> QListWidget::items(const QMimeData *data) const

data オブジェクトに含まれる項目へのポインタのリストを返します。そのオブジェクトが、同じプロセス内のQListWidget によって作成されたものでない場合、リストは空になります。

[virtual protected] QMimeData *QListWidget::mimeData(const QList<QListWidgetItem *> &items) const

指定されたitems のシリアライズされた記述を含むオブジェクトを返します。項目の記述に使用される形式は、mimeTypes()関数から取得されます。

項目のリストが空の場合、シリアライズされた空のリストの代わりにnullptr が返されます。

[virtual protected] QStringList QListWidget::mimeTypes() const

リストウィジェットの項目のリストを記述するために使用できるMIMEタイプのリストを返します。

mimeData()も参照してください 。

void QListWidget::openPersistentEditor(QListWidgetItem *item)

指定されたitem のエディタを開きます。編集後もエディタは開いたままになります。

closePersistentEditor() およびisPersistentEditorOpen()も参照してください 。

void QListWidget::removeItemWidget(QListWidgetItem *item)

指定されたitem に設定されたウィジェットを削除します。

リストから項目（行）を完全に削除するには、その項目を削除するか、takeItem() を使用してください。

itemWidget() およびsetItemWidget()も参照してください 。

int QListWidget::row(const QListWidgetItem *item) const

指定されたitem を含む行を返します。

item()も参照してください 。

[slot] void QListWidget::scrollToItem(const QListWidgetItem *item, QAbstractItemView::ScrollHint hint = EnsureVisible)

必要に応じてビューをスクロールし、item が確実に表示されるようにします。

hint 操作後にitem を配置する位置を指定します。

QList<QListWidgetItem *> QListWidget::selectedItems() const

リストウィジェットで選択されているすべての項目のリストを返します。

void QListWidget::setCurrentItem(QListWidgetItem *item)

現在の項目を「item 」に設定します。

選択モードがNoSelection でない限り、その項目も選択されます。

currentItem()も参照してください 。

void QListWidget::setCurrentItem(QListWidgetItem *item, QItemSelectionModel::SelectionFlags command)

指定されたcommand を使用して、現在の項目をitem に設定します。

void QListWidget::setCurrentRow(int row, QItemSelectionModel::SelectionFlags command)

指定された `command` を使用して、現在の行を指定された `row` に設定します。

関連項目： currentRow()。

void QListWidget::setItemWidget(QListWidgetItem *item, QWidget *widget)

指定されたitem 内に表示されるwidget を設定します。

この関数は、リストウィジェットの項目の代わりに静的なコンテンツを表示する場合にのみ使用してください。カスタムの動的コンテンツを表示したり、カスタムエディタウィジェットを実装したりする場合は、代わりにQListView を使用し、QStyledItemDelegate をサブクラス化してください。

関連項目: ` itemWidget()`、`removeItemWidget()`、およびデリゲートクラス。

[override virtual] void QListWidget::setSelectionModel(QItemSelectionModel *selectionModel)

QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel) を再実装します。

void QListWidget::sortItems(Qt::SortOrder order = Qt::AscendingOrder)

リストウィジェット内のすべての項目を、指定されたorder に基づいて並べ替えます。

[virtual protected] Qt::DropActions QListWidget::supportedDropActions() const

このビューでサポートされているドロップ操作を返します。

Qt::DropActions 、supportedDragActions 、およびdropMimeData()も参照してください 。

QListWidgetItem *QListWidget::takeItem(int row)

リストウィジェット内の指定されたrow からアイテムを削除して返します。そうでない場合は、nullptr を返します。

リストウィジェットから削除された項目はQtによって管理されなくなるため、手動で削除する必要があります。

insertItem() およびaddItem()も参照してください 。

QRect QListWidget::visualItemRect(const QListWidgetItem *item) const

item における、そのアイテムがビューポート上で占める矩形を返します。