Método IRawElementProviderHwndOverride::GetOverrideProviderForHwnd (uiautomationcore.h)

Obtém um provedor de Automação da Interface do Usuário para o elemento especificado.

Sintaxe

HRESULT GetOverrideProviderForHwnd(
  [in]          HWND                      hwnd,
  [out, retval] IRawElementProviderSimple **pRetVal
);

Parâmetros

[in] hwnd

Tipo: HWND

O identificador de janela do elemento.

[out, retval] pRetVal

Tipo: IRawElementProviderSimple**

Recebe um ponteiro para o novo provedor para a janela especificada ou NULL se o provedor não estiver sendo substituído. Este parâmetro é passado não inicializado.

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 é implementado por raízes de fragmento que contêm elementos filho baseados em janela. Por padrão, os controles hospedados em janelas são atendidos por provedores padrão, além de provedores personalizados. Os provedores padrão tratam todas as janelas dentro de uma janela pai como irmãos. Se você quiser reestruturar a árvore Automação da Interface do Usuário para que um controle baseado em janela seja visto como um filho de outro, substitua o provedor padrão implementando esse método na raiz do fragmento. O provedor retornado pode fornecer propriedades adicionais ou substituir propriedades do componente especificado.

O provedor retornado deve fazer parte da árvore de fragmentos. Ele pode fornecer propriedades adicionais ou substituir propriedades do componente especificado.

Se o provedor retornado implementar IRawElementProviderFragment, o provedor deverá fazer parte da árvore do fragmento e ser acessível navegando pela raiz do fragmento.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	uiautomationcore.h (inclua UIAutomation.h)

Confira também

IRawElementProviderHwndOverride