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