En esta página

QAccessibleActionInterface Class

La clase `QAccessibleActionInterface` implementa la compatibilidad con acciones invocables en la interfaz. Más información...

Encabezado: #include <QAccessibleActionInterface>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado por:

QAccessibleWidget

Funciones públicas

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

Miembros públicos estáticos

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 &showOnScreenAction()
const QString &toggleAction()

Descripción detallada

Los objetos accesibles deben implementar la interfaz de acción si admiten la interacción con el usuario. Normalmente, esta interfaz la implementan clases que también implementan QAccessibleInterface.

Las acciones admitidas deben utilizar las acciones predefinidas que ofrece esta clase, a menos que no se ajusten a ninguna de ellas. En ese caso, se puede añadir una acción personalizada.

Al crear una subclase de `QAccessibleActionInterface`, es necesario proporcionar una lista de ` actionNames `, que es el medio principal para descubrir las acciones disponibles. Los nombres de las acciones nunca se localizan. Para presentar las acciones al usuario, hay dos funciones que deben devolver versiones localizadas del nombre y proporcionar una descripción de la acción. Para los nombres de acciones predefinidos, utilice QAccessibleActionInterface::localizedActionName() y QAccessibleActionInterface::localizedActionDescription() para devolver sus equivalentes localizados.

En general, debes utilizar uno de los nombres de acción predefinidos, a menos que se trate de una acción que no encaje en esta categoría:

Nombre de la acciónDescripción
toggleAction()activa o desactiva el elemento (casilla de selección, botón de opción, interruptor, etc.)
decreaseAction()disminuye el valor del elemento accesible (p. ej., cuadro de selección)
increaseAction()aumenta el valor del elemento accesible (p. ej., cuadro de selección)
pressAction()pulsar, hacer clic o activar el elemento accesible (debería corresponder a hacer clic en el objeto con el ratón)
setFocusAction()establecer el foco en este elemento accesible
showOnScreenAction()mover este elemento accesible al área visible
showMenuAction()Mostrar un menú contextual, equivalente a hacer clic con el botón derecho

Para invocar la acción, se llama a doAction() con un nombre de acción.

La mayoría de los widgets se limitarán a implementar pressAction(). Esto es lo que ocurre cuando se activa el widget al hacer clic en él, pulsar la barra espaciadora o algo similar.

Especificación de IAccessible2

Documentación de las funciones de miembro

[constexpr noexcept default] QAccessibleActionInterface::QAccessibleActionInterface()

Crea por defecto una instancia de ` QAccessibleActionInterface`.

[virtual noexcept] QAccessibleActionInterface::~QAccessibleActionInterface()

Destruye el « QAccessibleActionInterface ».

[pure virtual] QStringList QAccessibleActionInterface::actionNames() const

Devuelve la lista de acciones compatibles con este objeto accesible. Las acciones devueltas deben aparecer en orden de preferencia; es decir, la acción que el usuario tenga más probabilidades de querer activar debe aparecer en primer lugar, mientras que la menos probable debe aparecer en último lugar.

La lista solo contiene acciones que se pueden invocar. No devolverá acciones desactivadas ni acciones asociadas a controles de la interfaz de usuario desactivados.

La lista puede estar vacía.

Ten en cuenta que esta lista no está localizada. Para obtener una representación localizada, reimplementa ` localizedActionName()` y ` localizedActionDescription()`.

Véase también doAction(), localizedActionName() y localizedActionDescription().

[static] const QString &QAccessibleActionInterface::decreaseAction()

Devuelve el nombre de la acción predeterminada de disminución.

Véase también actionNames() y localizedActionName().

[pure virtual] void QAccessibleActionInterface::doAction(const QString &actionName)

Invoca la acción especificada por actionName. Ten en cuenta que actionName es el nombre sin localizar que devuelve actionNames(). Esta función suele implementarse llamando a las mismas funciones que desencadenarían otras interacciones del usuario, como hacer clic en el objeto.

Véase también actionNames().

[static] const QString &QAccessibleActionInterface::increaseAction()

Devuelve el nombre de la acción predeterminada de «incrementar».

Véase también actionNames() y localizedActionName().

[pure virtual] QStringList QAccessibleActionInterface::keyBindingsForAction(const QString &actionName) const

Devuelve una lista de los atajos de teclado disponibles para ejecutar la acción denominada « actionName ».

Esto es importante para que los usuarios aprendan formas alternativas de utilizar la aplicación, haciendo hincapié en el teclado.

Véase también actionNames().

[virtual] QString QAccessibleActionInterface::localizedActionDescription(const QString &actionName) const

Devuelve una descripción localizada de la acción actionName.

Si se utiliza uno de los nombres predeterminados, se puede llamar a esta función en QAccessibleActionInterface para obtener la cadena localizada.

Véase también actionNames() y localizedActionName().

[virtual] QString QAccessibleActionInterface::localizedActionName(const QString &actionName) const

Devuelve el nombre localizado de la acción « actionName ».

Para acciones personalizadas, esta función debe reimplementarse. Cuando se utilice uno de los nombres predeterminados, se puede llamar a esta función en QAccessibleActionInterface para obtener la cadena localizada.

Véase también actionNames() y localizedActionDescription().

[static] QString QAccessibleActionInterface::nextPageAction()

Devuelve el nombre de la acción predeterminada de la página siguiente.

Véase también actionNames() y localizedActionName().

[static] const QString &QAccessibleActionInterface::pressAction()

Devuelve el nombre de la acción predeterminada de «press».

Véase también actionNames() y localizedActionName().

[static] QString QAccessibleActionInterface::previousPageAction()

Devuelve el nombre de la acción predeterminada de la página anterior.

Véase también actionNames() y localizedActionName().

[static] QString QAccessibleActionInterface::scrollDownAction()

Devuelve el nombre de la acción predeterminada de desplazamiento hacia abajo.

Véase también actionNames() y localizedActionName().

[static] QString QAccessibleActionInterface::scrollLeftAction()

Devuelve el nombre de la acción predeterminada al desplazarse hacia la izquierda.

Véase también actionNames() y localizedActionName().

[static] QString QAccessibleActionInterface::scrollRightAction()

Devuelve el nombre de la acción predeterminada para desplazarse hacia la derecha.

Véase también actionNames() y localizedActionName().

[static] QString QAccessibleActionInterface::scrollUpAction()

Devuelve el nombre de la acción predeterminada para desplazarse hacia arriba.

Véase también actionNames() y localizedActionName().

[static] const QString &QAccessibleActionInterface::setFocusAction()

Devuelve el nombre de la acción predeterminada al establecer el foco.

Véase también actionNames() y localizedActionName().

[static] const QString &QAccessibleActionInterface::showMenuAction()

Devuelve el nombre de la acción predeterminada del menú «Mostrar».

Véase también actionNames() y localizedActionName().

[static] const QString &QAccessibleActionInterface::showOnScreenAction()

Devuelve el nombre de la acción predeterminada «Mostrar en pantalla».

Véase también actionNames() y localizedActionName().

[static] const QString &QAccessibleActionInterface::toggleAction()

Devuelve el nombre de la acción predeterminada del botón de alternancia.

Véase también actionNames() y localizedActionName().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.