CAxWindow::CreateControl

  • Artikel

 

Veröffentlicht: Juli 2016

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

Syntax

      HRESULT CreateControl(
   LPCOLESTR lpszName,
   IStream* pStream = NULL,
   IUnknown** ppUnkContainer = NULL 
);
HRESULT CreateControl(
   DWORD dwResID,
   IStream* pStream = NULL,
   IUnknown** ppUnkContainer = 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>"

      Hinweis

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

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

Rückgabewert

Ein HRESULT-Standardwert.

Hinweise

Wenn die zweite Version dieser Methode verwendet wird, wird ein HTML-Steuerelement zur Ressource erstellt und gebunden, die von dwResID identifiziert wird.

Diese Methode erhalten Sie das gleiche Ergebnis wie aufgerufen:

AtlAxCreateControlEx(lpszName, hWnd, pStream, NULL, NULL, GUID_NULL, NULL);

Siehe CAxWindow2T::CreateControlLic, 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 CreateControl verwendet.

Anforderungen

Header: atlwin.h

Siehe auch

CAxWindow Class
AtlAxCreateControl