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

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