QTableView Class

Documentation des fonctions membres

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

Construit une vue de table avec un parent pour représenter les données.

Voir également QAbstractItemModel.

[virtual noexcept] QTableView::~QTableView()

Détruit la vue du tableau.

void QTableView::clearSpans()

Supprime toutes les travées de lignes et de colonnes dans la vue du tableau.

Voir également setSpan().

int QTableView::columnAt(int x) const

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

Voir également rowAt().

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

Ce slot est appelé chaque fois que des colonnes sont ajoutées ou supprimées. Le nombre précédent de colonnes 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'adresse column donnée dans la vue du tableau. L'ancien index est spécifié par oldIndex, et le nouvel index par newIndex.

Voir aussi rowMoved().

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

Ce slot est appelé pour modifier la largeur de la page column. L'ancienne largeur est spécifiée par oldWidth, et la nouvelle par newWidth.

Voir aussi rowResized().

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

Renvoie l'étendue de la colonne de l'élément de tableau à (row, column). La valeur par défaut est 1.

Voir aussi setSpan() et rowSpan().

int QTableView::columnViewportPosition(int column) const

Renvoie la coordonnée x en coordonnées de contenu de l'adresse column.

int QTableView::columnWidth(int column) const

Renvoie la largeur de l'image donnée column.

Voir aussi 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)

Cache le site column.

Voir aussi showColumn() et hideRow().

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

Cache le site row.

Voir aussi showRow() et hideColumn().

QHeaderView *QTableView::horizontalHeader() const

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

Voir aussi 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 tableau.

Notez que la vue 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 la position d'index de l'élément de modèle correspondant à l'élément de tableau à la position pos en coordonnées de 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 le site column est caché ; 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 le site row est caché ; 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'action donnée cursorAction, en utilisant les informations fournies par modifiers.

Voir également QAbstractItemView::CursorAction.

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

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

Peint la table à la réception de l'événement de peinture donné event.

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

Redimensionne le site column en fonction des indices de taille du délégué utilisé pour rendre chaque élément de la colonne.

Voir aussi resizeColumnsToContents(), sizeHintForColumn(), et QHeaderView::resizeContentsPrecision().

[slot] void QTableView::resizeColumnsToContents()

Redimensionne toutes les colonnes en fonction des indices de taille du délégué utilisé pour rendre chaque élément dans les colonnes.

Voir aussi resizeColumnToContents(), sizeHintForColumn(), et QHeaderView::resizeContentsPrecision().

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

Redimensionne le site row en fonction des indices de taille du délégué utilisé pour rendre chaque élément de la ligne.

Voir aussi resizeRowsToContents(), sizeHintForRow(), et QHeaderView::resizeContentsPrecision().

[slot] void QTableView::resizeRowsToContents()

Redimensionne toutes les lignes en fonction des indices de taille du délégué utilisé pour rendre chaque élément des lignes.

Voir aussi 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, en coordonnées de contenu.

Voir également columnAt().

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

Ce slot est appelé chaque fois que des lignes sont ajoutées ou supprimées. Le nombre précédent de lignes est spécifié par oldCount, et le nouveau nombre de lignes est spécifié par newCount.

int QTableView::rowHeight(int row) const

Renvoie la hauteur de l'image donnée row.

Voir aussi 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'adresse row donnée dans la vue du tableau. L'ancien index est spécifié par oldIndex, et le nouvel index par newIndex.

Voir aussi columnMoved().

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

Ce slot est appelé pour modifier la hauteur de la page row. L'ancienne hauteur est spécifiée par oldHeight, et la nouvelle par newHeight.

Voir aussi columnResized().

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

Renvoie l'interligne de l'élément de tableau à (row, column). La valeur par défaut est 1.

Voir aussi setSpan() et columnSpan().

int QTableView::rowViewportPosition(int row) const

Renvoie la coordonnée y en coordonnées de contenu de l'adresse row.

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

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

Fait défiler le contenu de la vue en tableau par (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'adresse index est visible dans la vue de la table, en la faisant défiler si nécessaire.

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

Sélectionne l'adresse column dans la vue du tableau si le SelectionMode et le SelectionBehavior actuels permettent de sélectionner des colonnes.

Voir également selectRow().

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

Sélectionne l'adresse row dans la vue du tableau si le SelectionMode et le SelectionBehavior actuels permettent de sélectionner des lignes.

Voir également 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 vrai, la page column sera cachée, sinon elle sera affichée.

Voir aussi isColumnHidden() et setRowHidden().

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

Définit la largeur de la page column donnée comme étant width.

Voir aussi columnWidth().

void QTableView::setHorizontalHeader(QHeaderView *header)

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

Voir aussi 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 la page row donnée comme étant height.

Voir aussi rowHeight().

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

Si hide est vrai, row sera caché, sinon il sera affiché.

Voir aussi 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 à l'intérieur du site rect et conformément à la sélection spécifiée flags.

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

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

void QTableView::setSortingEnabled(bool enable)

Si enable est vrai, le tri est activé pour le tableau et un appel à sortByColumn() est immédiatement déclenché avec la section et l'ordre de tri actuels.

Voir également isSortingEnabled().

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

Définit l'étendue de l'élément table à (row, column) au 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 à header.

Voir aussi verticalHeader() et setHorizontalHeader().

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

Montrez le site column.

Voir aussi hideColumn() et showRow().

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

Montrez le site row.

Voir aussi hideRow() et showColumn().

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

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

Renvoie l'indice de taille pour la largeur de la colonne donnée column ou -1 s'il n'y a pas de modèle.

Si vous devez fixer la largeur d'une colonne donnée à une valeur fixe, appelez QHeaderView::resizeSection() sur l'en-tête horizontal du tableau.

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é. Si une largeur de colonne plus importante est requise par l'en-tête horizontal ou le délégué de l'élément, la largeur la plus importante sera utilisée à la place.

Voir aussi 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'indice de taille pour la hauteur donnée row ou -1 s'il n'y a pas de modèle.

Si vous devez fixer la hauteur d'une ligne donnée à une valeur fixe, appelez QHeaderView::resizeSection() sur l'en-tête vertical du tableau.

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é. Dans ce cas, si une hauteur de ligne plus importante est requise par l'en-tête vertical ou le délégué de l'élément, cette largeur 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 indiquées dans column et order.

column peut être -1, auquel cas aucun indicateur de tri ne sera affiché et le modèle reprendra son ordre naturel, non trié. Notez que tous les modèles ne supportent pas cela et peuvent même se planter 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 tableau.

Voir aussi 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 tableau.

Notez que la vue tableau 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 de la fenêtre de visualisation occupé par l'index donné index. Si l'index est caché dans la vue, il renverra une valeur nulle QRect.

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

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

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

Depuis la version 4.7, la région renvoyée ne contient que les rectangles intersectant (ou inclus dans) la fenêtre.