Класс QAccessibleActionInterface

Класс QAccessibleActionInterface реализует поддержку вызываемых действий в интерфейсе. Подробнее...

Заголовок:	#include <QAccessibleActionInterface>
qmake:	QT += gui
Наследуется от:	QAccessibleWidget

Список всех членов, включая унаследованные

Открытые функции

виртуальный	~QAccessibleActionInterface()
виртуальный QStringList	actionNames() const = 0
виртуальный void	doAction(const QString &actionName) = 0
виртуальный QStringList	keyBindingsForAction(const QString &actionName) const = 0
виртуальный QString	localizedActionDescription(const QString &actionName) const
виртуальный 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(). Это то, что происходит, когда виджет активируется щелчком, нажатием пробела или аналогичным действием.

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

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

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