Класс 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(). Это происходит, когда виджет активируется щелчком, нажатием пробела или подобным образом.

Спецификация IAccessible2

Документация по функциям-членам

`[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().