QColumnView Class
La classe QColumnView fournit une implémentation modèle/vue d'une vue en colonnes. Plus d'informations...
| En-tête : | #include <QColumnView> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Héritages : | 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 un certain nombre de QListViews, un pour chaque hiérarchie de l'arbre. On parle parfois de liste en cascade.
La classe QColumnView est l'une des classes Modèle/Vue et fait partie du cadre Modèle/Vue de Qt.
QColumnView implémente les interfaces définies par la classe QAbstractItemView pour lui permettre d'afficher les données fournies par les modèles dérivés de la classe QAbstractItemModel.

Voir aussi Programmation Modèle/Vue.
Documentation sur les propriétés
[since 6.11] previewColumnVisible : bool
Cette propriété indique si la colonne de prévisualisation est visible
Par défaut, visible a la valeur true (vrai)
Cette propriété 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 spécifier si les vues en liste bénéficient ou non de poignées de redimensionnement
Par défaut, visible est défini sur true (vrai)
Fonctions d'accès :
| bool | resizeGripsVisible() const |
| void | setResizeGripsVisible(bool visible) |
Voir également setRootIndex().
Documentation des fonctions membres
[explicit] QColumnView::QColumnView(QWidget *parent = nullptr)
Construit une vue en colonnes avec parent pour représenter les données d'un modèle. Utilisez setModel() pour définir le modèle.
Voir aussi QAbstractItemModel.
[virtual noexcept] QColumnView::~QColumnView()
Détruit la vue de la colonne.
QList<int> QColumnView::columnWidths() const
Renvoie une liste de 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é pour la dernière colonne lorsque vous sélectionnez un élément, surchargez cette fonction et renvoyez un widget. index est l'index racine qui sera attribué à la vue.
Renvoyez la nouvelle vue. QColumnView prendra automatiquement possession du widget.
Voir aussi 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 en colonnes et les applique à column comme iconSize(), textElideMode() et alternatingRowColors(). Cela peut être utile lors de la réimplémentation de createColumn().
Voir aussi 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).
Déplacer vers la gauche doit aller à l'index parent Déplacer vers la droite doit aller à l'index enfant ou vers le bas s'il n'y a pas d'enfant
QWidget *QColumnView::previewWidget() const
Renvoie le widget de prévisualisation, ou nullptr s'il n'y en a pas.
Voir aussi 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émente : 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)
Fixe la largeur des colonnes aux valeurs indiquées dans le fichier list. Les valeurs supplémentaires de la liste sont conservées et utilisées lors de la création des colonnes.
Si la liste contient trop peu de valeurs, seule la largeur des autres colonnes ne sera pas modifiée.
Voir aussi 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'aperçu widget.
Le site widget devient un enfant de la vue en colonnes et sera détruit lorsque la zone de colonnes 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émente : 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 riches sur le contenu de la page. index
Voir aussi 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émente : 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.