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

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