En esta página

QColumnView Class

La clase QColumnView proporciona una implementación modelo/vista de una vista de columna. Más...

Cabecera: #include <QColumnView>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Hereda: 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 un número de QListViews, uno por cada jerarquía en el árbol. A veces se denomina lista en cascada.

La clase QColumnView es una de las Clases Modelo/Vista y forma parte del framework 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 columnas

Ver también Programación Modelo/Vista.

Documentación de Propiedades

[since 6.11] previewColumnVisible : bool

Esta propiedad indica si la columna de vista previa es visible

Por defecto, visible es true

Esta propiedad 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 se redimensionan o no.

Por defecto, visible está establecido a true

Funciones de acceso:

bool resizeGripsVisible() const
void setResizeGripsVisible(bool visible)

Véase también setRootIndex().

Documentación de las funciones miembro

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

Construye una vista de columna con un parent para representar los datos de un modelo. Utilice setModel() para establecer el modelo.

Véase también QAbstractItemModel.

[virtual noexcept] QColumnView::~QColumnView()

Destruye la vista de columna.

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 para la columna final cuando se selecciona un elemento sobrecarga esta función y devuelve un widget. index es el índice raíz que se asignará a la vista.

Devuelve la nueva vista. QColumnView tomará 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 los aplica a column como iconSize(), textElideMode() y alternatingRowColors(). Esto puede ser útil al 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 modificadores).

Mover a la izquierda debe ir al índice padre Mover a la derecha debe ir al índice hijo o hacia abajo si no hay hijo

QWidget *QColumnView::previewWidget() const

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

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 inicio, int fin).

[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 a los valores dados en list. Los valores extra en la lista se mantienen y se utilizan cuando se crean las columnas.

Si la lista contiene pocos valores, sólo se modificará el ancho del resto de las columnas.

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 la vista previa widget.

El widget se convierte en un hijo de la vista de columna, y se destruirá 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 enriquecida 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.