Метод IUIAutomationElement::GetCurrentPropertyValueEx (uiautomationclient.h)

Статья
03/03/2024

Извлекает значение свойства для этого элемента модель автоматизации пользовательского интерфейса, при необходимости игнорируя любое значение по умолчанию.

Синтаксис

HRESULT GetCurrentPropertyValueEx(
  [in]          PROPERTYID propertyId,
  [in]          BOOL       ignoreDefaultValue,
  [out, retval] VARIANT    *retVal
);

Параметры

[in] propertyId

Тип: PROPERTYID

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

[in] ignoreDefaultValue

Тип: BOOL

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

[out, retval] retVal

Тип: VARIANT*

Получает значение свойства .

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

Тип: HRESULT

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

Если поставщик Microsoft модель автоматизации пользовательского интерфейса для самого элемента поддерживает свойство , возвращается значение свойства . В противном случае, если параметр ignoreDefaultValue имеет значение FALSE, возвращается значение по умолчанию, заданное модель автоматизации пользовательского интерфейса.

Этот метод возвращает код сбоя, если запрошенное свойство ранее не было кэшировано.

модель автоматизации пользовательского интерфейса свойства типа double поддерживают нечисловые значения (NaN). При получении свойства типа double клиент может использовать функцию _isnan , чтобы определить, является ли свойство значением NaN.

Требования

Требование	Значение
Минимальная версия клиента	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)