Accessible QML Type

Permet l'accessibilité des éléments QML. Plus d'informations...

• 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é.

Documentation sur les propriétés

checkStateMixed : bool

Cette propriété indique si l'élément se trouve dans l'état partiellement vérifié.

Par défaut, cette propriété vaut false.

Voir également checked et checkable.

checkable : bool

Cette propriété indique si l'élément est vérifiable (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 également 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, la valeur de cette propriété est false.

description : string

Cette propriété définit une description accessible. Tout comme le 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, la valeur de 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, Switch, 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 dont QQuickItem::hasActiveFocus() renvoie 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 [since 6.10]

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, la valeur de cette propriété est undefined.

Cette propriété a été introduite dans Qt 6.10.

labelledBy : Item [since 6.10]

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, la valeur de cette propriété est 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 cet élément peut être modifié par un 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, la valeur de cette propriété est 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, la valeur de cette propriété est 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 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.

searchEdit : bool

Cette propriété indique si l'élément est pris en compte dans une requête de recherche. Cette propriété n'affecte que les textes modifiables.

Par défaut, 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 aussi selected.

selectableText : bool

Cette propriété indique si l'élément contient du texte sélectionnable.

Par défaut, la valeur de cette propriété est false.

selected : bool

Cette propriété indique si l'élément est sélectionné.

Par défaut, la valeur de cette propriété est false.

Voir également selectable.

Documentation sur les signaux

decreaseAction()

Ce signal est émis lorsqu'une action de diminution est reçue d'un outil d'assistance tel qu'un lecteur d'écran.

increaseAction()

Ce signal est émis lorsqu'une action d'augmentation est reçue d'un outil d'assistance tel qu'un lecteur d'écran.

nextPageAction()

Ce signal est émis lorsqu'une action "page suivante" est reçue d'un outil d'assistance tel qu'un lecteur d'écran.

pressAction()

Ce signal est émis lorsqu'une action de pression est reçue d'un outil d'assistance tel qu'un lecteur d'écran.

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.

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.

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.

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.

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.

toggleAction()

Ce signal est émis lorsqu'une action de basculement est reçue d'un outil d'assistance tel qu'un lecteur d'écran.

Documentation de la méthode

[since 6.8] void announce(string message, AnnouncementPoliteness politeness)

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.