Método IUIAutomation::P ollForPotentialSupportedProperties (uiautomationclient.h)
Recupera as propriedades que podem ter suporte em um elemento Automação da Interface do Usuário.
Sintaxe
HRESULT PollForPotentialSupportedProperties(
[in] IUIAutomationElement *pElement,
[out] SAFEARRAY **propertyIds,
[out] SAFEARRAY **propertyNames
);
Parâmetros
[in] pElement
Tipo: IUIAutomationElement*
O endereço do elemento Automação da Interface do Usuário a ser sondado.
[out] propertyIds
Tipo: SAFEARRAY(int)**
Recebe um ponteiro para uma matriz de identificadores de propriedade. Para obter uma lista de IDs de propriedade, consulte Identificadores de propriedade.
[out] propertyNames
Tipo: SAFEARRAY(BSTR)**
Recebe um ponteiro para uma matriz de nomes de propriedade.
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 propriedades e padrões de controle. 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 propriedade específica 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
PollForPotentialSupportedPatterns
Referência