Класс QAccessibleActionInterface
Класс QAccessibleActionInterface реализует поддержку вызываемых действий в интерфейсе. Подробнее...
| Заголовок: | #include <QAccessibleActionInterface> |
| CMake: | find_package(Qt6 COMPONENTS Gui REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Наследуется от: |
Открытые функции
| 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] QAccessibleActionInterface::~QAccessibleActionInterface()
Уничтожает QAccessibleActionInterface.
[pure virtual] Список строк QAccessibleActionInterface::actionNames() const
Возвращает список действий, поддерживаемых этим доступным объектом. Возвращаемые действия должны быть в предпочтительном порядке, т.е. действие, которое пользователь, скорее всего, захочет выполнить, должно возвращаться первым, а наименее вероятное действие — последним.
Список содержит только действия, которые могут быть вызваны. Он не будет возвращать отключенные действия или действия, связанные с отключенными элементами пользовательского интерфейса.
Список может быть пустым.
Обратите внимание, что этот список не локализован. Для локализованного представления переопределите localizedActionName() и localizedActionDescription()
См. также doAction(), localizedActionName() и localizedActionDescription().
[static] const Строка &QAccessibleActionInterface::decreaseAction()
Возвращает имя действия по умолчанию для уменьшения.
См. также actionNames() и localizedActionName().
[pure virtual] void QAccessibleActionInterface::doAction(const Строка &actionName)
Вызывает действие, указанное именем actionName. Обратите внимание, что actionName — это имя без локализации, возвращаемое actionNames(). Эта функция обычно реализуется вызовом тех же функций, которые вызывались бы при других взаимодействиях с пользователем, таких как щелчок по объекту.
См. также actionNames().
[static] const Строка &QAccessibleActionInterface::increaseAction()
Возвращает имя действия по умолчанию для увеличения.
См. также actionNames() и localizedActionName().
[pure virtual] Список строк QAccessibleActionInterface::keyBindingsForAction(const Строка &actionName) const
Возвращает список сочетаний клавиш, доступных для вызова действия с именем actionName.
Это важно, чтобы пользователи узнали альтернативные способы использования приложения, подчеркивая использование клавиатуры.
См. также actionNames().
[virtual] Строка QAccessibleActionInterface::localizedActionDescription(const Строка &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() and localizedActionName().
[static] QString QAccessibleActionInterface::scrollDownAction()
Возвращает имя действия по умолчанию для прокрутки вниз.
См. также actionNames() and localizedActionName().
[static] QString QAccessibleActionInterface::scrollLeftAction()
Возвращает имя действия по умолчанию для прокрутки влево.
См. также actionNames() and localizedActionName().
[static] QString QAccessibleActionInterface::scrollRightAction()
Возвращает имя действия по умолчанию для прокрутки вправо.
См. также actionNames() and localizedActionName().
[static] QString QAccessibleActionInterface::scrollUpAction()
Возвращает имя действия по умолчанию для прокрутки вверх.
См. также actionNames() and localizedActionName().
[static] const QString &QAccessibleActionInterface::setFocusAction()
Возвращает имя действия по умолчанию для установки фокуса.
См. также actionNames() and localizedActionName().
[static] const QString &QAccessibleActionInterface::showMenuAction()
Возвращает имя действия по умолчанию для отображения меню.
См. также actionNames() and localizedActionName().
[static] const QString &QAccessibleActionInterface::toggleAction()
Возвращает имя действия по умолчанию для переключения.
См. также actionNames() and localizedActionName().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qaccessibleactioninterface.html
