Класс QAccessibleTextInterface

Класс QAccessibleTextInterface реализует поддержку обработки текста. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Подробное описание

Данный интерфейс соответствует интерфейсу IAccessibleText. Он должен быть реализован для виджетов, отображающих больше текста, чем простой метка. Метки должны быть представлены только через QAccessibleInterface и возвращать свой текст как имя (QAccessibleInterface::text() с QAccessible::Name в качестве типа). QAccessibleTextInterface обычно используется для текста, который экранный диктор может прочитать построчно, а также для виджетов, поддерживающих выделение текста и ввод.

Спецификация IAccessible2

Документация по функциям-членам

[virtual] QAccessibleTextInterface::~QAccessibleTextInterface()

Уничтожает QAccessibleTextInterface.

[pure virtual] void QAccessibleTextInterface::addSelection(int startOffset, int endOffset)

Выделяет текст от startOffset до endOffset. startOffset — это первый символ, который будет выделен. endOffset — это первый символ, который не будет выделен.

Если объект поддерживает несколько выделений (например, в текстовом редакторе), добавляется новое выделение; в противном случае предыдущее выделение заменяется.

Выделение будет иметь длину endOffset - startOffset символов.

[pure virtual] QString QAccessibleTextInterface::attributes(int offset, int *startOffset, int *endOffset) const

Возвращает атрибуты текста в позиции offset. Кроме того, диапазон атрибутов возвращается в startOffset и endOffset.

[pure virtual] int QAccessibleTextInterface::characterCount() const

Возвращает длину текста (общий размер, включая пробелы).

[pure virtual] QRect QAccessibleTextInterface::characterRect(int offset) const

Возвращает позицию и размер символа в позиции offset в координатах экрана.

[pure virtual] int QAccessibleTextInterface::cursorPosition() const

Возвращает текущую позицию курсора.

См. также setCursorPosition().

[pure virtual] int QAccessibleTextInterface::offsetAtPoint(const QPoint &point) const

Возвращает смещение символа в точке point в координатах экрана.

[pure virtual] void QAccessibleTextInterface::removeSelection(int selectionIndex)

Удаляет выделение с индексом selectionIndex.

[pure virtual] void QAccessibleTextInterface::scrollToSubstring(int startIndex, int endIndex)

Обеспечивает видимость текста между startIndex и endIndex.

[pure virtual] void QAccessibleTextInterface::selection(int selectionIndex, int *startOffset, int *endOffset) const

Возвращает выделение. Размер выделения возвращается в startOffset и endOffset. Если выделения нет, то и startOffset, и endOffset равны nullptr.

API доступности поддерживают несколько выделений. Однако для большинства виджетов поддерживается только одно выделение с selectionIndex, равным 0.

См. также setSelection().

[pure virtual] int QAccessibleTextInterface::selectionCount() const

Возвращает количество выделений в тексте.

[pure virtual] void QAccessibleTextInterface::setCursorPosition(int position)

Перемещает курсор в позицию position.

См. также cursorPosition().

[pure virtual] void QAccessibleTextInterface::setSelection(int selectionIndex, int startOffset, int endOffset)

Устанавливает выделение selectionIndex на диапазон от startOffset до endOffset.

См. также selection(), addSelection() и removeSelection().

[pure virtual] QString QAccessibleTextInterface::text(int startOffset, int endOffset) const

Возвращает текст от startOffset до endOffset. startOffset — это первый возвращаемый символ. endOffset — это первый символ, который не будет возвращён.

[virtual] QString QAccessibleTextInterface::textAfterOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const

Возвращает элемент текста типа boundaryType, расположенный сразу после смещения offset, и устанавливает значения startOffset и endOffset на начальную и конечную позиции этого элемента; возвращает пустую строку, если такого элемента нет. Устанавливает значения startOffset и endOffset в -1 при ошибке.

Эта реализация по умолчанию предназначена для небольших редактирований текста. Программа-обработчик текста или текстовый редактор должны предоставлять свои собственные эффективные реализации. Эта функция не различает абзацы и строки.

Примечание: эта функция не может учитывать позицию курсора. По соглашению, смещение offset равное -2 означает, что эта функция должна использовать позицию курсора в качестве смещения. Таким образом, смещение -2 необходимо преобразовать в позицию курсора перед вызовом этой функции. Смещение -1 используется для длины текста, и кастомные реализации этой функции должны возвращать результат так, как если бы длина была передана в качестве смещения.

[virtual] QString QAccessibleTextInterface::textAtOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const

Возвращает элемент текста типа boundaryType в смещении offset и устанавливает значения startOffset и endOffset на начальную и конечную позиции этого элемента; возвращает пустую строку, если такого элемента нет. Устанавливает значения startOffset и endOffset в -1 при ошибке.

Эта реализация по умолчанию предназначена для небольших редактирований текста. Программа-обработчик текста или текстовый редактор должны предоставлять свои собственные эффективные реализации. Эта функция не различает абзацы и строки.

Примечание: эта функция не может учитывать позицию курсора. По соглашению, смещение offset равное -2 означает, что эта функция должна использовать позицию курсора в качестве смещения. Таким образом, смещение -2 необходимо преобразовать в позицию курсора перед вызовом этой функции. Смещение -1 используется для длины текста, и кастомные реализации этой функции должны возвращать результат так, как если бы длина была передана в качестве смещения.

[virtual] QString QAccessibleTextInterface::textBeforeOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const

Возвращает элемент текста типа boundaryType, расположенный рядом со смещением offset, и устанавливает значения startOffset и endOffset на начальную и конечную позиции этого элемента; возвращает пустую строку, если такого элемента нет. Устанавливает значения startOffset и endOffset в -1 при ошибке.

Эта реализация по умолчанию предназначена для небольших редактирований текста. Программа-обработчик текста или текстовый редактор должны предоставлять свои собственные эффективные реализации. Эта функция не различает абзацы и строки.

Примечание: эта функция не может учитывать позицию курсора. По соглашению, смещение offset равное -2 означает, что эта функция должна использовать позицию курсора в качестве смещения. Таким образом, смещение -2 необходимо преобразовать в позицию курсора перед вызовом этой функции. Смещение -1 используется для длины текста, и кастомные реализации этой функции должны возвращать результат так, как если бы длина была передана в качестве смещения.