Qt Reference Documentation

QColumnView Class Reference

The QColumnView class provides a model/view implementation of a column view. More...

 #include <QColumnView>

Inherits: QAbstractItemView.

This class was introduced in Qt 4.3.

Properties

Public Functions

QColumnView ( QWidget * parent = 0 )
~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
virtual void scrollTo ( const QModelIndex & index, ScrollHint hint = EnsureVisible )
virtual void selectAll ()
virtual void setModel ( QAbstractItemModel * model )
virtual void setRootIndex ( const QModelIndex & index )
virtual void setSelectionModel ( QItemSelectionModel * newSelectionModel )
virtual QSize sizeHint () const
virtual QRect visualRect ( const QModelIndex & index ) const

Signals

void updatePreviewWidget ( const QModelIndex & index )

Protected Functions

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

Reimplemented Protected Functions

virtual void currentChanged ( const QModelIndex & current, const QModelIndex & previous )
virtual int horizontalOffset () const
virtual bool isIndexHidden ( const QModelIndex & index ) const
virtual QModelIndex moveCursor ( CursorAction cursorAction, Qt::KeyboardModifiers modifiers )
virtual void resizeEvent ( QResizeEvent * event )
virtual void rowsInserted ( const QModelIndex & parent, int start, int end )
virtual void scrollContentsBy ( int dx, int dy )
virtual void setSelection ( const QRect & rect, QItemSelectionModel::SelectionFlags command )
virtual int verticalOffset () const
virtual QRegion visualRegionForSelection ( const QItemSelection & selection ) const

Additional Inherited Members

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 = 0 )

Constructs a column view with a parent to represent a model's data. Use setModel() to set the model.

See also QAbstractItemModel.

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

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

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

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

Reimplemented from QAbstractItemView::currentChanged().

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

Reimplemented from QAbstractItemView::horizontalOffset().

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

Reimplemented from QAbstractItemView::indexAt().

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

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

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

Reimplemented from QAbstractItemView::isIndexHidden().

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

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

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

Reimplemented from QWidget::resizeEvent().

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

Reimplemented from QAbstractItemView::rowsInserted().

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

Reimplemented from QAbstractScrollArea::scrollContentsBy().

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

Reimplemented from QAbstractItemView::scrollTo().

void QColumnView::selectAll () [virtual]

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

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

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

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

Reimplemented from QAbstractItemView::setRootIndex().

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

Reimplemented from QAbstractItemView::setSelection().

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

Reimplemented from QAbstractItemView::setSelectionModel().

QSize QColumnView::sizeHint () const [virtual]

Reimplemented from QWidget::sizeHint().

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

This signal is emitted when the preview widget should be updated to provide rich information about index

See also previewWidget().

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

Reimplemented from QAbstractItemView::verticalOffset().

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

Reimplemented from QAbstractItemView::visualRect().

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

Reimplemented from QAbstractItemView::visualRegionForSelection().