CAxWindow::CreateControlEx

Artigo
02/25/2013

Cria um controle ActiveX, inicializa-o, e hospedá-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 cadeia de caracteres para criar o controle.Deve ser formatado em uma das seguintes maneiras:

ProgID como “MSCAL.Calendar.7”
Um CLSID como “{}” 8E27C92B-1264-101C-8A2F-040224009C02
UM URL como “https://www.microsoft.com”
Uma referência a um documento ativo como “file://\\Documents\MyDoc.doc”

Um fragmento HTML como “MSHTML:<HTML><BODY>isso é uma linha de texto</BODY></HTML>”

Observação
“MSHTML: ” deve preceder o fragmento HTML de modo que é designado como ser um fluxo de MSHTML.Somente ProgID e os CLSID são suportados nas plataformas Windows Mobile.Windows CE inseriu plataformas, a não ser o Windows Mobile com suporte para suporte de IE de CE todos os tipos que incluem ProgID, CLSID, URL, referência ao documento ativo, e fragmento HTML.

pStream
[in] um ponteiro à um fluxo que é usado para inicializar propriedades do controle.Pode ser NULO.
ppUnkContainer
[out] o endereço de um ponteiro que recebe IUnknown do recipiente.Pode ser NULO.
ppUnkControl
[out] o endereço de um ponteiro que recebe IUnknown do controle.Pode ser NULO.
iidSink
[in] o identificador da interface de uma interface de saída contido no objeto.Pode ser IID_NULL.
punkSink
[in] um ponteiro da interface de IUnknown do coletor a ser conectado ao ponto de conexão contido no objeto especificado por iidSink.
dwResID
[in] número de identificação do recurso de um recurso de HTML.O controle da web browser será criado e carregada com o recurso especificado.

Valor de retorno

Um valor padrão de HRESULT .

Comentários

Este método é semelhante a CAxWindow::CreateControl, mas diferentemente de esse método, CreateControlEx também permite que você receber um ponteiro de interface para o controle recém-criado e configurar um coletor de eventos para receber eventos acionados pelo controle.

Consulte CAxWindow2T::CreateControlLicEx para criar, inicialize, e hospedar um controle ActiveX licenciado.

Exemplo

Hospedando controles ActiveX usando ATL AXHost consulte para um exemplo que usa CreateControlEx.

Requisitos

Cabeçalho: atlwin.h

Consulte também

Referência

Classe de CAxWindow

AtlAxCreateControlEx

Partilhar via