CAxWindow::CreateControlEx

Artigo
08/25/2010

Cria um controle ActiveX, inicializa e hospeda-lo na janela especificada.

HRESULT CreateControlEx(
   LPCOLESTR lpszName,
   IStream* pStream = NULL,
   IUnknown** ppUnkContainer = NULL,
   IUnknown** ppUnkControl = NULL,
   REFIID iidSink = IID_NULL,
   IUnknown* punkSink = NULL 
);
HRESULT CreateControlEx(
   DWORD dwResID,
   IStream* pStream = NULL,
   IUnknown** ppUnkContainer = NULL,
   IUnknown** ppUnkControl = NULL,
   REFIID iidSink = IID_NULL,
   IUnknown* punkSink = NULL 
);

Parâmetros

lpszName
Um ponteiro para uma seqüência de caracteres para criar o controle.Deve ser formatado em uma das seguintes maneiras:

ProgID, sistema autônomo "MSCAL.calendário.7"
Um CLSID sistema autônomo "{8E27C92B-1264-101 - 8A2F - C 040224009C02}"
Uma URL, sistema autônomo "https://www.microsoft.com"
Uma referência a um documento ativo sistema autônomo "arquivo://\\Documents\MyDoc.doc"

Um fragmento de HTML, sistema autônomo "MSHTML: <html><body>Esta é uma linha de texto</body></html>"

Observação:
"MSHTML:" deve preceder o fragmento de HTML para que Ele é designado sistema autônomo sendo um fluxo MSHTML.Somente o ProgID e CLSID são suportados em plataformas Windows Mobile.Windows CE incorporado plataformas, diferente do Windows Mobile com suporte para o CE IE suporte todos os tipos, inclusive ProgID, CLSID, URL, referência a ac documento de defeito e fragmento de HTML.

pStream
[in] Um ponteiro para um fluxo é usado para inicializar as propriedades do controle.Pode ser NULO.
ppUnkContainer
[out] O endereço de um ponteiro que receberá o IUnknown do contêiner.Pode ser NULO.
ppUnkControl
[out] O endereço de um ponteiro que receberá o IUnknown do controle.Pode ser NULO.
iidSink
[in] O identificador de interface de uma interface de saída no objeto contido.Pode ser IID_NULL.
punkSink
[in] Um ponteiro para o IUnknown interface do objeto coletor a ser conectado ao ponto de conexão no objeto contido especificado por iidSink.
dwResID
[in] A ID de recurso de um recurso HTML.O controle WebBrowser será criado e carregado com o recurso especificado.

Valor de retorno

Um padrão HRESULT valor.

Comentários

Esse método é semelhante a CAxWindow::CreateControl, mas ao contrário do método, CreateControlEx também lhe permite receber um ponteiro de interface para o controle recém-criado e configurado um coletor de evento para receber eventos acionados pelo controle.

See CAxWindow2T::CreateControlLicEx para criar, inicializar e hospedar um controle ActiveX do Licenciado.

Exemplo

See Hospedagem de controles ActiveX usando AXHost ATL para obter um exemplo que usa CreateControlEx.

Requisitos

Cabeçalho: atlwin.h

Consulte também

Referência

Classe CAxWindow

AtlAxCreateControlEx

Outros recursos

CAxWindow membros

Partilhar via