AtlAxCreateControlEx
Cria um controle ActiveX, inicializa-o, e hospedá-lo na janela especificada.Um ponteiro e um coletor de eventos da interface para o novo controle também podem ser criados.
.gif "Observação importante") Importante |
|---|
Essa função não pode ser usada em aplicativos executados em Tempo de Execução do Windows. |
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 cadeia de caracteres a ser passado para 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>”
.gif "Observação")
Observação“MSHTML: ” deve preceder o fragmento HTML de modo que é designado como ser um fluxo de MSHTML.
hWnd
[in] identificador para a janela que o controle será associado.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 de controle criado.Pode ser NULO.iidSink
O identificador da interface de uma interface de saída contido no objeto.punkSink
Um ponteiro para a interface de IUnknown do coletor a ser conectado ao ponto de conexão especificado por iidSink contido no objeto depois que o objeto contido foi criado com êxito.
Valor de retorno
Um dos valores padrão do HRESULT.
Comentários
AtlAxCreateControlEx é semelhante a AtlAxCreateControl mas 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.
Para criar um controle ActiveX licenciado, consulte AtlAxCreateControlLicEx.
Requisitos
Cabeçalho: atlhost.h