QAccessibleTextInterface Class
La classe `QAccessibleTextInterface` permet la gestion du texte. En savoir plus...
| 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
| 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 |
Description détaillée
Cette interface correspond à l’interface IAccessibleText. Elle doit être implémentée pour les widgets qui affichent plus de texte qu’une simple étiquette. Les étiquettes doivent être représentées uniquement par des objets de type ` QAccessibleInterface ` et renvoyer leur texte via la méthode `name(QAccessibleInterface::text)` avec ` QAccessible::Name ` comme type. L'interface QAccessibleTextInterface est généralement destinée au texte qu'un lecteur d'écran pourrait vouloir lire ligne par ligne, ainsi qu'aux widgets prenant en charge la sélection et la saisie de texte. Cette interface est, par exemple, implémentée pour QLineEdit.
Documentation des fonctions membres
[constexpr noexcept default] QAccessibleTextInterface::QAccessibleTextInterface()
Construit par défaut une instance de ` QAccessibleTextInterface`.
[virtual noexcept] QAccessibleTextInterface::~QAccessibleTextInterface()
Supprime le fichier « QAccessibleTextInterface ».
[pure virtual] void QAccessibleTextInterface::addSelection(int startOffset, int endOffset)
Sélectionnez le texte compris entre startOffset et endOffset. Le caractère startOffset est le premier caractère qui sera sélectionné. Le caractère 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), cela ajoute une nouvelle sélection ; dans le cas contraire, cela remplace la sélection précédente.
La sélection comportera entre endOffset et startOffset caractères.
[pure virtual] QString QAccessibleTextInterface::attributes(int offset, int *startOffset, int *endOffset) const
Renvoie les attributs de texte situés à la position offset. De plus, la plage des attributs est renvoyée dans startOffset et endOffset.
[pure virtual] int QAccessibleTextInterface::characterCount() const
Renvoie la longueur du texte (longueur totale, espaces compris).
[pure virtual] QRect QAccessibleTextInterface::characterRect(int offset) const
Renvoie la position et la taille du caractère situé à 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 l'offset du caractère situé à l'point, exprimé en coordonnées d'écran.
[pure virtual] void QAccessibleTextInterface::removeSelection(int selectionIndex)
Efface la sélection dont l'index est selectionIndex.
[pure virtual] void QAccessibleTextInterface::scrollToSubstring(int startIndex, int endIndex)
Permet de s'assurer que le texte situé 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 renvoyée dans ` startOffset ` et ` endOffset`. S'il n'y a pas de sélection, ` startOffset ` et ` endOffset ` sont tous deux égaux à ` nullptr`.
Les API d’accessibilité prennent en charge les sélections multiples. Cependant, pour la plupart des widgets, 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 présentes dans ce texte.
[pure virtual] void QAccessibleTextInterface::setCursorPosition(int position)
Place le curseur sur position.
Voir aussi cursorPosition().
[pure virtual] void QAccessibleTextInterface::setSelection(int selectionIndex, int startOffset, int endOffset)
Définissez l'selectionIndex de sélection sur la plage allant de startOffset à endOffset.
Voir également selection(), addSelection() et removeSelection().
[pure virtual] QString QAccessibleTextInterface::text(int startOffset, int endOffset) const
Renvoie le texte situé entre startOffset et endOffset. startOffset correspond au premier caractère qui sera renvoyé. endOffset correspond au 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 situé immédiatement après l'offset offset et définit les valeurs startOffset et endOffset sur les positions de début et de fin de cet élément ; renvoie une chaîne vide si aucun élément de ce type n'existe. En cas d'erreur, définit les valeurs startOffset et endOffset sur -1.
Cette implémentation par défaut est prévue pour les modifications de texte de petite envergure. 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. Ainsi, un décalage de -2 doit ê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é passée 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 situé à l'offset offset et définit les valeurs startOffset et endOffset sur les positions de début et de fin de cet élément ; renvoie une chaîne vide si aucun élément de ce type n'existe. En cas d'erreur, définit les valeurs startOffset et endOffset sur -1.
Cette implémentation par défaut est prévue pour les modifications de texte de petite envergure. 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. Ainsi, un décalage de -2 doit ê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é passée 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 situé à proximité de l'offset offset et définit les valeurs startOffset et endOffset sur les positions de début et de fin de cet élément ; renvoie une chaîne vide si aucun élément de ce type n'existe. En cas d'erreur, définit les valeurs startOffset et endOffset sur -1.
Cette implémentation par défaut est prévue 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. Ainsi, un décalage de -2 doit ê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é passée 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.
