Método IUIAutomation::P ollForPotentialSupportedPatterns (uiautomationclient.h)

  • Artigo

Recupera os padrões de controle que podem ter suporte em um elemento Automação da Interface do Usuário.

Sintaxe

HRESULT PollForPotentialSupportedPatterns(
  [in]  IUIAutomationElement *pElement,
  [out] SAFEARRAY            **patternIds,
  [out] SAFEARRAY            **patternNames
);

Parâmetros

[in] pElement

Tipo: IUIAutomationElement*

O endereço do elemento a ser sondado.

[out] patternIds

Tipo: SAFEARRAY(int)**

Recebe um ponteiro para uma matriz de identificadores de padrão de controle.

[out] patternNames

Tipo: SAFEARRAY(BSTR)**

Recebe um ponteiro para uma matriz de nomes de padrão de controle.

Retornar valor

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 destina-se apenas ao uso pelas ferramentas de Automação da Interface do Usuário da Microsoft que precisam verificar as propriedades. Ele não se destina a ser usado por clientes Automação da Interface do Usuário.

Não há nenhuma garantia de que o elemento dará suporte a qualquer padrão de controle específico quando solicitado posteriormente.

Requisitos

Requisito Valor
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 (inclua UIAutomation.h)

Confira também

Práticas recomendadas para usar matrizes seguras

Conceitual

Propriedades personalizadas, eventos e padrões de controle

IUIAutomation

PollForPotentialSupportedProperties

Referência