Метод IUIAutomationElement::GetCachedPropertyValueEx (uiautomationclient.h)
Извлекает значение свойства из кэша для этого элемента модель автоматизации пользовательского интерфейса, при необходимости игнорируя любое значение по умолчанию.
Синтаксис
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) |
См. также раздел
Основные понятия
Справочные материалы
Общие сведения о свойствах автоматизированного пользовательского интерфейса