QAccessibleTextInterface Class
La classe QAccessibleTextInterface met en œuvre la prise en charge de la gestion du texte. Plus d'informations...
| En-tête : | #include <QAccessibleTextInterface> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
- Liste de tous les membres, y compris les membres hérités
- QAccessibleTextInterface fait partie des classes d'accessibilité.
Fonctions publiques
| 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 |
Description détaillée
Cette interface correspond à l'interface IAccessibleText. Elle doit être mise en œuvre pour les widgets qui affichent plus de texte qu'une simple étiquette. Les étiquettes doivent être représentées uniquement par QAccessibleInterface et renvoyer leur texte sous forme de nom (QAccessibleInterface::text() avec QAccessible::Name comme type). L'interface QAccessibleTextInterface est typiquement destinée au texte qu'un lecteur d'écran pourrait vouloir lire ligne par ligne, et aux widgets qui prennent en charge la sélection et la saisie de texte. Cette interface est, par exemple, mise en œuvre pour QLineEdit.
Documentation des fonctions membres
[virtual noexcept] QAccessibleTextInterface::~QAccessibleTextInterface()
Détruit le site QAccessibleTextInterface.
[pure virtual] void QAccessibleTextInterface::addSelection(int startOffset, int endOffset)
Sélectionnez le texte de startOffset à endOffset. startOffset est le premier caractère qui sera sélectionné. Le endOffset est le premier caractère qui ne sera pas sélectionné.
Lorsque l'objet prend en charge les sélections multiples (par exemple, dans un traitement de texte), cette opération ajoute une nouvelle sélection, sinon elle remplace la sélection précédente.
La sélection sera composée de endOffset à startOffset caractères.
[pure virtual] QString QAccessibleTextInterface::attributes(int offset, int *startOffset, int *endOffset) const
Renvoie les attributs du texte à la position offset. En outre, l'étendue des attributs est renvoyée dans startOffset et endOffset.
[pure virtual] int QAccessibleTextInterface::characterCount() const
Renvoie la longueur du texte (taille totale, espaces compris).
[pure virtual] QRect QAccessibleTextInterface::characterRect(int offset) const
Renvoie la position et la taille du caractère à la position offset en coordonnées d'écran.
[pure virtual] int QAccessibleTextInterface::cursorPosition() const
Renvoie la position actuelle du curseur.
Voir aussi setCursorPosition().
[pure virtual] int QAccessibleTextInterface::offsetAtPoint(const QPoint &point) const
Renvoie le décalage du caractère à l'adresse point en coordonnées d'écran.
[pure virtual] void QAccessibleTextInterface::removeSelection(int selectionIndex)
Efface la sélection avec l'index selectionIndex.
[pure virtual] void QAccessibleTextInterface::scrollToSubstring(int startIndex, int endIndex)
Assure que le texte entre startIndex et endIndex est visible.
[pure virtual] void QAccessibleTextInterface::selection(int selectionIndex, int *startOffset, int *endOffset) const
Renvoie une sélection. La taille de la sélection est indiquée dans startOffset et endOffset. S'il n'y a pas de sélection, startOffset et endOffset sont nullptr.
Les API d'accessibilité prennent en charge les sélections multiples. Pour la plupart des widgets, cependant, une seule sélection est prise en charge avec selectionIndex égal à 0.
Voir également setSelection().
[pure virtual] int QAccessibleTextInterface::selectionCount() const
Renvoie le nombre de sélections dans ce texte.
[pure virtual] void QAccessibleTextInterface::setCursorPosition(int position)
Déplace le curseur sur position.
Voir aussi cursorPosition().
[pure virtual] void QAccessibleTextInterface::setSelection(int selectionIndex, int startOffset, int endOffset)
Définissez la sélection selectionIndex comme étant comprise entre startOffset et endOffset.
Voir aussi selection(), addSelection() et removeSelection().
[pure virtual] QString QAccessibleTextInterface::text(int startOffset, int endOffset) const
Renvoie le texte de startOffset à endOffset. startOffset est le premier caractère qui sera renvoyé. Le endOffset est le premier caractère qui ne sera pas renvoyé.
[virtual] QString QAccessibleTextInterface::textAfterOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
Renvoie l'élément de texte de type boundaryType qui se trouve juste après le décalage offset et fixe les valeurs startOffset et endOffset aux positions de début et de fin de cet élément ; renvoie une chaîne vide s'il n'existe pas d'élément de ce type. En cas d'erreur, définit les valeurs startOffset et endOffset à -1.
Cette implémentation par défaut est fournie pour les petites modifications de texte. Un traitement de texte ou un éditeur de texte devrait fournir ses propres implémentations efficaces. Cette fonction ne fait aucune distinction entre les paragraphes et les lignes.
Remarque : cette fonction ne peut pas prendre en compte la position du curseur. Par convention, un offset de -2 signifie que cette fonction doit utiliser la position du curseur comme décalage. Un décalage de -2 doit donc être converti en position du curseur avant d'appeler cette fonction. Un décalage de -1 est utilisé pour la longueur du texte et les implémentations personnalisées de cette fonction doivent renvoyer le résultat comme si la longueur avait été transmise en tant que décalage.
[virtual] QString QAccessibleTextInterface::textAtOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
Renvoie l'élément de texte de type boundaryType à l'emplacement offset et fixe les valeurs startOffset et endOffset aux positions de début et de fin de cet élément ; renvoie une chaîne vide s'il n'existe pas d'élément de ce type. En cas d'erreur, définit les valeurs startOffset et endOffset à -1.
Cette implémentation par défaut est fournie pour les petites modifications de texte. Un traitement de texte ou un éditeur de texte devrait fournir ses propres implémentations efficaces. Cette fonction ne fait aucune distinction entre les paragraphes et les lignes.
Remarque : cette fonction ne peut pas prendre en compte la position du curseur. Par convention, un offset de -2 signifie que cette fonction doit utiliser la position du curseur comme décalage. Un décalage de -2 doit donc être converti en position du curseur avant d'appeler cette fonction. Un décalage de -1 est utilisé pour la longueur du texte et les implémentations personnalisées de cette fonction doivent renvoyer le résultat comme si la longueur avait été transmise en tant que décalage.
[virtual] QString QAccessibleTextInterface::textBeforeOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
Renvoie l'élément de texte de type boundaryType qui est proche du décalage offset et fixe les valeurs startOffset et endOffset aux positions de début et de fin de cet élément ; renvoie une chaîne vide s'il n'y a pas d'élément de ce type. En cas d'erreur, définit les valeurs startOffset et endOffset à -1.
Cette implémentation par défaut est fournie pour les petites modifications de texte. Un traitement de texte ou un éditeur de texte devrait fournir ses propres implémentations efficaces. Cette fonction ne fait aucune distinction entre les paragraphes et les lignes.
Remarque : cette fonction ne peut pas prendre en compte la position du curseur. Par convention, un offset de -2 signifie que cette fonction doit utiliser la position du curseur comme décalage. Un décalage de -2 doit donc être converti en position du curseur avant d'appeler cette fonction. Un décalage de -1 est utilisé pour la longueur du texte et les implémentations personnalisées de cette fonction doivent renvoyer le résultat comme si la longueur avait été transmise en tant que décalage.
© 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.
