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: |
- Lista de todos los miembros, incluidos los heredados
- QAccessibleActionInterface forma parte de las clases de accesibilidad.
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ón | Descripció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.
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.