QAccessibleTextInterface Class
La clase QAccessibleTextInterface implementa funciones para el manejo de texto. Más información...
| Encabezado: | #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 forma parte de las clases de accesibilidad.
Funciones públicas
| 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 |
Descripción detallada
Esta interfaz se corresponde con la interfaz IAccessibleText. Debe implementarse para widgets que muestren más texto que una simple etiqueta. Las etiquetas deben estar representadas únicamente por un objeto ` 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 podría querer leer línea por línea, y para widgets que admiten la selección y la introducción de texto. Esta interfaz se implementa, por ejemplo, para QLineEdit.
Documentación de las funciones miembro
[constexpr noexcept default] QAccessibleTextInterface::QAccessibleTextInterface()
Crea por defecto una instancia de ` QAccessibleTextInterface`.
[virtual noexcept] QAccessibleTextInterface::~QAccessibleTextInterface()
Destruye el « QAccessibleTextInterface ».
[pure virtual] void QAccessibleTextInterface::addSelection(int startOffset, int endOffset)
Selecciona el texto desde startOffset hasta endOffset. El startOffset es el primer carácter que se seleccionará. El 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 a la selección anterior.
La selección tendrá una longitud de entre endOffset y 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, se devuelve el rango de los atributos en startOffset y endOffset.
[pure virtual] int QAccessibleTextInterface::characterCount() const
Devuelve la longitud del texto (tamaño total, incluidos los espacios).
[pure virtual] QRect QAccessibleTextInterface::characterRect(int offset) const
Devuelve la posición y el tamaño del carácter situado 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 la posición del carácter situado en la dirección 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)
Garantiza que el texto que hay 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 ninguna selección, tanto ` startOffset ` como ` endOffset ` son ` nullptr`.
Las API de accesibilidad admiten selecciones múltiples. Sin embargo, para la mayoría de los widgets solo se admite una selección, en cuyo caso selectionIndex es igual a 0.
Véase también setSelection().
[pure virtual] int QAccessibleTextInterface::selectionCount() const
Devuelve el número de selecciones que hay en 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)
Establece 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. El startOffset es el primer carácter que se devolverá. El endOffset es el primer carácter que no se devolverá.
[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 de la posición offset y establece los valores de startOffset y endOffset en las posiciones inicial y final de dicho elemento; devuelve una cadena vacía si no existe tal elemento. En caso de error, establece los valores de startOffset y endOffset en -1.
Esta implementación por defecto se proporciona para pequeñas ediciones de texto. Un procesador de textos o un editor de texto debería 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. Se utiliza una compensación de -1 para la longitud del texto, y las implementaciones personalizadas de esta función deben devolver el resultado como si la longitud se hubiera pasado como compensación.
[virtual] QString QAccessibleTextInterface::textAtOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
Devuelve el elemento de texto de tipo boundaryType situado en la posición offset y establece los valores de startOffset y endOffset en las posiciones de inicio y fin de dicho elemento; devuelve una cadena vacía si no existe dicho elemento. Establece los valores de startOffset y endOffset en -1 en caso de error.
Esta implementación por defecto se proporciona para pequeñas ediciones de texto. Un procesador de textos o un editor de texto debería 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. Se utiliza una compensación de -1 para la longitud del texto, y las implementaciones personalizadas de esta función deben devolver el resultado como si la longitud se hubiera pasado como compensación.
[virtual] QString QAccessibleTextInterface::textBeforeOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
Devuelve el elemento de texto de tipo « boundaryType » más cercano al desplazamiento « offset » y establece los valores de « startOffset » y « endOffset » en las posiciones de inicio y fin de dicho elemento; devuelve una cadena vacía si no existe tal elemento. En caso de error, establece los valores de « startOffset » y « endOffset » en -1.
Esta implementación predeterminada está pensada para pequeñas modificaciones de texto. Un procesador de textos o un editor de texto debería 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. Se utiliza un desplazamiento de -1 para la longitud del texto, y las implementaciones personalizadas de esta función deben devolver el resultado como si la longitud se hubiera pasado como desplazamiento.
© 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.