QAccessibleActionInterface Class
QAccessibleActionInterface 클래스는 인터페이스에서 호출할 수 없는 액션에 대한 지원을 구현합니다. 더 보기...
| Header: | #include <QAccessibleActionInterface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 상속 대상: |
- 상속된 멤버를 포함한 모든 멤버 목록
- 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 & | toggleAction() |
상세 설명
접근성 객체는 사용자 상호작용을 지원하는 경우 액션 인터페이스를 구현해야 합니다. 일반적으로 이 인터페이스는 QAccessibleInterface 를 구현하는 클래스에서 구현됩니다.
지원되는 액션은 미리 정의된 액션에 맞지 않는 경우를 제외하고 이 클래스에서 제공되는 미리 정의된 액션을 사용해야 합니다. 이 경우 사용자 정의 액션을 추가할 수 있습니다.
QAccessibleActionInterface를 서브클래싱할 때 사용 가능한 액션을 검색하는 기본 수단인 actionNames 목록을 제공해야 합니다. 액션 이름은 지역화되지 않습니다. 사용자에게 동작을 표시하려면 이름의 현지화된 버전을 반환하고 동작에 대한 설명을 제공해야 하는 두 가지 함수가 있습니다. 미리 정의된 작업 이름의 경우 QAccessibleActionInterface::localizedActionName() 및 QAccessibleActionInterface::localizedActionDescription()을 사용하여 현지화된 작업 이름을 반환합니다.
일반적으로 여기에 맞지 않는 작업을 설명하지 않는 한 미리 정의된 작업 이름 중 하나를 사용해야 합니다:
| 작업 이름 | 설명 |
|---|---|
| toggleAction() | 항목(체크박스, 라디오 버튼, 스위치, ...)을 토글합니다. |
| decreaseAction() | 액세스 가능한 값(예: 스핀박스)을 줄입니다. |
| increaseAction() | 접근 가능한 값(예: 스핀박스)을 증가시킵니다. |
| pressAction() | 접근 가능한 것을 누르거나 클릭하거나 활성화합니다 (마우스로 개체를 클릭하는 것과 일치해야 함). |
| setFocusAction() | 포커스를 이 접근 가능으로 설정 |
| showMenuAction() | 컨텍스트 메뉴를 표시하고 오른쪽 클릭에 해당합니다. |
액션을 호출하기 위해 액션 이름과 함께 doAction()를 호출합니다.
대부분의 위젯은 pressAction()를 구현합니다. 위젯을 클릭하거나 스페이스바를 누르는 등의 동작을 통해 위젯이 활성화되면 이런 일이 발생합니다.
멤버 함수 문서
[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::toggleAction()
토글 기본 동작의 이름을 반환합니다.
actionNames() 및 localizedActionName()도 참조하세요 .
© 2025 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.
