CAxWindow::CreateControlEx

Artigo
06/11/2016

Publicado: abril de 2016

Cria um controle ActiveX, inicializa-o, e hospedá-lo na janela especificada.

Sintaxe

      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>”
  
  Dica
  
  “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

Classe de CAxWindow
AtlAxCreateControlEx

Compartilhar via