MFC-ActiveX-Steuerelemente: Methoden
Ein ActiveX-Steuerelement löst Ereignisse aus, um zwischen sich und seinem Steuerelementcontainer zu kommunizieren. Ein Container kann auch mithilfe von Methoden und Eigenschaften mit einem Steuerelement kommunizieren. Methoden werden auch als Funktionen bezeichnet.
Methoden und Eigenschaften stellen eine exportierte Schnittstelle für die Verwendung durch andere Anwendungen bereit, z. B. Automatisierungsclients und ActiveX-Steuerelementcontainer. Weitere Informationen zu ActiveX-Steuerelementeigenschaften finden Sie im Artikel MFC ActiveX Controls: Properties.
Methoden ähneln der Verwendung und dem Zweck der Memberfunktionen einer C++-Klasse. Es gibt zwei Arten von Methoden, die Ihr Steuerelement implementieren kann: Lager und benutzerdefiniert. Ähnlich wie bei Aktienereignissen sind Aktienmethoden die Methoden, für die COleControl eine Implementierung bereitstellt. Weitere Informationen zu Aktienmethoden finden Sie im Artikel MFC ActiveX Controls: Adding Stock Methods. Benutzerdefinierte Methoden, die vom Entwickler definiert werden, ermöglichen zusätzliche Anpassungen des Steuerelements. Weitere Informationen finden Sie im Artikel MFC ActiveX Controls: Hinzufügen von benutzerdefinierten Methoden.
Die Microsoft Foundation Class Library (MFC) implementiert einen Mechanismus, mit dem Ihr Steuerelement Aktien- und benutzerdefinierte Methoden unterstützen kann. Der erste Teil ist Klasse COleControl. Abgeleitet von CWnd, COleControl member functions support stock methods that are common to all ActiveX controls. Der zweite Teil dieses Mechanismus ist die Verteilerkarte. Eine Verteilerkarte ähnelt einer Nachrichtenkarte; Statt einer Windows-Nachrichten-ID eine Funktion zuzuordnen, ordnet eine Verteilerzuordnung jedoch den IDispatch-IDS virtuelle Memberfunktionen zu.
Damit ein Steuerelement verschiedene Methoden ordnungsgemäß unterstützt, muss die Klasse eine Verteilerzuordnung deklarieren. Dies wird durch die folgende Codezeile im Steuerelementklassenheader () erreicht. H) Datei:
DECLARE_DISPATCH_MAP()
Der Standard Zweck der Verteilerzuordnung besteht darin, die Beziehung zwischen den Methodennamen festzulegen, die von einem externen Aufrufer (z. B. dem Container) verwendet werden, und den Memberfunktionen der Klasse des Steuerelements, die die Methoden implementieren. Nachdem die Verteilerzuordnung deklariert wurde, muss sie in der Implementierung des Steuerelements definiert werden (. CPP)-Datei. Die folgenden Codezeilen definieren die Verteilerzuordnung:
BEGIN_DISPATCH_MAP(CMyAxUICtrl, COleControl)
END_DISPATCH_MAP()
Wenn Sie den MFC ActiveX-Steuerelement-Assistenten zum Erstellen des Projekts verwendet haben, wurden diese Zeilen automatisch hinzugefügt. Wenn der MFC ActiveX-Steuerelement-Assistent nicht verwendet wurde, müssen Sie diese Zeilen manuell hinzufügen.
In den folgenden Artikeln werden die Methoden ausführlich behandelt:
MFC-ActiveX-Steuerelemente: Hinzufügen von vordefinierten Methoden
MFC-ActiveX-Steuerelemente: Hinzufügen von benutzerdefinierten Methoden
MFC-ActiveX-Steuerelemente: Zurückgeben von Fehlercodes aus einer Methode