QAccessibleActionInterface Class
La clase QAccessibleActionInterface implementa soporte para acciones invocables en la interfaz. Más...
| Cabecera: | #include <QAccessibleActionInterface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado Por: |
- Lista de todos los miembros, incluidos los heredados
- QAccessibleActionInterface es parte de Clases de Accesibilidad.
Funciones públicas
| 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 & | toggleAction() |
Descripción detallada
Los objetos accesibles deben implementar la interfaz action si soportan la interacción con el usuario. Normalmente, esta interfaz es implementada por clases que también implementan QAccessibleInterface.
Las acciones soportadas deben utilizar las acciones predefinidas ofrecidas en esta clase a menos que no se ajusten a una acción predefinida. En ese caso se puede añadir una acción personalizada.
Al subclasificar 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 acciones al usuario hay dos funciones que necesitan devolver versiones localizadas del nombre y dar una descripción de la acción. Para los nombres de acción predefinidos, utilice QAccessibleActionInterface::localizedActionName() y QAccessibleActionInterface::localizedActionDescription() para obtener sus equivalentes localizados.
En general, debe utilizar uno de los nombres de acción predefinidos, a menos que describa una acción que no se ajuste a ellos:
| Nombre de la acción | Descripción |
|---|---|
| toggleAction() | activa el elemento (casilla de verificación, botón de radio, interruptor, ...) |
| decreaseAction() | disminuye el valor del accesible (por ejemplo, spinbox) |
| increaseAction() | aumenta el valor del elemento accesible (por ejemplo, spinbox) |
| pressAction() | pulsar o hacer clic o activar el accesible (debe corresponder a hacer clic en el objeto con el ratón) |
| setFocusAction() | poner el foco en este accesible |
| showMenuAction() | mostrar un menú contextual, corresponde a hacer clic con el botón derecho del ratón |
Para invocar la acción, se llama a doAction() con un nombre de acción.
La mayoría de los widgets implementarán simplemente pressAction(). Esto es lo que ocurre cuando se activa el widget al hacer clic en él, pulsar la barra espaciadora o similar.
Documentación de las funciones miembro
[virtual noexcept] QAccessibleActionInterface::~QAccessibleActionInterface()
Destruye el QAccessibleActionInterface.
[pure virtual] QStringList QAccessibleActionInterface::actionNames() const
Devuelve la lista de acciones soportadas por este objeto accesible. Las acciones devueltas deben estar en orden preferente, es decir, la acción que el usuario más probablemente quiera activar debe devolverse en primer lugar, mientras que la acción menos probable debe devolverse en último lugar.
La lista sólo contiene acciones que pueden invocarse. No devolverá acciones desactivadas ni acciones asociadas a controles de interfaz de usuario desactivados.
La lista puede estar vacía.
Tenga en cuenta que esta lista no está localizada. Para una representación localizada, vuelva a implementar localizedActionName() y localizedActionDescription().
Véase también doAction(), localizedActionName(), y localizedActionDescription().
[static] const QString &QAccessibleActionInterface::decreaseAction()
Devuelve el nombre de la acción por defecto decrease.
Véase también actionNames() y localizedActionName().
[pure virtual] void QAccessibleActionInterface::doAction(const QString &actionName)
Invoca la acción especificada por actionName. Tenga en cuenta que actionName es el nombre no localizado devuelto por actionNames() Esta función se implementa normalmente llamando a las mismas funciones que activaría otra interacción 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 por defecto de incremento.
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 invocar 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 utiliza uno de los nombres predeterminados, 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 un nombre de acción localizado de actionName.
Para acciones personalizadas esta función debe ser reimplementada. Si utiliza uno de los nombres predeterminados, 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 por defecto 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 pulsar.
Véase también actionNames() y localizedActionName().
[static] QString QAccessibleActionInterface::previousPageAction()
Devuelve el nombre de la acción por defecto de la página anterior.
Véase también actionNames() y localizedActionName().
[static] QString QAccessibleActionInterface::scrollDownAction()
Devuelve el nombre de la acción por defecto de desplazamiento hacia abajo.
Véase también actionNames() y localizedActionName().
[static] QString QAccessibleActionInterface::scrollLeftAction()
Devuelve el nombre de la acción por defecto de desplazamiento a la izquierda.
Véase también actionNames() y localizedActionName().
[static] QString QAccessibleActionInterface::scrollRightAction()
Devuelve el nombre de la acción por defecto de desplazamiento a la derecha.
Véase también actionNames() y localizedActionName().
[static] QString QAccessibleActionInterface::scrollUpAction()
Devuelve el nombre de la acción por defecto de desplazamiento hacia arriba.
Véase también actionNames() y localizedActionName().
[static] const QString &QAccessibleActionInterface::setFocusAction()
Devuelve el nombre de la acción por defecto set focus.
Véase también actionNames() y localizedActionName().
[static] const QString &QAccessibleActionInterface::showMenuAction()
Devuelve el nombre de la acción por defecto de mostrar menú.
Véase también actionNames() y localizedActionName().
[static] const QString &QAccessibleActionInterface::toggleAction()
Devuelve el nombre de la acción toggle por defecto.
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.
