QAccessibleActionInterface Class
Die Klasse „QAccessibleActionInterface“ implementiert die Unterstützung für aufrufbare Aktionen in der Schnittstelle. Mehr...
| Header: | #include <QAccessibleActionInterface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Vererbt an: |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QAccessibleActionInterface ist Teil der Barrierefreiheitsklassen.
Öffentliche Funktionen
| QAccessibleActionInterface() | |
| virtual | ~QAccessibleActionInterface() |
| virtual QStringList | actionNames() const = 0 |
| virtual void | doAction(const QString &actionName) = 0 |
| virtual QStringList | keyBindingsForAction(const QString &actionName) const = 0 |
| virtual QString | localizedActionDescription(const QString &actionName) const |
| virtual QString | localizedActionName(const QString &actionName) const |
Statische öffentliche Mitglieder
| const QString & | decreaseAction() |
| const QString & | increaseAction() |
| QString | nextPageAction() |
| const QString & | pressAction() |
| QString | previousPageAction() |
| QString | scrollDownAction() |
| QString | scrollLeftAction() |
| QString | scrollRightAction() |
| QString | scrollUpAction() |
| const QString & | setFocusAction() |
| const QString & | showMenuAction() |
| const QString & | showOnScreenAction() |
| const QString & | toggleAction() |
Ausführliche Beschreibung
Barrierefreie Objekte sollten die Aktionsschnittstelle implementieren, wenn sie Benutzerinteraktion unterstützen. In der Regel wird diese Schnittstelle von Klassen implementiert, die auch „ QAccessibleInterface “ implementieren.
Die unterstützten Aktionen sollten die in dieser Klasse angebotenen vordefinierten Aktionen verwenden, es sei denn, sie passen nicht zu einer vordefinierten Aktion. In diesem Fall kann eine benutzerdefinierte Aktion hinzugefügt werden.
Bei der Unterklassifizierung von `QAccessibleActionInterface` müssen Sie eine Liste von ` actionNames ` bereitstellen, da dies das wichtigste Mittel zum Ermitteln der verfügbaren Aktionen ist. Aktionsnamen werden niemals lokalisiert. Um dem Benutzer Aktionen anzuzeigen, gibt es zwei Funktionen, die lokalisierte Versionen des Namens zurückgeben und eine Beschreibung der Aktion liefern müssen. Verwenden Sie für die vordefinierten Aktionsnamen „ QAccessibleActionInterface::localizedActionName()“ und „ QAccessibleActionInterface::localizedActionDescription()“, um deren lokalisierte Entsprechungen zurückzugeben.
Im Allgemeinen sollten Sie einen der vordefinierten Aktionsnamen verwenden, es sei denn, Sie beschreiben eine Aktion, die nicht zu diesen passt:
| Aktionsname | Beschreibung |
|---|---|
| toggleAction() | schaltet das Element um (Kontrollkästchen, Optionsfeld, Schalter, …) |
| decreaseAction() | verringert den Wert des barrierefreien Elements (z. B. Drehfeld) |
| increaseAction() | erhöht den Wert des barrierefreien Elements (z. B. Drehfeld) |
| pressAction() | Das Steuerelement drücken, anklicken oder aktivieren (sollte dem Anklicken des Objekts mit der Maus entsprechen) |
| setFocusAction() | Den Fokus auf dieses Bedienelement setzen |
| showOnScreenAction() | dieses Element in den Ansichtsbereich verschieben |
| showMenuAction() | Ein Kontextmenü anzeigen, entspricht einem Rechtsklick |
Um die Aktion auszulösen, wird ` doAction()` mit einem Aktionsnamen aufgerufen.
Die meisten Widgets implementieren einfach ` pressAction()`. Dies geschieht, wenn das Widget durch einen Klick, das Drücken der Leertaste oder Ähnliches aktiviert wird.
Dokumentation der Mitgliedsfunktionen
[constexpr noexcept default] QAccessibleActionInterface::QAccessibleActionInterface()
Erstellt standardmäßig eine Instanz von ` QAccessibleActionInterface`.
[virtual noexcept] QAccessibleActionInterface::~QAccessibleActionInterface()
Zerstört den „ QAccessibleActionInterface “.
[pure virtual] QStringList QAccessibleActionInterface::actionNames() const
Gibt die Liste der von diesem barrierefreien Objekt unterstützten Aktionen zurück. Die zurückgegebenen Aktionen sollten in der bevorzugten Reihenfolge sortiert sein, d. h., die Aktion, die der Benutzer am ehesten auslösen möchte, sollte an erster Stelle stehen, während die am wenigsten wahrscheinliche Aktion an letzter Stelle stehen sollte.
Die Liste enthält nur Aktionen, die aufgerufen werden können. Deaktivierte Aktionen oder Aktionen, die mit deaktivierten UI-Steuerelementen verknüpft sind, werden nicht zurückgegeben.
Die Liste kann leer sein.
Beachten Sie, dass diese Liste nicht lokalisiert ist. Für eine lokalisierte Darstellung implementieren Sie „ localizedActionName()“ und „ localizedActionDescription()“ neu.
Siehe auch doAction(), localizedActionName() und localizedActionDescription().
[static] const QString &QAccessibleActionInterface::decreaseAction()
Gibt den Namen der Standardaktion „Verringern“ zurück.
Siehe auch actionNames() und localizedActionName().
[pure virtual] void QAccessibleActionInterface::doAction(const QString &actionName)
Ruft die unter actionName angegebene Aktion auf. Beachten Sie, dass actionName der nicht lokalisierte Name ist, wie er von actionNames() zurückgegeben wird. Diese Funktion wird in der Regel durch den Aufruf derselben Funktionen implementiert, die auch andere Benutzerinteraktionen – wie beispielsweise das Klicken auf das Objekt – auslösen würden.
Siehe auch actionNames().
[static] const QString &QAccessibleActionInterface::increaseAction()
Gibt den Namen der Standardaktion „Erhöhen“ zurück.
Siehe auch „ actionNames()“ und „ localizedActionName()“.
[pure virtual] QStringList QAccessibleActionInterface::keyBindingsForAction(const QString &actionName) const
Gibt eine Liste der Tastenkombinationen zurück, die zum Aufrufen der Aktion „ actionName “ verfügbar sind.
Dies ist wichtig, damit Benutzer alternative Möglichkeiten zur Nutzung der Anwendung kennenlernen, indem der Schwerpunkt auf die Tastatur gelegt wird.
Siehe auch „ actionNames()“.
[virtual] QString QAccessibleActionInterface::localizedActionDescription(const QString &actionName) const
Gibt eine lokalisierte Aktionsbeschreibung der Aktion „ actionName “ zurück.
Wenn Sie einen der Standardnamen verwenden, können Sie diese Funktion in ` QAccessibleActionInterface ` aufrufen, um die lokalisierte Zeichenfolge abzurufen.
Siehe auch „ actionNames()“ und „ localizedActionName()“.
[virtual] QString QAccessibleActionInterface::localizedActionName(const QString &actionName) const
Gibt einen lokalisierten Aktionsnamen für „ actionName “ zurück.
Für benutzerdefinierte Aktionen muss diese Funktion neu implementiert werden. Wenn Sie einen der Standardnamen verwenden, können Sie diese Funktion in ` QAccessibleActionInterface ` aufrufen, um die lokalisierte Zeichenfolge abzurufen.
Siehe auch „ actionNames()“ und „ localizedActionDescription()“.
[static] QString QAccessibleActionInterface::nextPageAction()
Gibt den Namen der Standardaktion für die nächste Seite zurück.
Siehe auch actionNames() und localizedActionName().
[static] const QString &QAccessibleActionInterface::pressAction()
Gibt den Namen der Standardaktion für „Drucken“ zurück.
Siehe auch actionNames() und localizedActionName().
[static] QString QAccessibleActionInterface::previousPageAction()
Gibt den Namen der Standardaktion „Zurück zur vorherigen Seite“ zurück.
Siehe auch „ actionNames()“ und „ localizedActionName()“.
[static] QString QAccessibleActionInterface::scrollDownAction()
Gibt den Namen der Standardaktion „Nach unten scrollen“ zurück.
Siehe auch „ actionNames()“ und „ localizedActionName()“.
[static] QString QAccessibleActionInterface::scrollLeftAction()
Gibt den Namen der Standardaktion „Nach links scrollen“ zurück.
Siehe auch „ actionNames()“ und „ localizedActionName()“.
[static] QString QAccessibleActionInterface::scrollRightAction()
Gibt den Namen der Standardaktion „Nach rechts scrollen“ zurück.
Siehe auch „ actionNames()“ und „ localizedActionName()“.
[static] QString QAccessibleActionInterface::scrollUpAction()
Gibt den Namen der Standardaktion „Nach oben scrollen“ zurück.
Siehe auch „ actionNames()“ und „ localizedActionName()“.
[static] const QString &QAccessibleActionInterface::setFocusAction()
Gibt den Namen der Standardaktion für den Fokuswechsel zurück.
Siehe auch „ actionNames()“ und „ localizedActionName()“.
[static] const QString &QAccessibleActionInterface::showMenuAction()
Gibt den Namen der Standardaktion des Show-Menüs zurück.
Siehe auch „ actionNames()“ und „ localizedActionName()“.
[static] const QString &QAccessibleActionInterface::showOnScreenAction()
Gibt den Namen der Standardaktion „Sendung auf dem Bildschirm anzeigen“ zurück.
Siehe auch „ actionNames()“ und „ localizedActionName()“.
[static] const QString &QAccessibleActionInterface::toggleAction()
Gibt den Namen der Standardaktion des Schalters zurück.
Siehe auch „ actionNames()“ und „ localizedActionName()“.
© 2026 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.
