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

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

  • Статья

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

Синтаксис

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

Параметры

[in] attr

Тип: TEXTATTRIBUTEID

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

[out, retval] value

Тип: VARIANT*

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

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

Тип: HRESULT

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

Комментарии

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

Если атрибут, заданный attr , не поддерживается, параметр value получает значение, эквивалентное свойству 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 [только классические приложения]
Целевая платформа Windows
Header uiautomationclient.h (включая UIAutomation.h)

См. также раздел

IUIAutomationTextRange

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