このページでは

ItemSelectionModel QML Type

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

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

プロパティ

信号

方法

詳細説明

「 QItemSelectionModel 」 および「 Qt Quick 」の「モデルとビュー」も参照してください 。

プロパティのドキュメント

currentIndex : QModelIndex [read-only]

setCurrentIndex() を使用してその値を設定します。

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

hasSelection : bool [read-only]

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

selection 、selectedIndexes 、select()、およびselectionChanged()も参照してください 。

model : QAbstractItemModel

このプロパティの値は、ビューのモデルと一致している必要があります。

selectedIndexes : list<var> [read-only]

選択モデル内のすべてのインデックス(QModelIndex インスタンス)のリストを格納します。

QModelIndexList 型も参照してください 。

selection : object [read-only]

選択モデルに保存されている選択範囲を保持します。

シグナルのドキュメント

currentChanged(QModelIndex current, QModelIndex previous)

このシグナルは、現在のアイテムが変更されるたびに発火します。previous のモデルアイテムインデックスが、current のインデックスに置き換えられ、選択項目の現在のアイテムとなります。

なお、アイテムモデルがリセットされた場合、このシグナルは発火しません。

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

currentIndex 、setCurrentIndex()、および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)

指定されたparent を持つアイテムがcolumn 内で選択されている場合、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)

指定されたparent を持つアイテムがrow で選択されている場合、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すべてのインデックスが、列にまたがるように拡張されます。
SelectCurrent利便性のために、「選択」と「現在」の組み合わせが用意されています。
ToggleCurrent利便性のために、「Toggle」と「Current」の組み合わせが用意されています。
ClearAndSelect利便性のため、「クリア」と「選択」の組み合わせが提供されています。

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()を発行します。現在の項目は、キーボードによるナビゲーションやフォーカスの表示に使用されます。これは、選択されている項目とは独立していますが、選択されている項目が現在の項目となることもあります。

指定されたcommand によっては、index が現在の選択範囲の一部となる場合もあります。

有効な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.