MFC-ActiveX-Steuerelemente: Methoden
Ein ActiveX-Steuerelement löst Ereignisse aus, um zwischen sich selbst und den Steuerelementcontainer zu kommunizieren.Ein Container kann ein Steuerelement mithilfe der Methoden und Eigenschaften auch kommunizieren.Methoden sind darüber hinaus aufgerufene Funktionen.
Methoden und Eigenschaften stellen eine exportierte Schnittstelle für andere Anwendungen, z. B. ActiveX-Steuerelement-Container und Automatisierungsclients bereit.Weitere Informationen zu ActiveX-Steuerelement-Eigenschaften finden Sie im Artikel MFC-ActiveX-Steuerelemente: Eigenschaften.
gebräuchliches Methoden sind ähnlich und Zweck der Memberfunktionen von eine C++-Klasse.Es gibt zwei Typen von Methoden, die das Steuerelement implementiert werden kann: Vorrat und benutzerdefiniert.Ähnlich wie den vordefinierten Ereignissen sind vordefinierte Methoden, für die diese Methoden COleControl eine Implementierung bereitstellt.Weitere Informationen über vordefinierte Methoden, finden Sie im Artikel MFC-ActiveX-Steuerelemente: Vordefinierte Methoden hinzufügen.Die benutzerdefinierten Vom Entwickler definierte Methoden ermöglichen, weitere Anpassung des Steuerelements.Weitere Informationen finden Sie im Artikel MFC-ActiveX-Steuerelemente: Benutzerdefinierte Methoden hinzufügen.
Die Microsoft Foundation Class Library (MFC) implementiert einen Mechanismus, der das Steuerelement zum Unterstützen von vordefinierten und benutzerdefinierten Methoden zulässt.Der erste Teil ist COleControl-Klasse.Abgeleitet von CWnd, COleControl-Memberfunktion vorrat die Methoden, die für alle ActiveX-Steuerelemente gemeinsam sind.Der zweite Teil dieses Mechanismus ist die Dispatchzuordnung.Eine Dispatchzuordnung ist eine Meldungszuordnung vergleichbar. Anstatt jedoch eine Funktion auf eine Windows-Meldung ID zuordnen, ordnet eine Dispatchzuordnung virtuelle Memberfunktionen zu IDispatch-ID.
Damit ein Steuerelement ordnungsgemäß verschiedene Möglichkeiten, die Dispatchzuordnung muss eine Klasse deklarieren unterstützt.Dies wird in der folgenden Codezeile erreicht (Steuerelementklassen im Header. H) Datei:
DECLARE_DISPATCH_MAP()
Der wesentliche Zweck der Dispatchzuordnung ist die Beziehung zwischen den Methodennamen, die von einem externen Aufrufer verwendet werden (z. B. dem Container) und Memberfunktionen der Klasse des Steuerelements zu erstellen, die die Methoden implementieren.Nachdem die Dispatchzuordnung deklariert wurde, muss sie in der Implementierungsdatei des Steuerelements definiert sind (.CPP).Die nächsten Codezeilen definieren die Dispatchzuordnung:
BEGIN_DISPATCH_MAP(CMyAxUICtrl, COleControl)
...
END_DISPATCH_MAP()
Wenn Sie MFC-ActiveX-Steuerelement-Assistent verwendet haben, um das Projekt zu erstellen, wurden diese Zeilen automatisch hinzugefügt.Wenn der MFC-ActiveX-Steuerelement-Assistent nicht verwendet wurde, müssen Sie diese Zeilen manuell hinzufügen.
Die folgenden Elemente beschreiben Methoden detailliert:
MFC-ActiveX-Steuerelemente: Vordefinierte Methoden hinzufügen
MFC-ActiveX-Steuerelemente: Benutzerdefinierte Methoden hinzufügen
MFC-ActiveX-Steuerelemente: Fehlercode von der Methode zurückgeben