Accessible QML Type

Ermöglicht die Zugänglichkeit von QML-Elementen. Mehr...

Import Statement: import QtQuick

Liste aller Mitglieder, einschließlich geerbter Mitglieder
Accessible ist Teil von Accessibility Classes.

Eigenschaften

checkStateMixed : bool
checkable : bool
checked : bool
defaultButton : bool
description : string
editable : bool
focusable : bool
focused : bool
id : string
ignored : bool
multiLine : bool
name : string
passwordEdit : bool
pressed : bool
readOnly : bool
role : enumeration
searchEdit : bool
selectable : bool
selectableText : bool
selected : bool

Signale

Detaillierte Beschreibung

Diese Klasse ist Teil der Zugänglichkeit für Qt Quick Anwendungen.

Elemente, mit denen der Benutzer interagiert oder die Informationen an den Benutzer weitergeben, müssen ihre Informationen dem Accessibility Framework zur Verfügung stellen. Dann können Hilfsmittel diese Informationen nutzen, um den Benutzern die Interaktion mit der Anwendung auf verschiedene Weise zu ermöglichen. Auf diese Weise können die Anwendungen von Qt Quick zum Beispiel mit Bildschirmlesegeräten genutzt werden.

Die wichtigsten Eigenschaften sind name, description und role.

Beispiel für die Implementierung einer einfachen Schaltfläche:

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
    }
}

Die role wird auf Button gesetzt, um den Typ des Steuerelements anzugeben. name ist die wichtigste Information und an den Text auf der Schaltfläche gebunden. Der Name ist eine kurze und prägnante Beschreibung des Steuerelements und sollte die visuelle Bezeichnung wiedergeben. In diesem Fall ist es nicht klar, was die Schaltfläche allein mit dem Namen macht, daher enthält description eine Erklärung. Es gibt auch einen Signalhandler Accessible.pressAction, der von Hilfsmitteln aufgerufen werden kann, um die Schaltfläche auszulösen. Dieser Signalhandler muss die gleiche Wirkung haben wie das Antippen oder Anklicken der Schaltfläche.

Siehe auch Barrierefreiheit.

Eigenschaft Dokumentation

checkStateMixed : bool

Diese Eigenschaft gibt an, ob sich das Element im teilweise geprüften Zustand befindet.

Standardmäßig ist diese Eigenschaft false.

Siehe auch checked und checkable.

checkable : bool

Diese Eigenschaft gibt an, ob dieses Element ankreuzbar ist (wie ein Kontrollkästchen oder einige Schaltflächen).

Standardmäßig ist diese Eigenschaft false.

Siehe auch checked.

checked : bool

Diese Eigenschaft gibt an, ob dieses Element derzeit markiert ist.

Standardmäßig ist diese Eigenschaft false.

Siehe auch checkable.

defaultButton : bool

Diese Eigenschaft gibt an, ob dieses Element die Standardschaltfläche eines Dialogs ist.

Standardmäßig ist diese Eigenschaft false.

description : string

Diese Eigenschaft legt eine zugängliche Beschreibung fest. Ähnlich wie der Name beschreibt sie das Element. Die Beschreibung kann etwas ausführlicher sein und die Funktion des Elements beschreiben, z. B. die Funktionalität der Schaltfläche, die es beschreibt.

editable : bool

Diese Eigenschaft gibt an, ob dieses Element einen editierbaren Text hat.

Standardmäßig lautet diese Eigenschaft false.

focusable : bool

Diese Eigenschaft gibt an, ob dieses Element fokussierbar ist.

Standardmäßig ist diese Eigenschaft false, außer bei Elementen, deren Rolle eine der folgenden ist: CheckBox, RadioButton, Button, MenuItem, PageTab, EditableText, SpinBox, ComboBox, Terminal oder ScrollBar.

Siehe auch focused.

focused : bool

Diese Eigenschaft gibt an, ob dieses Element derzeit den aktiven Fokus hat.

Standardmäßig ist diese Eigenschaft false, aber sie gibt true für Elemente zurück, die QQuickItem::hasActiveFocus() und true haben.

Siehe auch focusable.

id : string

Diese Eigenschaft legt einen Bezeichner für das Objekt fest. Sie kann verwendet werden, um stabile Bezeichner für UI-Tests bereitzustellen. Standardmäßig wird der Bezeichner auf die ID des QML-Objekts gesetzt. Wenn die ID nicht festgelegt ist, wird der Standardwert QAccessible::Identifier verwendet.

ignored : bool

Diese Eigenschaft gibt an, ob dieses Element vom Accessibility Framework ignoriert werden soll.

Manchmal ist ein Element Teil einer Gruppe von Elementen, die als ein einziges behandelt werden sollten. Beispielsweise können zwei Beschriftungen visuell nebeneinander platziert werden, obwohl sie separate Elemente sind. Für die Zwecke der Barrierefreiheit sollten sie als ein Element behandelt werden und werden daher durch ein drittes unsichtbares Element mit der richtigen Geometrie dargestellt.

Zum Beispiel fügt eine Geschwindigkeitsanzeige "m/s" als kleinere Beschriftung hinzu:

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"
}

Standardmäßig ist diese Eigenschaft false.

multiLine : bool

Diese Eigenschaft gibt an, ob dieses Element mehrere Textzeilen hat.

Standardmäßig lautet diese Eigenschaft false.

name : string

Diese Eigenschaft legt einen zugänglichen Namen fest. Für eine Schaltfläche zum Beispiel sollte dies eine Bindung an ihren Text haben. Im Allgemeinen sollte diese Eigenschaft auf einen einfachen und prägnanten, aber für Menschen lesbaren Namen gesetzt werden. Geben Sie nicht den Typ des Steuerelements an, den Sie darstellen wollen, sondern nur den Namen.

passwordEdit : bool

Diese Eigenschaft gibt an, ob es sich bei diesem Element um eine Kennworttextbearbeitung handelt.

Standardmäßig ist diese Eigenschaft false.

pressed : bool

Diese Eigenschaft gibt an, ob dieses Element gedrückt ist (z. B. eine Schaltfläche bei einem Mausklick).

Standardmäßig ist diese Eigenschaft false.

readOnly : bool

Diese Eigenschaft zeigt an, dass ein Textfeld schreibgeschützt ist.

Sie ist relevant, wenn die Rolle QAccessible::EditableText lautet und auf schreibgeschützt eingestellt ist. Standardmäßig ist diese Eigenschaft false.

role : enumeration

Diese Flagge legt den semantischen Typ des Widgets fest. Eine Schaltfläche hätte zum Beispiel "Button" als Typ. Der Wert muss einer von QAccessible::Role sein.

Einige Rollen haben eine spezielle Semantik. Für die Implementierung von Kontrollkästchen wird zum Beispiel die Eigenschaft "checked" erwartet.

Rolle	Eigenschaften und Signale	Erläuterung
Alle interaktiven Elemente	focusable und focused	Bei allen Elementen, mit denen der Benutzer interagieren kann, sollte focusable auf `true` und `focus` auf `true` gesetzt werden, wenn sie den Fokus haben. Dies ist sogar für Anwendungen wichtig, die auf reinen Touch-Geräten laufen, da Bildschirmlesegeräte oft einen virtuellen Fokus implementieren, der von Element zu Element verschoben werden kann.
Schaltfläche, CheckBox, RadioButton	Accessible.pressAction	Eine Schaltfläche sollte einen Signalhandler mit dem Namen `onPressAction` haben. Dieses Signal kann von einem Hilfsmittel wie z. B. einem Bildschirmlesegerät ausgegeben werden. Die Implementierung muss sich genauso verhalten wie ein Mausklick oder ein Tippen auf die Schaltfläche.
CheckBox, RadioButton	checkable, checked, Accessible.toggleAction	Der Prüfstatus des Kontrollkästchens. Aktualisiert bei den Aktionen Drücken, Ankreuzen und Abwählen.
Schieberegler, SpinBox, Wählen, ScrollBar	`value`, `minimumValue`, `maximumValue`, `stepSize`	Diese Eigenschaften spiegeln den Zustand und die möglichen Werte für die Elemente wider.
Schieberegler, SpinBox, Wählscheibe, ScrollBar	Accessible.increaseAction, Accessible.decreaseAction	Aktionen zum Erhöhen und Verringern des Wertes des Elements.

searchEdit : bool

Diese Eigenschaft gibt an, ob dieses Element als Eingabe für eine Suchanfrage dient. Diese Eigenschaft wirkt sich nur auf editierbaren Text aus.

Standardmäßig ist diese Eigenschaft false.

selectable : bool

Diese Eigenschaft gibt an, ob dieses Element ausgewählt werden kann.

Standardmäßig steht diese Eigenschaft auf false.

Siehe auch selected.

selectableText : bool

Diese Eigenschaft gibt an, ob dieses Element auswählbaren Text enthält.

Standardmäßig ist diese Eigenschaft false.

selected : bool

Diese Eigenschaft gibt an, ob dieses Element ausgewählt ist.

Standardmäßig lautet diese Eigenschaft false.

Siehe auch selectable.

Signal Dokumentation

decreaseAction()

Dieses Signal wird ausgegeben, wenn eine Verkleinerungsaktion von einem Hilfsmittel wie z. B. einem Bildschirmlesegerät empfangen wird.

Hinweis: Der entsprechende Handler ist onDecreaseAction.

increaseAction()

Dieses Signal wird ausgegeben, wenn eine Vergrößerungsaktion von einem Hilfsmittel wie einem Bildschirmleser empfangen wird.

Hinweis: Der entsprechende Handler ist onIncreaseAction.

nextPageAction()

Dieses Signal wird ausgegeben, wenn eine Aktion "Nächste Seite" von einem Hilfsmittel wie z. B. einem Bildschirmlesegerät empfangen wird.

Hinweis: Der entsprechende Handler ist onNextPageAction.

pressAction()

Dieses Signal wird ausgegeben, wenn von einem Hilfsmittel wie einem Bildschirmlesegerät eine Aktion "Drücken" empfangen wird.

Hinweis: Der entsprechende Handler ist onPressAction.

previousPageAction()

Dieses Signal wird ausgegeben, wenn eine "Vorherige Seite"-Aktion von einem Hilfsmittel wie z. B. einem Bildschirmlesegerät empfangen wird.

Hinweis: Der entsprechende Handler ist onPreviousPageAction.

scrollDownAction()

Dieses Signal wird ausgegeben, wenn eine Aktion zum Herunterblättern von einem Hilfsmittel wie z. B. einem Screenreader empfangen wird.

Hinweis: Der entsprechende Handler ist onScrollDownAction.

scrollLeftAction()

Dieses Signal wird ausgegeben, wenn von einem Hilfsmittel wie z. B. einem Bildschirmlesegerät ein Bildlauf nach links empfangen wird.

Hinweis: Der entsprechende Handler ist onScrollLeftAction.

scrollRightAction()

Dieses Signal wird ausgegeben, wenn eine Aktion zum Scrollen nach rechts von einem Hilfsmittel wie einem Bildschirmlesegerät empfangen wird.

Hinweis: Der entsprechende Handler ist onScrollRightAction.

scrollUpAction()

Dieses Signal wird ausgegeben, wenn eine Bildlaufaktion nach oben von einem Hilfsmittel wie einem Bildschirmlesegerät empfangen wird.

Hinweis: Der entsprechende Handler ist onScrollUpAction.

toggleAction()

Dieses Signal wird ausgegeben, wenn eine Umschaltaktion von einem Hilfsmittel wie z. B. einem Bildschirmlesegerät empfangen wird.

Hinweis: Der entsprechende Handler ist onToggleAction.

© 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.