QAccessibleTextInterface Class
La clase QAccessibleTextInterface implementa soporte para el manejo de texto. Más...
| Cabecera: | #include <QAccessibleTextInterface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- Lista de todos los miembros, incluidos los heredados
- QAccessibleTextInterface es parte de Clases de Accesibilidad.
Funciones públicas
| 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 |
Descripción detallada
Esta interfaz corresponde a la interfaz IAccessibleText. Debe implementarse para widgets que muestren más texto que una simple etiqueta. Las etiquetas deberían estar representadas únicamente por QAccessibleInterface y devolver su texto como nombre (QAccessibleInterface::text() con QAccessible::Name como tipo). La interfaz QAccessibleTextInterface se utiliza normalmente para texto que un lector de pantalla puede querer leer línea a línea, y para widgets que admiten la selección e introducción de texto. Esta interfaz está implementada, por ejemplo, para QLineEdit.
Documentación de las funciones miembro
[virtual noexcept] QAccessibleTextInterface::~QAccessibleTextInterface()
Destruye el QAccessibleTextInterface.
[pure virtual] void QAccessibleTextInterface::addSelection(int startOffset, int endOffset)
Seleccione el texto de startOffset a endOffset. startOffset es el primer carácter que se seleccionará. endOffset es el primer carácter que no se seleccionará.
Cuando el objeto admite selecciones múltiples (por ejemplo, en un procesador de textos), esto añade una nueva selección; en caso contrario, sustituye la selección anterior.
La selección tendrá una longitud de endOffset - startOffset caracteres.
[pure virtual] QString QAccessibleTextInterface::attributes(int offset, int *startOffset, int *endOffset) const
Devuelve los atributos de texto en la posición offset. Además, el rango de los atributos se devuelve en startOffset y endOffset.
[pure virtual] int QAccessibleTextInterface::characterCount() const
Devuelve la longitud del texto (tamaño total incluyendo espacios).
[pure virtual] QRect QAccessibleTextInterface::characterRect(int offset) const
Devuelve la posición y el tamaño del carácter en la posición offset en coordenadas de pantalla.
[pure virtual] int QAccessibleTextInterface::cursorPosition() const
Devuelve la posición actual del cursor.
Véase también setCursorPosition().
[pure virtual] int QAccessibleTextInterface::offsetAtPoint(const QPoint &point) const
Devuelve el desplazamiento del carácter en point en coordenadas de pantalla.
[pure virtual] void QAccessibleTextInterface::removeSelection(int selectionIndex)
Borra la selección con el índice selectionIndex.
[pure virtual] void QAccessibleTextInterface::scrollToSubstring(int startIndex, int endIndex)
Asegura que el texto entre startIndex y endIndex sea visible.
[pure virtual] void QAccessibleTextInterface::selection(int selectionIndex, int *startOffset, int *endOffset) const
Devuelve una selección. El tamaño de la selección se devuelve en startOffset y endOffset. Si no hay selección se devuelven startOffset y endOffset nullptr .
Las API de accesibilidad admiten múltiples selecciones. Sin embargo, para la mayoría de los widgets, sólo se admite una selección con selectionIndex igual a 0.
Véase también setSelection().
[pure virtual] int QAccessibleTextInterface::selectionCount() const
Devuelve el número de selecciones de este texto.
[pure virtual] void QAccessibleTextInterface::setCursorPosition(int position)
Mueve el cursor a position.
Véase también cursorPosition().
[pure virtual] void QAccessibleTextInterface::setSelection(int selectionIndex, int startOffset, int endOffset)
Establezca la selección selectionIndex en el intervalo comprendido entre startOffset y endOffset.
Véase también selection(), addSelection() y removeSelection().
[pure virtual] QString QAccessibleTextInterface::text(int startOffset, int endOffset) const
Devuelve el texto de startOffset a endOffset. startOffset es el primer carácter que se devuelve. endOffset es el primer carácter que no se devuelve.
[virtual] QString QAccessibleTextInterface::textAfterOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
Devuelve el elemento de texto de tipo boundaryType que se encuentra justo después del desplazamiento offset y establece los valores startOffset y endOffset en las posiciones inicial y final de dicho elemento; devuelve una cadena vacía si no existe tal elemento. Establece los valores startOffset y endOffset a -1 en caso de error.
Esta implementación por defecto se proporciona para pequeñas ediciones de texto. Un procesador de texto o un editor de texto deberían proporcionar sus propias implementaciones eficientes. Esta función no distingue entre párrafos y líneas.
Nota: esta función no puede tener en cuenta la posición del cursor. Por convención, un offset de -2 significa que esta función debe utilizar la posición del cursor como desplazamiento. Por lo tanto, un desplazamiento de -2 debe convertirse a la posición del cursor antes de llamar a esta función. Un offset de -1 se utiliza para la longitud del texto y las implementaciones personalizadas de esta función tienen que devolver el resultado como si la longitud se hubiera pasado como offset.
[virtual] QString QAccessibleTextInterface::textAtOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
Devuelve el elemento de texto de tipo boundaryType en el desplazamiento offset y establece los valores startOffset y endOffset en las posiciones inicial y final de dicho elemento; devuelve una cadena vacía si no existe tal elemento. Establece los valores startOffset y endOffset a -1 en caso de error.
Esta implementación por defecto se proporciona para pequeñas ediciones de texto. Un procesador de texto o un editor de texto deberían proporcionar sus propias implementaciones eficientes. Esta función no distingue entre párrafos y líneas.
Nota: esta función no puede tener en cuenta la posición del cursor. Por convención, un offset de -2 significa que esta función debe utilizar la posición del cursor como desplazamiento. Por lo tanto, un desplazamiento de -2 debe convertirse a la posición del cursor antes de llamar a esta función. Un offset de -1 se utiliza para la longitud del texto y las implementaciones personalizadas de esta función tienen que devolver el resultado como si la longitud se hubiera pasado como offset.
[virtual] QString QAccessibleTextInterface::textBeforeOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
Devuelve el elemento de texto de tipo boundaryType que está cerca del desplazamiento offset y establece los valores startOffset y endOffset en las posiciones inicial y final de dicho elemento; devuelve una cadena vacía si no existe tal elemento. Establece los valores startOffset y endOffset a -1 en caso de error.
Esta implementación por defecto se proporciona para pequeñas ediciones de texto. Un procesador de texto o un editor de texto deberían proporcionar sus propias implementaciones eficientes. Esta función no distingue entre párrafos y líneas.
Nota: esta función no puede tener en cuenta la posición del cursor. Por convención, un offset de -2 significa que esta función debe utilizar la posición del cursor como desplazamiento. Por lo tanto, un desplazamiento de -2 debe convertirse a la posición del cursor antes de llamar a esta función. Un offset de -1 se utiliza para la longitud del texto y las implementaciones personalizadas de esta función tienen que devolver el resultado como si la longitud se hubiera pasado como offset.
© 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.
