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) |