# QColumnView Class Reference ## [[QtGui](index.htm) module] 該QColumnView類提供了一個模型/視圖實現列視圖中。[More...](#details) 繼承[QAbstractItemView](qabstractitemview.html)。 ### 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 該QColumnView類提供了一個模型/視圖實現列視圖中。 QColumnView在一些QListViews ，一個用于在該樹中的每個層次的顯示一個模型。這有時被稱為級聯列表。 該QColumnView類是一個[Model/View Classes](index.htm)并且是Qt的一部分[model/view framework](index.htm)。 QColumnView實現由定義的接口[QAbstractItemView](qabstractitemview.html)類以允許其顯示由從派生模型提供數據[QAbstractItemModel](qabstractitemmodel.html)類。  * * * ## Method Documentation ``` QColumnView.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個列視圖_parent_來表示模型的數據。使用[setModel](qcolumnview.html#setModel)（）來設定模型。 **See also** [QAbstractItemModel](qabstractitemmodel.html)。 ``` list-of-int QColumnView.columnWidths (self) ``` 返回此視圖中的所有列的寬度的列表。 **See also** [setColumnWidths](qcolumnview.html#setColumnWidths)（ ） 。 ``` QAbstractItemView QColumnView.createColumn (self, QModelIndex?rootIndex) ``` [ 要使用自定義部件的最后一列，當你選擇一個項目超負荷此功能，并返回一個widget 。_index_是將被分配到該視圖的根索引。 ](qabstractitemview.html) [返回新的觀點。](qabstractitemview.html)[QColumnView](qcolumnview.html)便會自動將窗口小部件的所有權。 **See also** [setPreviewWidget](qcolumnview.html#setPreviewWidget)（ ） 。 ``` QColumnView.currentChanged (self, QModelIndex?current, QModelIndex?previous) ``` 這種方法也是一個Qt槽與C + +的簽名`void currentChanged(const QModelIndex&,const QModelIndex&)`。 從重新實現[QAbstractItemView.currentChanged](qabstractitemview.html#currentChanged)（ ） 。 ``` int QColumnView.horizontalOffset (self) ``` 從重新實現[QAbstractItemView.horizontalOffset](qabstractitemview.html#horizontalOffset)（ ） 。 ``` QModelIndex QColumnView.indexAt (self, QPoint?point) ``` [](qmodelindex.html) [從重新實現](qmodelindex.html)[QAbstractItemView.indexAt](qabstractitemview.html#indexAt)（ ） 。 ``` QColumnView.initializeColumn (self, QAbstractItemView?column) ``` 復制列視圖的行為和選擇，并將它們應用到_column_如[iconSize](qabstractitemview.html#iconSize-prop)（ ）[textElideMode](qabstractitemview.html#textElideMode-prop)（）和[alternatingRowColors](qabstractitemview.html#alternatingRowColors-prop)（ ） 。重新實現時，這可能是有用的[createColumn](qcolumnview.html#createColumn)（ ） 。 此功能被引入Qt的4.4 。 **See also** [createColumn](qcolumnview.html#createColumn)（ ） 。 ``` bool QColumnView.isIndexHidden (self, QModelIndex?index) ``` 從重新實現[QAbstractItemView.isIndexHidden](qabstractitemview.html#isIndexHidden)（ ） 。 ``` QModelIndex QColumnView.moveCursor (self, QAbstractItemView.CursorAction?cursorAction, Qt.KeyboardModifiers?modifiers) ``` [](qmodelindex.html) [從重新實現](qmodelindex.html)[QAbstractItemView.moveCursor](qabstractitemview.html#moveCursor)（ ） 。 向左移動應該去主指數向右移動應該去子索引或下降，如果沒有孩子 ``` QWidget QColumnView.previewWidget (self) ``` [ 返回預覽窗口小部件，或者0，如果是沒有的。 ](qwidget.html) [**See also**](qwidget.html) [setPreviewWidget](qcolumnview.html#setPreviewWidget)（）和[updatePreviewWidget](qcolumnview.html#updatePreviewWidget)（ ） 。 ``` QColumnView.resizeEvent (self, QResizeEvent?event) ``` 從重新實現[QWidget.resizeEvent](qwidget.html#resizeEvent)（ ） 。 ``` bool QColumnView.resizeGripsVisible (self) ``` ``` QColumnView.rowsInserted (self, QModelIndex?parent, int?start, int?end) ``` 從重新實現[QAbstractItemView.rowsInserted](qabstractitemview.html#rowsInserted)（ ） 。 ``` QColumnView.scrollContentsBy (self, int?dx, int?dy) ``` 從重新實現[QAbstractScrollArea.scrollContentsBy](qabstractscrollarea.html#scrollContentsBy)（ ） 。 ``` QColumnView.scrollTo (self, QModelIndex?index, QAbstractItemView.ScrollHint?hint?=?QAbstractItemView.EnsureVisible) ``` 從重新實現[QAbstractItemView.scrollTo](qabstractitemview.html#scrollTo)（ ） 。 ``` QColumnView.selectAll (self) ``` 從重新實現[QAbstractItemView.selectAll](qabstractitemview.html#selectAll)（ ） 。 ``` QColumnView.setColumnWidths (self, list-of-int?list) ``` 列寬設置為在給定的值_list_。在列表中多馀的值會保持不變，在創建列時使用。 如果列表中包含的值太少，只有寬度的列的其馀部分將不會被修改。 **See also** [columnWidths](qcolumnview.html#columnWidths)（）和[createColumn](qcolumnview.html#createColumn)（ ） 。 ``` QColumnView.setModel (self, QAbstractItemModel?model) ``` 從重新實現[QAbstractItemView.setModel](qabstractitemview.html#setModel)（ ） 。 ``` QColumnView.setPreviewWidget (self, QWidget?widget) ``` 該_widget_說法有它的所有權轉移給Qt的。 設置預覽_widget_。 該_widget_成為列視圖的孩子，當列區域被刪除或者當一個新的widget設定將被破壞。 **See also** [previewWidget](qcolumnview.html#previewWidget)（）和[updatePreviewWidget](qcolumnview.html#updatePreviewWidget)（ ） 。 ``` QColumnView.setResizeGripsVisible (self, bool?visible) ``` ``` QColumnView.setRootIndex (self, QModelIndex?index) ``` 從重新實現[QAbstractItemView.setRootIndex](qabstractitemview.html#setRootIndex)（ ） 。 ``` QColumnView.setSelection (self, QRect?rect, QItemSelectionModel.SelectionFlags?command) ``` 從重新實現[QAbstractItemView.setSelection](qabstractitemview.html#setSelection)（ ） 。 ``` QColumnView.setSelectionModel (self, QItemSelectionModel?selectionModel) ``` 從重新實現[QAbstractItemView.setSelectionModel](qabstractitemview.html#setSelectionModel)（ ） 。 ``` QSize QColumnView.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（ ） 。 ``` int QColumnView.verticalOffset (self) ``` 從重新實現[QAbstractItemView.verticalOffset](qabstractitemview.html#verticalOffset)（ ） 。 ``` QRect QColumnView.visualRect (self, QModelIndex?index) ``` [](qrect.html) [從重新實現](qrect.html)[QAbstractItemView.visualRect](qabstractitemview.html#visualRect)（ ） 。 ``` QRegion QColumnView.visualRegionForSelection (self, QItemSelection?selection) ``` [](qregion.html) [從重新實現](qregion.html)[QAbstractItemView.visualRegionForSelection](qabstractitemview.html#visualRegionForSelection)（ ） 。 * * * ## Qt Signal Documentation ``` void updatePreviewWidget (const QModelIndex&) ``` 這是該信號的默認超載。 這個信號被發射時，預覽窗口小部件應進行更新，以提供有關致富信息_index_ **See also** [previewWidget](qcolumnview.html#previewWidget)（ ） 。