Метод IUIAutomation::P ollForPotentialSupportedProperties (uiautomationclient.h)

Статья
08/26/2023

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

Синтаксис

HRESULT PollForPotentialSupportedProperties(
  [in]  IUIAutomationElement *pElement,
  [out] SAFEARRAY            **propertyIds,
  [out] SAFEARRAY            **propertyNames
);

Параметры

[in] pElement

Тип: IUIAutomationElement*

Адрес опрашивающего элемента модель автоматизации пользовательского интерфейса.

[out] propertyIds

Тип: SAFEARRAY(int)**

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

[out] propertyNames

Тип: SAFEARRAY(BSTR)**

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

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

Тип: HRESULT

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

Этот метод предназначен только для использования средствами Microsoft модель автоматизации пользовательского интерфейса, которые должны проверять свойства и шаблоны элементов управления. Он не предназначен для использования клиентами модель автоматизации пользовательского интерфейса.

Нет никакой гарантии, что элемент будет поддерживать какое-либо конкретное свойство при его последующем запросе.

Требования

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