AtlAxCreateControlEx

  • Artikel

 

Erstellt ein ActiveX-Steuerelement, initialisiert und hostet es im angegebenen Fenster.  Ein Schnittstellenzeiger und eine Ereignissenke für das neue Steuerelement können auch erstellt werden.  

Wichtig

Diese Funktion kann nicht in den Anwendungen verwendet werden, die in Windows-Runtime ausführen.

Syntax

      ATLAPI AtlAxCreateControlEx(
LPCOLESTR lpszName,
HWND hWnd,
IStream* pStream,
IUnknown** ppUnkContainer,
IUnknown** ppUnkControl,
REFIID iidSink = IID_NULL,
IUnknown* punkSink = NULL
);

Parameter

  • lpszName
    Ein Zeiger auf eine an das Steuerelement übergeben werden, Zeichenfolge.  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.

  • hWnd
    [in] Handle für das Fenster, dass das Steuerelement angefügt ist.

  • 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 erstellten Steuerelements empfängt.  Kann NULL.  

  • iidSink
    Der Schnittstellenbezeichner einer Ausgangsschnittstelle auf dem enthaltenden Objekt.

  • punkSink
    Ein Zeiger auf die IUnknown-Schnittstelle des an den Verbindungspunkt verbunden werden Senkenobjekts, angegeben durch iidSink auf dem enthaltenden Objekt, nachdem das enthaltende Objekt erfolgreich erstellt wurde.

Rückgabewert

Einer der Werte des Standards HRESULT.

Hinweise

AtlAxCreateControlEx ist ähnlich, zu AtlAxCreateControl jedoch 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.

Um ein lizenziertes ActiveX-Steuerelement erstellen, finden Sie unter AtlAxCreateControlLicEx.

Anforderungen

Header: atlhost.h

Siehe auch

Composite Control Global Functions
ATL-Grundlagen von zusammengesetzten Steuerelementen
CAxWindow::CreateControlEx