このページでは

ItemSelectionModel QML Type

QAbstractItemModel およびそれをサポートするビューと組み合わせて使用するQItemSelectionModel をインスタンス化します。詳細...

Import Statement: import QtQml.Models
In C++: QItemSelectionModel

プロパティ

信号

方法

詳細説明

Qt QuickQItemSelectionModel およびモデルとビューも参照してください

プロパティの説明

currentIndex : QModelIndex [read-only]

この値を設定するにはsetCurrentIndex() を使用する。

setCurrentIndex() およびcurrentChanged()も参照のこと

hasSelection : bool [read-only]

値が変更されていなくても、selectionChanged ()が発行されるたびに、プロパティ・バインディングの更新がトリガーされます。

selectionselectedIndexesselect ()、selectionChanged)も参照

model : QAbstractItemModel

このプロパティの値は、ビューのモデルと一致しなければならない。

selectedIndexes : list<var> [read-only]

選択モデル内のすべてのインデックス (QModelIndex インスタンス) のリストを含む。

QModelIndexList 型も参照してください

selection : object [read-only]

選択モデルに格納されている選択範囲を保持する。

シグナルのドキュメント

currentChanged(QModelIndex current, QModelIndex previous)

このシグナルはカレントアイテムが変更されるたびに発行される。previous モデルのアイテムインデックスは、セレクションの現在のアイテムとしてcurrent インデックスに置き換えられます。

アイテムモデルがリセットされると、このシグナルは発せられないことに注意してください。

注: 対応するハンドラはonCurrentChanged です。

currentIndexsetCurrentIndex()、selectionChanged()も参照してください

selectionChanged(QItemSelection selected, QItemSelection deselected)

このシグナルは、セレクションが変更されるたびに発せられる。選択範囲の変更は、deselected 項目の項目選択と、selected 項目の項目選択として表現される。

現在のインデックスはセレクションとは無関係に変化することに注意してください。また、アイテムモデルがリセットされると、このシグナルは発行されないことにも注意してください。

注: 対応するハンドラはonSelectionChanged です。

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

メソッドのドキュメント

void clear()

選択モデルをクリアする。selectionChanged() とcurrentChanged() を発する。

void clearCurrentIndex()

現在のインデックスをクリアします。currentChanged() を返す。

void clearSelection()

セレクションモデルのセレクションをクリアします。selectionChanged() を出す。

bool columnIntersectsSelection(int column, QModelIndex parent)

column で、与えられたparent で選択されている項目があれば、true を返す。

bool isColumnSelected(int column, QModelIndex parent)

与えられたparent を持つcolumn ですべての項目が選択されている場合、true を返す。

この関数は通常、同じ列のすべての項目に対してisSelected() を呼び出すよりも高速であり、選択不可能な項目は無視されることに注意してください。

bool isRowSelected(int row, QModelIndex parent)

与えられたparent を持つrow ですべての項目が選択されている場合、true を返す。

この関数は通常、同じ行のすべての項目に対してisSelected() を呼び出すよりも高速であり、選択不可能な項目は無視されることに注意してください。

bool isSelected(QModelIndex index)

指定されたモデル項目index が選択されている場合、true を返します。

void reset()

選択モデルをクリアする。シグナルは出さない。

bool rowIntersectsSelection(int row, QModelIndex parent)

row で、与えられたparent で選択されている項目があれば、true を返す。

void select(QItemSelection selection, SelectionFlags command)

指定されたcommand を用いて項目selection を選択し、selectionChanged() を発する。

有効なcommand の値は select(index, command).

void select(QModelIndex index, SelectionFlags command)

指定されたcommand を使用してモデル項目index を選択し、selectionChanged() を出力する。

command パラメータの有効な値は以下のとおり:

定数説明
NoUpdate選択は行われない。
Clear完全な選択はクリアされます。
Select指定されたすべてのインデックスが選択される。
Deselect指定されたすべてのインデックスが選択解除されます。
Toggle指定されたすべてのインデックスが現在の状態に応じて選択または選択解除されます。
Current現在の選択範囲が更新される。
Rowsすべてのインデックスが行にまたがって展開されます。
Columnsすべてのインデックスが列をまたぐように展開される。
SelectCurrentSelectとCurrentの組み合わせ。
ToggleCurrentToggleとCurrentの組み合わせ。
ClearAndSelectClear と Select の組み合わせ。

list<var> selectedColumns(int row)

すべての行が選択されている列の、指定されたrow 内のインデックス (QModelIndex インスタンスのリスト) を返します。

selectedRows() およびQModelIndexList 型も参照してください

list<var> selectedRows(int column)

すべての列が選択されている行の、指定されたcolumn 内のインデックス (QModelIndex インスタンスのリスト) を返します。

selectedColumns() およびQModelIndexList 型も参照してください

void setCurrentIndex(QModelIndex index, SelectionFlags command)

モデルアイテムindex をカレントアイテムに設定し、currentChanged() を出力する。カレントアイテムは、キーボードナビゲーションとフォーカスの表示に使われます。カレントアイテムは、選択されたアイテムとは無関係ですが、選択されたアイテムがカレントアイテムになることもあります。

指定されたcommandindex は、現在の選択項目の一部となることもできます。

有効なcommand の値は select(index, command).

select()も参照

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.