Accessible QML Type (Uncreatable)

Permet l'accessibilité des éléments QML. En savoir plus...

Remarque : il s'agit d'un type non instanciable. Il ne peut pas être instancié en QML.

• Liste de tous les membres, y compris les membres hérités
• Accessible fait partie des classes d'accessibilité.

Propriétés

• checkStateMixed : bool
• checkable : bool
• checked : bool
• defaultButton : bool
• description : string
• editable : bool
• expandable : bool (since 6.12)
• expanded : bool (since 6.12)
• 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()
• showOnScreenAction()
• toggleAction()

Méthodes

• void announce(string message, AnnouncementPoliteness politeness) (since 6.8)

Description détaillée

Cette classe fait partie du cadre d'accessibilité pour les applications d'Qt Quick .

Les éléments avec lesquels l'utilisateur interagit ou qui lui fournissent des informations doivent exposer ces informations au framework d'accessibilité. Les outils d'assistance peuvent alors exploiter ces informations pour permettre aux utilisateurs d'interagir avec l'application de différentes manières. Cela permet, par exemple, d'utiliser les applications Qt Quick avec des lecteurs d'écran.

Les propriétés les plus importantes sont ` name`, ` description ` et ` role`.

Exemple d’implémentation d’un bouton simple :

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. La propriété ` name ` contient l’information la plus importante et est liée au texte affiché sur le bouton. Le nom est une description courte et concise du contrôle et doit refléter le libellé visuel. Dans ce cas, le nom seul ne permet pas de comprendre clairement la fonction du bouton ; c’est pourquoi la propriété ` description ` contient une explication. Il existe également un gestionnaire de signal Accessible.pressAction qui peut être appelé par des outils d’assistance pour déclencher le bouton. Ce gestionnaire de signal doit produire le même effet que celui obtenu en appuyant ou en cliquant sur le bouton.

Voir également Accessibilité.

Documentation sur les propriétés

checkStateMixed : bool

Cette propriété indique si cet élément se trouve dans l'état « partiellement coché ».

Par défaut, cette propriété est définie sur « false ».

Voir également « checked » et « checkable ».

checkable : bool

Cette propriété indique si cet élément peut être coché (comme une case à cocher ou certains boutons).

Par défaut, cette propriété est définie sur « false ».

Voir également checked.

checked : bool

Cette propriété indique si cet élément est actuellement coché.

Par défaut, cette propriété est définie sur « 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, cette propriété est définie sur « false ».

description : string

Cette propriété permet de définir une description accessible. À l'instar du nom, elle décrit l'élément. La description peut être un peu plus détaillée et expliquer à quoi sert l'élément, par exemple la fonctionnalité du bouton qu'elle décrit.

editable : bool

Cette propriété indique si le texte de cet élément est modifiable.

Par défaut, cette propriété prend la valeur « false ».

expandable : bool [since 6.12]

Cette propriété indique si cet élément est développable.

Par défaut, cette propriété est définie sur « false ».

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

Voir également expanded.

expanded : bool [since 6.12]

Cette propriété indique si cet élément est actuellement développé.

Par défaut, cette propriété est définie sur « false ».

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

Voir également expandable.

focusable : bool

Cette propriété indique si cet élément peut recevoir le focus.

Par défaut, cette propriété est définie sur « 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 cet élément a actuellement le focus.

Par défaut, cette propriété prend la valeur « false », mais elle renverra « true » pour les éléments dont la méthode QQuickItem::hasActiveFocus() renvoie « true ».

Voir également focusable.

id : string

Cette propriété définit un identifiant pour l'objet. Elle permet d'attribuer des identifiants stables aux tests d'interface utilisateur. Par défaut, l'identifiant correspond à l'ID de l'objet QML. Si l'ID n'est pas défini, la valeur par défaut « QAccessible::Identifier » est utilisée.

ignored : bool

Cette propriété détermine si cet élément doit être ignoré par le cadre d'accessibilité.

Il arrive parfois qu'un élément fasse partie d'un groupe d'éléments qui doivent être traités comme un tout. Par exemple, deux étiquettes peuvent être placées visuellement l'une à côté de l'autre, mais constituer des éléments distincts. À des fins 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 doté de la géométrie appropriée.

Par exemple, un affichage de vitesse ajoute « m/s » sous forme d’é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 définie sur « false ».

labelFor : Item [since 6.10]

Cette propriété contient l'élément auquel cet élément sert d'étiquette.

La définition de cette propriété configure automatiquement la relation « labelledBy » de l'autre objet.

Par défaut, cette propriété prend la valeur « undefined ».

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

labelledBy : Item [since 6.10]

Cette propriété contient l'élément utilisé comme libellé pour cet élément.

La définition de cette propriété configure automatiquement la relation « labelFor » de l'autre objet.

Par défaut, cette propriété est définie sur « undefined ».

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

multiLine : bool

Cette propriété indique si cet élément comporte plusieurs lignes de texte.

Par défaut, cette propriété est définie sur « false ».

name : string

Cette propriété permet de définir un nom accessible. Pour un bouton, par exemple, elle doit être associée à son texte. En général, cette propriété doit être définie sur un nom simple, concis et lisible par l'utilisateur. N'incluez pas le type de contrôle que vous souhaitez représenter, mais uniquement le nom.

passwordEdit : bool

Cette propriété indique si cet élément est un champ de saisie de mot de passe.

Par défaut, cette propriété prend la valeur « false ».

pressed : bool

Cette propriété indique si cet élément est enfoncé (par exemple, un bouton lors d'un clic de souris).

Par défaut, cette propriété est définie sur « false ».

readOnly : bool

Cette propriété indique qu'un champ de texte est en lecture seule.

Elle s'applique lorsque le rôle est « QAccessible::EditableText » et défini comme étant en lecture seule. Par défaut, cette propriété est « false ».

role : enumeration

Cet indicateur définit le type sémantique du widget. Un bouton, par exemple, aurait pour type « Button ». La valeur doit être l'une des suivantes : QAccessible::Role.

Certains rôles ont une sémantique particulière. Pour implémenter des cases à cocher, par exemple, une propriété « checked » est requise.

searchEdit : bool

Cette propriété indique si cet élément est saisi dans le cadre d'une requête de recherche. Elle ne s'applique qu'au texte modifiable.

Par défaut, cette propriété est définie sur « false ».

selectable : bool

Cette propriété indique si cet élément peut être sélectionné.

Par défaut, cette propriété est définie sur « 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 définie sur « false ».

selected : bool

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

Par défaut, cette propriété est définie sur « false ».

Voir également « selectable ».

Documentation sur les signaux

decreaseAction()

Ce signal est émis lorsqu'une action de réduction est reçue de la part d'un outil d'assistance, tel qu'un lecteur d'écran.

increaseAction()

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

nextPageAction()

Ce signal est émis lorsqu'une action de passage à la page suivante est reçue de la part d'un outil d'assistance, tel qu'un lecteur d'écran.

pressAction()

Ce signal est émis lorsqu'une action de clic est reçue de la part 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 de la part 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 de la part 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 de la part d'un outil d'assistance, tel qu'un lecteur d'écran.

showOnScreenAction()

Ce signal est émis lorsqu'un outil d'aide, tel qu'un lecteur d'écran, détecte un élément partiellement visible et demande que celui-ci soit entièrement visible.

toggleAction()

Ce signal est émis lorsqu'une action de basculement est reçue de la part 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)

Déclenche un événement d'annonce avec une message et une politesse politeness.

Cette méthode a été introduite dans Qt 6.8.

Voir également QAccessibleAnnouncementEvent.