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

Статья
03/13/2024

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

Синтаксис

HRESULT GetCachedPropertyValueEx(
  [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 .

Этот метод извлекает указанное свойство из кэша для элемента модель автоматизации пользовательского интерфейса. Чтобы получить текущее свойство, вызовите IUIAutomationElement::GetCurrentPropertyValueEx.

Передача FALSE в параметре ignoreDefaultValue эквивалентна вызову IUIAutomationElement::GetCachedPropertyValue.

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

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

модель автоматизации пользовательского интерфейса свойства типа double поддерживают значения Not a Number (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)