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

  • Статья

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

Синтаксис

HRESULT GetAttributeValue(
  [in]          TEXTATTRIBUTEID attributeId,
  [out, retval] VARIANT         *pRetVal
);

Параметры

[in] attributeId

Тип: TEXTATTRIBUTEID

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

[out, retval] pRetVal

Тип: VARIANT*

Получает одно из следующих элементов.

  • Адрес объекта , представляющего значение указанного атрибута. Тип данных значения зависит от указанного атрибута. Например, если attributeId имеет значение UIA_FontNameAttributeId, Метод GetAttributeValue возвращает строку, представляющую имя шрифта текстового диапазона, но если attributeId имеет значение UIA_IsItalicAttributeId, GetAttributeValue возвращает логическое значение.
  • Адрес значения, полученного функцией UiaGetReservedMixedAttributeValue , если значение указанного атрибута зависит от текстового диапазона.
  • Адрес значения, полученного функцией UiaGetReservedNotSupportedValue , если указанный атрибут не поддерживается поставщиком или элементом управления.
Этот параметр передается неинициализированным.

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

Тип: HRESULT

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

Комментарии

Метод GetAttributeValue должен получать значение атрибута независимо от того, является ли текст скрытым или видимым.

Требования

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

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

Основные понятия

ITextProvider

ITextRangeProvider

Справочные материалы

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