Sur cette page

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

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 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.

Informations sur l'adresse dans une colonne

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 &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 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.