QAbstractItemView Class Reference · PyQt4 中文文檔

# QAbstractItemView Class Reference ## [[QtGui](index.htm) module] 該QAbstractItemView類為項目視圖類的基本功能。[More...](#details) 繼承[QAbstractScrollArea](qabstractscrollarea.html)。通過繼承[QColumnView](qcolumnview.html)，[QHeaderView](qheaderview.html)，[QListView](qlistview.html)，[QTableView](qtableview.html)和[QTreeView](qtreeview.html)。 ### Types * `enum CursorAction { MoveUp, MoveDown, MoveLeft, MoveRight, ..., MovePrevious }` * `enum DragDropMode { NoDragDrop, DragOnly, DropOnly, DragDrop, InternalMove }` * `enum DropIndicatorPosition { OnItem, AboveItem, BelowItem, OnViewport }` * `enum EditTrigger { NoEditTriggers, CurrentChanged, DoubleClicked, SelectedClicked, ..., AllEditTriggers }` * `class **[EditTriggers](index.htm)**` * `enum ScrollHint { EnsureVisible, PositionAtTop, PositionAtBottom, PositionAtCenter }` * `enum ScrollMode { ScrollPerItem, ScrollPerPixel }` * `enum SelectionBehavior { SelectItems, SelectRows, SelectColumns }` * `enum SelectionMode { NoSelection, SingleSelection, MultiSelection, ExtendedSelection, ContiguousSelection }` * `enum State { NoState, DraggingState, DragSelectingState, EditingState, ..., AnimatingState }` ### Methods * `__init__ (self, QWidget?parent?=?None)` * `bool alternatingRowColors (self)` * `int autoScrollMargin (self)` * `clearSelection (self)` * `closeEditor (self, QWidget?editor, QAbstractItemDelegate.EndEditHint?hint)` * `closePersistentEditor (self, QModelIndex?index)` * `commitData (self, QWidget?editor)` * `currentChanged (self, QModelIndex?current, QModelIndex?previous)` * `QModelIndex currentIndex (self)` * `dataChanged (self, QModelIndex?topLeft, QModelIndex?bottomRight)` * `Qt.DropAction defaultDropAction (self)` * `QPoint dirtyRegionOffset (self)` * `DragDropMode dragDropMode (self)` * `bool dragDropOverwriteMode (self)` * `bool dragEnabled (self)` * `dragEnterEvent (self, QDragEnterEvent?e)` * `dragLeaveEvent (self, QDragLeaveEvent?e)` * `dragMoveEvent (self, QDragMoveEvent?e)` * `dropEvent (self, QDropEvent?e)` * `DropIndicatorPosition dropIndicatorPosition (self)` * `edit (self, QModelIndex?index)` * `bool edit (self, QModelIndex?index, EditTrigger?trigger, QEvent?event)` * `editorDestroyed (self, QObject?editor)` * `EditTriggers editTriggers (self)` * `bool event (self, QEvent?event)` * `executeDelayedItemsLayout (self)` * `focusInEvent (self, QFocusEvent?e)` * `bool focusNextPrevChild (self, bool?next)` * `focusOutEvent (self, QFocusEvent?e)` * `bool hasAutoScroll (self)` * `int horizontalOffset (self)` * `horizontalScrollbarAction (self, int?action)` * `horizontalScrollbarValueChanged (self, int?value)` * `ScrollMode horizontalScrollMode (self)` * `int horizontalStepsPerItem (self)` * `QSize iconSize (self)` * `QModelIndex indexAt (self, QPoint?p)` * `QWidget indexWidget (self, QModelIndex?index)` * `inputMethodEvent (self, QInputMethodEvent?event)` * `QVariant inputMethodQuery (self, Qt.InputMethodQuery?query)` * `bool isIndexHidden (self, QModelIndex?index)` * `QAbstractItemDelegate itemDelegate (self)` * `QAbstractItemDelegate itemDelegate (self, QModelIndex?index)` * `QAbstractItemDelegate itemDelegateForColumn (self, int?column)` * `QAbstractItemDelegate itemDelegateForRow (self, int?row)` * `keyboardSearch (self, QString?search)` * `keyPressEvent (self, QKeyEvent?e)` * `QAbstractItemModel model (self)` * `mouseDoubleClickEvent (self, QMouseEvent?e)` * `mouseMoveEvent (self, QMouseEvent?e)` * `mousePressEvent (self, QMouseEvent?e)` * `mouseReleaseEvent (self, QMouseEvent?e)` * `QModelIndex moveCursor (self, CursorAction?cursorAction, Qt.KeyboardModifiers?modifiers)` * `openPersistentEditor (self, QModelIndex?index)` * `reset (self)` * `resizeEvent (self, QResizeEvent?e)` * `QModelIndex rootIndex (self)` * `rowsAboutToBeRemoved (self, QModelIndex?parent, int?start, int?end)` * `rowsInserted (self, QModelIndex?parent, int?start, int?end)` * `scheduleDelayedItemsLayout (self)` * `scrollDirtyRegion (self, int?dx, int?dy)` * `scrollTo (self, QModelIndex?index, ScrollHint?hint?=?QAbstractItemView.EnsureVisible)` * `scrollToBottom (self)` * `scrollToTop (self)` * `selectAll (self)` * `list-of-QModelIndex selectedIndexes (self)` * `SelectionBehavior selectionBehavior (self)` * `selectionChanged (self, QItemSelection?selected, QItemSelection?deselected)` * `QItemSelectionModel.SelectionFlags selectionCommand (self, QModelIndex?index, QEvent?event?=?None)` * `SelectionMode selectionMode (self)` * `QItemSelectionModel selectionModel (self)` * `setAlternatingRowColors (self, bool?enable)` * `setAutoScroll (self, bool?enable)` * `setAutoScrollMargin (self, int?margin)` * `setCurrentIndex (self, QModelIndex?index)` * `setDefaultDropAction (self, Qt.DropAction?dropAction)` * `setDirtyRegion (self, QRegion?region)` * `setDragDropMode (self, DragDropMode?behavior)` * `setDragDropOverwriteMode (self, bool?overwrite)` * `setDragEnabled (self, bool?enable)` * `setDropIndicatorShown (self, bool?enable)` * `setEditTriggers (self, EditTriggers?triggers)` * `setHorizontalScrollMode (self, ScrollMode?mode)` * `setHorizontalStepsPerItem (self, int?steps)` * `setIconSize (self, QSize?size)` * `setIndexWidget (self, QModelIndex?index, QWidget?widget)` * `setItemDelegate (self, QAbstractItemDelegate?delegate)` * `setItemDelegateForColumn (self, int?column, QAbstractItemDelegate?delegate)` * `setItemDelegateForRow (self, int?row, QAbstractItemDelegate?delegate)` * `setModel (self, QAbstractItemModel?model)` * `setRootIndex (self, QModelIndex?index)` * `setSelection (self, QRect?rect, QItemSelectionModel.SelectionFlags?command)` * `setSelectionBehavior (self, SelectionBehavior?behavior)` * `setSelectionMode (self, SelectionMode?mode)` * `setSelectionModel (self, QItemSelectionModel?selectionModel)` * `setState (self, State?state)` * `setTabKeyNavigation (self, bool?enable)` * `setTextElideMode (self, Qt.TextElideMode?mode)` * `setVerticalScrollMode (self, ScrollMode?mode)` * `setVerticalStepsPerItem (self, int?steps)` * `bool showDropIndicator (self)` * `int sizeHintForColumn (self, int?column)` * `QSize sizeHintForIndex (self, QModelIndex?index)` * `int sizeHintForRow (self, int?row)` * `startDrag (self, Qt.DropActions?supportedActions)` * `State state (self)` * `bool tabKeyNavigation (self)` * `Qt.TextElideMode textElideMode (self)` * `timerEvent (self, QTimerEvent?e)` * `update (self)` * `update (self, QModelIndex?index)` * `updateEditorData (self)` * `updateEditorGeometries (self)` * `updateGeometries (self)` * `int verticalOffset (self)` * `verticalScrollbarAction (self, int?action)` * `verticalScrollbarValueChanged (self, int?value)` * `ScrollMode verticalScrollMode (self)` * `int verticalStepsPerItem (self)` * `QStyleOptionViewItem viewOptions (self)` * `bool viewportEvent (self, QEvent?e)` * `QRect visualRect (self, QModelIndex?index)` * `QRegion visualRegionForSelection (self, QItemSelection?selection)` ### Qt Signals * `void activated (const QModelIndex&)` * `void clicked (const QModelIndex&)` * `void doubleClicked (const QModelIndex&)` * `void entered (const QModelIndex&)` * `void pressed (const QModelIndex&)` * `void viewportEntered ()` * * * ## Detailed Description 該QAbstractItemView類為項目視圖類的基本功能。 QAbstractItemView類是使用每個標準視圖的基類[QAbstractItemModel](qabstractitemmodel.html)。 QAbstractItemView是一個抽象類，本身不能被實例化。它提供了通過信號和槽機制與模型進行交互操作，使子類必須跟上最新的變化，以他們的模型的標準接口。這個類提供了用于鍵盤和鼠標導航，視口滾動，項目編輯和選擇標準的支持。鍵盤導航實現了這個功能： | Keys | Functionality | | --- | --- | | Arrow keys | Changes the current item and selects it. | | Ctrl+Arrow keys | Changes the current item but does not select it. | | Shift+Arrow keys | Changes the current item and selects it. The previously selected item(s) is not deselected. | | Ctr+Space | Toggles selection of the current item. | | Tab/Backtab | Changes the current item to the next/previous item. | | Home/End | Selects the first/last item in the model. | | Page up/Page down | Scrolls the rows shown up/down by the number of visible rows in the view. | | Ctrl+A | Selects all items in the model. | 注意，上述表假設[selection mode](qabstractitemview.html#selectionMode-prop)允許的操作。例如，你不能選擇項目，如果選擇模式為[QAbstractItemView.NoSelection](qabstractitemview.html#SelectionMode-enum)。該QAbstractItemView類是一個[Model/View Classes](index.htm)并且是Qt的一部分[model/view framework](index.htm)。繼承QAbstractItemView的視圖類只需要實現自己的看法特定的功能，如繪圖項目，返回項目的幾何形狀，尋找項目，等等。 QAbstractItemView提供通用的插槽，如[edit](qabstractitemview.html#edit)（）和[setCurrentIndex](qabstractitemview.html#setCurrentIndex)（）。還提供了許多保護的時隙，包括[dataChanged](qabstractitemview.html#dataChanged)（）[rowsInserted](qabstractitemview.html#rowsInserted)（）[rowsAboutToBeRemoved](qabstractitemview.html#rowsAboutToBeRemoved)（）[selectionChanged](qabstractitemview.html#selectionChanged)（）和[currentChanged](qabstractitemview.html#currentChanged)（）。根項目是由返回[rootIndex](qabstractitemview.html#rootIndex)（），并且通過當前項目[currentIndex](qabstractitemview.html#currentIndex)（）。為了確保一個項目是可見的使用[scrollTo](qabstractitemview.html#scrollTo)（）。一些QAbstractItemView的功能所關心的滾動，例如[setHorizontalScrollMode](qabstractitemview.html#horizontalScrollMode-prop)（）和[setVerticalScrollMode](qabstractitemview.html#verticalScrollMode-prop)（）。要設置滾動條的范圍內，你可以，例如，重新實現視圖的[resizeEvent](qabstractitemview.html#resizeEvent)（）函數： ``` void MyView.resizeEvent([QResizeEvent](qresizeevent.html) *event) { horizontalScrollBar()->setRange(0, realWidth - width()); ... } ``` 請注意，該區域未更新，直到小部件顯示。其他一些功能所關心的選擇控制，例如[setSelectionMode](qabstractitemview.html#selectionMode-prop)（）和[setSelectionBehavior](qabstractitemview.html#selectionBehavior-prop)（）。這個類提供了一個默認的選擇模型一起工作（[selectionModel](qabstractitemview.html#selectionModel)（）），但是這可以通過使用代替[setSelectionModel](qabstractitemview.html#setSelectionModel)（）與實例[QItemSelectionModel](qitemselectionmodel.html)。有關完整的控制項的顯示和編輯您可以指定一個委讬[setItemDelegate](qabstractitemview.html#setItemDelegate)（）。 QAbstractItemView提供了很多保護功能。一些所關注的編輯，例如，[edit](qabstractitemview.html#edit)（）和[commitData](qabstractitemview.html#commitData)（），而有些則是鍵盤和鼠標的事件處理程序。 **Note:**如果你繼承QAbstractItemView并打算更新視口的內容，你應該使用視口 - \u003e[update](qabstractitemview.html#update)（）而不是[update()](qwidget.html#update)因為所有的繪畫操作需要視口的地方。 * * * ## Type Documentation ``` QAbstractItemView.CursorAction ``` 這個枚舉變量描述的不同方法的項目之間導航， | Constant | Value | Description | | --- | --- | --- | | `QAbstractItemView.MoveUp` | `0` | 移動到高于目前項目的項目。 | | `QAbstractItemView.MoveDown` | `1` | 移動到低于當前項目的項目。 | | `QAbstractItemView.MoveLeft` | `2` | 移動到當前項目的左邊的項目。 | | `QAbstractItemView.MoveRight` | `3` | 移動到當前項目的項目的權利。 | | `QAbstractItemView.MoveHome` | `4` | 移動到左上角的項目。 | | `QAbstractItemView.MoveEnd` | `5` | 移動到右下角項目。 | | `QAbstractItemView.MovePageUp` | `6` | 移動一頁了高于目前的項目。 | | `QAbstractItemView.MovePageDown` | `7` | 移動一頁向下跌破目前的項目。 | | `QAbstractItemView.MoveNext` | `8` | 目前項目后移至該項目。 | | `QAbstractItemView.MovePrevious` | `9` | 移動到該項目目前的項目之前。 | **See also** [moveCursor](qabstractitemview.html#moveCursor)（）。 ``` QAbstractItemView.DragDropMode ``` 介紹了各種拖放事件的視圖可以進行操作。默認情況下，視圖不支持拖動或下降（`NoDragDrop`）。 | Constant | Value | Description | | --- | --- | --- | | `QAbstractItemView.NoDragDrop` | `0` | 不支持拖放或刪除。 | | `QAbstractItemView.DragOnly` | `1` | 該視圖支持自己的物品拖動 | | `QAbstractItemView.DropOnly` | `2` | 該視圖接受滴 | | `QAbstractItemView.DragDrop` | `3` | 該視圖支持拖放 | | `QAbstractItemView.InternalMove` | `4` | 認為接受移動（**not copy**）只能從本身的操作。 | 請注意，該模式使用需求，提供拖放操作的支持。這個枚舉被引入或修改的Qt 4.2 。 **See also** [setDragDropMode](qabstractitemview.html#dragDropMode-prop)（）和[Using drag and drop with item views](index.htm#using-drag-and-drop-with-item-views)。 ``` QAbstractItemView.DropIndicatorPosition ``` 這個枚舉表示有關該指數的下降指標在當前鼠標位置的位置： | Constant | Value | Description | | --- | --- | --- | | `QAbstractItemView.OnItem` | `0` | 該項目將在指數下跌。 | | `QAbstractItemView.AboveItem` | `1` | 該項目將索引上面被丟棄。 | | `QAbstractItemView.BelowItem` | `2` | 該項目將被丟棄指數下方。 | | `QAbstractItemView.OnViewport` | `3` | 該項目將被丟棄到視口的區域，沒有項目。每個視圖處理項目拖放到視口的方式取決于所使用的底層模型的行為。 | ``` QAbstractItemView.EditTrigger ``` 這個枚舉變量描述了將啟動項目編輯操作。 | Constant | Value | Description | | --- | --- | --- | | `QAbstractItemView.NoEditTriggers` | `0` | 沒有編輯成為可能。 | | `QAbstractItemView.CurrentChanged` | `1` | 編輯啟動時電流項的變化。 | | `QAbstractItemView.DoubleClicked` | `2` | 編輯開始當一個項目被雙擊。 | | `QAbstractItemView.SelectedClicked` | `4` | 編輯在已經選定的項目時，點擊開始。 | | `QAbstractItemView.EditKeyPressed` | `8` | 當平臺的編輯鍵被按下了某個項目開始編輯。 | | `QAbstractItemView.AnyKeyPressed` | `16` | 當任何鍵被按下了某個項目開始編輯。 | | `QAbstractItemView.AllEditTriggers` | `31` | 編輯開始對所有上述行動。 | 該EditTriggers類型是一個typedef為[QFlags](index.htm)\u003cEditTrigger\u003e 。它存儲EditTrigger值的或組合。 ``` QAbstractItemView.ScrollHint ``` | Constant | Value | Description | | --- | --- | --- | | `QAbstractItemView.EnsureVisible` | `0` | 滾動，以確保該項目是可見的。 | | `QAbstractItemView.PositionAtTop` | `1` | 滾動的視口的頂部位置的項目。 | | `QAbstractItemView.PositionAtBottom` | `2` | 滾動的視口的底部位置的項目。 | | `QAbstractItemView.PositionAtCenter` | `3` | 滾動的視口的中心位置的項目。 | ``` QAbstractItemView.ScrollMode ``` | Constant | Value | Description | | --- | --- | --- | | `QAbstractItemView.ScrollPerItem` | `0` | 該視圖會滾動的內容一個項目的時間。 | | `QAbstractItemView.ScrollPerPixel` | `1` | 該視圖會滾動的內容一個像素的時間。 | 這個枚舉被引入或修改的Qt 4.2 。 ``` QAbstractItemView.SelectionBehavior ``` | Constant | Value | Description | | --- | --- | --- | | `QAbstractItemView.SelectItems` | `0` | 選擇單個項目。 | | `QAbstractItemView.SelectRows` | `1` | 只選擇行。 | | `QAbstractItemView.SelectColumns` | `2` | 只選擇列。 | ``` QAbstractItemView.SelectionMode ``` 這個枚舉表示視圖如何響應用戶的選擇： | Constant | Value | Description | | --- | --- | --- | | `QAbstractItemView.SingleSelection` | `1` | 當用戶選擇一個項目，任何已選定的項目變成未選中，并單擊其上的用戶無法取消選擇所選的項目。 | | `QAbstractItemView.ContiguousSelection` | `4` | 當用戶以通常的方式選擇一個項目時，該選擇被清除，新的項目中選定。但是，如果用戶按下Shift鍵的同時單擊某個項目，目前的項目和被點擊的項目之間的所有項目都選擇或取消選擇，這取決于單擊項的狀態。 | | `QAbstractItemView.ExtendedSelection` | `3` | 當用戶以通常的方式選擇一個項目時，該選擇被清除，新的項目中選定。但是，如果用戶對某個項目時，點擊按下Ctrl鍵，單擊該項目被觸發，其他所有項均保持不變。如果用戶按下Shift鍵的同時單擊某個項目，目前的項目和被點擊的項目之間的所有項目都選擇或取消選擇，這取決于單擊項的狀態。多個項目可以通過拖動鼠標在他們被選中。 | | `QAbstractItemView.MultiSelection` | `2` | 當用戶在通常的方式選擇一個項目，該項目的選擇狀態翻轉，其他項目都單獨留在家中。多個項目可以通過拖動鼠標在他們進行切換。 | | `QAbstractItemView.NoSelection` | `0` | 項目無法選擇。 | 最常用的方式是SingleSelection和ExtendedSelection 。 ``` QAbstractItemView.State ``` 描述了不同狀態下的視圖可以是英寸重新實現自己的看法時，這通常是只有趣。 | Constant | Value | Description | | --- | --- | --- | | `QAbstractItemView.NoState` | `0` | 的是默認狀態。 | | `QAbstractItemView.DraggingState` | `1` | 用戶拖動項目。 | | `QAbstractItemView.DragSelectingState` | `2` | 該用戶選擇項目的操作。 | | `QAbstractItemView.EditingState` | `3` | 用戶正在編輯一個項目中一個小部件的編輯器。 | | `QAbstractItemView.ExpandingState` | `4` | 用戶被打開的項目的一個分支。 | | `QAbstractItemView.CollapsingState` | `5` | 該用戶被關閉的項目的一個分支。 | | `QAbstractItemView.AnimatingState` | `6` | 項目視圖正在執行的動畫。 | * * * ## Method Documentation ``` QAbstractItemView.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個抽象的項目視圖與給定_parent_。 ``` bool QAbstractItemView.alternatingRowColors (self) ``` ``` int QAbstractItemView.autoScrollMargin (self) ``` ``` QAbstractItemView.clearSelection (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void clearSelection()`。取消選擇所有選定的項目。當前索引將不會被改變。 **See also** [setSelection](qabstractitemview.html#setSelection)（）和[selectAll](qabstractitemview.html#selectAll)（）。 ``` QAbstractItemView.closeEditor (self, QWidget?editor, QAbstractItemDelegate.EndEditHint?hint) ``` 這種方法也是一個Qt槽與C + +的簽名`void closeEditor(QWidget *,QAbstractItemDelegate::EndEditHint)`。關閉給定的_editor_，并釋放它。該_hint_用于指定視圖如何應于編輯操作結束時作出響應。例如，提示可能表明，在視圖中的下一個項目應該打開進行編輯。 **See also** [edit](qabstractitemview.html#edit)（）和[commitData](qabstractitemview.html#commitData)（）。 ``` QAbstractItemView.closePersistentEditor (self, QModelIndex?index) ``` 關閉持久編輯該項目在給定的_index_。 **See also** [openPersistentEditor](qabstractitemview.html#openPersistentEditor)（）。 ``` QAbstractItemView.commitData (self, QWidget?editor) ``` 這種方法也是一個Qt槽與C + +的簽名`void commitData(QWidget *)`。提交的資料_editor_到模型中。 **See also** [closeEditor](qabstractitemview.html#closeEditor)（）。 ``` QAbstractItemView.currentChanged (self, QModelIndex?current, QModelIndex?previous) ``` 這種方法也是一個Qt槽與C + +的簽名`void currentChanged(const QModelIndex&,const QModelIndex&)`。當一個新項目成為當前項目這個槽被調用。先前的目前的項目是由指定的_previous_指數，并且由新的項目_current_索引。如果您想了解變更的項目看[dataChanged](qabstractitemview.html#dataChanged)（）信號。 ``` QModelIndex QAbstractItemView.currentIndex (self) ``` [ 返回當前項的模型索引。 ](qmodelindex.html) [**See also**](qmodelindex.html) [setCurrentIndex](qabstractitemview.html#setCurrentIndex)（）。 ``` QAbstractItemView.dataChanged (self, QModelIndex?topLeft, QModelIndex?bottomRight) ``` 這種方法也是一個Qt槽與C + +的簽名`void dataChanged(const QModelIndex&,const QModelIndex&)`。這個槽被調用時，項目模型被改變。該變更的項目是那些從_topLeft_至_bottomRight_包容性。如果只有一個項目被改變_topLeft_==_bottomRight_。 ``` Qt.DropAction QAbstractItemView.defaultDropAction (self) ``` [](qt.html#DropAction-enum) ``` QPoint QAbstractItemView.dirtyRegionOffset (self) ``` [ 骯臟的地區，在視圖返回偏移量。 ](qpoint.html) [如果你使用](qpoint.html)[scrollDirtyRegion](qabstractitemview.html#scrollDirtyRegion)（）和實施[paintEvent](qabstractscrollarea.html#paintEvent)（）中的子類[QAbstractItemView](qabstractitemview.html)，你應該翻譯的Paint事件與此功能的偏移返回給定的區域。 **See also** [scrollDirtyRegion](qabstractitemview.html#scrollDirtyRegion)（）和[setDirtyRegion](qabstractitemview.html#setDirtyRegion)（）。 ``` DragDropMode QAbstractItemView.dragDropMode (self) ``` [ ``` bool QAbstractItemView.dragDropOverwriteMode (self) ``` ``` bool QAbstractItemView.dragEnabled (self) ``` ``` QAbstractItemView.dragEnterEvent (self, QDragEnterEvent?e) ``` ](qabstractitemview.html#DragDropMode-enum) [從重新實現](qabstractitemview.html#DragDropMode-enum)[QWidget.dragEnterEvent](qwidget.html#dragEnterEvent)（）。這個函數被調用給定的_event_當拖放操作進入小部件。如果拖動是在一個有效的滴地方（如在接受滴的項目），該事件被接受，否則它將被忽略。 **See also** [dropEvent](qabstractitemview.html#dropEvent)（）和[startDrag](qabstractitemview.html#startDrag)（）。 ``` QAbstractItemView.dragLeaveEvent (self, QDragLeaveEvent?e) ``` 從重新實現[QWidget.dragLeaveEvent](qwidget.html#dragLeaveEvent)（）。這個函數被調用時，被拖動的項葉的看法。該_event_介紹了拖放操作的狀態。 ``` QAbstractItemView.dragMoveEvent (self, QDragMoveEvent?e) ``` 從重新實現[QWidget.dragMoveEvent](qwidget.html#dragMoveEvent)（）。此功能是與給定的連續叫_event_一個拖放操作在小部件中。它可以使視圖的，舉個例子，用戶拖動鼠標選擇要查看的右側或底部邊緣滾動。在這種情況下，事件將被接受，否則將被忽略。 **See also** [dropEvent](qabstractitemview.html#dropEvent)（）和[startDrag](qabstractitemview.html#startDrag)（）。 ``` QAbstractItemView.dropEvent (self, QDropEvent?e) ``` 從重新實現[QWidget.dropEvent](qwidget.html#dropEvent)（）。這個函數被調用給定的_event_當一個放置事件發生在窗口小部件。如果模型接受甚至定位放置事件被接受，否則它將被忽略。 **See also** [startDrag](qabstractitemview.html#startDrag)（）。 ``` DropIndicatorPosition QAbstractItemView.dropIndicatorPosition (self) ``` [ 返回相對于最接近的項目拖放指示符的位置。這個函數是Qt 4.1中引入。 ``` QAbstractItemView.edit (self, QModelIndex?index) ``` 這種方法也是一個Qt槽與C + +的簽名`void edit(const QModelIndex&)`。開始編輯對應于給定的產品_index_如果是可編輯的。 ](qabstractitemview.html#DropIndicatorPosition-enum) [注意，這個函數不改變當前索引。由于目前指數定義了一個和以前的項目進行編輯，用戶可能會發現，由于預期鍵盤導航不起作用。為了提供一致的導航行為，請致電](qabstractitemview.html#DropIndicatorPosition-enum)[setCurrentIndex](qabstractitemview.html#setCurrentIndex)（）這個函數有相同的模型索引之前。 **See also** [QModelIndex.flags](qmodelindex.html#flags)（）。 ``` bool QAbstractItemView.edit (self, QModelIndex?index, EditTrigger?trigger, QEvent?event) ``` 開始編輯了該項目_index_，如果有必要創建一個編輯器，并返回True，如果該視圖的[State](qabstractitemview.html#State-enum)現在是[EditingState](qabstractitemview.html#State-enum)否則返回False 。導致該編輯過程中的作用通過描述_trigger_以及是由指定的相關聯的事件_event_。編輯可以通過指定強制的_trigger_要[QAbstractItemView.AllEditTriggers](qabstractitemview.html#EditTrigger-enum)。 **See also** [closeEditor](qabstractitemview.html#closeEditor)（）。 ``` QAbstractItemView.editorDestroyed (self, QObject?editor) ``` 這種方法也是一個Qt槽與C + +的簽名`void editorDestroyed(QObject *)`。這個函數被調用的時候給出_editor_已被摧毀。 **See also** [closeEditor](qabstractitemview.html#closeEditor)（）。 ``` EditTriggers QAbstractItemView.editTriggers (self) ``` [ ``` bool QAbstractItemView.event (self, QEvent?event) ``` ](index.htm) [從重新實現](index.htm)[QObject.event](qobject.html#event)（）。 ``` QAbstractItemView.executeDelayedItemsLayout (self) ``` 執行預定的布局，而無需等待該事件的處理開始。 **See also** [scheduleDelayedItemsLayout](qabstractitemview.html#scheduleDelayedItemsLayout)（）。 ``` QAbstractItemView.focusInEvent (self, QFocusEvent?e) ``` 從重新實現[QWidget.focusInEvent](qwidget.html#focusInEvent)（）。這個函數被調用給定的_event_當插件獲得焦點。默認情況下，事件被忽略。 **See also** [setFocus](qwidget.html#setFocus)（）和[focusOutEvent](qabstractitemview.html#focusOutEvent)（）。 ``` bool QAbstractItemView.focusNextPrevChild (self, bool?next) ``` 從重新實現[QWidget.focusNextPrevChild](qwidget.html#focusNextPrevChild)（）。 ``` QAbstractItemView.focusOutEvent (self, QFocusEvent?e) ``` 從重新實現[QWidget.focusOutEvent](qwidget.html#focusOutEvent)（）。這個函數被調用給定的_event_當小部件失去焦點。默認情況下，事件被忽略。 **See also** [clearFocus](qwidget.html#clearFocus)（）和[focusInEvent](qabstractitemview.html#focusInEvent)（）。 ``` bool QAbstractItemView.hasAutoScroll (self) ``` ``` int QAbstractItemView.horizontalOffset (self) ``` 這種方法是抽象的，應在任何子類中重新實現。返回水平視圖的偏移量。在基類中，這是一個純虛函數。 **See also** [verticalOffset](qabstractitemview.html#verticalOffset)（）。 ``` QAbstractItemView.horizontalScrollbarAction (self, int?action) ``` 這種方法也是一個Qt槽與C + +的簽名`void horizontalScrollbarAction(int)`。 ``` QAbstractItemView.horizontalScrollbarValueChanged (self, int?value) ``` 這種方法也是一個Qt槽與C + +的簽名`void horizontalScrollbarValueChanged(int)`。 ``` ScrollMode QAbstractItemView.horizontalScrollMode (self) ``` [ ``` int QAbstractItemView.horizontalStepsPerItem (self) ``` ](qabstractitemview.html#ScrollMode-enum) ``` QSize QAbstractItemView.iconSize (self) ``` [](qsize.html) ``` QModelIndex QAbstractItemView.indexAt (self, QPoint?p) ``` [ 這種方法是抽象的，應在任何子類中重新實現。返回項的模型索引處的視口坐標_point_。在基類中，這是一個純虛函數。 ](qmodelindex.html) [**See also**](qmodelindex.html) [visualRect](qabstractitemview.html#visualRect)（）。 ``` QWidget QAbstractItemView.indexWidget (self, QModelIndex?index) ``` [ 返回部件的項目在給定的_index_。這個函數是Qt 4.1中引入。 ](qwidget.html) [**See also**](qwidget.html) [setIndexWidget](qabstractitemview.html#setIndexWidget)（）。 ``` QAbstractItemView.inputMethodEvent (self, QInputMethodEvent?event) ``` 從重新實現[QWidget.inputMethodEvent](qwidget.html#inputMethodEvent)（）。 ``` QVariant QAbstractItemView.inputMethodQuery (self, Qt.InputMethodQuery?query) ``` 從重新實現[QWidget.inputMethodQuery](qwidget.html#inputMethodQuery)（）。 ``` bool QAbstractItemView.isIndexHidden (self, QModelIndex?index) ``` 這種方法是抽象的，應在任何子類中重新實現。返回True ，如果該項目由給定的簡稱_index_隱藏在視圖，否則返回False 。隱藏的是一個視圖特定的功能。例如在TableView中的列可以被標記為隱藏或行中的樹視圖。在基類中，這是一個純虛函數。 ``` QAbstractItemDelegate QAbstractItemView.itemDelegate (self) ``` [](qabstractitemdelegate.html) [返回此視圖和模型的項目委讬。這可能是一組與](qabstractitemdelegate.html)[setItemDelegate](qabstractitemview.html#setItemDelegate)（），或默認之一。 **See also** [setItemDelegate](qabstractitemview.html#setItemDelegate)（）。 ``` QAbstractItemDelegate QAbstractItemView.itemDelegate (self, QModelIndex?index) ``` [ 返回此視圖和模型對于給定的項目代表_index_。 ](qabstractitemdelegate.html) ``` QAbstractItemDelegate QAbstractItemView.itemDelegateForColumn (self, int?column) ``` [](qabstractitemdelegate.html) [返回此視圖和模型對于給定的項目代表_column_。您可以致電](qabstractitemdelegate.html)[itemDelegate](qabstractitemview.html#itemDelegate)（）來獲得一個指向當前委讬一個給定的索引。這個函數中引入了Qt 4.2中。 **See also** [setItemDelegateForColumn](qabstractitemview.html#setItemDelegateForColumn)（）[itemDelegateForRow](qabstractitemview.html#itemDelegateForRow)（）和[itemDelegate](qabstractitemview.html#itemDelegate)（）。 ``` QAbstractItemDelegate QAbstractItemView.itemDelegateForRow (self, int?row) ``` [](qabstractitemdelegate.html) [返回此視圖和模型對于給定的項目代表_row_，或者0 ，如果沒有委讬已分配。您可以致電](qabstractitemdelegate.html)[itemDelegate](qabstractitemview.html#itemDelegate)（）來獲得一個指向當前委讬一個給定的索引。這個函數中引入了Qt 4.2中。 **See also** [setItemDelegateForRow](qabstractitemview.html#setItemDelegateForRow)（）[itemDelegateForColumn](qabstractitemview.html#itemDelegateForColumn)（）和[setItemDelegate](qabstractitemview.html#setItemDelegate)（）。 ``` QAbstractItemView.keyboardSearch (self, QString?search) ``` 移動到并選擇最好的項目相匹配的字符串_search_。如果沒有項目被發現沒有任何反應。在默認實現中，搜索是復位，如果_search_是空的，或時間間隔上次的搜索已經超過[QApplication.keyboardInputInterval](qapplication.html#keyboardInputInterval-prop)（）。 ``` QAbstractItemView.keyPressEvent (self, QKeyEvent?e) ``` 從重新實現[QWidget.keyPressEvent](qwidget.html#keyPressEvent)（）。這個函數被調用給定的_event_當一個鍵事件被發送給窗口小部件。默認實現處理基本的光標移動，如上，下，左，右，首頁，上一頁，和PageDown ;的[activated](qabstractitemview.html#activated)如果當前索引有效和激活鍵被按下（例如Enter鍵或Return ，取決于平臺）（）信號被發射。這個功能就是編輯是由按鍵啟動，如如果F2被按下。 **See also** [edit](qabstractitemview.html#edit)（）[moveCursor](qabstractitemview.html#moveCursor)（）[keyboardSearch](qabstractitemview.html#keyboardSearch)（）和[tabKeyNavigation](qabstractitemview.html#tabKeyNavigation-prop)。 ``` QAbstractItemModel QAbstractItemView.model (self) ``` [ 返回該視圖呈現模式。 ](qabstractitemmodel.html) [**See also**](qabstractitemmodel.html) [setModel](qabstractitemview.html#setModel)（）。 ``` QAbstractItemView.mouseDoubleClickEvent (self, QMouseEvent?e) ``` 從重新實現[QWidget.mouseDoubleClickEvent](qwidget.html#mouseDoubleClickEvent)（）。這個函數被調用給定的_event_當鼠標按鈕被雙擊的widget內點擊。如果雙擊是一個有效的項目它發出的[doubleClicked](qabstractitemview.html#doubleClicked)（）信號和通話[edit](qabstractitemview.html#edit)（）上的項目。 ``` QAbstractItemView.mouseMoveEvent (self, QMouseEvent?e) ``` 從重新實現[QWidget.mouseMoveEvent](qwidget.html#mouseMoveEvent)（）。這個函數被調用給定的_event_當鼠標移動事件被發送給窗口小部件。如果選擇是在進步和新項目移到選擇是延長;如果拖動操作正在進行，它繼續。 ``` QAbstractItemView.mousePressEvent (self, QMouseEvent?e) ``` 從重新實現[QWidget.mousePressEvent](qwidget.html#mousePressEvent)（）。這個函數被調用給定的_event_當按下鼠標按鈕時光標在widget內。如果一個有效的項目上按下制成的當前項。此功能會發出[pressed](qabstractitemview.html#pressed)（）信號。 ``` QAbstractItemView.mouseReleaseEvent (self, QMouseEvent?e) ``` 從重新實現[QWidget.mouseReleaseEvent](qwidget.html#mouseReleaseEvent)（）。這個函數被調用給定的_event_當釋放鼠標按鈕，在窗口小部件鼠標按下事件后。如果用戶按下你的widget里面的鼠標，然后拖動鼠標到另一個位置釋放鼠標按鈕之前，你的widget接收釋放事件。該函數將放出[clicked](qabstractitemview.html#clicked)（）如果一個項目是被按下的信號。 ``` QModelIndex QAbstractItemView.moveCursor (self, CursorAction?cursorAction, Qt.KeyboardModifiers?modifiers) ``` [ 這種方法是抽象的，應在任何子類中重新實現。 ](qmodelindex.html) [返回](qmodelindex.html)[QModelIndex](qmodelindex.html)對象指向在視圖中的下一個對象，根據給定的_cursorAction_并通過指定的鍵盤功能鍵_modifiers_。在基類中，這是一個純虛函數。 ``` QAbstractItemView.openPersistentEditor (self, QModelIndex?index) ``` 打開關于該項目的持續性編輯器在給定的_index_。如果沒有編輯器存在，則委讬將創建一個新的編輯器。 **See also** [closePersistentEditor](qabstractitemview.html#closePersistentEditor)（）。 ``` QAbstractItemView.reset (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void reset()`。重置視圖的內部狀態。 **Warning:**此功能將重新打開的編輯器，滾動條的位置，選擇等現有的更改將不會被提交。如果你想重置視圖時，保存更改，您可以重新實現此功能，提交你的修改，然后調用父類的實現。 ``` QAbstractItemView.resizeEvent (self, QResizeEvent?e) ``` 從重新實現[QWidget.resizeEvent](qwidget.html#resizeEvent)（）。這個函數被調用給定的_event_當resize事件被發送給窗口小部件。 **See also** [QWidget.resizeEvent](qwidget.html#resizeEvent)（）。 ``` QModelIndex QAbstractItemView.rootIndex (self) ``` [ 返回模型的根項的模型索引。根項目是父項視圖的頂層項目。根可以是無效的。 ](qmodelindex.html) [**See also**](qmodelindex.html) [setRootIndex](qabstractitemview.html#setRootIndex)（）。 ``` QAbstractItemView.rowsAboutToBeRemoved (self, QModelIndex?parent, int?start, int?end) ``` 這種方法也是一個Qt槽與C + +的簽名`void rowsAboutToBeRemoved(const QModelIndex&,int,int)`。這個槽被調用時的行是要被去除。被刪除的行是指在給定的_parent_從_start_至_end_包容性。 **See also** [rowsInserted](qabstractitemview.html#rowsInserted)（）。 ``` QAbstractItemView.rowsInserted (self, QModelIndex?parent, int?start, int?end) ``` 這種方法也是一個Qt槽與C + +的簽名`void rowsInserted(const QModelIndex&,int,int)`。插入行時這個槽被調用。新行是指在給定的_parent_從_start_至_end_包容性。基類實現調用fetchMore （）在模型上，以檢查更多的數據。 **See also** [rowsAboutToBeRemoved](qabstractitemview.html#rowsAboutToBeRemoved)（）。 ``` QAbstractItemView.scheduleDelayedItemsLayout (self) ``` 附表的事件處理開始時要執行在視圖中的項目的布局。即使scheduleDelayedItemsLayout （）被調用前，事件被處理多次，認為只會做布局一次。 **See also** [executeDelayedItemsLayout](qabstractitemview.html#executeDelayedItemsLayout)（）。 ``` QAbstractItemView.scrollDirtyRegion (self, int?dx, int?dy) ``` 準備由（視圖為滾動_dx_，_dy_）像素通過移動臟區在相反的方向。你只需要調用這個函數，如果你要實現一個滾動視口在你的視圖子類。如果您實現[scrollContentsBy](qabstractscrollarea.html#scrollContentsBy)（）中的子類[QAbstractItemView](qabstractitemview.html)，在打電話之前調用這個函數[QWidget.scroll](qwidget.html#scroll)（）上的視口。另外，只需要調用[update](qabstractitemview.html#update)（）。 **See also** [scrollContentsBy](qabstractscrollarea.html#scrollContentsBy)（）[dirtyRegionOffset](qabstractitemview.html#dirtyRegionOffset)（）和[setDirtyRegion](qabstractitemview.html#setDirtyRegion)（）。 ``` QAbstractItemView.scrollTo (self, QModelIndex?index, ScrollHint?hint?=?QAbstractItemView.EnsureVisible) ``` 這種方法是抽象的，應在任何子類中重新實現。滾動的視圖，如果必要，以確保在產品_index_是可見的。該視圖將嘗試根據給定定位產品_hint_。在基類中，這是一個純虛函數。 ``` QAbstractItemView.scrollToBottom (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void scrollToBottom()`。滾動視圖的底部。這個函數是Qt 4.1中引入。 **See also** [scrollTo](qabstractitemview.html#scrollTo)（）和[scrollToTop](qabstractitemview.html#scrollToTop)（）。 ``` QAbstractItemView.scrollToTop (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void scrollToTop()`。滾動視圖頂端。這個函數是Qt 4.1中引入。 **See also** [scrollTo](qabstractitemview.html#scrollTo)（）和[scrollToBottom](qabstractitemview.html#scrollToBottom)（）。 ``` QAbstractItemView.selectAll (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void selectAll()`。選擇視圖中的所有項目。此功能將使用選擇的行為選擇時，在視圖中設置。 **See also** [setSelection](qabstractitemview.html#setSelection)（）[selectedIndexes](qabstractitemview.html#selectedIndexes)（）和[clearSelection](qabstractitemview.html#clearSelection)（）。 ``` list-of-QModelIndex QAbstractItemView.selectedIndexes (self) ``` 這個便利函數返回所有選定和非隱藏項的索引視圖的列表。該列表包含沒有重復，并沒有排序。 **See also** [QItemSelectionModel.selectedIndexes](qitemselectionmodel.html#selectedIndexes)（）。 ``` SelectionBehavior QAbstractItemView.selectionBehavior (self) ``` [ ``` QAbstractItemView.selectionChanged (self, QItemSelection?selected, QItemSelection?deselected) ``` 這種方法也是一個Qt槽與C + +的簽名`void selectionChanged(const QItemSelection&,const QItemSelection&)`。當選擇改變這個槽被調用。先前的選擇（可能是空的），通過指定_deselected_，和新的選擇由_selected_。 ](qabstractitemview.html#SelectionBehavior-enum) [**See also**](qabstractitemview.html#SelectionBehavior-enum) [setSelection](qabstractitemview.html#setSelection)（）。 ``` QItemSelectionModel.SelectionFlags QAbstractItemView.selectionCommand (self, QModelIndex?index, QEvent?event?=?None) ``` [ 更新與選擇要包括在返回要使用的SelectionFlags的_index_規定。該_event_是一個用戶輸入事件，例如鼠標或鍵盤事件。重新實現這個函數來定義自己的選擇行為。 ](index.htm) [**See also**](index.htm) [setSelection](qabstractitemview.html#setSelection)（）。 ``` SelectionMode QAbstractItemView.selectionMode (self) ``` [](qabstractitemview.html#SelectionMode-enum) ``` QItemSelectionModel QAbstractItemView.selectionModel (self) ``` [ 返回當前的選擇模型。 ](qitemselectionmodel.html) [**See also**](qitemselectionmodel.html) [setSelectionModel](qabstractitemview.html#setSelectionModel)（）和[selectedIndexes](qabstractitemview.html#selectedIndexes)（）。 ``` QAbstractItemView.setAlternatingRowColors (self, bool?enable) ``` ``` QAbstractItemView.setAutoScroll (self, bool?enable) ``` ``` QAbstractItemView.setAutoScrollMargin (self, int?margin) ``` ``` QAbstractItemView.setCurrentIndex (self, QModelIndex?index) ``` 這種方法也是一個Qt槽與C + +的簽名`void setCurrentIndex(const QModelIndex&)`。設置當前項目是在該項目_index_。除非目前的選擇模式[NoSelection](qabstractitemview.html#SelectionMode-enum)時，該項目也被選中。請注意，此功能也更新任何新的選擇，用戶執行的起始位置。設定的項目為當前項目而不選擇它，調用 `selectionModel()->setCurrentIndex(index, QItemSelectionModel.NoUpdate);` **See also** [currentIndex](qabstractitemview.html#currentIndex)（）[currentChanged](qabstractitemview.html#currentChanged)（）和[selectionMode](qabstractitemview.html#selectionMode-prop)。 ``` QAbstractItemView.setDefaultDropAction (self, Qt.DropAction?dropAction) ``` ``` QAbstractItemView.setDirtyRegion (self, QRegion?region) ``` 標志著定_region_臟和時間表加以更新。你只需要調用這個函數，如果你要實現自己的視圖子類。這個函數是Qt 4.1中引入。 **See also** [scrollDirtyRegion](qabstractitemview.html#scrollDirtyRegion)（）和[dirtyRegionOffset](qabstractitemview.html#dirtyRegionOffset)（）。 ``` QAbstractItemView.setDragDropMode (self, DragDropMode?behavior) ``` ``` QAbstractItemView.setDragDropOverwriteMode (self, bool?overwrite) ``` ``` QAbstractItemView.setDragEnabled (self, bool?enable) ``` ``` QAbstractItemView.setDropIndicatorShown (self, bool?enable) ``` ``` QAbstractItemView.setEditTriggers (self, EditTriggers?triggers) ``` ``` QAbstractItemView.setHorizontalScrollMode (self, ScrollMode?mode) ``` ``` QAbstractItemView.setHorizontalStepsPerItem (self, int?steps) ``` ``` QAbstractItemView.setIconSize (self, QSize?size) ``` ``` QAbstractItemView.setIndexWidget (self, QModelIndex?index, QWidget?widget) ``` 該_widget_說法有它的所有權轉移給Qt的。設置給定_widget_于在給定的產品_index_，通過widget的所有權視域。 If _index_無效（例如，如果您通過根指數），這個函數不會做任何事。給定_widget_的[autoFillBackground](qwidget.html)屬性必須設置為True，否則widget的背景是透明的，顯示出在給定兩個模型數據與項目_index_。如果指數小部件A被替換為索引部件B，指數控件A將被刪除。例如，下面的代碼片段中，[QLineEdit](qlineedit.html)對象將被刪除。 ``` setIndexWidget(index, new [QLineEdit](qlineedit.html)); ... setIndexWidget(index, new [QTextEdit](qtextedit.html)); ``` 這個功能應該僅被用于對應于數據項的可見區域內顯示靜態內容。如果你想顯示自定義的動態內容或實現自定義編輯器部件，子類[QItemDelegate](qitemdelegate.html)代替。這個函數是Qt 4.1中引入。 **See also** [indexWidget](qabstractitemview.html#indexWidget)（）和[Delegate Classes](index.htm#delegate-classes)。 ``` QAbstractItemView.setItemDelegate (self, QAbstractItemDelegate?delegate) ``` 設置項委讬該視圖及其模型_delegate_。如果你想完全控制了項目的編輯和顯示，這是很有用的。任何現有的委讬將被刪除，但不會被刪除。[QAbstractItemView](qabstractitemview.html)不采取所有權_delegate_。 **Warning:**你不應該共享視圖之間的委讬的同一實例。否則會導致不正確或不直觀的編輯行為，因為在一個給定的委讬每個視圖可能會收到[closeEditor()](qabstractitemdelegate.html#closeEditor)信號，并試圖訪問，修改或關閉一個已經被關閉的編輯器。 **See also** [itemDelegate](qabstractitemview.html#itemDelegate)（）。 ``` QAbstractItemView.setItemDelegateForColumn (self, int?column, QAbstractItemDelegate?delegate) ``` 設置給定項目_delegate_使用此視圖和模型對于給定的_column_。所有項目_column_將繪制和管理_delegate_而不是使用默認的委讬（即，[itemDelegate](qabstractitemview.html#itemDelegate)（））。任何現有列委讬_column_將被刪除，但不刪除。[QAbstractItemView](qabstractitemview.html)不采取所有權_delegate_。 **Note:**如果委讬已被分配到兩個行和列，行的委讬將優先考慮和管理的交叉單元索引。 **Warning:**你不應該共享視圖之間的委讬的同一實例。否則會導致不正確或不直觀的編輯行為，因為在一個給定的委讬每個視圖可能會收到[closeEditor()](qabstractitemdelegate.html#closeEditor)信號，并試圖訪問，修改或關閉一個已經被關閉的編輯器。這個函數中引入了Qt 4.2中。 **See also** [itemDelegateForColumn](qabstractitemview.html#itemDelegateForColumn)（）[setItemDelegateForRow](qabstractitemview.html#setItemDelegateForRow)（）和[itemDelegate](qabstractitemview.html#itemDelegate)（）。 ``` QAbstractItemView.setItemDelegateForRow (self, int?row, QAbstractItemDelegate?delegate) ``` 設置給定項目_delegate_使用此視圖和模型對于給定的_row_。所有項目_row_將繪制和管理_delegate_而不是使用默認的委讬（即，[itemDelegate](qabstractitemview.html#itemDelegate)（））。任何現有的行委讬_row_將被刪除，但不刪除。[QAbstractItemView](qabstractitemview.html)不采取所有權_delegate_。 **Note:**如果委讬已被分配到兩個行和列，行委讬（即該委讬）將優先考慮和管理的交叉單元索引。 **Warning:**你不應該共享視圖之間的委讬的同一實例。否則會導致不正確或不直觀的編輯行為，因為在一個給定的委讬每個視圖可能會收到[closeEditor()](qabstractitemdelegate.html#closeEditor)信號，并試圖訪問，修改或關閉一個已經被關閉的編輯器。這個函數中引入了Qt 4.2中。 **See also** [itemDelegateForRow](qabstractitemview.html#itemDelegateForRow)（）[setItemDelegateForColumn](qabstractitemview.html#setItemDelegateForColumn)（）和[itemDelegate](qabstractitemview.html#itemDelegate)（）。 ``` QAbstractItemView.setModel (self, QAbstractItemModel?model) ``` 設置_model_該視圖呈現。這個函數將創建并設置一個新的選擇模式，取代先前設置的任何模型[setSelectionModel](qabstractitemview.html#setSelectionModel)（）。然而，舊的選擇模型不會因為它可能被多個視圖之間共享刪除。我們建議您刪除，如果它不再需要舊的選擇模型。這樣做是用下面的代碼： ``` [QItemSelectionModel](qitemselectionmodel.html) *m = view->selectionModel(); view->setModel(new model); delete m; ``` 如果兩個舊的模式和舊的選擇模型沒有父母，或者他們的父母長期存活的對象，它可能是最好打電話到他們的[deleteLater](qobject.html#deleteLater)（）函數來顯式地刪除它們。視圖_does not_取模型的所有權，除非它是模型的父對象，因為該模型可以被許多不同的視圖之間共享。 **See also** [model](qabstractitemview.html#model)（）[selectionModel](qabstractitemview.html#selectionModel)（）和[setSelectionModel](qabstractitemview.html#setSelectionModel)（）。 ``` QAbstractItemView.setRootIndex (self, QModelIndex?index) ``` 這種方法也是一個Qt槽與C + +的簽名`void setRootIndex(const QModelIndex&)`。根項目設置的項目在給定的_index_。 **See also** [rootIndex](qabstractitemview.html#rootIndex)（）。 ``` QAbstractItemView.setSelection (self, QRect?rect, QItemSelectionModel.SelectionFlags?command) ``` 這種方法是抽象的，應在任何子類中重新實現。適用的選擇_flags_在項目或由矩形觸摸時，_rect_。當實現自己的ItemView控件setSelection應該調用[selectionModel](qabstractitemview.html#selectionModel)（） - \u003e選擇（選擇，旗），其中選擇要么是空的[QModelIndex](qmodelindex.html)或[QItemSelection](qitemselection.html)包含所包含的所有項目_rect_。 **See also** [selectionCommand](qabstractitemview.html#selectionCommand)（）和[selectedIndexes](qabstractitemview.html#selectedIndexes)（）。 ``` QAbstractItemView.setSelectionBehavior (self, SelectionBehavior?behavior) ``` ``` QAbstractItemView.setSelectionMode (self, SelectionMode?mode) ``` ``` QAbstractItemView.setSelectionModel (self, QItemSelectionModel?selectionModel) ``` 設置當前選擇模型給定的_selectionModel_。需要注意的是，如果你調用[setModel](qabstractitemview.html#setModel)（）這個函數之后，給定的_selectionModel_將由一個由視圖中創建所取代。 **Note:**它是由應用程序，如果它不再需要刪除舊的選擇模型，也就是說，如果它不被使用的其它視圖。當它的父對象被刪除，這會自動發生。然而，如果它不具有父，或者如果父是一個長期存在的對象，它可能是優選的，以調用其[deleteLater](qobject.html#deleteLater)（）函數來顯式地刪除它。 **See also** [selectionModel](qabstractitemview.html#selectionModel)（）[setModel](qabstractitemview.html#setModel)（）和[clearSelection](qabstractitemview.html#clearSelection)（）。 ``` QAbstractItemView.setState (self, State?state) ``` 設置項視圖的狀態給定的_state_。 **See also** [state](qabstractitemview.html#state)(). ``` QAbstractItemView.setTabKeyNavigation (self, bool?enable) ``` ``` QAbstractItemView.setTextElideMode (self, Qt.TextElideMode?mode) ``` ``` QAbstractItemView.setVerticalScrollMode (self, ScrollMode?mode) ``` ``` QAbstractItemView.setVerticalStepsPerItem (self, int?steps) ``` ``` bool QAbstractItemView.showDropIndicator (self) ``` ``` int QAbstractItemView.sizeHintForColumn (self, int?column) ``` 返回的寬度尺寸暗示指定_column_或者-1，如果沒有模型。此功能用于在一個水平標題的觀點找到尺寸暗示根據對給定內容的標題部分_column_。 **See also** [sizeHintForRow](qabstractitemview.html#sizeHintForRow)（）。 ``` QSize QAbstractItemView.sizeHintForIndex (self, QModelIndex?index) ``` [ 返回尺寸暗示該項目具有指定_index_或無效的大小無效索引。 ](qsize.html) [**See also**](qsize.html) [sizeHintForRow](qabstractitemview.html#sizeHintForRow)（）和[sizeHintForColumn](qabstractitemview.html#sizeHintForColumn)（）。 ``` int QAbstractItemView.sizeHintForRow (self, int?row) ``` 返回的高度尺寸暗示的指定_row_或者-1，如果沒有模型。返回的高度是用給定大小的提示計算_row_的項目，即返回值是項目中的最大高度。請注意，要控制一個行的高度，你必須重新實現[QAbstractItemDelegate.sizeHint](qabstractitemdelegate.html#sizeHint)（）函數。此功能用于在與垂直插頭觀點找到尺寸暗示根據對給定內容的標題部分_row_。 **See also** [sizeHintForColumn](qabstractitemview.html#sizeHintForColumn)（）。 ``` QAbstractItemView.startDrag (self, Qt.DropActions?supportedActions) ``` 使用給定的調用拖 - \u003e EXEC （啟動拖動）_supportedActions_。 ``` State QAbstractItemView.state (self) ``` [ 返回該項目視圖的狀態。 ](qabstractitemview.html#State-enum) [**See also**](qabstractitemview.html#State-enum) [setState](qabstractitemview.html#setState)（）。 ``` bool QAbstractItemView.tabKeyNavigation (self) ``` ``` Qt.TextElideMode QAbstractItemView.textElideMode (self) ``` [ ``` QAbstractItemView.timerEvent (self, QTimerEvent?e) ``` ](qt.html#TextElideMode-enum) [從重新實現](qt.html#TextElideMode-enum)[QObject.timerEvent](qobject.html#timerEvent)（）。這個函數被調用給定的_event_當一個計時器事件被發送給窗口小部件。 **See also** [QObject.timerEvent](qobject.html#timerEvent)（）。 ``` QAbstractItemView.update (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void update()`。更新由給定的所佔據的區域_index_。此功能被引入Qt的4.3 。 ``` QAbstractItemView.update (self, QModelIndex?index) ``` 這種方法也是一個Qt槽與C + +的簽名`void update(const QModelIndex&)`。 ``` QAbstractItemView.updateEditorData (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void updateEditorData()`。 ``` QAbstractItemView.updateEditorGeometries (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void updateEditorGeometries()`。 ``` QAbstractItemView.updateGeometries (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void updateGeometries()`。更新視圖的子部件的幾何形狀。此功能被引入Qt的4.4 。 ``` int QAbstractItemView.verticalOffset (self) ``` 這種方法是抽象的，應在任何子類中重新實現。返回垂直視圖的偏移量。在基類中，這是一個純虛函數。 **See also** [horizontalOffset](qabstractitemview.html#horizontalOffset)（）。 ``` QAbstractItemView.verticalScrollbarAction (self, int?action) ``` 這種方法也是一個Qt槽與C + +的簽名`void verticalScrollbarAction(int)`。 ``` QAbstractItemView.verticalScrollbarValueChanged (self, int?value) ``` 這種方法也是一個Qt槽與C + +的簽名`void verticalScrollbarValueChanged(int)`。 ``` ScrollMode QAbstractItemView.verticalScrollMode (self) ``` [ ``` int QAbstractItemView.verticalStepsPerItem (self) ``` ](qabstractitemview.html#ScrollMode-enum) ``` QStyleOptionViewItem QAbstractItemView.viewOptions (self) ``` [](qstyleoptionviewitem.html) [返回](qstyleoptionviewitem.html)[QStyleOptionViewItem](qstyleoptionviewitem.html)結構填充視圖的調色板，字體，狀態，線路走向等。 ``` bool QAbstractItemView.viewportEvent (self, QEvent?e) ``` 從重新實現[QAbstractScrollArea.viewportEvent](qabstractscrollarea.html#viewportEvent)（）。這個函數是用來處理工具提示，并這是什么？模式時，如果給定的_event_是[QEvent.ToolTip](qevent.html#Type-enum)或[QEvent.WhatsThis](qevent.html#Type-enum)。它傳遞給它的基類viewportEvent （）處理所有其他事件。 ``` QRect QAbstractItemView.visualRect (self, QModelIndex?index) ``` [ 這種方法是抽象的，應在任何子類中重新實現。返回矩形上通過了該項目所佔用的視_index_。如果你的項目會顯示在幾個方面，然后visualRect應該返回一個包含索引，而不是完整的區域指數可能包括，觸摸或導致繪圖的主要區域。在基類中，這是一個純虛函數。 ](qrect.html) [**See also**](qrect.html) [indexAt](qabstractitemview.html#indexAt)（）和[visualRegionForSelection](qabstractitemview.html#visualRegionForSelection)（）。 ``` QRegion QAbstractItemView.visualRegionForSelection (self, QItemSelection?selection) ``` [ 這種方法是抽象的，應在任何子類中重新實現。從在給定的項目的視口返回區域_selection_。在基類中，這是一個純虛函數。 ](qregion.html) [**See also**](qregion.html) [visualRect](qabstractitemview.html#visualRect)（）和[selectedIndexes](qabstractitemview.html#selectedIndexes)（）。 * * * ## Qt Signal Documentation ``` void activated (const QModelIndex&) ``` 這是該信號的默認超載。當指定的項目，該信號被發射_index_由用戶激活。如何激活項目取決于平臺，例如，通過單或雙擊該項目，或按回車鍵該項目是目前的當。 **See also** [clicked](qabstractitemview.html#clicked)（）[doubleClicked](qabstractitemview.html#doubleClicked)（）[entered](qabstractitemview.html#entered)（）和[pressed](qabstractitemview.html#pressed)（）。 ``` void clicked (const QModelIndex&) ``` 這是該信號的默認超載。單擊鼠標按鈕時，這個信號被發射。鼠標被點擊的項目是由指定的_index_。當索引是有效的信號只發射。 **See also** [activated](qabstractitemview.html#activated)（）[doubleClicked](qabstractitemview.html#doubleClicked)（）[entered](qabstractitemview.html#entered)（）和[pressed](qabstractitemview.html#pressed)（）。 ``` void doubleClicked (const QModelIndex&) ``` 這是該信號的默認超載。當鼠標按鈕被雙擊這個信號被發射。鼠標被雙擊的項目是由指定的_index_。當索引是有效的信號只發射。 **See also** [clicked](qabstractitemview.html#clicked)（）和[activated](qabstractitemview.html#activated)（）。 ``` void entered (const QModelIndex&) ``` 這是該信號的默認超載。當鼠標光標進入由指定的項目，這個信號被發射_index_。鼠標跟蹤需要啟用此功能工作。 **See also** [viewportEntered](qabstractitemview.html#viewportEntered)（）[activated](qabstractitemview.html#activated)（）[clicked](qabstractitemview.html#clicked)（）[doubleClicked](qabstractitemview.html#doubleClicked)（）和[pressed](qabstractitemview.html#pressed)（）。 ``` void pressed (const QModelIndex&) ``` 這是該信號的默認超載。當按下鼠標按鍵，這個信號被發射。鼠標被按下的項目是由指定的_index_。當索引是有效的信號只發射。使用[QApplication.mouseButtons](qapplication.html#mouseButtons)（）函數來獲得鼠標按鈕的狀態。 **See also** [activated](qabstractitemview.html#activated)（）[clicked](qabstractitemview.html#clicked)（）[doubleClicked](qabstractitemview.html#doubleClicked)（）和[entered](qabstractitemview.html#entered)（）。 ``` void viewportEntered () ``` 這是該信號的默認超載。當鼠標光標進入視這個信號被發射。鼠標跟蹤需要啟用此功能工作。 **See also** [entered](qabstractitemview.html#entered)（）。