CAxWindow::CreateControl

 

Publicado: abril de 2016

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

Sintaxe

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

      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.

  • 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

Classe de CAxWindow
AtlAxCreateControl