QAccessibleActionInterface Class
La classe `QAccessibleActionInterface` permet de prendre en charge les actions exécutables dans l'interface. En savoir plus...
| En-tête : | #include <QAccessibleActionInterface> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Hérité par : |
- Liste de tous les membres, y compris les membres hérités
- QAccessibleActionInterface fait partie des classes d'accessibilité.
Fonctions publiques
| 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 |
Membres publics statiques
| 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() |
Description détaillée
Les objets accessibles doivent implémenter l'interface d'action s'ils prennent en charge l'interaction avec l'utilisateur. Généralement, cette interface est implémentée par des classes qui implémentent également l'interface « QAccessibleInterface ».
Les actions prises en charge doivent utiliser les actions prédéfinies proposées dans cette classe, sauf si elles ne correspondent à aucune action prédéfinie. Dans ce cas, une action personnalisée peut être ajoutée.
Lorsque vous sous-classez `QAccessibleActionInterface`, vous devez fournir une liste d’` actionNames `, qui constitue le principal moyen de découvrir les actions disponibles. Les noms d’actions ne sont jamais localisés. Afin de présenter les actions à l’utilisateur, deux fonctions doivent renvoyer les versions localisées du nom et fournir une description de l’action. Pour les noms d’actions prédéfinis, utilisez QAccessibleActionInterface::localizedActionName() et QAccessibleActionInterface::localizedActionDescription() afin de renvoyer leurs équivalents localisés.
En général, vous devez utiliser l'un des noms d'actions prédéfinis, sauf si vous décrivez une action qui ne correspond à aucun d'entre eux :
| Nom de l'action | Description |
|---|---|
| toggleAction() | active ou désactive l’élément (case à cocher, bouton radio, commutateur, etc.) |
| decreaseAction() | diminue la valeur du champ accessible (par exemple, une zone de saisie à molette) |
| increaseAction() | augmente la valeur du contrôle (par exemple, une zone de saisie à molette) |
| pressAction() | appuyer, cliquer ou activer l'élément accessible (ce qui devrait correspondre à un clic de souris sur l'objet) |
| setFocusAction() | placer le focus sur cet élément accessible |
| showOnScreenAction() | déplacer cet élément accessible dans la fenêtre d'affichage |
| showMenuAction() | afficher un menu contextuel, ce qui correspond à un clic droit |
Pour déclencher l’action, on appelle doAction() en lui passant un nom d’action.
La plupart des widgets implémenteront simplement la méthode pressAction(). C'est ce qui se produit lorsque le widget est activé par un clic, une pression sur la barre d'espace ou une action similaire.
Documentation des fonctions membres
[constexpr noexcept default] QAccessibleActionInterface::QAccessibleActionInterface()
Construit par défaut une instance de ` QAccessibleActionInterface`.
[virtual noexcept] QAccessibleActionInterface::~QAccessibleActionInterface()
Supprime l'QAccessibleActionInterface.
[pure virtual] QStringList QAccessibleActionInterface::actionNames() const
Renvoie la liste des actions prises en charge par cet objet accessible. Les actions renvoyées doivent être classées par ordre de préférence : l'action que l'utilisateur est le plus susceptible de vouloir déclencher doit apparaître en premier, tandis que celle qu'il est le moins susceptible de déclencher doit apparaître en dernier.
La liste ne contient que les actions pouvant être invoquées. Elle ne renvoie pas les actions désactivées, ni celles associées à des contrôles d'interface utilisateur désactivés.
La liste peut être vide.
Notez que cette liste n’est pas localisée. Pour obtenir une représentation localisée, réimplémentez les méthodes ` localizedActionName()` et ` localizedActionDescription()`.
Voir également doAction(), localizedActionName() et localizedActionDescription().
[static] const QString &QAccessibleActionInterface::decreaseAction()
Renvoie le nom de l'action par défaut de diminution.
Voir également actionNames() et localizedActionName().
[pure virtual] void QAccessibleActionInterface::doAction(const QString &actionName)
Appelle l'action spécifiée par actionName. Notez que actionName correspond au nom non localisé tel qu'il est renvoyé par actionNames(). Cette fonction est généralement implémentée en appelant les mêmes fonctions que celles déclenchées par d'autres interactions de l'utilisateur, telles que le clic sur l'objet.
Voir également actionNames().
[static] const QString &QAccessibleActionInterface::increaseAction()
Renvoie le nom de l'action par défaut « augmentation ».
Voir également actionNames() et localizedActionName().
[pure virtual] QStringList QAccessibleActionInterface::keyBindingsForAction(const QString &actionName) const
Renvoie une liste des raccourcis clavier disponibles pour déclencher l'action nommée « actionName ».
Ceci est important pour permettre aux utilisateurs de découvrir d’autres façons d’utiliser l’application en mettant l’accent sur le clavier.
Voir aussi actionNames().
[virtual] QString QAccessibleActionInterface::localizedActionDescription(const QString &actionName) const
Renvoie une description localisée de l'action actionName.
Lorsque vous utilisez l'un des noms par défaut, vous pouvez appeler cette fonction dans ` QAccessibleActionInterface ` pour obtenir la chaîne localisée.
Voir également actionNames() et localizedActionName().
[virtual] QString QAccessibleActionInterface::localizedActionName(const QString &actionName) const
Renvoie le nom localisé de l'action « actionName ».
Pour les actions personnalisées, cette fonction doit être réimplémentée. Lorsque vous utilisez l'un des noms par défaut, vous pouvez appeler cette fonction dans ` QAccessibleActionInterface ` pour obtenir la chaîne localisée.
Voir également actionNames() et localizedActionDescription().
[static] QString QAccessibleActionInterface::nextPageAction()
Renvoie le nom de l'action par défaut de la page suivante.
Voir également actionNames() et localizedActionName().
[static] const QString &QAccessibleActionInterface::pressAction()
Renvoie le nom de l'action par défaut de « press ».
Voir également actionNames() et localizedActionName().
[static] QString QAccessibleActionInterface::previousPageAction()
Renvoie le nom de l'action par défaut de la page précédente.
Voir également actionNames() et localizedActionName().
[static] QString QAccessibleActionInterface::scrollDownAction()
Renvoie le nom de l'action par défaut « défilement vers le bas ».
Voir également actionNames() et localizedActionName().
[static] QString QAccessibleActionInterface::scrollLeftAction()
Renvoie le nom de l'action par défaut « défilement vers la gauche ».
Voir également actionNames() et localizedActionName().
[static] QString QAccessibleActionInterface::scrollRightAction()
Renvoie le nom de l'action par défaut « défilement vers la droite ».
Voir également actionNames() et localizedActionName().
[static] QString QAccessibleActionInterface::scrollUpAction()
Renvoie le nom de l'action par défaut « défilement vers le haut ».
Voir également actionNames() et localizedActionName().
[static] const QString &QAccessibleActionInterface::setFocusAction()
Renvoie le nom de l'action par défaut associée à la mise au premier plan.
Voir également actionNames() et localizedActionName().
[static] const QString &QAccessibleActionInterface::showMenuAction()
Renvoie le nom de l'action par défaut du menu « Afficher ».
Voir également actionNames() et localizedActionName().
[static] const QString &QAccessibleActionInterface::showOnScreenAction()
Renvoie le nom de l'action par défaut « Afficher à l'écran ».
Voir également actionNames() et localizedActionName().
[static] const QString &QAccessibleActionInterface::toggleAction()
Renvoie le nom de l'action par défaut du bouton bascule.
Voir également actionNames() et 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.
