Accessible QML Type
Permet l'accessibilité des éléments QML. Plus d'informations...
| Import Statement: | import QtQuick |
- Liste de tous les membres, y compris les membres hérités
- Accessible fait partie de Accessibility Classes.
Propriétés
- checkStateMixed : bool
- checkable : bool
- checked : bool
- defaultButton : bool
- description : string
- editable : bool
- focusable : bool
- focused : bool
- id : string
- ignored : bool
- labelFor : Item
(since 6.10) - labelledBy : Item
(since 6.10) - multiLine : bool
- name : string
- passwordEdit : bool
- pressed : bool
- readOnly : bool
- role : enumeration
- searchEdit : bool
- selectable : bool
- selectableText : bool
- selected : bool
Signaux
- decreaseAction()
- increaseAction()
- nextPageAction()
- pressAction()
- previousPageAction()
- scrollDownAction()
- scrollLeftAction()
- scrollRightAction()
- scrollUpAction()
- toggleAction()
Méthodes
- void announce(string message, AnnouncementPoliteness politeness)
(since 6.8)
Description détaillée
Cette classe fait partie de l'accessibilité des applications Qt Quick .
Les éléments avec lesquels l'utilisateur interagit ou qui lui fournissent des informations doivent exposer ces informations au cadre d'accessibilité. Les outils d'assistance peuvent alors utiliser ces informations pour permettre aux utilisateurs d'interagir avec l'application de différentes manières. Cela permet aux applications Qt Quick d'être utilisées avec des lecteurs d'écran, par exemple.
Les propriétés les plus importantes sont name, description et role.
Exemple de mise en œuvre d'un simple bouton :
Rectangle { id: myButton Text { id: label text: "next" } Accessible.role: Accessible.Button Accessible.name: label.text Accessible.description: "shows the next page" Accessible.onPressAction: { // do a button click } }
La propriété role est définie sur Button pour indiquer le type de contrôle. name est l'information la plus importante et est liée au texte du bouton. Le nom est une description courte et concise du contrôle et doit refléter l'étiquette visuelle. Dans le cas présent, la fonction du bouton n'est pas claire avec le seul nom, c'est pourquoi description contient une explication. Il existe également un gestionnaire de signal Accessible.pressAction qui peut être invoqué par les outils d'assistance pour déclencher le bouton. Ce gestionnaire de signal doit avoir le même effet que le fait de taper ou de cliquer sur le bouton.
Voir aussi Accessibilité.
Propriété Documentation
checkStateMixed : bool |
checkable : bool |
Cette propriété indique si l'élément est cochable (comme une case à cocher ou certains boutons).
Par défaut, la valeur de cette propriété est false.
Voir aussi checked.
checked : bool |
Cette propriété indique si l'élément est actuellement coché.
Par défaut, la valeur de cette propriété est false.
Voir aussi checkable.
defaultButton : bool |
Cette propriété indique si cet élément est le bouton par défaut d'une boîte de dialogue.
Par défaut, cette propriété est false.
description : string |
Cette propriété définit une description accessible. Similaire au nom, elle décrit l'élément. La description peut être un peu plus verbeuse et indiquer ce que fait l'élément, par exemple la fonctionnalité du bouton qu'elle décrit.
editable : bool |
Cette propriété indique si le texte de l'élément est modifiable.
Par défaut, cette propriété est false.
focusable : bool |
Cette propriété indique si l'élément est focalisable.
Par défaut, cette propriété est false sauf pour les éléments dont le rôle est l'un des suivants : CheckBox, RadioButton, Button, MenuItem, PageTab, EditableText, SpinBox, ComboBox, Terminal ou ScrollBar.
Voir également focused.
focused : bool |
Cette propriété indique si l'élément a actuellement le focus actif.
Par défaut, cette propriété est false, mais elle renvoie true pour les éléments qui ont QQuickItem::hasActiveFocus() renvoyant true.
Voir également focusable.
id : string |
Cette propriété définit un identifiant pour l'objet. Elle peut être utilisée pour fournir des identifiants stables aux tests d'interface utilisateur. Par défaut, l'identifiant correspond à l'ID de l'objet QML. Si l'identifiant n'est pas défini, la valeur par défaut de QAccessible::Identifier est utilisée.
ignored : bool |
Cette propriété indique si cet élément doit être ignoré par le cadre d'accessibilité.
Parfois, un élément fait partie d'un groupe d'éléments qui doivent être traités comme un seul. Par exemple, deux étiquettes peuvent être visuellement placées l'une à côté de l'autre, mais il s'agit d'éléments distincts. Pour des raisons d'accessibilité, elles doivent être traitées comme un seul élément et sont donc représentées par un troisième élément invisible ayant la bonne géométrie.
Par exemple, un affichage de la vitesse ajoute "m/s" en tant qu'étiquette plus petite :
Row { Label { id: speedLabel text: "Speed: 5" Accessible.ignored: true } Label { text: qsTr("m/s") Accessible.ignored: true } Accessible.role: Accessible.StaticText Accessible.name: speedLabel.text + " meters per second" }
Par défaut, cette propriété est false.
labelFor : Item |
Cette propriété contient l'élément pour lequel cet élément est une étiquette.
La définition de cette propriété établit automatiquement la relation labelledBy de l'autre objet.
Par défaut, cette propriété est undefined.
Cette propriété a été introduite dans Qt 6.10.
labelledBy : Item |
Cette propriété contient l'élément qui est utilisé comme étiquette pour cet élément.
La définition de cette propriété établit automatiquement la relation labelFor de l'autre objet.
Par défaut, la valeur de cette propriété est undefined.
Cette propriété a été introduite dans Qt 6.10.
multiLine : bool |
Cette propriété indique si l'élément a plusieurs lignes de texte.
Par défaut, cette propriété vaut false.
name : string |
Cette propriété définit un nom accessible. Pour un bouton, par exemple, ce nom doit être lié à son texte. En général, cette propriété doit être définie par un nom simple et concis, mais lisible par l'homme. N'indiquez pas le type de contrôle que vous souhaitez représenter, mais simplement le nom.
passwordEdit : bool |
Cette propriété indique si l'élément est une édition de texte avec mot de passe.
Par défaut, la valeur de cette propriété est false.
pressed : bool |
Cette propriété indique si cet élément est pressé (par exemple un bouton lors d'un clic de souris).
Par défaut, cette propriété vaut false.
readOnly : bool |
Cette propriété indique qu'un champ de texte est en lecture seule.
Elle est pertinente lorsque le rôle est QAccessible::EditableText et qu'il est défini comme étant en lecture seule. Par défaut, cette propriété a la valeur false.
role : enumeration |
Ce drapeau définit le type sémantique du widget. Un bouton, par exemple, aura pour type "Button". La valeur doit être l'une des valeurs suivantes : QAccessible::Role.
Certains rôles ont une sémantique particulière. Pour mettre en œuvre des cases à cocher, par exemple, une propriété "checked" est attendue.
| Rôle | Propriétés et signaux | Explication |
|---|---|---|
| Tous les éléments interactifs | focusable et focused | Tous les éléments avec lesquels l'utilisateur peut interagir doivent avoir la valeur true pour focusable et la valeur true pour focus lorsqu'ils ont le focus. Ceci est important même pour les applications qui fonctionnent sur des appareils tactiles car les lecteurs d'écran implémentent souvent un focus virtuel qui peut être déplacé d'un élément à l'autre. |
| Bouton, CheckBox, RadioButton | Accessible.pressAction | Un bouton doit avoir un gestionnaire de signal portant le nom onPressAction. Ce signal peut être émis par un outil d'assistance tel qu'un lecteur d'écran. La mise en œuvre doit se comporter de la même manière qu'un clic de souris ou un tapotement sur le bouton. |
| CheckBox, RadioButton | checkable, checked, Accessible.toggleAction | L'état de la case à cocher. Mise à jour des actions Press, Check et Uncheck. |
| Curseur, SpinBox, Cadran, ScrollBar | value, minimumValue, maximumValue, stepSize | Ces propriétés reflètent l'état et les valeurs possibles des éléments. |
| Curseur, SpinBox, Dial, ScrollBar | Accessible.increaseAction, Accessible.decreaseAction | Actions permettant d'augmenter ou de diminuer la valeur de l'élément. |
searchEdit : bool |
Cette propriété indique si l'élément est une entrée pour une requête de recherche. Cette propriété n'affecte que le texte modifiable.
Par défaut, la valeur de cette propriété est false.
selectable : bool |
Cette propriété indique si cet élément peut être sélectionné.
Par défaut, la valeur de cette propriété est false.
Voir également selected.
selectableText : bool |
Cette propriété indique si cet élément contient du texte sélectionnable.
Par défaut, cette propriété est false.
selected : bool |
Cette propriété indique si cet élément est sélectionné.
Par défaut, cette propriété est false.
Voir également selectable.
Signal Documentation
decreaseAction() |
Ce signal est émis lorsqu'une action de diminution est reçue d'un outil d'assistance tel qu'un lecteur d'écran.
Remarque : le gestionnaire correspondant est onDecreaseAction.
increaseAction() |
Ce signal est émis lorsqu'une action d'augmentation est reçue d'un outil d'assistance tel qu'un lecteur d'écran.
Note : Le gestionnaire correspondant est onIncreaseAction.
nextPageAction() |
Ce signal est émis lorsqu'une action de page suivante est reçue d'un outil d'assistance tel qu'un lecteur d'écran.
Note : Le gestionnaire correspondant est onNextPageAction.
pressAction() |
Ce signal est émis lorsqu'une action de pression est reçue d'un outil d'assistance tel qu'un lecteur d'écran.
Note : Le gestionnaire correspondant est onPressAction.
previousPageAction() |
Ce signal est émis lorsqu'une action de page précédente est reçue d'un outil d'assistance tel qu'un lecteur d'écran.
Remarque : Le gestionnaire correspondant est onPreviousPageAction.
scrollDownAction() |
Ce signal est émis lorsqu'une action de défilement vers le bas est reçue d'un outil d'assistance tel qu'un lecteur d'écran.
Remarque : Le gestionnaire correspondant est onScrollDownAction.
scrollLeftAction() |
Ce signal est émis lorsqu'une action de défilement vers la gauche est reçue d'un outil d'assistance tel qu'un lecteur d'écran.
Remarque : Le gestionnaire correspondant est onScrollLeftAction.
scrollRightAction() |
Ce signal est émis lorsqu'une action de défilement vers la droite est reçue d'un outil d'assistance tel qu'un lecteur d'écran.
Remarque : Le gestionnaire correspondant est onScrollRightAction.
scrollUpAction() |
Ce signal est émis lorsqu'une action de défilement vers le haut est reçue d'un outil d'assistance tel qu'un lecteur d'écran.
Note : Le gestionnaire correspondant est onScrollUpAction.
toggleAction() |
Ce signal est émis lorsqu'une action de basculement est reçue d'un outil d'assistance tel qu'un lecteur d'écran.
Remarque : Le gestionnaire correspondant est onToggleAction.
Documentation de la méthode
|
Emet un événement d'annonce avec un message avec la politesse politeness.
Cette méthode a été introduite dans Qt 6.8.
Voir aussi QAccessibleAnnouncementEvent.
© 2025 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.