QAccessibleActionInterface Class
QAccessibleActionInterface 클래스는 인터페이스 내에서 호출 가능한 액션에 대한 지원을 구현합니다. 더 보기...
| 헤더: | #include <QAccessibleActionInterface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 상속된 항목: |
- 상속받은 멤버를 포함한 모든 멤버 목록
- QAccessibleActionInterface는 접근성 클래스의 일부입니다.
공개 함수
| QAccessibleActionInterface() | |
| virtual | ~QAccessibleActionInterface() |
| virtual QStringList | actionNames() const = 0 |
| virtual void | doAction(const QString &actionName) = 0 |
| virtual QStringList | keyBindingsForAction(const QString &actionName) const = 0 |
| virtual QString | localizedActionDescription(const QString &actionName) const |
| virtual QString | localizedActionName(const QString &actionName) const |
정적 공용 멤버
| const QString & | decreaseAction() |
| const QString & | increaseAction() |
| QString | nextPageAction() |
| const QString & | pressAction() |
| QString | previousPageAction() |
| QString | scrollDownAction() |
| QString | scrollLeftAction() |
| QString | scrollRightAction() |
| QString | scrollUpAction() |
| const QString & | setFocusAction() |
| const QString & | showMenuAction() |
| const QString & | showOnScreenAction() |
| const QString & | toggleAction() |
상세 설명
접근성 객체는 사용자 상호 작용을 지원하는 경우 액션 인터페이스를 구현해야 합니다. 일반적으로 이 인터페이스는 ` QAccessibleInterface`도 구현하는 클래스에 의해 구현됩니다.
지원되는 액션은 미리 정의된 액션에 부합하지 않는 경우가 아니라면, 이 클래스에서 제공하는 미리 정의된 액션을 사용해야 합니다. 그런 경우에는 사용자 정의 액션을 추가할 수 있습니다.
QAccessibleActionInterface를 상속할 때는 사용 가능한 액션을 파악하는 주요 수단인 ` actionNames ` 목록을 제공해야 합니다. 액션 이름은 절대 현지화되지 않습니다. 사용자에게 액션을 표시하기 위해서는 이름의 현지화된 버전을 반환하고 액션에 대한 설명을 제공하는 두 가지 함수가 필요합니다. 미리 정의된 액션 이름의 경우, QAccessibleActionInterface::localizedActionName() 및 QAccessibleActionInterface::localizedActionDescription()을 사용하여 해당 이름의 현지화된 버전을 반환해야 합니다.
일반적으로 미리 정의된 작업 이름 중 하나를 사용해야 하지만, 다음 경우에 해당하는 작업을 설명하는 경우에는 예외입니다:
| 작업 이름 | 설명 |
|---|---|
| toggleAction() | 항목(체크박스, 라디오 버튼, 스위치 등)의 상태를 전환합니다. |
| decreaseAction() | 접근 가능한 요소(예: 스핀박스)의 값을 줄입니다. |
| increaseAction() | 액세서블(예: 스핀박스)의 값을 증가시킵니다. |
| pressAction() | 액세서블을 누르거나 클릭하거나 활성화합니다(마우스로 개체를 클릭하는 것과 동일해야 함) |
| setFocusAction() | 이 접근 가능한 요소에 포커스를 설정 |
| showOnScreenAction() | 이 접근 가능한 요소를 뷰포트 안으로 이동시킵니다 |
| showMenuAction() | 컨텍스트 메뉴 표시 (마우스 오른쪽 클릭에 해당) |
이 동작을 호출하려면, 액션 이름과 함께 ` doAction()`를 호출합니다.
대부분의 위젯은 단순히 pressAction()을 구현합니다. 이는 위젯이 클릭되거나 스페이스 키가 눌리는 등 유사한 방식으로 활성화될 때 발생하는 동작입니다.
멤버 함수 문서
[constexpr noexcept default] QAccessibleActionInterface::QAccessibleActionInterface()
QAccessibleActionInterface 의 인스턴스를 기본 생성합니다.
[virtual noexcept] QAccessibleActionInterface::~QAccessibleActionInterface()
QAccessibleActionInterface 를 삭제합니다.
[pure virtual] QStringList QAccessibleActionInterface::actionNames() const
이 접근 가능한 객체가 지원하는 동작 목록을 반환합니다. 반환되는 동작은 선호 순서대로 정렬되어야 합니다. 즉, 사용자가 실행할 가능성이 가장 높은 동작이 먼저 반환되어야 하고, 실행할 가능성이 가장 낮은 동작은 마지막에 반환되어야 합니다.
이 목록에는 호출 가능한 동작만 포함됩니다. 비활성화된 동작이나 비활성화된 UI 컨트롤과 연관된 동작은 반환되지 않습니다.
이 목록은 비어 있을 수도 있습니다.
이 목록은 현지화되지 않는다는 점에 유의하십시오. 현지화된 표현을 얻으려면 localizedActionName() 및 localizedActionDescription()를 재구현하십시오.
doAction(), localizedActionName(), localizedActionDescription()도 참조하십시오 .
[static] const QString &QAccessibleActionInterface::decreaseAction()
감소 기본 동작의 이름을 반환합니다.
actionNames() 및 localizedActionName()도 참조하십시오 .
[pure virtual] void QAccessibleActionInterface::doAction(const QString &actionName)
actionName 로 지정된 액션을 호출합니다. actionName 는 actionNames()에서 반환되는 비로컬라이제이션된 이름이라는 점에 유의하십시오. 이 함수는 일반적으로 객체 클릭과 같은 다른 사용자 상호작용이 트리거하는 것과 동일한 함수를 호출하여 구현됩니다.
actionNames()도 참조하십시오 .
[static] const QString &QAccessibleActionInterface::increaseAction()
증가 기본 동작의 이름을 반환합니다.
actionNames() 및 localizedActionName()도 참조하십시오 .
[pure virtual] QStringList QAccessibleActionInterface::keyBindingsForAction(const QString &actionName) const
actionName 라는 이름의 액션을 호출하는 데 사용할 수 있는 키보드 단축키 목록을 반환합니다.
이는 키보드 사용을 강조함으로써 사용자가 애플리케이션을 사용하는 다른 방법을 익힐 수 있도록 하는 데 중요합니다.
actionNames()도 참조하십시오 .
[virtual] QString QAccessibleActionInterface::localizedActionDescription(const QString &actionName) const
actionName 액션에 대한 현지화된 설명 문자열을 반환합니다.
기본 이름 중 하나를 사용할 경우, QAccessibleActionInterface 에서 이 함수를 호출하여 현지화된 문자열을 얻을 수 있습니다.
actionNames() 및 localizedActionName()도 참조하십시오 .
[virtual] QString QAccessibleActionInterface::localizedActionName(const QString &actionName) const
actionName 의 현지화된 작업 이름을 반환합니다.
사용자 정의 액션의 경우 이 함수를 재구현해야 합니다. 기본 이름 중 하나를 사용할 때는 QAccessibleActionInterface 에서 이 함수를 호출하여 현지화된 문자열을 얻을 수 있습니다.
actionNames() 및 localizedActionDescription()도 참조하십시오 .
[static] QString QAccessibleActionInterface::nextPageAction()
다음 페이지의 기본 동작 이름을 반환합니다.
actionNames() 및 localizedActionName()도 참조하십시오 .
[static] const QString &QAccessibleActionInterface::pressAction()
프레스 기본 동작의 이름을 반환합니다.
actionNames() 및 localizedActionName()도 참조하십시오 .
[static] QString QAccessibleActionInterface::previousPageAction()
이전 페이지의 기본 작업 이름을 반환합니다.
actionNames() 및 localizedActionName()도 참조하십시오 .
[static] QString QAccessibleActionInterface::scrollDownAction()
스크롤 다운 기본 동작의 이름을 반환합니다.
actionNames() 및 localizedActionName()도 참조하십시오 .
[static] QString QAccessibleActionInterface::scrollLeftAction()
스크롤 왼쪽 기본 동작의 이름을 반환합니다.
actionNames() 및 localizedActionName()도 참조하십시오 .
[static] QString QAccessibleActionInterface::scrollRightAction()
스크롤 오른쪽 기본 동작의 이름을 반환합니다.
actionNames() 및 localizedActionName()도 참조하십시오 .
[static] QString QAccessibleActionInterface::scrollUpAction()
스크롤 위로 이동 기본 동작의 이름을 반환합니다.
actionNames() 및 localizedActionName()도 참조하십시오 .
[static] const QString &QAccessibleActionInterface::setFocusAction()
포커스가 설정된 기본 동작의 이름을 반환합니다.
actionNames() 및 localizedActionName()도 참조하십시오 .
[static] const QString &QAccessibleActionInterface::showMenuAction()
쇼 메뉴의 기본 동작 이름을 반환합니다.
actionNames() 및 localizedActionName()도 참조하십시오 .
[static] const QString &QAccessibleActionInterface::showOnScreenAction()
화면에 표시되는 쇼의 이름을 반환하는 기본 동작입니다.
actionNames() 및 localizedActionName()도 참조하십시오 .
[static] const QString &QAccessibleActionInterface::toggleAction()
토글의 기본 동작 이름을 반환합니다.
actionNames() 및 localizedActionName()도 참조하십시오 .
© 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.
