Класс QAccessibleActionInterface
Класс QAccessibleActionInterface реализует поддержку вызываемых действий в интерфейсе. Подробнее...
| Заголовок: | #include <QAccessibleActionInterface> |
| 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() |
Подробное описание
Класс QAccessibleActionInterface реализует поддержку вызываемых действий в интерфейсе.
Объекты-доступ к которым предоставляется, должны реализовывать интерфейс действий, если они поддерживают взаимодействие с пользователем. Обычно этот интерфейс реализуется классами, которые также реализуют QAccessibleInterface.
Поддерживаемые действия должны использовать предопределённые действия, предлагаемые в этом классе, если они не соответствуют предопределённому действию. В этом случае можно добавить пользовательское действие.
При наследовании от QAccessibleActionInterface необходимо предоставить список actionNames, который является основным способом обнаружения доступных действий. Имена действий никогда не локализуются. Для отображения действий пользователю необходимо использовать две функции, которые должны возвращать локализованные версии имени и описание действия. Для предопределённых имён действий используйте QAccessibleActionInterface::localizedActionName() и QAccessibleActionInterface::localizedActionDescription() для возврата их локализованных эквивалентов.
В общем случае вы должны использовать одно из предопределённых имён действий, если не описываете действие, которое не соответствует им:
| Имя действия | Описание |
|---|---|
| toggleAction() | переключает элемент (флажок, радиокнопка, переключатель, ...) |
| decreaseAction() | уменьшить значение доступного элемента (например, спинбокса) |
| increaseAction() | увеличить значение доступного элемента (например, спинбокса) |
| pressAction() | нажать или щелкнуть или активировать доступный элемент (должно соответствовать щелчку по объекту мышкой) |
| setFocusAction() | установить фокус на этот доступный элемент |
| showMenuAction() | отобразить контекстное меню, соответствует щелчку правой кнопкой мыши |
Для вызова действия вызывается doAction() с именем действия.
Большинство виджетов просто реализуют pressAction(). Это происходит, когда виджет активируется щелчком мыши, нажатием пробела или подобным образом.
Документация функций-членов
[virtual] QAccessibleActionInterface::~QAccessibleActionInterface()
Уничтожает QAccessibleActionInterface.
[pure virtual] QStringList QAccessibleActionInterface::actionNames() const
Возвращает список действий, поддерживаемых этим объектом доступа. Возвращаемые действия должны быть в предпочтительном порядке, т.е. действие, которое пользователь, скорее всего, хочет выполнить, должно возвращаться первым, а наименее вероятное действие — последним.
Список содержит только действия, которые можно выполнить. Он не возвращает отключенные действия или действия, связанные с отключенными элементами пользовательского интерфейса.
Список может быть пустым.
Обратите внимание, что этот список не локализован. Для локализованного представления переопределите 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() and 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().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qaccessibleactioninterface.html
