QAccessibleTextInterface Class
Die Klasse QAccessibleTextInterface implementiert Unterstützung für die Textverarbeitung. Mehr...
| Kopfzeile: | #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 von Accessibility Classes.
Öffentliche Funktionen
| 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 |
Detaillierte Beschreibung
Diese Schnittstelle entspricht der Schnittstelle IAccessibleText. Sie sollte für Widgets implementiert werden, die mehr Text als eine einfache Beschriftung anzeigen. Labels sollten nur durch QAccessibleInterface repräsentiert werden und ihren Text als Namen zurückgeben (QAccessibleInterface::text() mit QAccessible::Name als Typ). Das QAccessibleTextInterface ist typischerweise für Text, den ein Screenreader zeilenweise lesen möchte, und für Widgets, die Textauswahl und -eingabe unterstützen. Diese Schnittstelle ist z.B. für QLineEdit implementiert.
Dokumentation der Mitgliedsfunktionen
[virtual noexcept] QAccessibleTextInterface::~QAccessibleTextInterface()
Zerstört die QAccessibleTextInterface.
[pure virtual] void QAccessibleTextInterface::addSelection(int startOffset, int endOffset)
Wählen Sie den Text von startOffset bis endOffset. startOffset ist das erste Zeichen, das ausgewählt wird. Das endOffset ist das erste Zeichen, das nicht ausgewählt 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 umfasst die Zeichen endOffset - startOffset.
[pure virtual] QString QAccessibleTextInterface::attributes(int offset, int *startOffset, int *endOffset) const
Gibt die Textattribute an der Position offset zurück. Darüber hinaus 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 (Gesamtgröße 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 Position des Cursors zurück.
Siehe auch setCursorPosition().
[pure virtual] int QAccessibleTextInterface::offsetAtPoint(const QPoint &point) const
Gibt den Offset des Zeichens auf 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)
Sorgt dafür, 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 startOffset und endOffset zurückgegeben. Wenn es keine Auswahl gibt, sind startOffset und endOffset nullptr .
Die Zugänglichkeits-APIs unterstützen Mehrfachauswahlen. Für die meisten Widgets wird jedoch nur eine Auswahl mit selectionIndex gleich 0 unterstützt.
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 zu position.
Siehe auch cursorPosition().
[pure virtual] void QAccessibleTextInterface::setSelection(int selectionIndex, int startOffset, int endOffset)
Setzen Sie die Auswahl selectionIndex auf den Bereich von startOffset bis endOffset.
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. Das 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 sich direkt nach dem Offset offset befindet, und setzt die Werte startOffset und endOffset auf die Start- und Endpositionen dieses Elements; gibt eine leere Zeichenkette zurück, wenn es kein solches Element gibt. Setzt die Werte startOffset und endOffset im Fehlerfall auf -1.
Diese Standardimplementierung ist für kleine Textbearbeitungen vorgesehen. Ein Textverarbeitungsprogramm oder ein Texteditor sollte seine eigenen effizienten Implementierungen bereitstellen. Diese Funktion macht keinen Unterschied zwischen Absätzen und Zeilen.
Hinweis: Diese Funktion kann die Cursorposition nicht berücksichtigen. Eine offset von -2 bedeutet, dass diese Funktion die Cursorposition als Offset verwenden sollte. 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 ob die Länge als Offset übergeben wurde.
[virtual] QString QAccessibleTextInterface::textAtOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
Gibt das Textelement des Typs boundaryType am Offset offset zurück und setzt die Werte startOffset und endOffset auf die Start- und Endpositionen dieses Elements; gibt eine leere Zeichenkette zurück, wenn es kein solches Element gibt. Setzt im Fehlerfall die Werte startOffset und endOffset auf -1.
Diese Standardimplementierung ist für kleine Textbearbeitungen vorgesehen. Ein Textverarbeitungsprogramm oder ein Texteditor sollte seine eigenen effizienten Implementierungen bereitstellen. Diese Funktion macht keinen Unterschied zwischen Absätzen und Zeilen.
Hinweis: Diese Funktion kann die Cursorposition nicht berücksichtigen. Eine offset von -2 bedeutet, dass diese Funktion die Cursorposition als Offset verwenden sollte. 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 ob die Länge als Offset übergeben wurde.
[virtual] QString QAccessibleTextInterface::textBeforeOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
Gibt das Textelement vom Typ boundaryType zurück, das sich in der Nähe des Offsets offset befindet, und setzt die Werte startOffset und endOffset auf die Start- und Endpositionen dieses Elements; gibt eine leere Zeichenkette zurück, wenn es kein solches Element gibt. Setzt die Werte startOffset und endOffset im Fehlerfall auf -1.
Diese Standardimplementierung ist für kleine Textbearbeitungen vorgesehen. Ein Textverarbeitungsprogramm oder ein Texteditor sollte seine eigenen effizienten Implementierungen bereitstellen. Diese Funktion macht keinen Unterschied zwischen Absätzen und Zeilen.
Hinweis: Diese Funktion kann die Cursorposition nicht berücksichtigen. Eine offset von -2 bedeutet, dass diese Funktion die Cursorposition als Offset verwenden sollte. 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 ob die Länge als Offset übergeben wurde.
© 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.
