Класс QAccessibleActionInterface

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

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

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

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

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