CAxWindow::CreateControlEx

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

Classe di CAxWindow

AtlAxCreateControlEx