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

column 에서 지정된 parent 을 가진 항목이 선택된 경우, 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 라는 두 선택 항목을 비교하고, 선택 해제된 항목과 선택된 항목을 포함하여 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)

이 신호는 ` model `가 ` setModel()`를 통해 성공적으로 설정되었을 때 발생합니다.

model() 및 setModel()도 참조하십시오 .

[virtual slot] void QItemSelectionModel::reset()

선택 모델을 지웁니다. 신호를 발생시키지 않습니다.

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

row 에서 지정된 parent 와 일치하는 항목이 선택된 경우 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()도 참조하십시오 .