Метод IUIAutomationTextRange::GetAttributeValue (uiautomationclient.h)

Статья
03/05/2025

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

Синтаксис

HRESULT GetAttributeValue(
  [in]          TEXTATTRIBUTEID attr,
  [out, retval] VARIANT         *value
);

Параметры

[in] attr

Тип: TEXTATTRIBUTEID

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

[out, retval] value

Тип: VARIANT*

Получает значение указанного атрибута.

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

Тип: HRESULT

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

Замечания

Тип значения, полученного этим методом, зависит от параметра attr. Например, вызов GetAttributeValue с параметром attr значение UIA_FontNameAttributeId возвращает строку, представляющую имя шрифта текстового диапазона, при вызове GetAttributeValue с attr значение UIA_IsItalicAttributeId возвращает логическое значение.

Если атрибут, указанный attr, не поддерживается, значение получает значение, эквивалентное свойству IUIAutomation::ReservedNotSupportedValue.

Текстовый диапазон может содержать несколько значений для определенного атрибута. Например, если текстовый диапазон содержит несколько шрифтов, атрибут FontName будет иметь несколько значений. Атрибут с несколькими значениями называется смешанным атрибутом. Можно определить, является ли конкретный атрибут смешанным, сравнивая значение, полученное из GetAttributeValue с свойством UIAutomation::ReservedMixedAttributeValue.

Метод GetAttributeValue извлекает значение атрибута независимо от того, является ли текст скрытым или видимым. Используйте 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 [классические приложения только]
целевая платформа	Виндоус
заголовка	uiautomationclient.h (include UIAutomation.h)

См. также

IUIAutomationTextRange

поддержка автоматизации пользовательского интерфейса для текстового содержимого

Поделиться через