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
(since 6.11)previewColumnVisible : bool- resizeGripsVisible : bool
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 ¤t, 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 `.

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 ¤t, const QModelIndex &previous)
Réimplémente : QAbstractItemView::currentChanged(const QModelIndex ¤t, 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.