Класс QAccessibleTextInterface

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

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

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

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

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

Спецификация 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 используется для длины текста, и кастомные реализации этой функции должны возвращать результат так, как если бы длина была передана в качестве смещения.