QItemSelectionModel Class

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

[explicit] QItemSelectionModel::QItemSelectionModel(QAbstractItemModel *model = nullptr)

指定された項目model に対して動作する選択モデルを構築します。

[explicit] QItemSelectionModel::QItemSelectionModel(QAbstractItemModel *model, QObject *parent)

指定された項目 `model ` に対して、parent を用いて動作する選択モデルを構築します。

[virtual noexcept] QItemSelectionModel::~QItemSelectionModel()

選択モデルを破棄します。

[virtual slot] void QItemSelectionModel::clear()

選択モデルをクリアします。selectionChanged() およびcurrentChanged() を発行します。

[virtual slot] void QItemSelectionModel::clearCurrentIndex()

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

[slot] void QItemSelectionModel::clearSelection()

選択モデル内の選択内容をクリアします。selectionChanged() を発行します。

[invokable] bool QItemSelectionModel::columnIntersectsSelection(int column, const QModelIndex &parent = QModelIndex()) const

指定されたparent を持つアイテムがcolumn 内で選択されている場合、true を返します。

[signal] void QItemSelectionModel::currentChanged(const QModelIndex &current, const QModelIndex &previous)

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

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

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

[signal] void QItemSelectionModel::currentColumnChanged(const QModelIndex &current, const QModelIndex &previous)

このシグナルは、current アイテムが変更され、その列がprevious の現在のアイテムの列と異なる場合に発火します。

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

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

QModelIndex QItemSelectionModel::currentIndex() const

現在の項目のモデル項目のインデックスを返します。現在の項目がない場合は、無効なインデックスを返します。

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

[signal] void QItemSelectionModel::currentRowChanged(const QModelIndex &current, const QModelIndex &previous)

current アイテムが変更され、その行がprevious の現在のアイテムの行と異なる場合、このシグナルが発信されます。

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

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

[protected] void QItemSelectionModel::emitSelectionChanged(const QItemSelection &newSelection, const QItemSelection &oldSelection)

newSelection とoldSelection の 2 つの選択内容を比較し、選択解除された項目と選択された項目を指定してselectionChanged() を出力します。

bool QItemSelectionModel::hasSelection() const

選択モデルに選択された項目が含まれている場合は `true ` を返し、そうでない場合は `false` を返します。

[invokable] bool QItemSelectionModel::isColumnSelected(int column, const QModelIndex &parent = QModelIndex()) const

指定されたparent を持つcolumn 内のすべての項目が選択されている場合、true を返します。

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

[invokable] bool QItemSelectionModel::isRowSelected(int row, const QModelIndex &parent = QModelIndex()) const

指定されたparent を持つrow 内のすべての項目が選択されている場合、true を返します。

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

[invokable] bool QItemSelectionModel::isSelected(const QModelIndex &index) const

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

QAbstractItemModel *QItemSelectionModel::model()

選択モデルによって操作されたアイテムモデルを返します。

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

const QAbstractItemModel *QItemSelectionModel::model() const

選択モデルによって操作されたアイテムモデルを返します。

[signal] void QItemSelectionModel::modelChanged(QAbstractItemModel *model)

このシグナルは、`setModel()` を使用して `model ` の設定に成功した際に発生します。

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

[virtual slot] void QItemSelectionModel::reset()

選択モデルをクリアします。信号は一切出力されません。

[invokable] bool QItemSelectionModel::rowIntersectsSelection(int row, const QModelIndex &parent = QModelIndex()) const

指定されたparent を持つアイテムがrow 内で選択されている場合、true を返します。

[virtual slot] void QItemSelectionModel::select(const QItemSelection &selection, QItemSelectionModel::SelectionFlags command)

指定されたcommand を使用して、selection という項目を選択し、selectionChanged()を出力します。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        itemSelectionModel, qOverload(&QItemSelectionModel::select));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        itemSelectionModel, [receiver = itemSelectionModel](const QItemSelection &selection, QItemSelectionModel::SelectionFlags command) { receiver->select(selection, command); });

「QItemSelectionModel::SelectionFlag」も参照してください 。

[virtual slot] void QItemSelectionModel::select(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)

指定されたcommand を使用してモデルアイテムindex を選択し、selectionChanged()を出力します。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        itemSelectionModel, qOverload(&QItemSelectionModel::select));

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

「QItemSelectionModel::SelectionFlags」も参照してください 。

[invokable] QModelIndexList QItemSelectionModel::selectedColumns(int row = 0) const

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

関連項目: ` selectedIndexes()` および `selectedRows()`。

QModelIndexList QItemSelectionModel::selectedIndexes() const

選択されたすべてのモデル項目のインデックスのリストを返します。このリストには重複は含まれず、ソートもされていません。

[invokable] QModelIndexList QItemSelectionModel::selectedRows(int column = 0) const

指定されたcolumn において、すべての列が選択されている行のインデックスを返します。

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

const QItemSelection QItemSelectionModel::selection() const

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

[signal] void QItemSelectionModel::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

このシグナルは、選択内容が変更されるたびに発火します。選択内容の変更は、deselected のアイテムの選択と、selected のアイテムの選択として表されます。

なお、現在のインデックスは選択状態とは独立して変化することに注意してください。また、アイテムモデルがリセットされた場合、このシグナルは発火しない点にも注意してください。

選択されたままですがインデックスが変更された項目は、selected およびdeselected には含まれません。したがって、選択された項目のインデックスのみが変更された場合、selected およびdeselected の両方が空の状態でも、このシグナルが発火する可能性があります。

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

[virtual slot] void QItemSelectionModel::setCurrentIndex(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)

モデル項目index を現在の項目に設定し、currentChanged()を発行します。現在の項目は、キーボードによるナビゲーションやフォーカス表示に使用されます。これは選択された項目とは独立していますが、選択された項目が現在の項目となる場合もあります。

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

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

void QItemSelectionModel::setModel(QAbstractItemModel *model)

モデルをmodel に設定します。modelChanged()シグナルが発信されます。

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