QAccessibleTextInterface Class
Die Klasse „QAccessibleTextInterface“ implementiert Funktionen zur Textverarbeitung. Mehr...
| Header: | #include <QAccessibleTextInterface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QAccessibleTextInterface ist Teil der Accessibility-Klassen.
Öffentliche Funktionen
| QAccessibleTextInterface() | |
| virtual | ~QAccessibleTextInterface() |
| virtual void | addSelection(int startOffset, int endOffset) = 0 |
| virtual QString | attributes(int offset, int *startOffset, int *endOffset) const = 0 |
| virtual int | characterCount() const = 0 |
| virtual QRect | characterRect(int offset) const = 0 |
| virtual int | cursorPosition() const = 0 |
| virtual int | offsetAtPoint(const QPoint &point) const = 0 |
| virtual void | removeSelection(int selectionIndex) = 0 |
| virtual void | scrollToSubstring(int startIndex, int endIndex) = 0 |
| virtual void | selection(int selectionIndex, int *startOffset, int *endOffset) const = 0 |
| virtual int | selectionCount() const = 0 |
| virtual void | setCursorPosition(int position) = 0 |
| virtual void | setSelection(int selectionIndex, int startOffset, int endOffset) = 0 |
| virtual QString | text(int startOffset, int endOffset) const = 0 |
| virtual QString | textAfterOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const |
| virtual QString | textAtOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const |
| virtual QString | textBeforeOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const |
Ausführliche Beschreibung
Diese Schnittstelle entspricht der Schnittstelle `IAccessibleText`. Sie sollte für Widgets implementiert werden, die mehr Text anzeigen als ein einfaches Label. Labels sollten ausschließlich durch ` QAccessibleInterface ` dargestellt werden und ihren Text als Namen zurückgeben (QAccessibleInterface::text() mit ` QAccessible::Name ` als Typ). Die Schnittstelle `QAccessibleTextInterface` ist typischerweise für Text vorgesehen, den ein Screenreader Zeile für Zeile vorlesen möchte, sowie für Widgets, die Textmarkierung und -eingabe unterstützen. Diese Schnittstelle ist beispielsweise für ` QLineEdit` implementiert.
Dokumentation der Mitgliedsfunktionen
[constexpr noexcept default] QAccessibleTextInterface::QAccessibleTextInterface()
Erzeugt standardmäßig eine Instanz von ` QAccessibleTextInterface`.
[virtual noexcept] QAccessibleTextInterface::~QAccessibleTextInterface()
Zerstört das „ QAccessibleTextInterface “.
[pure virtual] void QAccessibleTextInterface::addSelection(int startOffset, int endOffset)
Markieren Sie den Text von startOffset bis endOffset. startOffset ist das erste Zeichen, das markiert wird. endOffset ist das erste Zeichen, das nicht markiert wird.
Wenn das Objekt Mehrfachauswahlen unterstützt (z. B. in einem Textverarbeitungsprogramm), wird eine neue Auswahl hinzugefügt, andernfalls wird die vorherige Auswahl ersetzt.
Die Auswahl ist endOffset - startOffset Zeichen lang.
[pure virtual] QString QAccessibleTextInterface::attributes(int offset, int *startOffset, int *endOffset) const
Gibt die Textattribute an der Position offset zurück. Zudem wird der Bereich der Attribute in startOffset und endOffset zurückgegeben.
[pure virtual] int QAccessibleTextInterface::characterCount() const
Gibt die Länge des Textes zurück (Gesamtlänge einschließlich Leerzeichen).
[pure virtual] QRect QAccessibleTextInterface::characterRect(int offset) const
Gibt die Position und Größe des Zeichens an der Position offset in Bildschirmkoordinaten zurück.
[pure virtual] int QAccessibleTextInterface::cursorPosition() const
Gibt die aktuelle Cursorposition zurück.
Siehe auch „ setCursorPosition()“.
[pure virtual] int QAccessibleTextInterface::offsetAtPoint(const QPoint &point) const
Gibt den Offset des Zeichens an der Adresse point in Bildschirmkoordinaten zurück.
[pure virtual] void QAccessibleTextInterface::removeSelection(int selectionIndex)
Löscht die Auswahl mit dem Index „ selectionIndex “.
[pure virtual] void QAccessibleTextInterface::scrollToSubstring(int startIndex, int endIndex)
Stellt sicher, dass der Text zwischen „ startIndex “ und „ endIndex “ sichtbar ist.
[pure virtual] void QAccessibleTextInterface::selection(int selectionIndex, int *startOffset, int *endOffset) const
Gibt eine Auswahl zurück. Die Größe der Auswahl wird in den Parametern „ startOffset “ und „ endOffset “ zurückgegeben. Wenn keine Auswahl vorliegt, sind sowohl „ startOffset “ als auch „ endOffset “ gleich „ nullptr “.
Die Barrierefreiheits-APIs unterstützen mehrere Auswahlen. Bei den meisten Widgets wird jedoch nur eine Auswahl unterstützt, wobei selectionIndex den Wert 0 annimmt.
Siehe auch setSelection().
[pure virtual] int QAccessibleTextInterface::selectionCount() const
Gibt die Anzahl der Markierungen in diesem Text zurück.
[pure virtual] void QAccessibleTextInterface::setCursorPosition(int position)
Bewegt den Cursor auf position.
Siehe auch cursorPosition().
[pure virtual] void QAccessibleTextInterface::setSelection(int selectionIndex, int startOffset, int endOffset)
Legen Sie den Auswahl selectionIndex auf den Bereich von startOffset bis endOffset fest.
Siehe auch selection(), addSelection() und removeSelection().
[pure virtual] QString QAccessibleTextInterface::text(int startOffset, int endOffset) const
Gibt den Text von startOffset bis endOffset zurück. startOffset ist das erste Zeichen, das zurückgegeben wird. endOffset ist das erste Zeichen, das nicht zurückgegeben wird.
[virtual] QString QAccessibleTextInterface::textAfterOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
Gibt das Textelement vom Typ „ boundaryType “ zurück, das unmittelbar nach dem Offset „ offset “ liegt, und setzt die Werte „ startOffset “ und „ endOffset “ auf die Start- und Endposition dieses Elements; gibt eine leere Zeichenkette zurück, wenn kein solches Element vorhanden ist. Setzt die Werte „ startOffset “ und „ endOffset “ bei einem Fehler auf -1.
Diese Standardimplementierung ist für kleine Textbearbeitungen vorgesehen. Ein Textverarbeitungsprogramm oder Texteditor sollte eigene effiziente Implementierungen bereitstellen. Diese Funktion unterscheidet nicht zwischen Absätzen und Zeilen.
Hinweis: Diese Funktion kann die Cursorposition nicht berücksichtigen. Gemäß Konvention bedeutet ein „ offset “ von -2, dass diese Funktion die Cursorposition als Offset verwenden soll. Daher muss ein Offset von -2 vor dem Aufruf dieser Funktion in die Cursorposition umgewandelt werden. Ein Offset von -1 wird für die Textlänge verwendet, und benutzerdefinierte Implementierungen dieser Funktion müssen das Ergebnis so zurückgeben, als wäre die Länge als Offset übergeben worden.
[virtual] QString QAccessibleTextInterface::textAtOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
Gibt das Textelement vom Typ „ boundaryType “ an der Position „ offset “ zurück und setzt die Werte „ startOffset “ und „ endOffset “ auf die Start- und Endposition dieses Elements; gibt eine leere Zeichenkette zurück, wenn kein solches Element vorhanden ist. Setzt die Werte „ startOffset “ und „ endOffset “ bei einem Fehler auf -1.
Diese Standardimplementierung ist für kleine Textbearbeitungen vorgesehen. Ein Textverarbeitungsprogramm oder Texteditor sollte eigene effiziente Implementierungen bereitstellen. Diese Funktion unterscheidet nicht zwischen Absätzen und Zeilen.
Hinweis: Diese Funktion kann die Cursorposition nicht berücksichtigen. Gemäß Konvention bedeutet ein ` offset ` von -2, dass diese Funktion die Cursorposition als Offset verwenden soll. Daher muss ein Offset von -2 vor dem Aufruf dieser Funktion in die Cursorposition umgewandelt werden. Ein Offset von -1 wird für die Textlänge verwendet, und benutzerdefinierte Implementierungen dieser Funktion müssen das Ergebnis so zurückgeben, als wäre die Länge als Offset übergeben worden.
[virtual] QString QAccessibleTextInterface::textBeforeOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
Gibt das Textelement vom Typ „ boundaryType “ zurück, das nahe am Offset „ offset “ liegt, und setzt die Werte „ startOffset “ und „ endOffset “ auf die Start- und Endposition dieses Elements; gibt eine leere Zeichenkette zurück, wenn kein solches Element vorhanden ist. Setzt die Werte „ startOffset “ und „ endOffset “ bei einem Fehler auf -1.
Diese Standardimplementierung ist für kleine Textbearbeitungen vorgesehen. Ein Textverarbeitungsprogramm oder Texteditor sollte eigene effiziente Implementierungen bereitstellen. Diese Funktion unterscheidet nicht zwischen Absätzen und Zeilen.
Hinweis: Diese Funktion kann die Cursorposition nicht berücksichtigen. Gemäß Konvention bedeutet ein „ offset “ von -2, dass diese Funktion die Cursorposition als Offset verwenden soll. Daher muss ein Offset von -2 vor dem Aufruf dieser Funktion in die Cursorposition umgewandelt werden. Ein Offset von -1 wird für die Textlänge verwendet, und benutzerdefinierte Implementierungen dieser Funktion müssen das Ergebnis so zurückgeben, als wäre die Länge als Offset übergeben worden.
© 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.
