CAxWindow::CreateControlEx

Erstellt ein ActiveX-Steuerelement, initialisiert und hostet es im angegebenen Fenster.

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 
);

Parameter

  • lpszName
    Ein Zeiger auf eine Zeichenfolge, um das Steuerelement zu erstellen.Muss in einer der folgenden Methoden formatiert werden:

    • Ein ProgID wie "MSCAL.Calendar.7"

    • Ein CLSID wie "{}" 8E27C92B-1264-101C-8A2F-040224009C02

    • Eine URL wie "https://www.microsoft.com"

    • Ein Verweis auf einen aktiven Dokument wie "file://\\Documents\MyDoc.doc"

    • Ein Fragment von HTML wie "MSHTML:<HTML><BODY>Dies ist eine Zeile Text</BODY></HTML>"

      HinweisHinweis

      "MSHTML: " muss dem HTML-Fragment vorausgehen, damit es als MSHTML-Stream festgelegt ist.Nur die ProgID und die CLSID wird in Windows Mobile-Plattformen unterstützt.Windows CE eingebettete Plattformen, anders als Windows Mobile mit Unterstützung für Unterstützung CEs IE alle Typen, einschließlich ProgID CLSID, URLs, Verweis auf den aktiven Dokument und Fragment von HTML.

  • pStream
    [in] Ein Zeiger auf einen Stream, der verwendet wird, um die Eigenschaften des Steuerelements zu initialisieren.Kann NULL.

  • ppUnkContainer
    [out] die Adresse eines Zeigers, der IUnknown des Containers empfängt.Kann NULL.

  • ppUnkControl
    [out] die Adresse eines Zeigers, der IUnknown des Steuerelements empfängt.Kann NULL.

  • iidSink
    [in] Der Schnittstellenbezeichner einer Ausgangsschnittstelle auf dem enthaltenden Objekt.Kann IID_NULL.

  • punkSink
    [in] Ein Zeiger auf die IUnknown-Schnittstelle des an den Verbindungspunkt auf dem enthaltenden Objekt verbunden werden Senkenobjekts, angegeben durch iidSink.

  • dwResID
    [in] Das Ressourcen-ID einer HTML-Ressource.Das ActiveX-Steuerelement browsersteuerelement wird mit der angegebenen Ressource erstellt und geladen.

Rückgabewert

Ein HRESULT-Standardwert.

Hinweise

Diese Methode ist zu CAxWindow::CreateControl ähnlich, jedoch anders diese Methode, CreateControlEx ermöglicht Ihnen auch, um einen Schnittstellenzeiger an die neu erstellte Steuerelement zu empfangen und eine Ereignissenke zu installieren, um die Ereignisse zu empfangen, die vom Steuerelement ausgelöst werden.

Siehe CAxWindow2T::CreateControlLicEx, um ein lizenziertes ActiveX-Steuerelement zu erstellen, zu initialisieren und zu hosten.

Beispiel

Siehe Hosten von ActiveX-Steuerelementen mit ATL AXHost für ein Beispiel, das CreateControlEx verwendet.

Anforderungen

Header: atlwin.h

Siehe auch

Referenz

CAxWindow-Klasse

AtlAxCreateControlEx