Класс QAccessibleTextInterface

Класс 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 равны 0.

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