Share via


Ereigniszuordnungen

Sobald ein Steuerelement seinen Container benachrichtigen möchte, dass eine Aktion vom Steuerelemententwickler spezifisch () geschehen ist (z. B. ein Mausklick, Tastatureingabe oder eine Änderung am Zustand des Steuerelements) ruft sie eine Ereignisauslösungsfunktion.Diese Funktion weist den Steuerelementcontainer, dass einige wichtige Aktion durchgeführt wurde, indem sie in die Ereignisse auslöst.

Microsoft Foundation Class Library stellt ein Programmiermodell, das zum Auslösen von Ereignissen optimiert wird.In diesem Modell "Ereigniszuordnungen" werden verwendet, um festzulegen, die Funktion ausgelöst wird das Ereignisse für ein bestimmtes Steuerelement.Ereigniszuordnungen ein Makro für jedes Ereignis enthalten.Beispielsweise könnte eine Ereigniszuordnung, die ein vordefiniertes Klickereignis ausgelöst werden, wie folgt aus:

BEGIN_EVENT_MAP(CMyAxCtrl, COleControl)
   EVENT_STOCK_CLICK()
END_EVENT_MAP()

Das EVENT_STOCK_CLICK Makro gibt an, dass es sich bei dem Steuerelement um ein vordefiniertes Klickereignis ausgelöst, das er jedes Mal einen Mausklick erkennt.Für Listen anderer vordefinierter Ereignisse detaillierteren finden Sie im Artikel ActiveX-Steuerelemente: Ereignisse.Makros sind ebenfalls verfügbar, benutzerdefinierte Ereignisse anzugeben.

Obwohl Ereigniszuordnungs Makros wichtig sind, fügen Sie sie im Allgemeinen nicht direkt ein.Dies liegt daran, dass das Eigenschaftenfenster Ereigniszuordnungs Dateisystemeinträgen in den Quelldateien automatisch erstellt, wenn Sie es verwenden, um Ereignisauslösungsfunktionen um Ereignisse zu verknüpfen.Immer wenn Sie einen Eintrag Ereigniszuordnungs hinzufügen oder bearbeiten möchten, können Sie das Eigenschaftenfenster verwenden.

Um Ereigniszuordnungen zu unterstützen, stellt MFC die folgenden Makros:

Ereigniszuordnungs-Deklaration und Abgrenzung

DECLARE_EVENT_MAP

Deklariert, dass eine Ereigniszuordnung in einer Klasse verwendet wird, um Ereignisse zu den Ereignisauslösungsfunktionen zuzuordnen (muss in der Klassendeklaration verwendet werden).

BEGIN_EVENT_MAP

Startet die Definition einer Ereigniszuordnung (muss in der Klassenimplementierung verwendet werden).

END_EVENT_MAP

Beendet die Definition einer Ereigniszuordnung (muss in der Klassenimplementierung verwendet werden).

Ereignis-Zuordnungs-Makros

EVENT_CUSTOM

Gibt an, welche Ereignisauslösungsfunktion das angegebene Ereignis auslöst.

EVENT_CUSTOM_ID

Gibt an, welche Ereignisauslösungsfunktion das angegebene Ereignis auslöst, mit einer festgelegten Weiterleitung an.

Meldungs-Zuordnungs-Makros

ON_OLEVERB

Gibt ein benutzerdefiniertes Verb an, das vom OLE-Steuerelement behandelt wird.

ON_STDOLEVERB

Überschreibt eine standardmäßige Zuordnung eines OLE-Steuerelements verb.

Siehe auch

Konzepte

MFC-Makros und -globale Werte