Método IRawElementProviderSimple::get_HostRawElementProvider (uiautomationcore.h)
Especifica o provedor de host para esse elemento.
Esta propriedade é somente para leitura.
Sintaxe
HRESULT get_HostRawElementProvider(
IRawElementProviderSimple **pRetVal
);
Parâmetros
pRetVal
Valor retornado
Nenhum
Comentários
Essa propriedade geralmente é o provedor de Automação da Interface do Usuário da Microsoft para a janela de um controle personalizado. Automação da Interface do Usuário usa esse provedor em combinação com o provedor personalizado. Por exemplo, o identificador de runtime do elemento geralmente é obtido do provedor de host.
Um provedor de host deve ser retornado nos seguintes casos: quando o elemento é uma raiz de fragmento, quando o elemento é um elemento simples (como um botão de push) e quando o provedor é um espaço reservado de reposicionamento (para obter mais informações, consulte Reposicionamento do provedor). Em outros casos, a propriedade deve ser NULL.
Exemplos
O exemplo a seguir retorna o provedor de host para a janela que hospeda o controle atendido por esse provedor.
HRESULT STDMETHODCALLTYPE Provider::get_HostRawElementProvider(IRawElementProviderSimple** pRetVal)
{
return UiaHostProviderFromHwnd(controlHWnd, pRetVal);
}
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) |