Partilhar via


AtlAxCreateControlEx

Cria um controle ActiveX, inicializa e hospeda-lo na janela especificada.Também é possível criar um coletor de ponteiro e o evento de interface para o novo controle.

ATLAPI AtlAxCreateControlEx(
   LPCOLESTR lpszName,
   HWND hWnd,
   IStream* pStream,
   IUnknown** ppUnkContainer,
   IUnknown** ppUnkControl,
   REFIID iidSink = IID_NULL,
   IUnknown* punkSink = NULL
);

Parâmetros

  • lpszName
    Um ponteiro para uma seqüência de caracteres a ser passada para 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.

  • hWnd
    [in] Identificador para a janela que o controle será anexado ao.

  • 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.

  • ppUnkControl
    [out] O endereço de um ponteiro que receberá o IUnknown do controle criado.Pode ser NULO.

  • iidSink
    O identificador de interface de uma interface de saída no objeto contido.

  • punkSink
    Um ponteiro para o IUnknown interface do objeto coletor a ser conectado ao ponto de conexão especificado por iidSink no objeto contido após o objeto contido, foi criado com êxito.

Valor de retorno

Um dos valores HRESULT padrão.

Comentários

AtlAxCreateControlEx é semelhante a AtlAxCreateControl mas também permite que você receber um ponteiro de interface para o controle recém-criado e configurado um coletor de evento para receber eventos acionados pelo controle.

Para criar um controle ActiveX licenciado, consulte AtlAxCreateControlLicEx.

Requisitos

Cabeçalho: atlhost.h

Consulte também

Conceitos

Conceitos básicos de controle composto

Referência

CAxWindow::CreateControlEx

Outros recursos

Controle composto funções global