функция TextRange_ExpandToEnclosingUnit (uiautomationcoreapi.h)

Примечание Эта функция является нерекомендуемой. Вместо этого клиентские приложения должны использовать интерфейсы Com (Microsoft модель автоматизации пользовательского интерфейса).

 

Расширяет текстовый диапазон до большего или меньшего блока, например символа, Word, строки или страницы.

Синтаксис

HRESULT TextRange_ExpandToEnclosingUnit(
  [in] HUIATEXTRANGE hobj,
  [in] TextUnit      unit
);

Параметры

[in] hobj

Тип: HUIATEXTRANGE

Объект текстового диапазона.

[in] unit

Тип: TextUnit

Единица измерения, до которую поставщик должен развернуть диапазон текста.

Возвращаемое значение

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения или значение ошибки в противном случае.

Комментарии

Если диапазон уже является целым числом указанных единиц, он остается неизменным.

Если начальная конечная точка не находится на границе TextUnit , она перемещается назад, пока не будет на границе. Если конечная конечная точка не находится на границе или находится на той же границе, что и начальная конечная точка, конечная конечная точка перемещается вперед, пока она не будет на границе.

Примечание Обычно средство чтения с экрана зачитывает полное слово, весь абзац и т. д. в точке вставки или в любой виртуальной позиции курсора.

 

TextRange_ExpandToEnclosingUnit учитывает как скрытый, так и видимый текст. Клиент автоматизации пользовательского интерфейса может проверка атрибут is-hidden (Text_IsHidden_Attribute_GUID) для видимости текста.

TextRange_ExpandToEnclosingUnit по умолчанию до следующего поддерживаемого TextUnit , если данный объект TextUnit не поддерживается элементом управления .

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	uiautomationcoreapi.h
Библиотека	Uiautomationcore.lib
DLL	Uiautomationcore.dll