Método IRawElementProviderSimple::get_HostRawElementProvider (uiautomationcore.h)

  • Artigo

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)

Confira também

Irawelementprovidersimple

UiaHostProviderFromHwnd