QAbstractItemView Class

メンバ関数のドキュメント

[explicit] QAbstractItemView::QAbstractItemView(QWidget *parent = nullptr)

指定されたparent を使用して、抽象アイテムビューを構築します。

[virtual noexcept] QAbstractItemView::~QAbstractItemView()

景観を台無しにする。

[signal] void QAbstractItemView::activated(const QModelIndex &index)

このシグナルは、index で指定された項目がユーザーによってアクティブ化されたときに発火します。項目のアクティブ化方法はプラットフォームによって異なります。例えば、項目をシングルクリックまたはダブルクリックしたり、項目がフォーカスされている状態で Return キーや Enter キーを押したりすることなどです。

関連項目： clicked()、doubleClicked()、entered()、およびpressed()。

[slot] void QAbstractItemView::clearSelection()

選択されているすべての項目の選択を解除します。現在のインデックスは変更されません。

setSelection() およびselectAll()も参照してください 。

[signal] void QAbstractItemView::clicked(const QModelIndex &index)

このシグナルは、マウスボタンの左クリックが行われたときに発火します。マウスがクリックされた項目は、index で指定されます。このシグナルは、インデックスが有効な場合にのみ発火します。

activated()、doubleClicked()、entered()、およびpressed()も参照してください 。

[virtual protected slot] void QAbstractItemView::closeEditor(QWidget *editor, QAbstractItemDelegate::EndEditHint hint)

指定されたeditor を閉じ、解放します。hint は、編集操作の終了時にビューがどのように反応すべきかを指定するために使用されます。たとえば、このヒントによって、ビュー内の次の項目を編集用に開くように指示することができます。

edit() およびcommitData()も参照してください 。

void QAbstractItemView::closePersistentEditor(const QModelIndex &index)

指定されたindex にある項目の永続エディタを閉じます。

openPersistentEditor() およびisPersistentEditorOpen()も参照してください 。

[virtual protected slot] void QAbstractItemView::commitData(QWidget *editor)

editor 内のデータをモデルにコミットします。

「closeEditor()」も参照してください 。

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

このスロットは、新しいアイテムが現在のアイテムになったときに呼び出されます。以前の現在のアイテムは `previous ` インデックスで指定され、新しいアイテムは `current ` インデックスで指定されます。

アイテムの変更について知りたい場合は、dataChanged() シグナルを参照してください。

QModelIndex QAbstractItemView::currentIndex() const

現在の項目のモデルインデックスを返します。

setCurrentIndex()も参照してください 。

[virtual protected slot] void QAbstractItemView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles = QList<int>())

このスロットは、モデル内で指定されたroles を持つ項目が変更された際に呼び出されます。変更された項目は、topLeft からbottomRight までの範囲に含まれるものです。項目が1つだけ変更された場合は、topLeft ==bottomRight となります。

変更されたroles は、空のコンテナ（すべてが変更されたことを意味する）であるか、変更されたロールのサブセットを含む非空のコンテナのいずれかになります。

[protected] QPoint QAbstractItemView::dirtyRegionOffset() const

ビュー内の変更済み領域のオフセットを返します。

scrollDirtyRegion() を使用し、QAbstractItemView のサブクラスでpaintEvent() を実装する場合は、ペイントイベントで指定された領域を、この関数から返されるオフセットで変換する必要があります。

scrollDirtyRegion() およびsetDirtyRegion()も参照してください 。

[signal] void QAbstractItemView::doubleClicked(const QModelIndex &index)

このシグナルは、マウスボタンがダブルクリックされたときに発せられます。マウスがダブルクリックされた項目は、index で指定されます。このシグナルは、インデックスが有効な場合にのみ発せられます。

clicked() およびactivated()も参照してください 。

[override virtual protected] void QAbstractItemView::dragEnterEvent(QDragEnterEvent *event)

QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event) を再実装します。

この関数は、ドラッグ＆ドロップ操作がウィジェットに入ってきた際に、指定されたevent を引数として呼び出されます。ドラッグが有効なドロップ先（例：ドロップを受け入れるアイテムの上）にある場合、イベントは受け入れられます。そうでない場合は無視されます。

dropEvent() およびstartDrag()も参照してください 。

[override virtual protected] void QAbstractItemView::dragLeaveEvent(QDragLeaveEvent *event)

QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event) を再実装します。

この関数は、ドラッグ中のアイテムがビューから離れたときに呼び出されます。event は、ドラッグ＆ドロップ操作の状態を表します。

[override virtual protected] void QAbstractItemView::dragMoveEvent(QDragMoveEvent *event)

QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event) を再実装します。

この関数は、ウィジェット上でドラッグ＆ドロップ操作が行われている間、指定されたevent を引数として継続的に呼び出されます。たとえば、ユーザーが選択範囲をビューの右端または下端までドラッグした場合など、ビューのスクロールを引き起こす可能性があります。この場合、イベントは受理されますが、それ以外の場合は無視されます。

dropEvent() およびstartDrag()も参照してください 。

[override virtual protected] void QAbstractItemView::dropEvent(QDropEvent *event)

QAbstractScrollArea::dropEvent(QDropEvent *event) を再実装します。

ウィジェット上でドロップイベントが発生すると、指定された `event ` を引数としてこの関数が呼び出されます。モデルがイベントの位置を受け入れる場合、ドロップイベントは受け入れられます。そうでない場合は無視されます。

startDrag()も参照してください 。

[protected] QAbstractItemView::DropIndicatorPosition QAbstractItemView::dropIndicatorPosition() const

最も近いアイテムに対するドロップインジケーターの位置を返します。

[slot] void QAbstractItemView::edit(const QModelIndex &index)

指定されたindex に対応する項目が編集可能な場合、その項目の編集を開始します。

なお、この関数は現在のインデックスを変更しません。現在のインデックスによって編集対象の次の項目と前の項目が定義されるため、ユーザーはキーボードによるナビゲーションが期待通りに動作しないと感じる可能性があります。一貫したナビゲーション動作を実現するには、この関数の呼び出し前に、同じモデルインデックスを指定してsetCurrentIndex()を呼び出してください。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        abstractItemView, qOverload(&QAbstractItemView::edit));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        abstractItemView, [receiver = abstractItemView](const QModelIndex &index) { receiver->edit(index); });

QModelIndex::flags()も参照してください 。

[virtual protected] bool QAbstractItemView::edit(const QModelIndex &index, QAbstractItemView::EditTrigger trigger, QEvent *event)

index にある項目の編集を開始し、必要に応じてエディタを作成します。ビューのState がEditingState になった場合はtrue を返し、そうでない場合はfalse を返します。

編集処理を引き起こしたアクションは `trigger` で記述され、関連するイベントは `event` で指定されます。

trigger をQAbstractItemView::AllEditTriggers に指定することで、編集を強制的に実行できます。

closeEditor()も参照してください 。

[virtual protected slot] void QAbstractItemView::editorDestroyed(QObject *editor)

この関数は、指定されたeditor が破棄されたときに呼び出されます。

closeEditor()も参照してください 。

[signal] void QAbstractItemView::entered(const QModelIndex &index)

このシグナルは、マウスカーソルが `index` で指定された項目に入ったときに発火します。この機能が動作するには、マウス追跡が有効になっている必要があります。

関連項目： viewportEntered()、activated()、clicked()、doubleClicked()、pressed()も参照してください 。

[override virtual protected] bool QAbstractItemView::event(QEvent *event)

QAbstractScrollArea::event(QEvent *event) を再実装します。

[override virtual protected] bool QAbstractItemView::eventFilter(QObject *object, QEvent *event)

QObject::eventFilter(QObject *watched, QEvent *event) を再実装します。

[protected] void QAbstractItemView::executeDelayedItemsLayout()

イベント処理が開始されるのを待たずに、スケジュールされたレイアウトを実行します。

scheduleDelayedItemsLayout()も参照してください 。

[override virtual protected] void QAbstractItemView::focusInEvent(QFocusEvent *event)

QWidget::focusInEvent(QFocusEvent *event) を再実装します。

この関数は、ウィジェットがフォーカスを取得した際に、指定されたevent を引数として呼び出されます。デフォルトでは、このイベントは無視されます。

setFocus() およびfocusOutEvent()も参照してください 。

[override virtual protected] bool QAbstractItemView::focusNextPrevChild(bool next)

QWidget::focusNextPrevChild （bool next）を再実装します。

[override virtual protected] void QAbstractItemView::focusOutEvent(QFocusEvent *event)

QWidget::focusOutEvent(QFocusEvent *event) を再実装します。

この関数は、ウィジェットがフォーカスを失った際に、指定されたevent を引数として呼び出されます。デフォルトでは、このイベントは無視されます。

clearFocus() およびfocusInEvent()も参照してください 。

[pure virtual protected] int QAbstractItemView::horizontalOffset() const

ビューの水平方向のオフセットを返します。

基底クラスでは、これは純粋仮想関数です。

verticalOffset()も参照してください 。

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

ビューポート座標point にあるアイテムのモデルインデックスを返します。

基底クラスでは、これは純粋仮想関数です。

visualRect()も参照してください 。

QWidget *QAbstractItemView::indexWidget(const QModelIndex &index) const

指定されたindex にある項目のウィジェットを返します。

setIndexWidget()も参照してください 。

[virtual protected, since 6.0] void QAbstractItemView::initViewItemOption(QStyleOptionViewItem *option) const

option 構造体を、ビューのパレット、フォント、状態、配置設定などで初期化します。

この関数は Qt 6.0 で導入されました。

[override virtual protected] void QAbstractItemView::inputMethodEvent(QInputMethodEvent *event)

QWidget::inputMethodEvent(QInputMethodEvent *event) を再実装します。

[override virtual] QVariant QAbstractItemView::inputMethodQuery(Qt::InputMethodQuery query) const

QWidget::inputMethodQuery （Qt::InputMethodQuery query）const を再実装します。

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

指定されたindex が指す項目がビュー内で非表示になっている場合はtrue を返し、そうでない場合はfalse を返します。

非表示設定はビュー固有の機能です。たとえば、TableView では列を非表示に設定でき、TreeView では行を非表示に設定できます。

基底クラスでは、これは純粋仮想関数です。

bool QAbstractItemView::isPersistentEditorOpen(const QModelIndex &index) const

インデックスindex の項目に対して、永続エディタが開かれているかどうかを返します。

openPersistentEditor() およびclosePersistentEditor()も参照してください 。

QAbstractItemDelegate *QAbstractItemView::itemDelegate() const

このビューおよびモデルで使用されるアイテムデリゲートを返します。これは、setItemDelegate() で設定されたもの、またはデフォルトのデリゲートのいずれかです。

setItemDelegate()も参照してください 。

QAbstractItemDelegate *QAbstractItemView::itemDelegateForColumn(int column) const

指定されたcolumn に対して、このビューおよびモデルで使用されているアイテムデリゲートを返します。itemDelegate() を呼び出すことで、指定されたインデックスに対する現在のデリゲートへのポインタを取得できます。

setItemDelegateForColumn()、itemDelegateForRow()、およびitemDelegate()も参照してください 。

[virtual, since 6.0] QAbstractItemDelegate *QAbstractItemView::itemDelegateForIndex(const QModelIndex &index) const

指定されたindex に対して、このビューおよびモデルで使用されているアイテムデリゲートを返します。

この関数は Qt 6.0 で導入されました。

setItemDelegate()、setItemDelegateForRow()、およびsetItemDelegateForColumn()も参照してください 。

QAbstractItemDelegate *QAbstractItemView::itemDelegateForRow(int row) const

指定されたrow に対して、このビューおよびモデルで使用されているアイテムデリゲートを返します。デリゲートが割り当てられていない場合は、nullptr を返します。itemDelegate()を呼び出すことで、指定されたインデックスに対する現在のデリゲートへのポインタを取得できます。

setItemDelegateForRow()、itemDelegateForColumn()、およびsetItemDelegate()も参照してください 。

[override virtual protected] void QAbstractItemView::keyPressEvent(QKeyEvent *event)

QAbstractScrollArea::keyPressEvent(QKeyEvent *e) を再実装します。

この関数は、ウィジェットにキーイベントが送信された際に、指定されたevent を引数として呼び出されます。 デフォルトの実装では、上、下、左、右、Home、PageUp、PageDown などの基本的なカーソル移動を処理します。現在のインデックスが有効で、アクティベーションキー（プラットフォームに応じて Enter または Return など）が押された場合、activated() シグナルが発信されます。 この関数では、F2キーが押された場合など、キーの押下によって編集が開始されます。

edit()、moveCursor()、keyboardSearch()、およびtabKeyNavigationも参照してください 。

[virtual] void QAbstractItemView::keyboardSearch(const QString &search)

文字列「search 」に最も一致する項目に移動して選択します。該当する項目が見つからない場合は、何も起こりません。

デフォルトの実装では、search が空の場合、または前回の検索からの経過時間がQApplication::keyboardInputInterval()を超えた場合、検索はリセットされます。

QAbstractItemModel *QAbstractItemView::model() const

このビューが表示しているモデルを返します。

setModel()も参照してください 。

[override virtual protected] void QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event)

QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e) を再実装します。

この関数は、ウィジェット内でマウスボタンがダブルクリックされた際に、指定されたevent を引数として呼び出されます。ダブルクリックが有効なアイテム上で行われた場合、doubleClicked()シグナルを発火し、そのアイテムに対してedit()を呼び出します。

[override virtual protected] void QAbstractItemView::mouseMoveEvent(QMouseEvent *event)

QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e) を再実装します。

この関数は、ウィジェットにマウス移動イベントが送信された際に、指定されたevent を引数として呼び出されます。選択操作が進行中で、新しい項目が選択範囲上を移動した場合、選択範囲が拡張されます。ドラッグ操作が進行中の場合は、その操作が継続されます。

[override virtual protected] void QAbstractItemView::mousePressEvent(QMouseEvent *event)

QAbstractScrollArea::mousePressEvent(QMouseEvent *e) を再実装します。

この関数は、カーソルがウィジェット内にある状態でマウスボタンが押されたときに、指定されたevent を引数として呼び出されます。有効な項目が押された場合、その項目が現在の項目として設定されます。この関数は、pressed()シグナルを発行します。

[override virtual protected] void QAbstractItemView::mouseReleaseEvent(QMouseEvent *event)

QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e) を再実装します。

この関数は、ウィジェットでマウスクリックイベントが発生した後、マウスボタンが離された際に、指定されたevent を引数として呼び出されます。ユーザーがウィジェット内でマウスをクリックし、マウスボタンを離す前に別の位置までマウスをドラッグした場合、ウィジェットはリリースイベントを受け取ります。アイテムが押されていた場合、この関数はclicked()シグナルを発行します。

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

指定されたcursorAction およびmodifiers で指定されたキーボード修飾子に基づいて、ビュー内の次のオブジェクトを指すQModelIndex オブジェクトを返します。

基底クラスでは、これは純粋仮想関数です。

void QAbstractItemView::openPersistentEditor(const QModelIndex &index)

指定されたindex にある項目に対して、永続的なエディタを開きます。エディタが存在しない場合、デリゲートは新しいエディタを作成します。

closePersistentEditor() およびisPersistentEditorOpen()も参照してください 。

[signal] void QAbstractItemView::pressed(const QModelIndex &index)

このシグナルは、マウスボタンが押されたときに発火します。マウスが押された項目は、index で指定されます。このシグナルは、インデックスが有効な場合にのみ発火します。

マウスボタンの状態を取得するには、QGuiApplication::mouseButtons() 関数を使用します。

activated()、clicked()、doubleClicked()、およびentered()も参照してください 。

[virtual slot] void QAbstractItemView::reset()

ビューの内部状態をリセットします。

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

QAbstractScrollArea::resizeEvent(QResizeEvent *event) を再実装します。

ウィジェットにリサイズイベントが送信されると、指定されたevent を引数としてこの関数が呼び出されます。

QWidget::resizeEvent()も参照してください 。

QModelIndex QAbstractItemView::rootIndex() const

モデルのルート項目のモデルインデックスを返します。ルート項目とは、ビューの最上位項目の親項目です。ルートが無効な場合もあります。

setRootIndex()も参照してください 。

[virtual protected slot] void QAbstractItemView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end)

このスロットは、行が削除されようとしているときに呼び出されます。削除される行は、指定されたparent の下にある、start からend までの行（両端を含む）です。

rowsInserted()も参照してください 。

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

このスロットは、行が挿入されたときに呼び出されます。新しい行は、指定されたparent の範囲内（start からend までを含む）の行です。基底クラスの実装では、モデルに対してfetchMore()を呼び出し、さらにデータがあるかどうかを確認します。

rowsAboutToBeRemoved()も参照してください 。

[protected] void QAbstractItemView::scheduleDelayedItemsLayout()

イベント処理が開始されたときに実行される、ビュー内の項目のレイアウトをスケジュールします。

イベントが処理される前に scheduleDelayedItemsLayout() が複数回呼び出された場合でも、ビューのレイアウトは 1 回のみ実行されます。

executeDelayedItemsLayout()も参照してください 。

[protected] void QAbstractItemView::scrollDirtyRegion(int dx, int dy)

（dx 、dy ）ピクセル分スクロールできるよう、変更された領域を反対方向に移動させてビューを準備します。この関数を呼び出す必要があるのは、ビューのサブクラスでスクロール可能なビューポートを実装している場合のみです。

QAbstractItemView のサブクラスでscrollContentsBy() を実装する場合は、ビューポートに対してQWidget::scroll() を呼び出す前に、この関数を呼び出してください。あるいは、単にupdate() を呼び出すだけでも構いません。

scrollContentsBy()、dirtyRegionOffset()、およびsetDirtyRegion()も参照してください 。

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

必要に応じてビューをスクロールし、index にある項目が表示されるようにします。ビューは、指定されたhint に従って、その項目の位置を調整しようとします。

基底クラスでは、これは純粋仮想関数です。

[slot] void QAbstractItemView::scrollToBottom()

ビューを一番下までスクロールします。

scrollTo() およびscrollToTop()も参照してください 。

[slot] void QAbstractItemView::scrollToTop()

ビューを先頭までスクロールします。

scrollTo() およびscrollToBottom()も参照してください 。

[virtual slot] void QAbstractItemView::selectAll()

ビュー内のすべての項目を選択します。この関数は、選択時にビューに設定されている選択動作を使用します。

setSelection()、selectedIndexes()、およびclearSelection()も参照してください 。

[virtual protected] QModelIndexList QAbstractItemView::selectedIndexes() const

この便利関数は、ビュー内で選択されており、かつ非表示になっていないすべての項目のインデックスをリストとして返します。このリストには重複は含まれず、ソートもされていません。

QItemSelectionModel::selectedIndexes()も参照してください 。

[virtual protected slot] void QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

このスロットは、選択内容が変更されたときに呼び出されます。以前の選択内容（空の場合もあります）は `deselected` で指定され、新しい選択内容は `selected` で指定されます。

setSelection()も参照してください 。

[virtual protected] QItemSelectionModel::SelectionFlags QAbstractItemView::selectionCommand(const QModelIndex &index, const QEvent *event = nullptr) const

指定されたindex の選択モデルを更新する際に使用されるSelectionFlagsを返します。結果は、現在のselectionMode()およびユーザー入力イベントevent （nullptr となる場合があります）に依存します。

独自の選択動作を定義するには、この関数を再実装してください。

setSelection()も参照してください 。

QItemSelectionModel *QAbstractItemView::selectionModel() const

現在の選択モデルを返します。

setSelectionModel() およびselectedIndexes()も参照してください 。

[slot] void QAbstractItemView::setCurrentIndex(const QModelIndex &index)

現在の項目を、index にある項目に設定します。

現在の選択モードがNoSelection でない限り、その項目も選択されます。なお、この関数は、ユーザーがその後行う新しい選択の開始位置も更新することに注意してください。

アイテムを選択せずに現在のアイテムとして設定するには、

selectionModel()->setCurrentIndex(index, QItemSelectionModel::NoUpdate);

currentIndex()、currentChanged()、およびselectionModeも参照してください 。

[protected] void QAbstractItemView::setDirtyRegion(const QRegion &region)

指定されたregion を「変更済み」としてマークし、更新が実行されるようスケジュールします。この関数を呼び出す必要があるのは、独自のビューサブクラスを実装している場合のみです。

scrollDirtyRegion() およびdirtyRegionOffset()も参照してください 。

void QAbstractItemView::setIndexWidget(const QModelIndex &index, QWidget *widget)

指定されたwidget を、指定されたindex にあるアイテムに設定し、ウィジェットの所有権をビューポートに渡します。

index が無効な場合（例：ルートインデックスが渡された場合など）、この関数は何も行いません。

指定されたwidget のautoFillBackground プロパティはtrueに設定されている必要があります。そうしないと、ウィジェットの背景が透明になり、モデルデータと、指定されたindex にあるアイテムの両方が表示されます。

setIndexWidget(index, new QLineEdit);
...
setIndexWidget(index, new QTextEdit);

この関数は、データ項目に対応する表示領域内で静的なコンテンツを表示する場合にのみ使用してください。カスタムの動的コンテンツを表示したり、カスタムエディタウィジェットを実装したりする場合は、代わりにQStyledItemDelegate をサブクラス化してください。

「indexWidget()」および「デリゲートクラス」も参照してください 。

void QAbstractItemView::setItemDelegate(QAbstractItemDelegate *delegate)

このビューとそのモデルのアイテムデリゲートをdelegate に設定します。これは、アイテムの編集や表示を完全に制御したい場合に役立ちます。

既存デリゲートは削除されますが、消去されることはありません。QAbstractItemView はdelegate の所有権を取得しません。

itemDelegate()も参照してください 。

void QAbstractItemView::setItemDelegateForColumn(int column, QAbstractItemDelegate *delegate)

指定されたcolumn に対して、このビューおよびモデルで使用される指定されたdelegate を設定します。column 上のすべてのアイテムは、デフォルトのデリゲート（つまり、itemDelegate()) を使用する代わりに、delegate によって描画および管理されます。

column に対して既存のカラムデリゲートがある場合は、それらは削除されますが、消去されることはありません。QAbstractItemView はdelegate の所有権を取得しません。

関連項目： itemDelegateForColumn()、setItemDelegateForRow()、およびitemDelegate()。

void QAbstractItemView::setItemDelegateForRow(int row, QAbstractItemDelegate *delegate)

指定されたrow に対して、このビューおよびモデルで使用される指定されたdelegate を設定します。row 上のすべてのアイテムは、デフォルトのデリゲート（つまり、itemDelegate()) を使用する代わりに、delegate によって描画および管理されます。

row に対して既存の行デリゲートがある場合は、それらは削除されますが、消去されることはありません。QAbstractItemView はdelegate の所有権を取得しません。

関連項目： itemDelegateForRow()、setItemDelegateForColumn()、およびitemDelegate()。

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

表示するビューのmodel を設定します。

この関数は、新しい選択モデルを作成して設定し、以前にsetSelectionModel()で設定されていたモデルを置き換えます。ただし、古い選択モデルは複数のビュー間で共有されている可能性があるため、削除されません。不要になった場合は、古い選択モデルを削除することをお勧めします。削除は次のコードで行います:

QItemSelectionModel *m = view->selectionModel();
view->setModel(new model);
delete m;

古いモデルと古い選択モデルの両方に親が存在しない場合、またはそれらの親が長寿命のオブジェクトである場合は、deleteLater() 関数を呼び出して明示的に削除する方が望ましい場合があります。

モデルは多くの異なるビュー間で共有される可能性があるため、ビューは、そのビューがモデルの親オブジェクトでない限り、モデルの所有権を取得しません。

model()、selectionModel()、およびsetSelectionModel()も参照してください 。

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

指定されたindex にあるアイテムをルートアイテムとして設定します。

rootIndex()も参照してください 。

[pure virtual protected] void QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)

矩形（rect ）内の、またはその矩形に接触している項目に対して、選択処理 `flags ` を適用します。

独自のアイテムビューを実装する場合、setSelection メソッドではselectionModel()->select(selection, flags) を呼び出す必要があります。ここで、selection は空のQModelIndex であるか、rect に含まれるすべてのアイテムを含むQItemSelection のいずれかです。

selectionCommand() およびselectedIndexes()も参照してください 。

[virtual] void QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel)

現在の選択モデルを、指定されたselectionModel に設定します。

なお、この関数の後にsetModel()を呼び出した場合、指定されたselectionModel は、ビューによって作成されたものに置き換えられます。

selectionModel()、setModel()、およびclearSelection()も参照してください 。

[protected] void QAbstractItemView::setState(QAbstractItemView::State state)

アイテムビューの状態を、指定されたstate に設定します。

state()も参照してください 。

[virtual] int QAbstractItemView::sizeHintForColumn(int column) const

指定されたcolumn の幅に関するサイズヒントを返します。モデルが存在しない場合は-1を返します。

この関数は、水平ヘッダーを持つビューにおいて、指定されたcolumn の内容に基づいてヘッダーセクションのサイズヒントを取得するために使用されます。

sizeHintForRow()も参照してください 。

QSize QAbstractItemView::sizeHintForIndex(const QModelIndex &index) const

指定されたindex を持つ項目のサイズヒントを返すか、無効なインデックスの場合は無効なサイズを返す。

sizeHintForRow() およびsizeHintForColumn()も参照してください 。

[virtual] int QAbstractItemView::sizeHintForRow(int row) const

指定されたrow の高さサイズヒントを返します。モデルが存在しない場合は-1を返します。

返される高さは、指定されたrow の項目のサイズヒントを用いて計算されます。つまり、返される値は各項目の中で最も高い高さとなります。行の高さを制御するには、QAbstractItemDelegate::sizeHint()関数を再実装する必要があることに注意してください。

この関数は、垂直ヘッダーを持つビューにおいて、指定されたrow の内容に基づいてヘッダーセクションのサイズヒントを取得するために使用されます。

sizeHintForColumn()も参照してください 。

[virtual protected] void QAbstractItemView::startDrag(Qt::DropActions supportedActions)

指定されたsupportedActions を使用して、drag->exec()を呼び出し、ドラッグを開始します。

[protected] QAbstractItemView::State QAbstractItemView::state() const

アイテムビューの状態を返します。

setState()も参照してください 。

[override virtual protected] void QAbstractItemView::timerEvent(QTimerEvent *event)

QObject::timerEvent(QTimerEvent *event) を再実装します。

この関数は、ウィジェットにタイマーイベントが送信された際に、指定されたevent を引数として呼び出されます。

QObject::timerEvent()も参照してください 。

[slot] void QAbstractItemView::update(const QModelIndex &index)

指定されたindex が占める領域を更新します。

[virtual protected slot] void QAbstractItemView::updateGeometries()

ビューの子ウィジェットのジオメトリを更新します。

[pure virtual protected] int QAbstractItemView::verticalOffset() const

ビューの垂直方向のオフセットを返します。

基底クラスでは、これは純粋仮想関数です。

horizontalOffset()も参照してください 。

[signal] void QAbstractItemView::viewportEntered()

このシグナルは、マウスカーソルがビューポートに入ったときに発生します。この機能が動作するには、マウス追跡が有効になっている必要があります。

entered()も参照してください 。

[override virtual protected] bool QAbstractItemView::viewportEvent(QEvent *event)

QAbstractScrollArea::viewportEvent(QEvent *event) を再実装します。

この関数は、指定されたevent がQEvent::ToolTip またはQEvent::WhatsThis である場合、ツールチップおよび「What's This?」モードの処理に使用されます。それ以外のすべてのイベントは、基底クラスのviewportEvent()ハンドラに転送されます。

event が認識され処理された場合はtrue を返し、それ以外の場合はfalse を返します。

[override virtual protected] QSize QAbstractItemView::viewportSizeHint() const

QAbstractScrollArea::viewportSizeHint() const を再実装します。

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

index における、そのアイテムがビューポート上で占める矩形を返します。

アイテムが複数の領域にまたがって表示されている場合、visualRect は、index が含まれる可能性のある領域全体ではなく、index を含む主要な領域を返す必要があります。

基底クラスでは、これは純粋仮想関数です。

indexAt() およびvisualRegionForSelection()も参照してください 。

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

指定されたselection 内のアイテムのビューポートから領域を返します。

基底クラスでは、これは純粋仮想関数です。

visualRect() およびselectedIndexes()も参照してください 。