Método IUIAutomationElement::GetCurrentPattern (uiautomationclient.h)

Artigo
08/26/2023

Recupera a interface IUnknown do padrão de controle especificado nesse elemento de Automação da Interface do Usuário.

Sintaxe

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

Parâmetros

[in] patternId

Tipo: PATTERNID

O identificador do padrão de controle. Para obter uma lista de IDs de padrão de controle, consulte Identificadores de padrão de controle.

[out, retval] patternObject

Tipo: IUnknown**

Recebe um ponteiro para uma interface IUnknown .

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método obtém o padrão de controle especificado com base em sua disponibilidade no momento da chamada.

Para algumas formas de interface do usuário, esse método incorrerá em sobrecarga de desempenho entre processos. Os aplicativos podem reduzir a sobrecarga armazenando padrões de controle em cache e, em seguida, recuperando-os usando IUIAutomationElement::GetCachedPattern.

Requisitos


Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista, Windows XP com SP3 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008, Windows Server 2003 com SP2 e Atualização de Plataforma para Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	uiautomationclient.h (include UIAutomation.h)