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)

Crée un QListWidget vide avec l'parent on fournie.

[virtual noexcept] QListWidget::~QListWidget()

Supprime le widget de liste et tous ses éléments.

void QListWidget::addItem(QListWidgetItem *item)

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

Voir aussi insertItem().

void QListWidget::addItem(const QString &label)

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

void QListWidget::addItems(const QStringList &labels)

Ajoute des é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 associé à l'item.

Voir également 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 chaque fois que l'élément actif change.

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

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

Ce signal est émis chaque fois que l'élément actif change.

currentRow est l'index de l'élément actuel. S'il n'y a pas d'élément actuel, l'currentRow est -1.

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

Ce signal est émis chaque fois que l'élément actif change.

currentText représente les données textuelles de l'élément actuel. S'il n'y a pas d'élément actuel, l'currentText ation 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)

Gère les objets ` data ` fournis par une opération externe de glisser-déposer qui s'est terminée avec l'action donné dans l'index donné. Renvoie ` true ` si ` data ` et ` action ` peuvent être gérés par le modèle ; sinon, renvoie ` false`.

Voir également supportedDropActions() et supportedDragActions.

void QListWidget::editItem(QListWidgetItem *item)

Lance l'édition de l'item, si celle-ci 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 contient la chaîne « text » à l'aide de l'flags.

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

Renvoie l'QModelIndex associé à l'item donné.

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

Insère l'item à la position de la liste indiquée par row.

Voir également addItem().

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

Insère un élément contenant le texte « label » dans le widget de liste, à la position indiquée par « row ».

Voir aussi addItem().

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

Ajoute les éléments de la liste labels à la liste, en commençant par l'row.

Voir également insertItem() et addItem().

bool QListWidget::isPersistentEditorOpen(QListWidgetItem *item) const

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

Voir également openPersistentEditor() et closePersistentEditor().

QListWidgetItem *QListWidget::item(int row) const

Renvoie l'élément occupant l'row donné dans la liste s'il a été défini ; sinon, renvoie nullptr.

Voir aussi row().

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

Ce signal est émis lorsque l'« item » est activé. L'« 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 « Command+O »).

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

Renvoie un pointeur vers l'élément situé aux coordonnées p. Ces coordonnées sont relatives à la fonction viewport() du widget de liste.

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

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

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

Ce signal est émis dès que les données de item ont changé.

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

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

Voir également itemPressed() et itemDoubleClicked().

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

Ce signal est émis avec l'item spécifiée lorsqu'on double-clique avec la souris sur un élément du widget.

Voir également ` 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'item correspond à l'élément dans lequel le curseur est entré. 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 également QWidget::setMouseTracking().

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

Renvoie un pointeur vers l'QListWidgetItem associé à l'index donné.

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

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

Voir également ` itemClicked()` et ` itemDoubleClicked()`.

[signal] void QListWidget::itemSelectionChanged()

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

Voir également selectedItems(), QListWidgetItem::isSelected() et currentItemChanged().

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

Renvoie le widget affiché dans l'item spécifiée.

Voir également 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 une fonction ` QListWidget ` au sein du même processus, la liste est vide.

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

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

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

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

Renvoie une liste des types MIME pouvant être utilisés pour décrire une liste d'éléments du widget « listwidget ».

Voir également mimeData().

void QListWidget::openPersistentEditor(QListWidgetItem *item)

Ouvre un éditeur pour le fichier item. L'éditeur reste ouvert après la modification.

Voir également closePersistentEditor() et isPersistentEditorOpen().

void QListWidget::removeItemWidget(QListWidgetItem *item)

Supprime le widget défini sur l'item spécifiée.

Pour supprimer définitivement un élément (une ligne) de la liste, supprimez-le ou utilisez la fonction takeItem().

Voir également itemWidget() et setItemWidget().

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

Renvoie la ligne contenant l'item on fournie.

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 l'item est visible.

hint Spécifie l'emplacement où l'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 ».

À moins que le mode de sélection ne soit « NoSelection », l'élément est également sélectionné.

Voir aussi currentItem().

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

Définir l'élément actuel sur « item », en utilisant l'command fournie.

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

Définit la ligne actuelle sur la valeur « row » indiquée, en utilisant la valeur « command » fournie,

Voir également currentRow().

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

Définit l'widget à afficher à l'item indiquée.

Cette fonction ne doit être utilisée que pour afficher du contenu statique à la place d’un élément de widget de liste. Si vous souhaitez afficher du contenu dynamique personnalisé ou implémenter un widget d’édition personnalisé, utilisez plutôt ` QListView ` et sous-classez ` QStyledItemDelegate `.

Voir également itemWidget(), removeItemWidget() et Classes de délégués.

[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 selon l'order e spécifiée.

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

Renvoie les actions de glisser-déposer prises en charge par cette vue.

Voir également Qt::DropActions, supportedDragActions et dropMimeData().

QListWidgetItem *QListWidget::takeItem(int row)

Supprime et renvoie l'élément de l'row e spécifié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 également insertItem() et addItem().

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

Renvoie le rectangle occupé par l'élément dans la fenêtre d'affichage à l'adresse item.