QAccessibleInterface Class

Documentation sur les fonctions membres

[constexpr noexcept protected default] QAccessibleInterface::QAccessibleInterface()

Construit par défaut une instance de ` QAccessibleInterface`.

[virtual noexcept protected] QAccessibleInterface::~QAccessibleInterface()

Supprime l'QAccessibleInterface.

QAccessibleActionInterface *QAccessibleInterface::actionInterface()

[virtual] QColor QAccessibleInterface::backgroundColor() const

Renvoie la couleur d'arrière-plan de l'élément accessible, le cas échéant, ou une valeur non valide de type ` QColor`.

Voir aussi foregroundColor().

[pure virtual] QAccessibleInterface *QAccessibleInterface::child(int index) const

Renvoie l'enfant accessible dont l'index est index. L'index commence à 0. Le nombre d'enfants d'un objet peut être vérifié à l'aide de childCount.

Renvoie ` nullptr ` lorsqu’on demande un enfant non valide (par exemple, lorsque l’enfant est devenu non valide entre-temps).

Voir également childCount() et parent().

[pure virtual] QAccessibleInterface *QAccessibleInterface::childAt(int x, int y) const

Renvoie l’ QAccessibleInterface e d’un élément enfant contenant les coordonnées à l’écran (x, y). S’il n’y a pas d’élément enfant à cette position, cette fonction renvoie nullptr. L’ e renvoyé doit être un élément enfant, mais pas nécessairement un enfant direct.

Cette fonction n'est fiable que pour les objets visibles (les objets invisibles risquent de ne pas être positionnés correctement).

Tous les objets visuels fournissent cette information.

Une implémentation par défaut est fournie pour les objets héritant de ` QAccessibleObject`. Celle-ci parcourt tous les enfants. Si le widget gère ses enfants (par exemple, un tableau), il sera plus efficace d’écrire une implémentation spécialisée.

Voir également ` rect()`.

[pure virtual] int QAccessibleInterface::childCount() const

Renvoie le nombre d'enfants associés à cet objet. Un enfant peut fournir lui-même des informations d'accessibilité (par exemple, un widget enfant) ou être un sous-élément de cet objet accessible.

Tous les objets fournissent ces informations.

Voir également indexOfChild().

[virtual] QAccessibleInterface *QAccessibleInterface::focusChild() const

Renvoie l'objet sur lequel se trouve le focus du clavier.

L'objet renvoyé peut être n'importe quel descendant, y compris lui-même.

[virtual] QColor QAccessibleInterface::foregroundColor() const

Renvoie la couleur de premier plan de l'élément actif, le cas échéant, ou une valeur non valide de type ` QColor`.

Voir également backgroundColor().

[pure virtual] int QAccessibleInterface::indexOfChild(const QAccessibleInterface *child) const

Renvoie l'index (à partir de 0) de l'objet child dans la liste des enfants de cet objet, ou -1 si child n'est pas un enfant de cet objet.

Tous les objets fournissent ces informations concernant leurs enfants.

Voir aussi childCount().

[virtual] void *QAccessibleInterface::interface_cast(QAccessible::InterfaceType type)

Renvoie une interface d'accessibilité spécialisée ` type ` à partir de l'interface générique ` QAccessibleInterface`.

Cette fonction doit être réimplémentée lorsqu'on fournit davantage d'informations sur un widget ou un objet via les interfaces spécialisées. Par exemple, un champ de saisie de texte devrait implémenter l'interface ` QAccessibleTextInterface`.

Voir également QAccessible::InterfaceType, QAccessibleTextInterface, QAccessibleValueInterface, QAccessibleActionInterface, QAccessibleTableInterface, QAccessibleTableCellInterface et QAccessibleViewportInterface.

[pure virtual] bool QAccessibleInterface::isValid() const

Renvoie « true » si toutes les données nécessaires à l’utilisation de cette implémentation d’interface sont valides (par exemple, si tous les pointeurs sont non nuls) ; sinon, renvoie « false ».

Voir également object().

[pure virtual] QObject *QAccessibleInterface::object() const

Renvoie un pointeur vers l'interface QObject, pour laquelle cette implémentation fournit des informations.

Voir également isValid().

[pure virtual] QAccessibleInterface *QAccessibleInterface::parent() const

Renvoie l'QAccessibleInterface du parent dans la hiérarchie des objets accessibles.

Renvoie nullptr si aucun parent n'existe (par exemple, pour l'objet d'application de niveau supérieur).

Voir aussi child().

[pure virtual] QRect QAccessibleInterface::rect() const

Renvoie la géométrie de l'objet. La géométrie est exprimée en coordonnées d'écran.

Cette fonction n'est fiable que pour les objets visibles (les objets invisibles risquent de ne pas être positionnés correctement).

Tous les objets visuels fournissent cette information.

Voir également ` childAt()`.

[virtual] QList<std::pair<QAccessibleInterface *, QAccessible::Relation>> QAccessibleInterface::relations(QAccessible::Relation match = QAccessible::AllRelations) const

Renvoie les relations pertinentes avec les autres widgets. En règle générale, cette fonction ne renvoie pas les relations parent/enfant, sauf si celles-ci sont gérées de manière spécifique, comme dans les arborescences. Elle renvoie généralement les relations « labeled-by » et « label ».

Il est possible de filtrer les relations à l'aide du paramètre facultatif ` match`. Cette fonction ne doit jamais se renvoyer elle-même.

Voir également ` parent()` et ` child()`.

[pure virtual] QAccessible::Role QAccessibleInterface::role() const

Renvoie le rôle de l'objet. Le rôle d'un objet est généralement statique.

Tous les objets accessibles ont un rôle.

Voir également text() et state().

[since 6.5] QAccessibleSelectionInterface *QAccessibleInterface::selectionInterface()

Cette fonction a été introduite dans Qt 6.5.

[pure virtual] void QAccessibleInterface::setText(QAccessible::Text t, const QString &text)

Définit la propriété de texte « t » de l'objet sur « text ».

Notez que les propriétés de texte de la plupart des objets sont en lecture seule ; l'appel de cette fonction peut donc ne produire aucun effet.

Voir également text().

[pure virtual] QAccessible::State QAccessibleInterface::state() const

Renvoie l'état actuel de l'objet. La valeur renvoyée est une combinaison des indicateurs de l'énumération QAccessible::StateFlag.

Tous les objets accessibles possèdent un état.

Voir également text() et role().

QAccessibleTableCellInterface *QAccessibleInterface::tableCellInterface()

QAccessibleTableInterface *QAccessibleInterface::tableInterface()

[pure virtual] QString QAccessibleInterface::text(QAccessible::Text t) const

Renvoie la valeur de la propriété text t de l'objet.

La propriété « QAccessible::Name » est une chaîne de caractères utilisée par les clients pour identifier, localiser ou annoncer un objet accessible à l’utilisateur. Tous les objets doivent posséder un nom unique au sein de leur conteneur. Ce nom pouvant être utilisé de différentes manières par les clients, il doit à la fois fournir une brève description de l’objet et être unique.

La propriété « QAccessible::Description » d’un objet accessible fournit des informations textuelles sur l’apparence visuelle de l’objet. La description sert principalement à fournir davantage de contexte aux utilisateurs malvoyants, mais elle est également utilisée pour la recherche contextuelle ou d’autres applications. Tous les objets ne possèdent pas de description. Un bouton « OK » n’a pas besoin de description, contrairement à un bouton d’outil affichant l’image d’un smiley.

L'QAccessible::Value d'un objet accessible représente les informations visuelles contenues dans l'objet, par exemple le texte d'un champ de saisie. En général, cette valeur peut être modifiée par l'utilisateur. Tous les objets ne possèdent pas de valeur ; c'est le cas, par exemple, des étiquettes de texte statiques, tandis que certains objets ont un état qui constitue déjà la valeur, comme les boutons à bascule.

Le texte d’ QAccessible::Help fournit des informations sur la fonction et l’utilisation d’un objet accessible. Tous les objets ne fournissent pas ces informations.

L’ QAccessible::Accelerator est un raccourci clavier qui active l’action par défaut de l’objet. Un raccourci clavier correspond au caractère souligné dans le texte d’un menu, d’un élément de menu ou d’un widget ; il s’agit soit du caractère lui-même, soit d’une combinaison de ce caractère et d’une touche de modification telle que Alt, Ctrl ou Maj. Les commandes de type « bouton d’outil » disposent également de raccourcis clavier, qui sont généralement affichés dans leur info-bulle.

L’ QAccessible::Identifier peut être défini explicitement afin de fournir un identifiant aux technologies d’assistance. Cela peut s’avérer particulièrement utile pour les tests d’interface utilisateur. Si aucun identifiant n’a été défini explicitement, l’identifiant est attribué par l’interface correspondante à partir d’un ID basé sur QObject::objectName ou son nom de classe, et sur QObject::objectName ou le nom de classe des parents dans sa chaîne de parents.

Tous les objets fournissent une chaîne de caractères pour ` QAccessible::Name`.

Voir également setText(), role() et state().

QAccessibleTextInterface *QAccessibleInterface::textInterface()

QAccessibleValueInterface *QAccessibleInterface::valueInterface()

[since 6.12] QAccessibleViewportInterface *QAccessibleInterface::viewportInterface()

Cette fonction a été introduite dans Qt 6.12.

[virtual] QWindow *QAccessibleInterface::window() const

Renvoie la fenêtre associée à l'objet sous-jacent. Par exemple, ` QAccessibleWidget ` réimplémente cette méthode et renvoie la méthode `windowHandle()` de ` QWidget`.

Cette méthode est utilisée sur certaines plateformes pour pouvoir notifier au client AT les changements d’état. Le backend remonte la hiérarchie des ancêtres jusqu’à ce qu’il trouve une fenêtre. (Cela signifie qu’au moins une interface parmi les ancêtres doit renvoyer un pointeur QWindow valide).

L’implémentation par défaut renvoie nullptr.