Sur cette page

QColumnView Class

La classe QColumnView propose une implémentation « modèle-vue » d'une vue en colonnes. En savoir plus...

En-tête : #include <QColumnView>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Hérite de : QAbstractItemView

Propriétés

Fonctions publiques

QColumnView(QWidget *parent = nullptr)
virtual ~QColumnView()
QList<int> columnWidths() const
bool isPreviewColumnVisible() const
QWidget *previewWidget() const
bool resizeGripsVisible() const
void setColumnWidths(const QList<int> &list)
void setPreviewColumnVisible(bool visible)
void setPreviewWidget(QWidget *widget)
void setResizeGripsVisible(bool visible)

Fonctions publiques réimplémentées

virtual QModelIndex indexAt(const QPoint &point) const override
virtual void scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible) override
virtual void selectAll() override
virtual void setModel(QAbstractItemModel *model) override
virtual void setRootIndex(const QModelIndex &index) override
virtual void setSelectionModel(QItemSelectionModel *newSelectionModel) override
virtual QSize sizeHint() const override
virtual QRect visualRect(const QModelIndex &index) const override

Signaux

void updatePreviewWidget(const QModelIndex &index)

Fonctions protégées

virtual QAbstractItemView *createColumn(const QModelIndex &index)
void initializeColumn(QAbstractItemView *column) const

Fonctions protégées réimplémentées

virtual void currentChanged(const QModelIndex &current, const QModelIndex &previous) override
virtual int horizontalOffset() const override
virtual bool isIndexHidden(const QModelIndex &index) const override
virtual QModelIndex moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers) override
virtual void resizeEvent(QResizeEvent *event) override
virtual void rowsInserted(const QModelIndex &parent, int start, int end) override
virtual void scrollContentsBy(int dx, int dy) override
virtual void setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command) override
virtual int verticalOffset() const override
virtual QRegion visualRegionForSelection(const QItemSelection &selection) const override

Description détaillée

QColumnView affiche un modèle dans plusieurs QListViews, une pour chaque hiérarchie de l'arborescence. On parle parfois de « liste en cascade ».

La classe QColumnView fait partie des classes Modèle/Vue et s'inscrit dans le cadre de travail Modèle/Vue de Qt.

QColumnView implémente les interfaces définies par la classe ` QAbstractItemView ` afin de pouvoir afficher les données fournies par les modèles dérivés de la classe ` QAbstractItemModel `.

Informations d'adresse dans une vue en colonnes

Voir également Programmation Modèle/Vue.

Documentation sur les propriétés

[since 6.11] previewColumnVisible : bool

Cette propriété détermine si la colonne d'aperçu est visible

Par défaut, la valeur de « visible » est définie sur « true »

Cette énumération a été introduite dans Qt 6.11.

Fonctions d'accès :

bool isPreviewColumnVisible() const
void setPreviewColumnVisible(bool visible)

resizeGripsVisible : bool

Cette propriété permet de définir si les vues de liste doivent comporter des poignées de redimensionnement ou non

Par défaut, la propriété « visible » est définie sur « true »

Fonctions d'accès :

bool resizeGripsVisible() const
void setResizeGripsVisible(bool visible)

Voir également setRootIndex().

Documentation des fonctions membres

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

Crée une vue de colonne avec une instance de ` parent ` pour représenter les données d'un modèle. Utilisez ` setModel()` pour définir le modèle.

Voir également QAbstractItemModel.

[virtual noexcept] QColumnView::~QColumnView()

Supprime l'affichage en colonnes.

QList<int> QColumnView::columnWidths() const

Renvoie une liste indiquant la largeur de toutes les colonnes de cette vue.

Voir aussi setColumnWidths().

[virtual protected] QAbstractItemView *QColumnView::createColumn(const QModelIndex &index)

Pour utiliser un widget personnalisé dans la dernière colonne lorsque vous sélectionnez un élément, redéfinissez cette fonction et renvoyez un widget. ` index ` est l'index racine qui sera attribué à la vue.

Renvoie la nouvelle vue. ` QColumnView ` prendra automatiquement possession du widget.

Voir également setPreviewWidget().

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

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

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

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

[override virtual] QModelIndex QColumnView::indexAt(const QPoint &point) const

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

[protected] void QColumnView::initializeColumn(QAbstractItemView *column) const

Copie le comportement et les options de la vue « colonne » et les applique aux méthodes « column », telles que ` iconSize()`, ` textElideMode()` et ` alternatingRowColors()`. Cela peut s'avérer utile lors de la réimplémentation de ` createColumn()`.

Voir également createColumn().

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

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

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

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

Le déplacement vers la gauche doit mener à l’index parent ; le déplacement vers la droite doit mener à l’index enfant ou vers le bas s’il n’y a pas d’enfant.

QWidget *QColumnView::previewWidget() const

Renvoie le widget d'aperçu, ou ` nullptr ` s'il n'y en a pas.

Voir également setPreviewWidget() et updatePreviewWidget().

[override virtual protected] void QColumnView::resizeEvent(QResizeEvent *event)

Réimplémente : QAbstractItemView::resizeEvent(QResizeEvent *event).

[override virtual protected] void QColumnView::rowsInserted(const QModelIndex &parent, int start, int end)

Réimplémente : QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end).

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

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

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

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

[override virtual] void QColumnView::selectAll()

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

void QColumnView::setColumnWidths(const QList<int> &list)

Définit la largeur des colonnes selon les valeurs indiquées dans la liste « list ». Les valeurs supplémentaires présentes dans la liste sont conservées et utilisées lors de la création des colonnes.

Si la liste contient trop peu de valeurs, seules les largeurs des colonnes restantes ne seront pas modifiées.

Voir également columnWidths() et createColumn().

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

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

void QColumnView::setPreviewWidget(QWidget *widget)

Définit l'widget d'aperçu.

L'widget devient un enfant de la vue de colonne et sera détruit lorsque la zone de colonne sera supprimée ou lorsqu'un nouveau widget sera défini.

Voir également ` previewWidget()` et ` updatePreviewWidget()`.

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

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

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

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

[override virtual] void QColumnView::setSelectionModel(QItemSelectionModel *newSelectionModel)

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

[override virtual] QSize QColumnView::sizeHint() const

Réimplémente : QAbstractScrollArea::sizeHint() const.

[signal] void QColumnView::updatePreviewWidget(const QModelIndex &index)

Ce signal est émis lorsque le widget de prévisualisation doit être mis à jour afin de fournir des informations détaillées sur index

Voir également previewWidget().

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

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

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

Réimplémentation de : QAbstractItemView::visualRect(const QModelIndex &index) const.

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

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

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.