Метод IUIAutomationTextRange::FindAttribute (uiautomationclient.h)
Извлекает подмножество текстового диапазона с указанным значением атрибута текста.
Синтаксис
HRESULT FindAttribute(
[in] TEXTATTRIBUTEID attr,
[in] VARIANT val,
[in] BOOL backward,
[out, retval] IUIAutomationTextRange **found
);
Параметры
[in] attr
Тип: TEXTATTRIBUTEID
Идентификатор атрибута text для извлекаемого подмножества диапазона текста. Список идентификаторов текстовых атрибутов см. в разделе Идентификаторы атрибутов текста.
[in] val
Тип: VARIANT
Значение атрибута. Это значение должно соответствовать заданному для атрибута типу.
[in] backward
Тип: BOOL
Значение TRUE , если должен быть возвращен последний текстовый диапазон, а не первый; в противном случае — FALSE.
[out, retval] found
Тип: IUIAutomationTextRange**
Получает указатель на текстовый диапазон, имеющий соответствующий атрибут и значение атрибута; в противном случае — NULL.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Метод FindAttribute извлекает соответствующий текст независимо от того, является ли он скрытым или видимым. Используйте UIA_IsHiddenAttributeId для проверка видимости текста.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7, Windows Vista с пакетом обновления 2 (SP2) и Обновление платформы для Windows Vista, Windows XP с пакетом обновления 3 (SP3) и Обновление платформы для Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и обновление платформы для Windows Server 2008, Windows Server 2003 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | uiautomationclient.h (включая UIAutomation.h) |
См. также раздел
Модель автоматизации пользовательского интерфейса поддержка текстового содержимого