QColumnView Class
The QColumnView class provides a model/view implementation of a column view. More...
Header: | #include <QColumnView> |
qmake: | QT += widgets |
Since: | Qt 4.3 |
Inherits: | QAbstractItemView |
Properties
- resizeGripsVisible : bool
- 16 properties inherited from QAbstractItemView
- 3 properties inherited from QAbstractScrollArea
- 6 properties inherited from QFrame
- 59 properties inherited from QWidget
- 1 property inherited from QObject
Public Functions
QColumnView(QWidget *parent = nullptr) | |
virtual | ~QColumnView() |
QList<int> | columnWidths() const |
QWidget * | previewWidget() const |
bool | resizeGripsVisible() const |
void | setColumnWidths(const QList<int> &list) |
void | setPreviewWidget(QWidget *widget) |
void | setResizeGripsVisible(bool visible) |
Reimplemented Public Functions
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 |
- 60 public functions inherited from QAbstractItemView
- 20 public functions inherited from QAbstractScrollArea
- 14 public functions inherited from QFrame
- 214 public functions inherited from QWidget
- 31 public functions inherited from QObject
- 14 public functions inherited from QPaintDevice
Signals
void | updatePreviewWidget(const QModelIndex &index) |
- 7 signals inherited from QAbstractItemView
- 3 signals inherited from QWidget
- 2 signals inherited from QObject
Static Public Members
const QMetaObject | staticMetaObject |
Protected Functions
virtual QAbstractItemView * | createColumn(const QModelIndex &index) |
void | initializeColumn(QAbstractItemView *column) const |
Reimplemented Protected Functions
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 |
- 38 protected functions inherited from QAbstractItemView
- 20 protected functions inherited from QAbstractScrollArea
- 4 protected functions inherited from QFrame
- 35 protected functions inherited from QWidget
- 9 protected functions inherited from QObject
- 1 protected function inherited from QPaintDevice
Additional Inherited Members
- 9 public slots inherited from QAbstractItemView
- 19 public slots inherited from QWidget
- 1 public slot inherited from QObject
- 9 protected slots inherited from QAbstractItemView
- 1 protected slot inherited from QWidget
Detailed Description
The QColumnView class provides a model/view implementation of a column view.
QColumnView displays a model in a number of QListViews, one for each hierarchy in the tree. This is sometimes referred to as a cascading list.
The QColumnView class is one of the Model/View Classes and is part of Qt's model/view framework.
QColumnView implements the interfaces defined by the QAbstractItemView class to allow it to display data provided by models derived from the QAbstractItemModel class.
See also Model/View Programming.
Property Documentation
resizeGripsVisible : bool
This property holds the way to specify if the list views gets resize grips or not
By default, visible
is set to true
Access functions:
bool | resizeGripsVisible() const |
void | setResizeGripsVisible(bool visible) |
See also setRootIndex().
Member Function Documentation
QColumnView::QColumnView(QWidget *parent = nullptr)
Constructs a column view with a parent to represent a model's data. Use setModel() to set the model.
See also QAbstractItemModel.
[virtual]
QColumnView::~QColumnView()
Destroys the column view.
QList<int> QColumnView::columnWidths() const
Returns a list of the width of all the columns in this view.
See also setColumnWidths().
[virtual protected]
QAbstractItemView *QColumnView::createColumn(const QModelIndex &index)
To use a custom widget for the final column when you select an item overload this function and return a widget. index is the root index that will be assigned to the view.
Return the new view. QColumnView will automatically take ownership of the widget.
See also setPreviewWidget().
[override virtual protected]
void QColumnView::currentChanged(const QModelIndex ¤t, const QModelIndex &previous)
Reimplemented from QAbstractItemView::currentChanged().
[override virtual protected]
int QColumnView::horizontalOffset() const
Reimplemented from QAbstractItemView::horizontalOffset().
[override virtual]
QModelIndex QColumnView::indexAt(const QPoint &point) const
Reimplemented from QAbstractItemView::indexAt().
[protected]
void QColumnView::initializeColumn(QAbstractItemView *column) const
Copies the behavior and options of the column view and applies them to the column such as the iconSize(), textElideMode() and alternatingRowColors(). This can be useful when reimplementing createColumn().
This function was introduced in Qt 4.4.
See also createColumn().
[override virtual protected]
bool QColumnView::isIndexHidden(const QModelIndex &index) const
Reimplemented from QAbstractItemView::isIndexHidden().
[override virtual protected]
QModelIndex QColumnView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)
Reimplemented from QAbstractItemView::moveCursor().
Move left should go to the parent index Move right should go to the child index or down if there is no child
QWidget *QColumnView::previewWidget() const
Returns the preview widget, or 0 if there is none.
See also setPreviewWidget() and updatePreviewWidget().
[override virtual protected]
void QColumnView::resizeEvent(QResizeEvent *event)
Reimplemented from QAbstractItemView::resizeEvent().
[override virtual protected]
void QColumnView::rowsInserted(const QModelIndex &parent, int start, int end)
Reimplemented from QAbstractItemView::rowsInserted().
[override virtual protected]
void QColumnView::scrollContentsBy(int dx, int dy)
Reimplemented from QAbstractScrollArea::scrollContentsBy().
[override virtual]
void QColumnView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)
Reimplemented from QAbstractItemView::scrollTo().
[override virtual]
void QColumnView::selectAll()
Reimplemented from QAbstractItemView::selectAll().
void QColumnView::setColumnWidths(const QList<int> &list)
Sets the column widths to the values given in the list. Extra values in the list are kept and used when the columns are created.
If list contains too few values, only width of the rest of the columns will not be modified.
See also columnWidths() and createColumn().
[override virtual]
void QColumnView::setModel(QAbstractItemModel *model)
Reimplemented from QAbstractItemView::setModel().
void QColumnView::setPreviewWidget(QWidget *widget)
Sets the preview widget.
The widget becomes a child of the column view, and will be destroyed when the column area is deleted or when a new widget is set.
See also previewWidget() and updatePreviewWidget().
[override virtual]
void QColumnView::setRootIndex(const QModelIndex &index)
Reimplemented from QAbstractItemView::setRootIndex().
[override virtual protected]
void QColumnView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command)
Reimplemented from QAbstractItemView::setSelection().
[override virtual]
void QColumnView::setSelectionModel(QItemSelectionModel *newSelectionModel)
Reimplemented from QAbstractItemView::setSelectionModel().
[override virtual]
QSize QColumnView::sizeHint() const
Reimplemented from QAbstractScrollArea::sizeHint().
[signal]
void QColumnView::updatePreviewWidget(const QModelIndex &index)
This signal is emitted when the preview widget should be updated to provide rich information about index
See also previewWidget().
[override virtual protected]
int QColumnView::verticalOffset() const
Reimplemented from QAbstractItemView::verticalOffset().
[override virtual]
QRect QColumnView::visualRect(const QModelIndex &index) const
Reimplemented from QAbstractItemView::visualRect().
[override virtual protected]
QRegion QColumnView::visualRegionForSelection(const QItemSelection &selection) const
Reimplemented from QAbstractItemView::visualRegionForSelection().
© 2019 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.