QTableView Class

Documentation sur les fonctions membres

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

Crée une vue de table avec une instance de ` parent ` pour représenter les données.

Voir aussi QAbstractItemModel.

[virtual noexcept] QTableView::~QTableView()

Supprime la vue de tableau.

void QTableView::clearSpans()

Supprime toutes les extensions de lignes et de colonnes dans la vue de tableau.

Voir aussi setSpan().

int QTableView::columnAt(int x) const

Renvoie la colonne dans laquelle se trouve la coordonnée x donnée, x, dans les coordonnées du contenu.

Voir aussi rowAt().

[protected slot] void QTableView::columnCountChanged(int oldCount, int newCount)

Cette méthode est appelée chaque fois que des colonnes sont ajoutées ou supprimées. Le nombre de colonnes précédent est spécifié par ` oldCount`, et le nouveau nombre de colonnes est spécifié par ` newCount`.

[protected slot] void QTableView::columnMoved(int column, int oldIndex, int newIndex)

Ce slot est appelé pour modifier l'index de l'column donné dans la vue de tableau. L'ancien index est spécifié par oldIndex, et le nouvel index par newIndex.

Voir également rowMoved().

[protected slot] void QTableView::columnResized(int column, int oldWidth, int newWidth)

Cette méthode est appelée pour modifier la largeur de l’élément column. L’ancienne largeur est spécifiée par oldWidth, et la nouvelle largeur par newWidth.

Voir également rowResized().

int QTableView::columnSpan(int row, int column) const

Renvoie le nombre de colonnes de l'élément de tableau situé à l'adresse (row, column). La valeur par défaut est 1.

Voir également setSpan() et rowSpan().

int QTableView::columnViewportPosition(int column) const

Renvoie la coordonnée x, dans le système de coordonnées « contents », de l'column on donnée.

int QTableView::columnWidth(int column) const

Renvoie la largeur de l'column donné.

Voir également setColumnWidth(), resizeColumnToContents() et rowHeight().

[override virtual protected] void QTableView::currentChanged(const QModelIndex &current, const QModelIndex &previous)

Réimplémente : QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous).

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

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

[slot] void QTableView::hideColumn(int column)

Masquer l'column on indiquée.

Voir également showColumn() et hideRow().

[slot] void QTableView::hideRow(int row)

Masquer l'row on indiquée.

Voir également showRow() et hideColumn().

QHeaderView *QTableView::horizontalHeader() const

Renvoie l'en-tête horizontal de la vue de tableau.

Voir également setHorizontalHeader(), verticalHeader() et QAbstractItemModel::headerData().

[override virtual protected] int QTableView::horizontalOffset() const

Réimplémente : QAbstractItemView::horizontalOffset() const.

Renvoie le décalage horizontal des éléments dans la vue de tableau.

Notez que la vue de tableau utilise les positions horizontales de la section d'en-tête pour déterminer les positions des colonnes dans la vue.

Voir également verticalOffset().

[override virtual] QModelIndex QTableView::indexAt(const QPoint &pos) const

Réimplémente : QAbstractItemView::indexAt(const QPoint &point) const.

Renvoie l’index de l’élément du modèle correspondant à l’élément du tableau situé à la position pos dans les coordonnées du contenu.

[override virtual protected] void QTableView::initViewItemOption(QStyleOptionViewItem *option) const

Réimplémente : QAbstractItemView::initViewItemOption(QStyleOptionViewItem *option) const.

bool QTableView::isColumnHidden(int column) const

Renvoie « true » si l'column e indiquée est masquée ; sinon, renvoie « false ».

Voir aussi isRowHidden().

[override virtual protected] bool QTableView::isIndexHidden(const QModelIndex &index) const

Réimplémente : QAbstractItemView::isIndexHidden(const QModelIndex &index) const.

bool QTableView::isRowHidden(int row) const

Renvoie « true » si l'row on fournie est masquée ; sinon, renvoie « false ».

Voir aussi isColumnHidden().

[override virtual protected] QModelIndex QTableView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)

Réimplémente : QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers).

Déplace le curseur conformément à l'cursorAction fournie, en utilisant les informations fournies par l'modifiers.

Voir aussi QAbstractItemView::CursorAction.

[override virtual protected] void QTableView::paintEvent(QPaintEvent *event)

Réimplémente : QAbstractScrollArea::paintEvent(QPaintEvent *event).

Dessine le tableau à la réception de l'événement de dessin spécifié event.

[slot] void QTableView::resizeColumnToContents(int column)

Redimensionne l'column donné en fonction des indications de taille fournies par le délégué utilisé pour afficher chaque élément de la colonne.

Voir également resizeColumnsToContents(), sizeHintForColumn() et QHeaderView::resizeContentsPrecision().

[slot] void QTableView::resizeColumnsToContents()

Redimensionne toutes les colonnes en fonction des indications de taille fournies par le délégué utilisé pour afficher chaque élément dans les colonnes.

Voir également resizeColumnToContents(), sizeHintForColumn() et QHeaderView::resizeContentsPrecision().

[slot] void QTableView::resizeRowToContents(int row)

Redimensionne l'row spécifié en fonction des indications de taille fournies par le délégué utilisé pour afficher chaque élément de la ligne.

Voir également ` resizeRowsToContents()`, ` sizeHintForRow()` et ` QHeaderView::resizeContentsPrecision()`.

[slot] void QTableView::resizeRowsToContents()

Redimensionne toutes les lignes en fonction des indications de taille fournies par le délégué utilisé pour afficher chaque élément des lignes.

Voir également resizeRowToContents(), sizeHintForRow() et QHeaderView::resizeContentsPrecision().

int QTableView::rowAt(int y) const

Renvoie la ligne dans laquelle se trouve la coordonnée y donnée, y, dans les coordonnées du contenu.

Voir aussi columnAt().

[protected slot] void QTableView::rowCountChanged(int oldCount, int newCount)

Cette méthode est appelée chaque fois que des lignes sont ajoutées ou supprimées. Le nombre de lignes précédent est indiqué par ` oldCount`, et le nouveau nombre de lignes est indiqué par ` newCount`.

int QTableView::rowHeight(int row) const

Renvoie la hauteur de l'row donné.

Voir également setRowHeight(), resizeRowToContents() et columnWidth().

[protected slot] void QTableView::rowMoved(int row, int oldIndex, int newIndex)

Ce slot est appelé pour modifier l'index de l'row donné dans la vue de table. L'ancien index est spécifié par oldIndex, et le nouvel index par newIndex.

Voir également columnMoved().

[protected slot] void QTableView::rowResized(int row, int oldHeight, int newHeight)

Cette méthode est appelée pour modifier la hauteur de l'objet ` row` donné. L'ancienne hauteur est spécifiée par ` oldHeight`, et la nouvelle hauteur par ` newHeight`.

Voir également columnResized().

int QTableView::rowSpan(int row, int column) const

Renvoie le nombre de lignes couvertes par l'élément de tableau situé à l'adresse (row, column). La valeur par défaut est 1.

Voir également setSpan() et columnSpan().

int QTableView::rowViewportPosition(int row) const

Renvoie la coordonnée y, dans le système de coordonnées « contents », de l'row donné.

[override virtual protected] void QTableView::scrollContentsBy(int dx, int dy)

Réimplémente : QAbstractScrollArea::scrollContentsBy(int dx, int dy).

Faites défiler le contenu de la vue de table à l'aide de (dx, dy).

[override virtual] void QTableView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)

Réimplémente : QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint).

S'assure que l'index fourni est visible dans la vue de tableau, en effectuant un défilement si nécessaire.

[slot] void QTableView::selectColumn(int column)

Sélectionne l'column donnée dans la vue de tableau si le SelectionMode et le SelectionBehavior actuels autorisent la sélection de colonnes.

Voir également selectRow().

[slot] void QTableView::selectRow(int row)

Sélectionne l'row donnée dans la vue de table si le SelectionMode et le SelectionBehavior actuels autorisent la sélection de lignes.

Voir aussi selectColumn().

[override virtual protected] QModelIndexList QTableView::selectedIndexes() const

Réimplémente : QAbstractItemView::selectedIndexes() const.

[override virtual protected] void QTableView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

Réimplémente : QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected).

void QTableView::setColumnHidden(int column, bool hide)

Si hide est défini sur « true », l'column on indiquée sera masquée ; dans le cas contraire, elle sera affichée.

Voir également isColumnHidden() et setRowHidden().

void QTableView::setColumnWidth(int column, int width)

Définit la largeur de l'column on indiquée sur width.

Voir aussi columnWidth().

void QTableView::setHorizontalHeader(QHeaderView *header)

Définit le widget à utiliser pour l'en-tête horizontal sur header.

Voir également horizontalHeader() et setVerticalHeader().

[override virtual] void QTableView::setModel(QAbstractItemModel *model)

Réimplémente : QAbstractItemView::setModel(QAbstractItemModel *model).

[override virtual] void QTableView::setRootIndex(const QModelIndex &index)

Réimplémente : QAbstractItemView::setRootIndex(const QModelIndex &index).

void QTableView::setRowHeight(int row, int height)

Définit la hauteur de l'row ion indiquée sur height.

Voir aussi rowHeight().

void QTableView::setRowHidden(int row, bool hide)

Si la valeur de « hide » est « true », « row » sera masqué ; dans le cas contraire, il sera affiché.

Voir également isRowHidden() et setColumnHidden().

[override virtual protected] void QTableView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)

Réimplémente : QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags).

Sélectionne les éléments situés dans l'rect donné et conformément à l'flags de sélection spécifiée.

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

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

void QTableView::setSortingEnabled(bool enable)

Si la propriété « enable » est définie sur « true », le tri de la table est activé et la fonction « sortByColumn() » est immédiatement appelée avec la section de tri et l'ordre actuels

Voir également isSortingEnabled().

void QTableView::setSpan(int row, int column, int rowSpanCount, int columnSpanCount)

Définit l'étendue de l'élément de tableau (row, column) sur le nombre de lignes et de colonnes spécifié par (rowSpanCount, columnSpanCount).

Voir également rowSpan() et columnSpan().

void QTableView::setVerticalHeader(QHeaderView *header)

Définit le widget à utiliser pour l'en-tête vertical sur header.

Voir également verticalHeader() et setHorizontalHeader().

[slot] void QTableView::showColumn(int column)

Afficher l'column ion suivante : .

Voir également hideColumn() et showRow().

[slot] void QTableView::showRow(int row)

Afficher l'row on fournie.

Voir également hideRow() et showColumn().

[override virtual protected] int QTableView::sizeHintForColumn(int column) const

Réimplémente : QAbstractItemView::sizeHintForColumn(int column) const.

Renvoie l'indicateur de taille correspondant à la largeur de l'column donné, ou -1 s'il n'y a pas de modèle.

Si vous devez définir la largeur d’une colonne donnée sur une valeur fixe, appelez la fonction ` QHeaderView::resizeSection()` sur l’en-tête horizontal de la table.

Si vous réimplémentez cette fonction dans une sous-classe, notez que la valeur que vous renvoyez sera utilisée lorsque resizeColumnToContents() ou QHeaderView::resizeSections() sera appelée. Si une largeur de colonne supérieure est requise soit par l’en-tête horizontal, soit par le délégué d’élément, c’est cette largeur supérieure qui sera utilisée à la place.

Voir également QWidget::sizeHint, horizontalHeader() et QHeaderView::resizeContentsPrecision().

[override virtual protected] int QTableView::sizeHintForRow(int row) const

Réimplémente : QAbstractItemView::sizeHintForRow(int row) const.

Renvoie l’indication de taille pour la hauteur de l’ row donné, ou -1 s’il n’y a pas de modèle.

Si vous devez définir la hauteur d’une ligne donnée sur une valeur fixe, appelez la fonction ` QHeaderView::resizeSection()` sur l’en-tête verticale de la table.

Si vous réimplémentez cette fonction dans une sous-classe, notez que la valeur que vous renvoyez n’est utilisée que lorsque ` resizeRowToContents()` est appelée. Dans ce cas, si une hauteur de ligne supérieure est requise soit par l’en-tête verticale, soit par le délégué d’élément, c’est cette largeur qui sera utilisée à la place.

Voir également QWidget::sizeHint, verticalHeader() et QHeaderView::resizeContentsPrecision().

[slot] void QTableView::sortByColumn(int column, Qt::SortOrder order)

Trie le modèle en fonction des valeurs contenues dans les paramètres ` column ` et ` order`.

column Peut prendre la valeur -1 ; dans ce cas, aucun indicateur de tri ne s’affichera et le modèle reprendra son ordre naturel, non trié. Notez que tous les modèles ne prennent pas en charge cette fonctionnalité et peuvent même se bloquer dans ce cas.

Voir également sortingEnabled.

[override virtual protected] void QTableView::timerEvent(QTimerEvent *event)

Réimplémente : QAbstractItemView::timerEvent(QTimerEvent *event).

[override virtual protected] void QTableView::updateGeometries()

Réimplémente : QAbstractItemView::updateGeometries().

QHeaderView *QTableView::verticalHeader() const

Renvoie l'en-tête vertical de la vue de table.

Voir également setVerticalHeader(), horizontalHeader() et QAbstractItemModel::headerData().

[override virtual protected] int QTableView::verticalOffset() const

Réimplémente : QAbstractItemView::verticalOffset() const.

Renvoie le décalage vertical des éléments dans la vue de table.

Notez que la vue de table utilise les positions verticales de la section d'en-tête pour déterminer les positions des lignes dans la vue.

Voir également horizontalOffset().

[override virtual protected] QSize QTableView::viewportSizeHint() const

Réimplémente : QAbstractItemView::viewportSizeHint() const.

[override virtual] QRect QTableView::visualRect(const QModelIndex &index) const

Réimplémente : ` QAbstractItemView::visualRect(const QModelIndex &index) const`.

Renvoie le rectangle occupé dans la fenêtre d'affichage par l'index donné. Si l'index est masqué dans la vue, la fonction renvoie un QRect nul.

[override virtual protected] QRegion QTableView::visualRegionForSelection(const QItemSelection &selection) const

Réimplémente : ` QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const`.

Renvoie le rectangle correspondant à la fenêtre d'affichage des éléments de l'selection donné.

Depuis la version 4.7, la région renvoyée ne contient que les rectangles qui coupent (ou sont inclus dans) la fenêtre d'affichage.