Freigeben über


Was ist das ATL-Steuerelement-Hosting API?

SteuerelementHosting API ATL ist der Satz von Funktionen, der jedem Fenster ermöglicht, als ein ActiveX-Steuerelementcontainer fungiert.Diese Funktionen können in das Projekt statisch oder dynamisch zu verknüpfen, da sie als Quellcode verfügbar sind und von ATL90.dll verfügbar gemacht.Die SteuerelementHosting Funktionen sind in der folgenden Tabelle aufgelistet.

Funktion

Description

AtlAxAttachControl

Erstellt ein Hostobjekt, schließt die an das angegebene Fenster, fügt dann ein vorhandenes Steuerelement an.

AtlAxCreateControl

Erstellt ein Hostobjekt, schließt die an das angegebene Fenster, dann wird ein Steuerelement.

AtlAxCreateControlLic

Erstellt ein lizenziertes ActiveX-Steuerelement, initialisiert und hostet es im angegebenen Fenster, das zu AtlAxCreateControl ähnelt.

AtlAxCreateControlEx

Erstellt ein Hostobjekt, schließt die an das angegebene Fenster, dann wird ein Steuerelement (ermöglicht auch die installiert werden Ereignissenken,).

AtlAxCreateControlLicEx

Erstellt ein lizenziertes ActiveX-Steuerelement, initialisiert und hostet es im angegebenen Fenster, das zu AtlAxCreateControlLic ähnelt.

AtlAxCreateDialog

Stellt ein nicht modales Dialogfeld aus einer Dialogfeldressource erstellt und gibt das Fensterhandle zurück.

AtlAxDialogBox

Stellt ein modales Dialogfeld aus einer Dialogfeldressource erstellt.

AtlAxGetControl

Gibt den IUnknown-Schnittstellenzeiger des Steuerelements zurück, die in einem Fenster gehostet wird.

AtlAxGetHost

Gibt den IUnknown-Schnittstellenzeiger des Hostobjekts zurück, das an ein Fenster verbunden ist.

AtlAxWinInit

Initialisiert den SteuerelementHosting Code.

AtlAxWinTerm

Deinitialisiert den SteuerelementHosting Code.

Die HWND-Parameter in den ersten drei Funktionen muss ein vorhandenes Fenster (fast) eines beliebigen Typs sein.Wenn Sie alle drei Funktionen explizit (in der Regel, sind Sie nicht müssen), aufrufen, übergeben Sie ein Handle nicht zu einem Fenster, das bereits als Host fungiert (wenn Sie ausführen, wird das vorhandene Hostobjekt nicht freigegeben).

Der erste Aufruf AtlAxWinInit mit sieben Funktionen implizit.

HinweisHinweis

Das SteuerelementHosting API bildet die Grundlage Unterstützung ATL für ActiveX-Steuerelement-Kapselung.Es gibt jedoch normalerweise wenig Anforderung, diese Funktionen direkt aufrufen, wenn Sie vollständigen Verwendung Wrapperklassen ATL nutzen oder ausführen.Weitere Informationen finden Sie unter Welche ATL klassifiziert erleichtert ActiveX-Steuerelement-Kapselung?.

Siehe auch

Konzepte

ATL-Steuerkapselung FAQs