QAccessibleInterface Class

Dokumentation zu den Member-Funktionen

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

Erstellt standardmäßig eine Instanz von ` QAccessibleInterface`.

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

Zerstört das „ QAccessibleInterface “.

QAccessibleActionInterface *QAccessibleInterface::actionInterface()

[virtual] QColor QAccessibleInterface::backgroundColor() const

Gibt gegebenenfalls die Hintergrundfarbe des „accessible“-Elements zurück oder einen ungültigen „ QColor “-Wert.

Siehe auch ` foregroundColor()`.

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

Gibt das zugängliche untergeordnete Objekt mit dem Index „ index “ zurück. Der Index beginnt bei 0. Die Anzahl der untergeordneten Objekte eines Objekts kann mit „ childCount “ überprüft werden.

Gibt „ nullptr “ zurück, wenn ein ungültiges untergeordnetes Element abgefragt wird (z. B. wenn das untergeordnete Element inzwischen ungültig geworden ist).

Siehe auch „ childCount()“ und „ parent()“.

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

Gibt das „ QAccessibleInterface “ eines untergeordneten Elements zurück, das die Bildschirmkoordinaten enthält (x, y). Wenn an dieser Position keine untergeordneten Elemente vorhanden sind, gibt diese Funktion „ nullptr “ zurück. Das zurückgegebene „ “ muss ein untergeordnetes Element sein, jedoch nicht unbedingt ein direktes untergeordnetes Element.

Diese Funktion ist nur für sichtbare Objekte zuverlässig (unsichtbare Objekte werden möglicherweise nicht korrekt angeordnet).

Alle visuellen Objekte stellen diese Informationen bereit.

Für Objekte, die von ` QAccessibleObject` erben, wird eine Standardimplementierung bereitgestellt. Diese durchläuft alle untergeordneten Elemente. Wenn das Widget seine untergeordneten Elemente verwaltet (z. B. eine Tabelle), ist es effizienter, eine spezialisierte Implementierung zu schreiben.

Siehe auch ` rect()` ().

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

Gibt die Anzahl der untergeordneten Elemente zurück, die zu diesem Objekt gehören. Ein untergeordnetes Element kann selbst Barrierefreiheitsinformationen bereitstellen (z. B. ein untergeordnetes Widget) oder ein Unterelement dieses barrierefreien Objekts sein.

Alle Objekte stellen diese Informationen bereit.

Siehe auch ` indexOfChild()`.

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

Gibt das Objekt zurück, das den Tastaturfokus besitzt.

Das zurückgegebene Objekt kann ein beliebiger Nachkomme sein, einschließlich des Objekts selbst.

[virtual] QColor QAccessibleInterface::foregroundColor() const

Gibt gegebenenfalls die Vordergrundfarbe des „accessible“-Objekts zurück oder einen ungültigen Wert vom Typ „ QColor “.

Siehe auch ` backgroundColor()`.

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

Gibt den 0-basierten Index des Objekts „ child “ in der Unterobjektliste dieses Objekts zurück oder -1, wenn „ child “ kein Unterobjekt dieses Objekts ist.

Alle Objekte stellen diese Informationen über ihre untergeordneten Elemente bereit.

Siehe auch ` childCount()`.

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

Gibt eine spezialisierte Barrierefreiheitsschnittstelle „ type “ aus der generischen Schnittstelle „ QAccessibleInterface “ zurück.

Diese Funktion muss neu implementiert werden, wenn über die spezialisierten Schnittstellen weitere Informationen zu einem Widget oder Objekt bereitgestellt werden sollen. Beispielsweise sollte ein Zeileneingabefeld die Schnittstelle ` QAccessibleTextInterface` implementieren.

Siehe auch „ QAccessible::InterfaceType“ , „ QAccessibleTextInterface “, „ QAccessibleValueInterface “, „ QAccessibleActionInterface “, „ QAccessibleTableInterface “, „ QAccessibleTableCellInterface “ und „ QAccessibleViewportInterface “.

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

Gibt „ true “ zurück, wenn alle für die Verwendung dieser Schnittstellenimplementierung erforderlichen Daten gültig sind (z. B. sind alle Zeiger nicht null); andernfalls wird „ false “ zurückgegeben.

Siehe auch object().

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

Gibt einen Zeiger auf die ` QObject ` zurück, für die diese Schnittstellenimplementierung Informationen bereitstellt.

Siehe auch ` isValid()`.

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

Gibt den „ QAccessibleInterface “ des übergeordneten Objekts in der zugänglichen Objekthierarchie zurück.

Gibt „ nullptr “ zurück, wenn kein übergeordnetes Objekt vorhanden ist (z. B. beim Anwendungsobjekt der obersten Ebene).

Siehe auch child().

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

Gibt die Geometrie des Objekts zurück. Die Geometrie wird in Bildschirmkoordinaten angegeben.

Diese Funktion ist nur für sichtbare Objekte zuverlässig (unsichtbare Objekte werden möglicherweise nicht korrekt dargestellt).

Alle visuellen Objekte stellen diese Informationen bereit.

Siehe auch ` childAt()`.

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

Gibt die aussagekräftigen Beziehungen zu anderen Widgets zurück. In der Regel werden dabei keine Eltern-Kind-Beziehungen zurückgegeben, es sei denn, diese werden auf besondere Weise behandelt, wie beispielsweise in Baumansichten. Typischerweise werden die Beziehungen „labelled-by“ und „label“ zurückgegeben.

Es ist möglich, die Beziehungen mithilfe des optionalen Parameters ` match` zu filtern. Die Funktion sollte niemals sich selbst zurückgeben.

Siehe auch „ parent()“ und „ child()“.

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

Gibt die Rolle des Objekts zurück. Die Rolle eines Objekts ist in der Regel statisch.

Alle zugänglichen Objekte haben eine Rolle.

Siehe auch „ text()“ und „ state()“.

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

Diese Funktion wurde in Qt 6.5 eingeführt.

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

Setzt die Texteigenschaft „ t “ des Objekts auf „ text “.

Beachten Sie, dass die Texteigenschaften der meisten Objekte schreibgeschützt sind, sodass der Aufruf dieser Funktion möglicherweise keine Auswirkungen hat.

Siehe auch text().

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

Gibt den aktuellen Zustand des Objekts zurück. Der zurückgegebene Wert ist eine Kombination der Flags aus der Aufzählung „QAccessible::StateFlag“.

Alle barrierefreien Objekte haben einen Zustand.

Siehe auch „ text()“ und „ role()“.

QAccessibleTableCellInterface *QAccessibleInterface::tableCellInterface()

QAccessibleTableInterface *QAccessibleInterface::tableInterface()

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

Gibt den Wert der Texteigenschaft „ t “ des Objekts zurück.

Die „ QAccessible::Name “ ist eine Zeichenfolge, die von Clients verwendet wird, um ein barrierefreies Objekt für den Benutzer zu identifizieren, zu finden oder anzukündigen. Alle Objekte müssen einen Namen haben, der innerhalb ihres Containers eindeutig ist. Da der Name von Clients unterschiedlich verwendet werden kann, sollte er sowohl eine kurze Beschreibung des Objekts liefern als auch eindeutig sein.

Die Eigenschaft „ QAccessible::Description “ eines barrierefreien Objekts liefert textuelle Informationen über das visuelle Erscheinungsbild eines Objekts. Die Beschreibung dient in erster Linie dazu, sehbehinderten Nutzern einen besseren Kontext zu vermitteln, wird aber auch für die Kontextsuche oder andere Anwendungen genutzt. Nicht alle Objekte verfügen über eine Beschreibung. Eine „OK“-Schaltfläche benötigt keine Beschreibung, eine Werkzeugschaltfläche, die ein Smiley-Bild anzeigt, hingegen schon.

Der Wert („ QAccessible::Value “) eines barrierefreien Objekts stellt die visuellen Informationen dar, die das Objekt enthält, z. B. den Text in einem Zeilenbearbeitungsfeld. In der Regel kann der Wert vom Nutzer geändert werden. Nicht alle Objekte haben einen Wert, z. B. statische Textbeschriftungen nicht, und bei einigen Objekten ist der Status bereits der Wert, z. B. bei Umschalt-Schaltflächen.

Der „ QAccessible::Help “-Text liefert Informationen über die Funktion und Verwendung eines barrierefreien Objekts. Nicht alle Objekte stellen diese Informationen bereit.

Die „ QAccessible::Accelerator “ ist eine Tastenkombination, die die Standardaktion des Objekts auslöst. Ein Tastaturkürzel ist das unterstrichene Zeichen im Text eines Menüs, Menüpunkts oder Widgets und besteht entweder aus dem Zeichen selbst oder aus einer Kombination dieses Zeichens mit einer Modifikatortaste wie Alt, Strg oder Umschalt. Befehlssteuerelemente wie Werkzeugschaltflächen verfügen ebenfalls über Tastaturkürzel und zeigen diese in der Regel in ihrem Tooltip an.

Die „ QAccessible::Identifier “ kann explizit festgelegt werden, um Hilfstechnologien eine ID bereitzustellen. Dies kann insbesondere für UI-Tests nützlich sein. Wenn kein Bezeichner explizit festgelegt wurde, wird der Bezeichner von der jeweiligen Schnittstelle auf eine ID gesetzt, die auf „ QObject::objectName “ oder deren Klassennamen sowie auf „ QObject::objectName “ oder den Klassennamen der übergeordneten Elemente in der Elternkette basiert.

Alle Objekte stellen eine Zeichenkette für ` QAccessible::Name` bereit.

Siehe auch setText(), role() und state().

QAccessibleTextInterface *QAccessibleInterface::textInterface()

QAccessibleValueInterface *QAccessibleInterface::valueInterface()

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

Diese Funktion wurde in Qt 6.12 eingeführt.

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

Gibt das mit dem zugrunde liegenden Objekt verknüpfte Fenster zurück. Beispielsweise implementiert „ QAccessibleWidget “ diese Funktion neu und gibt die „windowHandle()“-Methode von „ QWidget “ zurück.

Dies wird auf einigen Plattformen verwendet, um den AT-Client über Zustandsänderungen zu benachrichtigen. Das Backend durchläuft alle übergeordneten Elemente nach oben, bis es ein Fenster findet. (Das bedeutet, dass mindestens eine Schnittstelle unter den übergeordneten Elementen einen gültigen Zeiger auf „ QWindow “ zurückgeben sollte).

Die Standardimplementierung gibt ` nullptr` zurück.