CAxWindow::CreateControlEx

Articolo
06/09/2015

Crea un controllo ActiveX, la inizializza e lo ospita nella finestra specificata.

HRESULT CreateControlEx( 
   LPCOLESTR lpszName, 
   IStream* pStream = NULL, 
   IUnknown** ppUnkContainer = NULL, 
   IUnknown** ppUnkControl = NULL, 
   REFIID iidSink = IID_NULL, 
   IUnknown* punkSink = NULL  
); 
HRESULT CreateControlEx( 
   DWORD dwResID, 
   IStream* pStream = NULL, 
   IUnknown** ppUnkContainer = NULL, 
   IUnknown** ppUnkControl = NULL, 
   REFIID iidSink = IID_NULL, 
   IUnknown* punkSink = NULL  
);

Parametri

lpszName
Un puntatore a una stringa per creare il controllo. Deve essere formattato in uno dei modi seguenti:
- Un ProgID come "MSCAL.Calendar.7"
- Un CLSID come "{}" 8E27C92B-1264-101C-8A2F-040224009C02
- Un URL come "https://www.microsoft.com"
- Un riferimento a un documento attivo in "file://\\Documents\MyDoc.doc"
- Un frammento di codice HTML come "MSHTML:<HTML><BODY>questo è una riga di text</body></html>"
  
  Nota
  
  "MSHTML: " deve precedere il codice HTML in modo da definirlo di come un flusso di MSHTML.Solo il ProgID e il CLSID sono supportati in piattaforme Windows Mobile.Windows CE ha incorporato le piattaforme, diversa da Windows Mobile con supporto per il supporto di CE e tutti i tipi inclusi ProgID, il CLSID, l'url, il riferimento al documento attivo e il frammento di codice HTML.
pStream
[in] puntatore A un flusso utilizzato per inizializzare le proprietà del controllo. Può essere NULL.
ppUnkContainer
[out] indirizzo di un puntatore che riceverà IUnknown del contenitore. Può essere NULL.
ppUnkControl
[out] indirizzo di un puntatore che riceverà IUnknown del controllo. Può essere NULL.
iidSink
[in] identificatore di interfaccia di un'interfaccia in uscita all'oggetto contenuto. Può essere IID_NULL.
punkSink
[in] puntatore All'interfaccia IUnknown dell'oggetto sink per connettersi al punto di connessione sull'oggetto contenuto specificato da iidSink.
dwResID
[in] ID di risorsa di una risorsa HTML. Il controllo WebBrowser verrà creato e caricato con la risorsa specificata.

Valore restituito

Un valore standard HRESULT.

Note

Questo metodo è simile a CAxWindow::CreateControl, a differenza del metodo, CreateControlEx consente di ricevere un puntatore a interfaccia al controllo appena creata e installare un sink di evento per ricevere eventi generati dal controllo.

Vedere CAxWindow2T::CreateControlLicEx per creare, l'inizializzazione e ospitare un controllo ActiveX con licenza.

Esempio

Vedere Controlli ActiveX di hosting mediante ATL AXHost per un esempio che utilizza CreateControlEx.

Requisiti

Header: atlwin.h

Vedere anche

Riferimenti

CAxWindow Class

AtlAxCreateControlEx

Condividi tramite