|  | Home · All Classes · Modules

# QColumnView Class Reference
[QtGui module]

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

Inherits QAbstractItemView.

### Methods

- __init__ (self, QWidget parent = None)
- list-of-int columnWidths (self)
- QAbstractItemView createColumn (self, QModelIndex rootIndex)
- currentChanged (self, QModelIndex current, QModelIndex previous)
- int horizontalOffset (self)
- QModelIndex indexAt (self, QPoint point)
- initializeColumn (self, QAbstractItemView column)
- bool isIndexHidden (self, QModelIndex index)
- QModelIndex moveCursor (self, QAbstractItemView.CursorAction cursorAction, Qt.KeyboardModifiers modifiers)
- QWidget previewWidget (self)
- resizeEvent (self, QResizeEvent event)
- bool resizeGripsVisible (self)
- rowsInserted (self, QModelIndex parent, int start, int end)
- scrollContentsBy (self, int dx, int dy)
- scrollTo (self, QModelIndex index, QAbstractItemView.ScrollHint hint = QAbstractItemView.EnsureVisible)
- selectAll (self)
- setColumnWidths (self, list-of-int list)
- setModel (self, QAbstractItemModel model)
- setPreviewWidget (self, QWidget widget)
- setResizeGripsVisible (self, bool visible)
- setRootIndex (self, QModelIndex index)
- setSelection (self, QRect rect, QItemSelectionModel.SelectionFlags command)
- setSelectionModel (self, QItemSelectionModel selectionModel)
- QSize sizeHint (self)
- int verticalOffset (self)
- QRect visualRect (self, QModelIndex index)
- QRegion visualRegionForSelection (self, QItemSelection selection)

### Qt Signals

- void updatePreviewWidget (const QModelIndex&)

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

## Method Documentation

### QColumnView.__init__ (self, QWidget parent = None)

The parent argument, if not None, causes self to be owned by Qt instead of PyQt.

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

See also QAbstractItemModel.

### list-of-int QColumnView.columnWidths (self)

Returns a list of the width of all the columns in this view.

See also setColumnWidths().

### QAbstractItemView QColumnView.createColumn (self, QModelIndex rootIndex)

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

### QColumnView.currentChanged (self, QModelIndex current, QModelIndex previous)

This method is also a Qt slot with the C++ signature `void currentChanged(const QModelIndex&,const QModelIndex&)`.

Reimplemented from QAbstractItemView.currentChanged().

### int QColumnView.horizontalOffset (self)

Reimplemented from QAbstractItemView.horizontalOffset().

### QModelIndex QColumnView.indexAt (self, QPoint point)

Reimplemented from QAbstractItemView.indexAt().

### QColumnView.initializeColumn (self, QAbstractItemView column)

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 (self, QModelIndex index)

Reimplemented from QAbstractItemView.isIndexHidden().

### QModelIndex QColumnView.moveCursor (self, 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 (self)

Returns the preview widget, or 0 if there is none.

See also setPreviewWidget() and updatePreviewWidget().

### QColumnView.resizeEvent (self, QResizeEvent event)

Reimplemented from QWidget.resizeEvent().

### bool QColumnView.resizeGripsVisible (self)

### QColumnView.rowsInserted (self, QModelIndex parent, int start, int end)

Reimplemented from QAbstractItemView.rowsInserted().

### QColumnView.scrollContentsBy (self, int dx, int dy)

Reimplemented from QAbstractScrollArea.scrollContentsBy().

### QColumnView.scrollTo (self, QModelIndex index, QAbstractItemView.ScrollHint hint = QAbstractItemView.EnsureVisible)

Reimplemented from QAbstractItemView.scrollTo().

### QColumnView.selectAll (self)

Reimplemented from QAbstractItemView.selectAll().

### QColumnView.setColumnWidths (self, list-of-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().

### QColumnView.setModel (self, QAbstractItemModel model)

Reimplemented from QAbstractItemView.setModel().

### QColumnView.setPreviewWidget (self, QWidget widget)

The widget argument has it's ownership transferred to Qt.

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

### QColumnView.setResizeGripsVisible (self, bool visible)

### QColumnView.setRootIndex (self, QModelIndex index)

Reimplemented from QAbstractItemView.setRootIndex().

### QColumnView.setSelection (self, QRect rect, QItemSelectionModel.SelectionFlags command)

Reimplemented from QAbstractItemView.setSelection().

### QColumnView.setSelectionModel (self, QItemSelectionModel selectionModel)

Reimplemented from QAbstractItemView.setSelectionModel().

### QSize QColumnView.sizeHint (self)

Reimplemented from QWidget.sizeHint().

### int QColumnView.verticalOffset (self)

Reimplemented from QAbstractItemView.verticalOffset().

### QRect QColumnView.visualRect (self, QModelIndex index)

Reimplemented from QAbstractItemView.visualRect().

### QRegion QColumnView.visualRegionForSelection (self, QItemSelection selection)

Reimplemented from QAbstractItemView.visualRegionForSelection().

## Qt Signal Documentation

### void updatePreviewWidget (const QModelIndex&)

This is the default overload of this signal.

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

See also previewWidget().