이 페이지에서

QAccessibleSelectionInterface Class

QAccessibleSelectionInterface 클래스는 선택 처리에 대한 지원을 구현합니다. 더 보기...

헤더: #include <QAccessibleSelectionInterface>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
다음부터: Qt 6.5부터

공개 함수

QAccessibleSelectionInterface()
virtual ~QAccessibleSelectionInterface()
virtual bool clear() = 0
virtual bool isSelected(QAccessibleInterface *childItem) const
virtual bool select(QAccessibleInterface *childItem) = 0
virtual bool selectAll() = 0
virtual QAccessibleInterface *selectedItem(int selectionIndex) const
virtual int selectedItemCount() const = 0
virtual QList<QAccessibleInterface *> selectedItems() const = 0
virtual bool unselect(QAccessibleInterface *childItem) = 0

상세 설명

현재 선택 항목을 가져오고 선택 항목을 수정하는 두 가지 메서드를 제공합니다.

직계 자식 요소의 선택 항목만 지원됩니다.

멤버 함수 문서

[constexpr noexcept default] QAccessibleSelectionInterface::QAccessibleSelectionInterface()

QAccessibleSelectionInterface 의 인스턴스를 기본 생성합니다.

[virtual noexcept] QAccessibleSelectionInterface::~QAccessibleSelectionInterface()

QAccessibleSelectionInterface 를 삭제합니다.

[pure virtual] bool QAccessibleSelectionInterface::clear()

접근 가능한 모든 하위 항목의 선택을 해제합니다.

접근 가능한 모든 하위 항목이 실제로 선택에서 제거되었는지, 즉 이 메서드가 호출된 후 선택 집합이 비어 있는지 여부를 반환합니다.

[virtual] bool QAccessibleSelectionInterface::isSelected(QAccessibleInterface *childItem) const

childItem 가 현재 선택 영역에 포함되어 있는지 여부를 반환합니다.

기본 구현은 ` childItem `가 ` QAccessibleSelectionInterface::selectedItems`를 통해 가져온 항목 목록에 포함되어 있는지 확인합니다.

[pure virtual] bool QAccessibleSelectionInterface::select(QAccessibleInterface *childItem)

childItem 를 선택 항목에 추가합니다. childItem 가 실제로 선택 항목에 추가되었는지 여부를 반환합니다.

단일 선택만 허용하는 구현의 경우, 이 메서드는 현재 선택 영역을 대체할 수 있습니다.

[pure virtual] bool QAccessibleSelectionInterface::selectAll()

접근 가능한 모든 하위 항목을 선택합니다.

접근 가능한 모든 하위 항목이 실제로 선택 영역에 추가되었는지 여부를 반환합니다.

[virtual] QAccessibleInterface *QAccessibleSelectionInterface::selectedItem(int selectionIndex) const

선택 범위 내에서 인덱스 selectionIndex 에 해당하는 선택된 접근 가능한 항목을 반환합니다.

이 인덱스는 n번째로 선택된 접근 가능한 항목(즉, 현재 선택 영역 내의 인덱스)을 가리키며, 일반적으로 동일한 항목을 가져오기 위해 QAccessibleInterface::child()에 전달되는 인덱스와는 다릅니다.

기본 구현은 QAccessibleSelectionInterface::selectedItems()를 통해 가져온 선택된 항목 목록에서 selectionIndex 를 사용하여 해당 항목을 가져옵니다.

특히 선택된 항목이 많은 경우, 성능상의 이유로 이 메서드를 더 효율적인 방식으로 재구현하는 것이 바람직할 수 있습니다.

[pure virtual] int QAccessibleSelectionInterface::selectedItemCount() const

선택된 접근 가능한 항목의 총 개수를 반환합니다.

[pure virtual] QList<QAccessibleInterface *> QAccessibleSelectionInterface::selectedItems() const

선택된 접근 가능한 항목의 목록을 반환합니다.

[pure virtual] bool QAccessibleSelectionInterface::unselect(QAccessibleInterface *childItem)

선택 항목에서 ‘ childItem ’을 제거합니다.

접근 가능한 항목이 실제로 선택 항목에서 제거되었는지 여부를 반환합니다.

© 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.