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