CAxWindow::CreateControl

Artigo
08/25/2010

Cria um controle ActiveX, inicializa e hospeda-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 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, Outros que o Windows Mobile com suporte para o CE IE suporte todos os tipos, inclusive ProgID, CLSID, URL, referência ao documento ativo e o 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.
dwResID
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

Se a segunda versão deste método é usada, um controle HTML é criado e limite para o recurso identificado por dwResID.

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

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

See CAxWindow2T::CreateControlLic 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 CreateControl.

Requisitos

Cabeçalho: atlwin.h

Consulte também

Referência

Classe CAxWindow

AtlAxCreateControl

Outros recursos

CAxWindow membros

Partilhar via