Метод ITextRangeProvider::FindAttribute (uiautomationcore.h)

Статья
03/13/2024

Возвращает подмножество текстового диапазона, которое имеет указанное значение атрибута текста.

Синтаксис

HRESULT FindAttribute(
  [in]          TEXTATTRIBUTEID    attributeId,
  [in]          VARIANT            val,
  [in]          BOOL               backward,
  [out, retval] ITextRangeProvider **pRetVal
);

Параметры

[in] attributeId

Тип: TEXTATTRIBUTEID

Идентификатор атрибута text. Список идентификаторов текстовых атрибутов см. в разделе Идентификаторы атрибутов текста.

[in] val

Тип: VARIANT

Искомое значение атрибута. Это значение должно соответствовать заданному для атрибута типу.

[in] backward

Тип: BOOL

Значение TRUE , если должен быть возвращен последний текстовый диапазон, а не первый; в противном случае — FALSE.

[out, retval] pRetVal

Тип: ITextRangeProvider**

Получает указатель на текстовый диапазон, имеющий соответствующий атрибут и значение атрибута; в противном случае — NULL.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Метод FindAttribute извлекает соответствующий текст независимо от того, является ли он скрытым или видимым. Клиенты могут использовать UIA_IsHiddenAttributeId для проверка видимости текста.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	uiautomationcore.h (включая UIAutomation.h)