En esta página

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

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.

Especificación de IAccessible2

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.