QAccessibleActionInterface Class
Die Klasse QAccessibleActionInterface implementiert die Unterstützung für aufrufbare Aktionen in der Schnittstelle. Mehr...
| Kopfzeile: | #include <QAccessibleActionInterface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Vererbt von: |
- Liste aller Member, einschließlich geerbter Member
- QAccessibleActionInterface ist Teil von Accessibility Classes.
Öffentliche Funktionen
| 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 & | toggleAction() |
Detaillierte Beschreibung
Zugängliche Objekte sollten die Aktionsschnittstelle implementieren, wenn sie Benutzerinteraktion unterstützen. Normalerweise 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 eigene Aktion hinzugefügt werden.
Wenn Sie QAccessibleActionInterface subclassing, müssen Sie eine Liste von actionNames bereitstellen, die das primäre Mittel ist, um die verfügbaren Aktionen zu entdecken. Aktionsnamen werden niemals lokalisiert. Um dem Benutzer Aktionen zu präsentieren, gibt es zwei Funktionen, die lokalisierte Versionen des Namens zurückgeben und eine Beschreibung der Aktion liefern müssen. Für die vordefinierten Aktionsnamen verwenden Sie QAccessibleActionInterface::localizedActionName() und QAccessibleActionInterface::localizedActionDescription(), um ihre lokalisierten Entsprechungen zurückzugeben.
Im Allgemeinen sollten Sie einen der vordefinierten Aktionsnamen verwenden, es sei denn, Sie beschreiben eine Aktion, die nicht zu diesen Namen passt:
| Name der Aktion | Beschreibung |
|---|---|
| toggleAction() | schaltet das Element um (Kontrollkästchen, Optionsfeld, Schalter, ...) |
| decreaseAction() | verringert den Wert des zugänglichen Elements (z. B. Spinbox) |
| increaseAction() | erhöht den Wert des zugänglichen Elements (z.B. Spinbox) |
| pressAction() | Drücken oder Klicken oder Aktivieren des zugänglichen Objekts (sollte dem Klicken des Objekts mit der Maus entsprechen) |
| setFocusAction() | setze den Fokus auf dieses Accessible |
| showMenuAction() | ein Kontextmenü anzeigen, entspricht einem Rechtsklick |
Um die Aktion aufzurufen, wird doAction() mit einem Aktionsnamen aufgerufen.
Die meisten Widgets werden einfach pressAction() implementieren. Dies geschieht, wenn das Widget durch Anklicken, Drücken der Leertaste oder ähnliches aktiviert wird.
Dokumentation der Mitgliedsfunktionen
[virtual noexcept] QAccessibleActionInterface::~QAccessibleActionInterface()
Zerstört die QAccessibleActionInterface.
[pure virtual] QStringList QAccessibleActionInterface::actionNames() const
Gibt die Liste der von diesem zugänglichen Objekt unterstützten Aktionen zurück. Die zurückgegebenen Aktionen sollten in bevorzugter Reihenfolge sein, d. h. die Aktion, die der Benutzer am wahrscheinlichsten auslösen möchte, sollte zuerst zurückgegeben werden, während die am wenigsten wahrscheinliche Aktion zuletzt zurückgegeben werden sollte.
Die Liste enthält nur Aktionen, die aufgerufen werden können. Deaktivierte Aktionen oder Aktionen, die mit deaktivierten UI-Controls verbunden 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 für die Abnahme zurück.
Siehe auch actionNames() und localizedActionName().
[pure virtual] void QAccessibleActionInterface::doAction(const QString &actionName)
Ruft die durch actionName angegebene Aktion auf. Beachten Sie, dass actionName der nicht lokalisierte Name ist, der von actionNames() zurückgegeben wird. Diese Funktion wird in der Regel durch den Aufruf derselben Funktionen implementiert, die andere Benutzerinteraktionen, wie das Anklicken des Objekts, auslösen würden.
Siehe auch actionNames().
[static] const QString &QAccessibleActionInterface::increaseAction()
Gibt den Namen der Standardaktion increase zurück.
Siehe auch actionNames() und localizedActionName().
[pure virtual] QStringList QAccessibleActionInterface::keyBindingsForAction(const QString &actionName) const
Gibt eine Liste der Tastaturkürzel zurück, die für den Aufruf der Aktion mit dem Namen actionName verfügbar sind.
Dies ist wichtig, damit die Benutzer alternative Möglichkeiten zur Verwendung der Anwendung erlernen können, indem die Tastatur hervorgehoben 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 zu erhalten.
Siehe auch actionNames() und localizedActionName().
[virtual] QString QAccessibleActionInterface::localizedActionName(const QString &actionName) const
Gibt einen lokalisierten Aktionsnamen von 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 zu erhalten.
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 press zurück.
Siehe auch actionNames() und localizedActionName().
[static] QString QAccessibleActionInterface::previousPageAction()
Gibt den Namen der Standardaktion für die vorherige Seite zurück.
Siehe auch actionNames() und localizedActionName().
[static] QString QAccessibleActionInterface::scrollDownAction()
Gibt den Namen der Standardaktion "Nach unten blättern" 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 für das Blättern nach rechts zurück.
Siehe auch actionNames() und localizedActionName().
[static] QString QAccessibleActionInterface::scrollUpAction()
Gibt den Namen der Standardaktion "Nach oben blättern" zurück.
Siehe auch actionNames() und localizedActionName().
[static] const QString &QAccessibleActionInterface::setFocusAction()
Gibt den Namen der Standardaktion für den gesetzten Fokus zurück.
Siehe auch actionNames() und localizedActionName().
[static] const QString &QAccessibleActionInterface::showMenuAction()
Gibt den Namen der Standardaktion "Menü anzeigen" zurück.
Siehe auch actionNames() und localizedActionName().
[static] const QString &QAccessibleActionInterface::toggleAction()
Gibt den Namen der Standardaktion toggle zurück.
Siehe auch actionNames() und localizedActionName().
© 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.
