CAxWindow::CreateControl

Artigo
02/25/2013

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

HRESULT CreateControl(
   LPCOLESTR lpszName,
   IStream* pStream = NULL,
   IUnknown** ppUnkContainer = NULL 
);
HRESULT CreateControl(
   DWORD dwResID,
   IStream* pStream = NULL,
   IUnknown** ppUnkContainer = 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.
dwResID
A identificação de um recurso de recurso 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

Se a segunda versão de esse método é usado, um controle HTML é criado e associado a um recurso identificado por dwResID.

Esse método oferece o mesmo resultado que a chamada:

AtlAxCreateControlEx(lpszName, hWnd, pStream, NULL, NULL, GUID_NULL, NULL);

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

Exemplo

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

Requisitos

Cabeçalho: atlwin.h

Consulte também

Referência

Classe de CAxWindow

AtlAxCreateControl

Compartilhar via