En esta página

QColumnView Class

La clase QColumnView ofrece una implementación del modelo/vista de una vista en columnas. Más información...

Encabezado: #include <QColumnView>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QAbstractItemView

Propiedades

Funciones públicas

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)

Funciones públicas reimplementadas

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

Señales

void updatePreviewWidget(const QModelIndex &index)

Funciones protegidas

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

Funciones protegidas reimplementadas

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

Descripción detallada

QColumnView muestra un modelo en varias QListViews, una por cada jerarquía del árbol. A veces se denomina «lista en cascada».

La clase QColumnView es una de las clases de modelo/vista y forma parte del marco de trabajo de modelo/vista de Qt.

QColumnView implementa las interfaces definidas por la clase ` QAbstractItemView ` para permitirle mostrar datos proporcionados por modelos derivados de la clase ` QAbstractItemModel `.

Información de direcciones en una vista de columna

Véase también Programación Modelo/Vista.

Documentación de propiedades

[since 6.11] previewColumnVisible : bool

Esta propiedad determina si la columna de vista previa está visible

Por defecto, « visible » está establecido en «true»

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

bool isPreviewColumnVisible() const
void setPreviewColumnVisible(bool visible)

resizeGripsVisible : bool

Esta propiedad permite especificar si las vistas de lista tienen controles de redimensionamiento o no

Por defecto, « visible » está establecido en «true»

Funciones de acceso:

bool resizeGripsVisible() const
void setResizeGripsVisible(bool visible)

Véase también setRootIndex().

Documentación de funciones de miembro

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

Crea una vista de columna con un objeto ` parent ` para representar los datos de un modelo. Utiliza ` setModel()` para establecer el modelo.

Véase también QAbstractItemModel.

[virtual noexcept] QColumnView::~QColumnView()

Elimina la vista en columnas.

QList<int> QColumnView::columnWidths() const

Devuelve una lista con el ancho de todas las columnas de esta vista.

Véase también setColumnWidths().

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

Para utilizar un widget personalizado en la última columna al seleccionar un elemento, sobrescribe esta función y devuelve un widget. ` index ` es el índice raíz que se asignará a la vista.

Devuelve la nueva vista. QColumnView asumirá automáticamente la propiedad del widget.

Véase también setPreviewWidget().

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

Reimplementa: QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous).

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

Reimplementa: QAbstractItemView::horizontalOffset() const.

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

Reimplementa: QAbstractItemView::indexAt(const QPoint &point) const.

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

Copia el comportamiento y las opciones de la vista de columna y las aplica a la vista de fila ( column ), como por ejemplo « iconSize()», « textElideMode()» y « alternatingRowColors()». Esto puede resultar útil a la hora de reimplementar « createColumn()».

Véase también createColumn().

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

Reimplementa: ` QAbstractItemView::isIndexHidden(const QModelIndex &index) const`.

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

Reimplementa: ` QAbstractItemView::moveCursor` (`QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers`).

«Mover a la izquierda» debería ir al índice padre; «Mover a la derecha» debería ir al índice hijo o hacia abajo si no hay ningún hijo.

QWidget *QColumnView::previewWidget() const

Devuelve el widget de vista previa o, si no hay ninguno, ` nullptr `.

Véase también setPreviewWidget() y updatePreviewWidget().

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

Reimplementa: QAbstractItemView::resizeEvent(QResizeEvent *event).

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

Reimplementa: QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end).

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

Reimplementa: QAbstractScrollArea::scrollContentsBy(int dx, int dy).

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

Reimplementa: QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint).

[override virtual] void QColumnView::selectAll()

Reimplementa: QAbstractItemView::selectAll().

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

Establece el ancho de las columnas según los valores indicados en list. Los valores adicionales de la lista se conservan y se utilizan al crear las columnas.

Si la lista contiene muy pocos valores, solo el ancho del resto de las columnas no se modificará.

Véase también columnWidths() y createColumn().

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

Reimplementa: ` QAbstractItemView::setModel(QAbstractItemModel *model)`.

void QColumnView::setPreviewWidget(QWidget *widget)

Establece el widget de vista previa ` widget`.

El widget pasa a ser un elemento secundario de la vista de columna y se eliminará cuando se elimine el área de columna o cuando se establezca un nuevo widget.

Véase también ` previewWidget()` y ` updatePreviewWidget()`.

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

Reimplementa: ` QAbstractItemView::setRootIndex(const QModelIndex &index)`.

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

Reimplementa: QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags).

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

Reimplementa: QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel).

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

Reimplementa: ` QAbstractScrollArea::sizeHint()` const.

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

Esta señal se emite cuando el widget de vista previa debe actualizarse para proporcionar información detallada sobre index

Véase también previewWidget().

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

Reimplementa: ` QAbstractItemView::verticalOffset()` const.

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

Reimplementa: ` QAbstractItemView::visualRect(const QModelIndex &index) const`.

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

Reimplementa: ` 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.