QTableWidget Class

Documentation sur les fonctions membres

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

Crée une nouvelle vue de table avec l'parent on fournie.

QTableWidget::QTableWidget(int rows, int columns, QWidget *parent = nullptr)

Crée une nouvelle vue de table avec les paramètres ` rows ` et ` columns` indiqués, ainsi que le paramètre ` parent` spécifié.

[virtual noexcept] QTableWidget::~QTableWidget()

Supprime cette page : QTableWidget.

[signal] void QTableWidget::cellActivated(int row, int column)

Ce signal est émis lorsque la cellule spécifiée par row et column a été activée.

[signal] void QTableWidget::cellChanged(int row, int column)

Ce signal est émis chaque fois que les données de l'élément contenu dans la cellule spécifiée par « row » et « column » ont changé.

[signal] void QTableWidget::cellClicked(int row, int column)

Ce signal est émis chaque fois qu'un clic est effectué sur une cellule du tableau. Les paramètres ` row ` et ` column ` indiquent la cellule sur laquelle le clic a été effectué.

[signal] void QTableWidget::cellDoubleClicked(int row, int column)

Ce signal est émis chaque fois qu'on double-clique sur une cellule du tableau. Les paramètres ` row ` et ` column ` indiquent la cellule sur laquelle on a double-cliqué.

[signal] void QTableWidget::cellEntered(int row, int column)

Ce signal est émis lorsque le curseur de la souris entre dans une cellule. La cellule est spécifiée par row et column.

Ce signal n'est émis que lorsque le suivi de la souris (mouseTracking) est activé, ou lorsqu'un bouton de la souris est enfoncé pendant le déplacement vers un élément.

[signal] void QTableWidget::cellPressed(int row, int column)

Ce signal est émis chaque fois qu'une cellule du tableau est sélectionnée. Les paramètres ` row ` et ` column ` indiquent la cellule qui a été sélectionnée.

QWidget *QTableWidget::cellWidget(int row, int column) const

Renvoie le widget affiché dans la cellule des colonnes « row » et « column ».

Voir aussi setCellWidget().

[slot] void QTableWidget::clear()

Supprime tous les éléments de la vue. Cette opération supprime également toutes les sélections et tous les en-têtes. Si vous ne souhaitez pas supprimer les en-têtes, utilisez la fonction QTableWidget::clearContents(). Les dimensions du tableau restent inchangées.

[slot] void QTableWidget::clearContents()

Supprime de la vue tous les éléments qui ne figurent pas dans les en-têtes. Cela supprime également toutes les sélections. Les dimensions du tableau restent inchangées.

void QTableWidget::closePersistentEditor(QTableWidgetItem *item)

Ferme l'éditeur persistant de item.

Voir également openPersistentEditor() et isPersistentEditorOpen().

int QTableWidget::column(const QTableWidgetItem *item) const

Renvoie la colonne correspondant à l'item.

int QTableWidget::columnCount() const

Renvoie le nombre de colonnes.

Voir aussi setColumnCount().

[signal] void QTableWidget::currentCellChanged(int currentRow, int currentColumn, int previousRow, int previousColumn)

Ce signal est émis chaque fois que la cellule active change. La cellule indiquée par previousRow et previousColumn est celle qui avait précédemment le focus, tandis que celle indiquée par currentRow et currentColumn est la nouvelle cellule active.

int QTableWidget::currentColumn() const

Renvoie la colonne de l'élément actuel.

Voir également currentRow() et setCurrentCell().

QTableWidgetItem *QTableWidget::currentItem() const

Renvoie l'élément actuel.

Voir aussi setCurrentItem().

[signal] void QTableWidget::currentItemChanged(QTableWidgetItem *current, QTableWidgetItem *previous)

Ce signal est émis chaque fois que l'élément actif change. L'élément « previous » correspond à l'élément qui avait précédemment le focus, tandis que « current » désigne le nouvel élément actif.

int QTableWidget::currentRow() const

Renvoie la ligne de l'élément actuel.

Voir également currentColumn() et setCurrentCell().

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

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

[virtual protected] bool QTableWidget::dropMimeData(int row, int column, const QMimeData *data, Qt::DropAction action)

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

Voir également supportedDropActions() et supportedDragActions.

void QTableWidget::editItem(QTableWidgetItem *item)

Lance l'édition de l'item, si celui-ci est modifiable.

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

Réimplémente : QAbstractItemView::event(QEvent *event).

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

Recherche les éléments correspondant à l'text, en utilisant l'flags fournie.

QTableWidgetItem *QTableWidget::horizontalHeaderItem(int column) const

Renvoie l'élément d'en-tête horizontal de la colonne column, s'il a été défini ; sinon, renvoie nullptr.

Voir également setHorizontalHeaderItem().

QModelIndex QTableWidget::indexFromItem(const QTableWidgetItem *item) const

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

[slot] void QTableWidget::insertColumn(int column)

Insère une colonne vide dans la table à l'adresse column.

[slot] void QTableWidget::insertRow(int row)

Insère une ligne vide dans la table à l'adresse row.

bool QTableWidget::isPersistentEditorOpen(QTableWidgetItem *item) const

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

Voir également openPersistentEditor() et closePersistentEditor().

QTableWidgetItem *QTableWidget::item(int row, int column) const

Renvoie l'élément correspondant aux paramètres row et column s'ils ont été définis ; sinon, renvoie nullptr.

Voir aussi setItem().

[signal] void QTableWidget::itemActivated(QTableWidgetItem *item)

Ce signal est émis lorsque l’ item on spécifiée a été activée.

QTableWidgetItem *QTableWidget::itemAt(const QPoint &point) const

Renvoie un pointeur vers l'élément situé à l'point indiquée, ou renvoie nullptr si point n'est pas couvert par un élément du widget de tableau.

Voir aussi item().

QTableWidgetItem *QTableWidget::itemAt(int ax, int ay) const

Renvoie l'élément situé à la position équivalente à QPoint(ax, ay) dans le système de coordonnées du widget de tableau, ou renvoie nullptr si le point spécifié n'est pas couvert par un élément du widget de tableau.

Voir également item().

[signal] void QTableWidget::itemChanged(QTableWidgetItem *item)

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

[signal] void QTableWidget::itemClicked(QTableWidgetItem *item)

Ce signal est émis chaque fois qu'un élément du tableau est sélectionné par un clic. L'item e spécifiée correspond à l'élément sur lequel le clic a été effectué.

[signal] void QTableWidget::itemDoubleClicked(QTableWidgetItem *item)

Ce signal est émis chaque fois qu'un élément du tableau fait l'objet d'un double-clic. L'item e spécifiée correspond à l'élément sur lequel le double-clic a été effectué.

[signal] void QTableWidget::itemEntered(QTableWidgetItem *item)

Ce signal est émis lorsque le curseur de la souris entre dans un élément. L'item, c'est 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 le déplacement vers un élément.

QTableWidgetItem *QTableWidget::itemFromIndex(const QModelIndex &index) const

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

[signal] void QTableWidget::itemPressed(QTableWidgetItem *item)

Ce signal est émis chaque fois qu'un élément du tableau est sélectionné. L'item e spécifiée correspond à l'élément qui a été sélectionné.

const QTableWidgetItem *QTableWidget::itemPrototype() const

Renvoie le prototype d'élément utilisé par la table.

Voir aussi setItemPrototype().

[signal] void QTableWidget::itemSelectionChanged()

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

Voir également selectedItems() et QTableWidgetItem::isSelected().

QList<QTableWidgetItem *> QTableWidget::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 ` QTreeWidget ` au sein du même processus, la liste est vide.

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

Renvoie un objet contenant une description sérialisée de la liste spécifiée 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 QTableWidget::mimeTypes() const

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

Voir également mimeData().

void QTableWidget::openPersistentEditor(QTableWidgetItem *item)

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

Voir également closePersistentEditor() et isPersistentEditorOpen().

void QTableWidget::removeCellWidget(int row, int column)

Supprime le widget défini sur la cellule indiquée par row et column.

[slot] void QTableWidget::removeColumn(int column)

Supprime la colonne « column » et tous ses éléments du tableau.

[slot] void QTableWidget::removeRow(int row)

Supprime la ligne « row » et tous ses éléments du tableau.

int QTableWidget::row(const QTableWidgetItem *item) const

Renvoie la ligne correspondant à l'item.

int QTableWidget::rowCount() const

Renvoie le nombre de lignes.

Voir aussi setRowCount().

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

Fait défiler la vue si nécessaire pour s'assurer que l'item est visible. Le paramètre « hint » précise l'emplacement exact où la item doit se trouver à l'issue de l'opération.

QList<QTableWidgetItem *> QTableWidget::selectedItems() const

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

Cette fonction renvoie une liste de pointeurs vers le contenu des cellules sélectionnées. Utilisez la fonction selectedIndexes() pour récupérer la sélection complète, y compris les cellules vides.

Voir aussi selectedIndexes().

QList<QTableWidgetSelectionRange> QTableWidget::selectedRanges() const

Renvoie une liste de toutes les plages sélectionnées.

Voir également QTableWidgetSelectionRange.

void QTableWidget::setCellWidget(int row, int column, QWidget *widget)

Définit l'widget donné comme élément à afficher dans la cellule située à l'row et à l'column indiqués, en transférant la propriété du widget à la table.

Si le widget de cellule A est remplacé par le widget de cellule B, le widget de cellule A sera supprimé. Par exemple, dans l'extrait de code ci-dessous, l'objet ` QLineEdit ` sera supprimé.

setCellWidget(row, column, new QLineEdit);
...
setCellWidget(row, column, new QTextEdit);

Voir également cellWidget().

void QTableWidget::setColumnCount(int columns)

Définit le nombre de colonnes du modèle de cette table sur columns. Si cette valeur est inférieure à columnCount(), les données des colonnes non souhaitées sont ignorées.

Voir également columnCount() et setRowCount().

void QTableWidget::setCurrentCell(int row, int column)

Définit la cellule actuelle comme étant celle située à la position (row, column).

En fonction de la valeur actuelle de ` selection mode`, la cellule peut également être sélectionnée.

Voir également setCurrentItem(), currentRow() et currentColumn().

void QTableWidget::setCurrentCell(int row, int column, QItemSelectionModel::SelectionFlags command)

Définit la cellule actuelle comme étant celle située à la position (row, column), en utilisant l'command.

Voir également setCurrentItem(), currentRow() et currentColumn().

void QTableWidget::setCurrentItem(QTableWidgetItem *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 également currentItem() et setCurrentCell().

void QTableWidget::setCurrentItem(QTableWidgetItem *item, QItemSelectionModel::SelectionFlags command)

Définit l'élément actuel sur item, en utilisant l'command fournie.

Voir également currentItem() et setCurrentCell().

void QTableWidget::setHorizontalHeaderItem(int column, QTableWidgetItem *item)

Définit l'élément d'en-tête horizontal de la colonne column sur item. Si nécessaire, le nombre de colonnes est augmenté pour s'adapter à cet élément. L'élément d'en-tête précédent (s'il y en avait un) est supprimé.

Voir également horizontalHeaderItem().

void QTableWidget::setHorizontalHeaderLabels(const QStringList &labels)

Définit les libellés horizontaux de l'en-tête à l'aide de ` labels`.

void QTableWidget::setItem(int row, int column, QTableWidgetItem *item)

Définit l'élément associé aux adresses row et column sur item.

La table prend possession de l'élément.

Notez que si le tri est activé (voir sortingEnabled) et que column correspond à la colonne de tri actuelle, l'élément row sera déplacé vers la position triée déterminée par item.

Si vous souhaitez définir plusieurs éléments d’une ligne particulière (par exemple, en appelant `setItem()` dans une boucle), vous pouvez désactiver le tri avant de le faire, puis le réactiver par la suite ; cela vous permettra d’utiliser le même argument ` row ` pour tous les éléments d’une même ligne (c’est-à-dire que `setItem()` ne déplacera pas la ligne).

Voir également item() et takeItem().

void QTableWidget::setItemPrototype(const QTableWidgetItem *item)

Définit le prototype d'élément de la table sur l'item spécifié.

Le widget de tableau utilisera la fonction de clonage du prototype d’élément lorsqu’il devra créer un nouvel élément de tableau. Par exemple, lorsque l’utilisateur effectue une modification dans une cellule vide. Cela s’avère utile lorsque vous disposez d’une sous-classe de ` QTableWidgetItem ` et que vous souhaitez vous assurer que ` QTableWidget ` crée des instances de votre sous-classe.

Le tableau prend possession du prototype.

Voir également ` itemPrototype()`.

void QTableWidget::setRangeSelected(const QTableWidgetSelectionRange &range, bool select)

Active ou désactive l'option « range » en fonction de la valeur de « select ».

void QTableWidget::setRowCount(int rows)

Définit le nombre de lignes du modèle de ce tableau sur rows. Si cette valeur est inférieure à rowCount(), les données des lignes non souhaitées sont ignorées.

Voir également rowCount() et setColumnCount().

void QTableWidget::setVerticalHeaderItem(int row, QTableWidgetItem *item)

Définit l'élément d'en-tête vertical de la ligne row sur item.

Voir également ` verticalHeaderItem()`.

void QTableWidget::setVerticalHeaderLabels(const QStringList &labels)

Définit les libellés verticaux des en-têtes à l'aide de la fonction ` labels`.

void QTableWidget::sortItems(int column, Qt::SortOrder order = Qt::AscendingOrder)

Trie toutes les lignes du widget de tableau en fonction des critères indiqués sur column et order.

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

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

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

QTableWidgetItem *QTableWidget::takeHorizontalHeaderItem(int column)

Supprime de l'en-tête l'élément horizontal situé à l'adresse column sans le supprimer.

QTableWidgetItem *QTableWidget::takeItem(int row, int column)

Supprime de la table les entrées situées à l'adresse row et column sans les effacer.

QTableWidgetItem *QTableWidget::takeVerticalHeaderItem(int row)

Supprime l'élément d'en-tête vertical situé à l'adresse row de l'en-tête sans le supprimer.

QTableWidgetItem *QTableWidget::verticalHeaderItem(int row) const

Renvoie l'élément d'en-tête vertical correspondant à la ligne row.

Voir aussi setVerticalHeaderItem().

int QTableWidget::visualColumn(int logicalColumn) const

Renvoie la colonne visuelle de l'logicalColumn donné.

QRect QTableWidget::visualItemRect(const QTableWidgetItem *item) const

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

int QTableWidget::visualRow(int logicalRow) const

Renvoie la ligne visuelle de l’ logicalRow donné.