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

Статья
08/26/2023

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

Синтаксис

HRESULT GetCurrentPattern(
  [in]          PATTERNID patternId,
  [out, retval] IUnknown  **patternObject
);

Параметры

[in] patternId

Тип: PATTERNID

Идентификатор шаблона элемента управления. Список идентификаторов шаблонов элементов управления см. в разделе Идентификаторы шаблонов элементов управления.

[out, retval] patternObject

Тип: IUnknown**

Получает указатель на интерфейс IUnknown .

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

Тип: HRESULT

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

Для некоторых форм пользовательского интерфейса этот метод будет нести нагрузку на производительность между процессами. Приложения могут сократить затраты за счет кэширования шаблонов элементов управления и последующего их извлечения с помощью IUIAutomationElement::GetCachedPattern.

Требования


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