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);

Documentation des fonctions membres

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

Construit un QListWidget vide avec l'adresse parent.

[virtual noexcept] QListWidget::~QListWidget()

Détruit le widget liste et tous ses éléments.

void QListWidget::addItem(QListWidgetItem *item)

Insère le item à la fin du widget de liste.

Voir aussi insertItem().

void QListWidget::addItem(const QString &label)

Insère un élément avec le texte label à la fin du widget de liste.

void QListWidget::addItems(const QStringList &labels)

Insère les éléments contenant le texte labels à la fin du widget de liste.

Voir aussi insertItems().

[slot] void QListWidget::clear()

Supprime tous les éléments et toutes les sélections de la vue.

void QListWidget::closePersistentEditor(QListWidgetItem *item)

Ferme l'éditeur persistant pour le site item donné.

Voir aussi openPersistentEditor() et isPersistentEditorOpen().

QListWidgetItem *QListWidget::currentItem() const

Renvoie l'élément actuel.

Voir aussi setCurrentItem().

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

Ce signal est émis lorsque l'élément courant change.

previous est l'élément qui avait précédemment le focus ; current est le nouvel élément courant.

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

Ce signal est émis lorsque l'élément en cours est modifié.

currentRow est la ligne de l'élément courant. S'il n'y a pas d'élément courant, la valeur de currentRow est -1.

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

Ce signal est émis lorsque l'élément en cours est modifié.

currentText est le texte de l'élément en cours. S'il n'y a pas d'élément courant, le site currentText n'est pas valide.

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

Réimplémente : QListView::dropEvent(QDropEvent *event).

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

Traite data fourni par une opération externe de glisser-déposer qui s'est terminée par action dans index. Renvoie true si data et action peuvent être traités par le modèle ; sinon, renvoie false.

Voir également supportedDropActions() et supportedDragActions.

void QListWidget::editItem(QListWidgetItem *item)

Commence à éditer le site item s'il est modifiable.

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

Réimplémente : QListView::event(QEvent *e).

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

Recherche les éléments dont le texte correspond à la chaîne de caractères text en utilisant la chaîne de caractères flags.

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

Retourne le QModelIndex associé au item donné.

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

Insère le fichier item à la position dans la liste donnée par row.

Voir aussi addItem().

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

Insère un élément avec le texte label dans le widget liste à la position donnée par row.

Voir aussi addItem().

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

Insère des éléments de la liste de labels dans la liste, en commençant par row.

Voir aussi insertItem() et addItem().

bool QListWidget::isPersistentEditorOpen(QListWidgetItem *item) const

Indique si un éditeur persistant est ouvert pour l'élément item.

Voir aussi openPersistentEditor() et closePersistentEditor().

QListWidgetItem *QListWidget::item(int row) const

Renvoie l'élément qui occupe l'emplacement donné row dans la liste si un emplacement a été défini ; sinon, renvoie nullptr.

Voir aussi row().

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

Ce signal est émis lorsque le site item est activé. Le site item est activé lorsque l'utilisateur clique ou double-clique dessus, selon la configuration du système. Il est également activé lorsque l'utilisateur appuie sur la touche d'activation (sous Windows et X11, il s'agit de la touche Return, sous Mac OS X, il s'agit de la touche Command+O).

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

Renvoie un pointeur sur l'élément aux coordonnées p. Les coordonnées sont relatives au widget de liste viewport().

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

Renvoie un pointeur sur l'élément aux coordonnées (x, y). Les coordonnées sont relatives à l'adresse viewport() du widget de liste.

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

Ce signal est émis lorsque les données de item ont changé.

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

Ce signal est émis avec l'adresse item spécifiée lorsqu'un bouton de souris est cliqué sur un élément du widget.

Voir aussi itemPressed() et itemDoubleClicked().

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

Ce signal est émis avec l'adresse item spécifiée lorsqu'un bouton de souris est doublement cliqué sur un élément du widget.

Voir aussi itemClicked() et itemPressed().

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

Ce signal est émis lorsque le curseur de la souris entre dans un élément. L'adresse item correspond à l'élément saisi. Ce signal n'est émis que lorsque le suivi de la souris est activé ou lorsqu'un bouton de la souris est enfoncé pendant que le curseur entre dans un élément.

Voir aussi QWidget::setMouseTracking().

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

Renvoie un pointeur sur le site QListWidgetItem associé au site index donné.

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

Ce signal est émis avec l'adresse item spécifiée lorsqu'un bouton de souris est pressé sur un élément du widget.

Voir aussi itemClicked() et itemDoubleClicked().

[signal] void QListWidget::itemSelectionChanged()

Ce signal est émis chaque fois que la sélection change.

Voir aussi selectedItems(), QListWidgetItem::isSelected() et currentItemChanged().

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

Renvoie le widget affiché sur le site item.

Voir aussi setItemWidget() et removeItemWidget().

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

Renvoie une liste de pointeurs vers les éléments contenus dans l'objet data. Si l'objet n'a pas été créé par un QListWidget dans le même processus, la liste est vide.

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

Renvoie un objet qui contient une description sérialisée de l'élément spécifié items. Le format utilisé pour décrire les éléments est obtenu à partir de la fonction mimeTypes().

Si la liste des éléments est vide, nullptr est renvoyé à la place d'une liste vide sérialisée.

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

Renvoie une liste de types MIME pouvant être utilisés pour décrire une liste d'éléments de listwidget.

Voir aussi mimeData().

void QListWidget::openPersistentEditor(QListWidgetItem *item)

Ouvre un éditeur pour le site item. L'éditeur reste ouvert après l'édition.

Voir aussi closePersistentEditor() et isPersistentEditorOpen().

void QListWidget::removeItemWidget(QListWidgetItem *item)

Supprime l'ensemble de widgets sur le site item.

Pour supprimer entièrement un élément (ligne) de la liste, il faut soit supprimer l'élément, soit utiliser takeItem().

Voir également itemWidget() et setItemWidget().

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

Renvoie la ligne contenant l'adresse item.

Voir aussi item().

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

Fait défiler la vue si nécessaire pour s'assurer que le site item est visible.

hint spécifie l'endroit où le site item doit se trouver après l'opération.

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

Renvoie une liste de tous les éléments sélectionnés dans le widget de liste.

void QListWidget::setCurrentItem(QListWidgetItem *item)

Définit l'élément actuel sur item.

Si le mode de sélection n'est pas NoSelection, l'élément est également sélectionné.

Voir également currentItem().

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

Fixer l'élément actuel à item, en utilisant la valeur donnée command.

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

Définit la ligne actuelle comme étant la ligne donnée row, en utilisant la ligne donnée command,

Voir aussi currentRow().

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

Définit l'adresse widget à afficher dans l'adresse item donnée.

Cette fonction ne doit être utilisée que pour afficher un contenu statique à la place d'un élément de widget de liste. Si vous souhaitez afficher un contenu dynamique personnalisé ou mettre en œuvre un widget d'édition personnalisé, utilisez plutôt QListView et la sous-classe QStyledItemDelegate.

Voir également itemWidget(), removeItemWidget() et Delegate Classes.

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

Réimplémente : QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel).

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

Trie tous les éléments du widget de liste en fonction de l'adresse order spécifiée.

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

Renvoie les actions de dépôt prises en charge par cette vue.

Voir aussi Qt::DropActions, supportedDragActions, et dropMimeData().

QListWidgetItem *QListWidget::takeItem(int row)

Supprime et renvoie l'élément de l'adresse row donnée dans le widget de liste ; sinon, renvoie nullptr.

Les éléments supprimés d'un widget de liste ne seront pas gérés par Qt, et devront être supprimés manuellement.

Voir aussi insertItem() et addItem().

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

Renvoie le rectangle de la fenêtre de visualisation occupé par l'élément à l'adresse item.