QAccessibleActionInterface Class
La classe QAccessibleActionInterface met en œuvre la prise en charge des actions invocables dans l'interface. Plus d'informations...
| En-tête : | #include <QAccessibleActionInterface> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Inherited By : |
- Liste de tous les membres, y compris les membres hérités
- QAccessibleActionInterface fait partie des classes d'accessibilité.
Fonctions publiques
| 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 & | 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. En général, cette interface est implémentée par des classes qui implémentent également QAccessibleInterface.
Les actions prises en charge doivent utiliser les actions prédéfinies proposées dans cette classe, sauf si elles ne correspondent pas à une 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 de actionNames qui est le principal moyen de découvrir les actions disponibles. Les noms des actions ne sont jamais localisés. Afin de présenter les actions à l'utilisateur, deux fonctions doivent renvoyer des versions localisées du nom et donner une description de l'action. Pour les noms d'action prédéfinis, utilisez QAccessibleActionInterface::localizedActionName() et QAccessibleActionInterface::localizedActionDescription() pour renvoyer leurs équivalents localisés.
En général, vous devriez utiliser l'un des noms d'action prédéfinis, sauf si vous décrivez une action qui ne correspond pas à ces noms :
| Nom de l'action | Description de l'action |
|---|---|
| toggleAction() | fait basculer l'élément (case à cocher, bouton radio, interrupteur, ...) |
| decreaseAction() | diminue la valeur de l'élément accessible (par exemple, spinbox) |
| increaseAction() | augmente la valeur de l'élément accessible (par exemple, spinbox) |
| pressAction() | appuyer ou cliquer ou activer l'accessible (devrait correspondre à un clic de souris sur l'objet) |
| setFocusAction() | mettre l'accent sur cet accès |
| showMenuAction() | afficher un menu contextuel, ce qui correspond à un clic droit. |
Afin d'invoquer l'action, doAction() est appelé avec un nom d'action.
La plupart des widgets implémenteront simplement pressAction(). C'est ce qui se passe lorsque le widget est activé par un clic, une pression sur l'espace ou une action similaire.
Documentation des fonctions membres
[virtual noexcept] QAccessibleActionInterface::~QAccessibleActionInterface()
Détruit le site 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 préférentiel, c'est-à-dire que l'action que l'utilisateur souhaite le plus probablement déclencher doit être renvoyée en premier, tandis que l'action la moins probable doit être renvoyée en dernier.
La liste ne contient que les actions qui peuvent être invoquées. Elle ne renvoie pas d'actions désactivées ou d'actions 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 une représentation localisée, réimplémentez localizedActionName() et localizedActionDescription().
Voir aussi doAction(), localizedActionName(), et localizedActionDescription().
[static] const QString &QAccessibleActionInterface::decreaseAction()
Renvoie le nom de l'action par défaut de diminution.
Voir aussi actionNames() et localizedActionName().
[pure virtual] void QAccessibleActionInterface::doAction(const QString &actionName)
Invoque l'action spécifiée par actionName. Notez que actionName est le nom non localisé renvoyé par actionNames(). Cette fonction est généralement mise en œuvre en appelant les mêmes fonctions que celles que déclencherait une autre interaction avec l'utilisateur, par exemple en cliquant sur l'objet.
Voir également actionNames().
[static] const QString &QAccessibleActionInterface::increaseAction()
Renvoie le nom de l'action par défaut d'augmentation.
Voir aussi actionNames() et localizedActionName().
[pure virtual] QStringList QAccessibleActionInterface::keyBindingsForAction(const QString &actionName) const
Renvoie une liste des raccourcis clavier disponibles pour invoquer l'action nommée actionName.
Ceci est important pour permettre aux utilisateurs d'apprendre 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.
Si vous utilisez l'un des noms par défaut, vous pouvez appeler cette fonction dans QAccessibleActionInterface pour obtenir la chaîne localisée.
Voir aussi actionNames() et localizedActionName().
[virtual] QString QAccessibleActionInterface::localizedActionName(const QString &actionName) const
Renvoie un nom d'action localisé de actionName.
Pour les actions personnalisées, cette fonction doit être réimplémentée. Si vous utilisez l'un des noms par défaut, vous pouvez appeler cette fonction dans QAccessibleActionInterface pour obtenir la chaîne de caractères localisée.
Voir aussi actionNames() et localizedActionDescription().
[static] QString QAccessibleActionInterface::nextPageAction()
Renvoie le nom de l'action par défaut de la page suivante.
Voir aussi actionNames() et localizedActionName().
[static] const QString &QAccessibleActionInterface::pressAction()
Renvoie le nom de l'action par défaut de la presse.
Voir aussi actionNames() et localizedActionName().
[static] QString QAccessibleActionInterface::previousPageAction()
Renvoie le nom de l'action par défaut de la page précédente.
Voir aussi actionNames() et localizedActionName().
[static] QString QAccessibleActionInterface::scrollDownAction()
Renvoie le nom de l'action par défaut de défilement vers le bas.
Voir aussi actionNames() et localizedActionName().
[static] QString QAccessibleActionInterface::scrollLeftAction()
Renvoie le nom de l'action par défaut de défilement vers la gauche.
Voir aussi actionNames() et localizedActionName().
[static] QString QAccessibleActionInterface::scrollRightAction()
Renvoie le nom de l'action par défaut de défilement vers la droite.
Voir aussi actionNames() et localizedActionName().
[static] QString QAccessibleActionInterface::scrollUpAction()
Renvoie le nom de l'action par défaut de défilement vers le haut.
Voir aussi actionNames() et localizedActionName().
[static] const QString &QAccessibleActionInterface::setFocusAction()
Renvoie le nom de l'action par défaut de la mise au point.
Voir aussi actionNames() et localizedActionName().
[static] const QString &QAccessibleActionInterface::showMenuAction()
Renvoie le nom de l'action par défaut de l'affichage du menu.
Voir aussi actionNames() et localizedActionName().
[static] const QString &QAccessibleActionInterface::toggleAction()
Renvoie le nom de l'action par défaut "toggle".
Voir aussi 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.
