Поделиться через

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

  • Статья

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

Синтаксис

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)

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

Рекомендации по использованию безопасных массивов

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

Настраиваемые свойства, события и шаблоны элементов управления

IUIAutomation

PollForPotentialSupportedPatterns

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