MFC-ActiveX-Steuerelemente: Methoden
Ein ActiveX-Steuerelement löst Ereignisse aus, um sich zwischen und seinem Steuerelementcontainer zu kommunizieren. Ein Container kann ein Steuerelement mithilfe der Methoden und Eigenschaften auch kommunizieren. Methoden sind auch aufgerufene Funktionen.
Methoden und Eigenschaften stellen eine exportierte Schnittstelle für andere Anwendungen, z Automatisierungsclients und ActiveX-Steuerelementcontainer bereit. Weitere Informationen über ActiveX-Steuerelementeigenschaften, finden Sie im Artikel MFC-ActiveX-Steuerelemente: Eigenschaften.
Methoden sind ähnlich gebräuchliches und beabsichtigen zu Memberfunktionen von eine C++-Klasse. Es gibt zwei Typen von Methoden, die das Steuerelement implementieren kann: Bestand und Custom. Ähnlich den vordefinierten Ereignisse sind vordefinierte, Methoden diese Methoden, für die COleControl eine Implementierung bereitstellt. Weitere Informationen über vordefinierte Methoden, finden Sie im Artikel MFC-ActiveX-Steuerelemente: Hinzufügen vordefinierter Methoden. Die benutzerdefinierten Methoden definiert, dem Entwickler, können weitere Anpassungen des Steuerelements. Weitere Informationen finden Sie im Artikel MFC-ActiveX-Steuerelemente: Hinzufügen von benutzerdefinierten Methoden.
Die Microsoft Foundation Class-Bibliothek " (MFC-Bibliothek) implementiert einen Mechanismus, der das Steuerelement an Stützvordefinierten und benutzerdefinierten Methoden zulässig. Der erste Teil ist die Klasse COleControl. Ist von CWnd, COleControl-Memberfunktionsstützvorratmethoden, die allen ActiveX-Steuerelemente häufig sind. Der zweite Teil dieses Mechanismus ist die Dispatchzuordnung. Eine Dispatchzuordnung ist einer Meldungszuordnung ähnlich; jedoch, anstatt einer Funktion einer Windows-Meldung ID zugeordnet zu, wird eine Dispatchzuordnung virtuellen Memberfunktionen zu IDispatch-IDS.
Damit Steuerelemente ordnungsgemäß verschiedene Möglichkeiten, die Klasse muss eine Dispatchzuordnung deklarieren unterstützt. Dies wird durch die folgende Codezeile in der Steuerelementklassenkopfzeile erreicht (.H) Datei:
DECLARE_DISPATCH_MAP()
Der primäre Zweck der Dispatchzuordnung ist, die Beziehung zwischen den Methodennamen, die von einem externen Aufrufer (verwendet werden wie dem Container) und Memberfunktionen der Klasse des Steuerelements erstellen, die die Methoden implementieren. Nachdem die Dispatchzuordnung deklariert wurde, muss sie in der Implementierung des Steuerelements definiert werden (.CPP). Die folgenden Codezeilen werden die Dispatchzuordnung:
BEGIN_DISPATCH_MAP(CMyAxUICtrl, COleControl)
...
END_DISPATCH_MAP()
Wenn Sie MFC-ActiveX-Steuerelement-Assistent verwenden, um das Projekt zu erstellen, wurden diese Zeilen automatisch hinzugefügt. Wenn der MFC-ActiveX-Steuerelement-Assistent nicht verwendet wurde, müssen Sie diese manuell Zeilen hinzufügen.
Die folgenden Elemente werden Methoden ausführlich erörtert:
MFC-ActiveX-Steuerelemente: Hinzufügen vordefinierter Methoden
MFC-ActiveX-Steuerelemente: Hinzufügen von benutzerdefinierten Methoden
MFC-ActiveX-Steuerelemente: Rückgabe von Fehlercodes aus einer Methode