Ereignissenkenzuordnungen
Wenn ein eingebettetes OLE-Steuerelement ein Ereignis auslöst, empfängt der Container des Steuerelements das Ereignis mithilfe eines Mechanismus, der als "Ereignissenkenzuordnung" bezeichnet wird, die von MFC bereitgestellt wird. Diese Ereignissenkezuordnung bestimmt Handlerfunktionen für jedes bestimmte Ereignis sowie Parameter dieser Ereignisse. Weitere Informationen zu Ereignissenkenzuordnungen finden Sie im Artikel ActiveX-Steuerelementcontainer.
Ereignissenkenzuordnungen
| Name | Beschreibung |
|---|---|
| BEGIN_EVENTSINK_MAP | Startet die Definition einer Ereignissenkenzuordnung. |
| DECLARE_EVENTSINK_MAP | Deklariert eine Ereignissenkenzuordnung. |
| END_EVENTSINK_MAP | Beendet die Definition einer Ereignissenkenzuordnung. |
| ON_EVENT | Definiert einen Ereignishandler für ein bestimmtes Ereignis. |
| ON_EVENT_RANGE | Definiert einen Ereignishandler für ein bestimmtes Ereignis, das aus einer Reihe von OLE-Steuerelementen ausgelöst wird. |
| ON_EVENT_REFLECT | Empfängt Ereignisse, die vom Steuerelement ausgelöst werden, bevor sie vom Container des Steuerelements behandelt werden. |
| ON_PROPNOTIFY | Definiert einen Handler zum Behandeln von Eigenschaftenbenachrichtigungen aus einem OLE-Steuerelement. |
| ON_PROPNOTIFY_RANGE | Definiert einen Handler für die Behandlung von Eigenschaftenbenachrichtigungen aus einer Reihe von OLE-Steuerelementen. |
| ON_PROPNOTIFY_REFLECT | Empfängt Eigenschaftenbenachrichtigungen, die vom Steuerelement gesendet werden, bevor sie vom Container des Steuerelements behandelt werden. |
BEGIN_EVENTSINK_MAP
Beginnt mit der Definition der Ereignissenkenzuordnung.
BEGIN_EVENTSINK_MAP(theClass, baseClass)
Parameter
theClass
Gibt den Namen der Steuerelementklasse an, deren Ereignissenkenzuordnung dies ist.
Baseclass
Gibt den Namen der Basisklasse der Klasse an.
Hinweise
Starten Sie in der Implementierungsdatei (.cpp), die die Memberfunktionen für Ihre Klasse definiert, die Ereignissenkenzuordnung mit dem BEGIN_EVENTSINK_MAP Makro, fügen Sie dann Makroeinträge für jedes Ereignis hinzu, über das sie benachrichtigt werden soll, und schließen Sie die Ereignissenkenzuordnung mit dem END_EVENTSINK_MAP Makro ab.
Weitere Informationen zu Ereignissenkenzuordnungen und OLE-Steuerelementcontainern finden Sie im Artikel ActiveX-Steuerelementcontainer.
Anforderungen
Header afxdisp.h
DECLARE_EVENTSINK_MAP
Ein OLE-Container kann eine Ereignissenkezuordnung bereitstellen, um die Ereignisse anzugeben, über die Ihr Container benachrichtigt wird.
DECLARE_EVENTSINK_MAP()
Hinweise
Verwenden Sie das DECLARE_EVENTSINK_MAP Makro am Ende der Klassendeklaration. Dann in der . CPP-Datei, die die Memberfunktionen für die Klasse definiert, das BEGIN_EVENTSINK_MAP Makro, Makroeinträge für jedes der Ereignisse, die benachrichtigt werden sollen, und das END_EVENTSINK_MAP Makro, um das Ende der Ereignissenkenliste zu deklarieren.
Weitere Informationen zu Ereignissenkenzuordnungen finden Sie im Artikel ActiveX-Steuerelementcontainer.
Anforderungen
Header afxwin.h
END_EVENTSINK_MAP
Beendet die Definition der Ereignissenkenzuordnung.
END_EVENTSINK_MAP()
Anforderungen
Header afxdisp.h
ON_EVENT
Verwenden Sie das ON_EVENT Makro, um eine Ereignishandlerfunktion für ein Ereignis zu definieren, das von einem OLE-Steuerelement ausgelöst wird.
ON_EVENT(theClass, id, dispid, pfnHandler, vtsParams)
Parameter
theClass
Die Klasse, zu der diese Ereignissenkennkarte gehört.
id
Die Steuerelement-ID des OLE-Steuerelements.
Dispid
Die Verteiler-ID des Ereignisses, das vom Steuerelement ausgelöst wird.
pfnHandler
Zeiger auf eine Memberfunktion, die das Ereignis behandelt. Diese Funktion sollte über einen BOOL-Rückgabetyp und Parametertypen verfügen, die den Parametern des Ereignisses entsprechen (siehe vtsParams). Die Funktion sollte WAHR zurückgeben, um anzugeben, dass das Ereignis behandelt wurde. andernfalls FALSE.
vtsParams
Eine Abfolge von VTS_ Konstanten, die die Typen der Parameter für das Ereignis angibt. Dies sind die gleichen Konstanten, die in Verteilerzuordnungseinträgen wie DISP_FUNCTION verwendet werden.
Hinweise
Das Argument vtsParams ist eine durch Leerzeichen getrennte Liste von Werten aus den VTS_ Konstanten. Mindestens einer dieser Werte, die durch Leerzeichen (keine Kommas) getrennt sind, gibt die Parameterliste der Funktion an. Beispiel:
VTS_I2 VTS_BOOL
Gibt eine Liste an, die eine kurze ganze Zahl gefolgt von einer BOOL enthält.
Eine Liste der VTS_ Konstanten finden Sie unter EVENT_CUSTOM.
Anforderungen
Header afxdisp.h
ON_EVENT_RANGE
Verwenden Sie das makro ON_EVENT_RANGE, um eine Ereignishandlerfunktion für ein Ereignis zu definieren, das von jedem OLE-Steuerelement ausgelöst wird, das eine Steuerelement-ID innerhalb eines zusammenhängenden Bereichs von IDs aufweist.
ON_EVENT_RANGE(theClass, idFirst, idLast, dispid, pfnHandler, vtsParams)
Parameter
theClass
Die Klasse, zu der diese Ereignissenkennkarte gehört.
idFirst
Die Steuerelement-ID des ersten OLE-Steuerelements im Bereich.
idLast
Die Steuerelement-ID des letzten OLE-Steuerelements im Bereich.
Dispid
Die Verteiler-ID des Ereignisses, das vom Steuerelement ausgelöst wird.
pfnHandler
Zeiger auf eine Memberfunktion, die das Ereignis behandelt. Diese Funktion sollte über einen BOOL-Rückgabetyp, einen ersten Parameter vom Typ UINT (für die Steuerelement-ID) und zusätzliche Parametertypen verfügen, die den Parametern des Ereignisses entsprechen (siehe vtsParams). Die Funktion sollte WAHR zurückgeben, um anzugeben, dass das Ereignis behandelt wurde. andernfalls FALSE.
vtsParams
Eine Abfolge von VTS_ Konstanten, die die Typen der Parameter für das Ereignis angibt. Die erste Konstante sollte vom Typ VTS_I4 sein, für die Steuerelement-ID. Dies sind die gleichen Konstanten, die in Verteilerzuordnungseinträgen wie DISP_FUNCTION verwendet werden.
Hinweise
Das Argument vtsParams ist eine durch Leerzeichen getrennte Liste von Werten aus den VTS_ Konstanten. Mindestens einer dieser Werte, die durch Leerzeichen (keine Kommas) getrennt sind, gibt die Parameterliste der Funktion an. Beispiel:
VTS_I2 VTS_BOOL
Gibt eine Liste an, die eine kurze ganze Zahl gefolgt von einer BOOL enthält.
Eine Liste der VTS_ Konstanten finden Sie unter EVENT_CUSTOM.
Beispiel
Im folgenden Beispiel wird ein Ereignishandler für das MouseDown-Ereignis veranschaulicht, das für drei Steuerelemente implementiert ist ( IDC_MYCTRL1 bis IDC_MYCTRL3). Die Ereignishandlerfunktion , OnRangeMouseDownwird in der Headerdatei der Dialogklasse ( CMyDlg) als:
BOOL OnRangeMouseDown(UINT CtlID, short MouseButton, short Shift,
long x, long y);
Der folgende Code wird in der Implementierungsdatei der Dialogklasse definiert.
BEGIN_EVENTSINK_MAP(CMyDlg, CDialog)
ON_EVENT_RANGE(CMyDlg, IDC_MYCTRL1, IDC_MYCTRL3, -605, OnRangeMouseDown,
VTS_I4 VTS_I2 VTS_I2 VTS_I4 VTS_I4)
END_EVENTSINK_MAP()
Anforderungen
Header afxdisp.h
ON_EVENT_REFLECT
Das ON_EVENT_REFLECT Makro empfängt bei Verwendung in der Ereignissenkezuordnung der Wrapperklasse eines OLE-Steuerelements Ereignisse, die vom Steuerelement ausgelöst werden, bevor sie vom Container des Steuerelements behandelt werden.
ON_EVENT_REFLECT(theClass, dispid, pfnHandler, vtsParams)
Parameter
theClass
Die Klasse, zu der diese Ereignissenkennkarte gehört.
Dispid
Die Verteiler-ID des Ereignisses, das vom Steuerelement ausgelöst wird.
pfnHandler
Zeiger auf eine Memberfunktion, die das Ereignis behandelt. Diese Funktion sollte einen BOOL-Rückgabetyp und Parametertypen aufweisen, die den Parametern des Ereignisses entsprechen (siehe vtsParams). Die Funktion sollte WAHR zurückgeben, um anzugeben, dass das Ereignis behandelt wurde. andernfalls FALSE.
vtsParams
Eine Abfolge von VTS_ Konstanten, die die Typen der Parameter für das Ereignis angibt. Dies sind die gleichen Konstanten, die in Verteilerzuordnungseinträgen wie DISP_FUNCTION verwendet werden.
Hinweise
Das Argument vtsParams ist eine durch Leerzeichen getrennte Liste von Werten aus den VTS_ Konstanten.
Mindestens einer dieser Werte, die durch Leerzeichen (keine Kommas) getrennt sind, gibt die Parameterliste der Funktion an. Beispiel:
VTS_I2 VTS_BOOL
Gibt eine Liste an, die eine kurze ganze Zahl gefolgt von einer BOOL enthält.
Eine Liste der VTS_ Konstanten finden Sie unter EVENT_CUSTOM.
Anforderungen
Header afxdisp.h
ON_PROPNOTIFY
Verwenden Sie das makro ON_PROPNOTIFY, um einen Ereignissenkennzuordnungseintrag zum Behandeln von Eigenschaftenbenachrichtigungen aus einem OLE-Steuerelement zu definieren.
ON_PROPNOTIFY(theClass, id, dispid, pfnRequest, pfnChanged)
Parameter
theClass
Die Klasse, zu der diese Ereignissenkennkarte gehört.
id
Die Steuerelement-ID des OLE-Steuerelements.
Dispid
Die Verteiler-ID der Eigenschaft, die an der Benachrichtigung beteiligt ist.
pfnRequest
Zeiger auf eine Memberfunktion, die die OnRequestEdit Benachrichtigung für diese Eigenschaft behandelt. Diese Funktion sollte einen BOOL-Rückgabetyp und einen BOOL-Parameter* aufweisen. Diese Funktion sollte den Parameter auf TRUE festlegen, damit die Eigenschaft geändert werden kann und FALSE nicht zulässig ist. Die Funktion sollte WAHR zurückgeben, um anzugeben, dass die Benachrichtigung behandelt wurde. andernfalls FALSE.
pfnChanged
Zeiger auf eine Memberfunktion, die die OnChanged Benachrichtigung für diese Eigenschaft behandelt. Die Funktion sollte einen BOOL-Rückgabetyp und einen UINT-Parameter aufweisen. Die Funktion sollte WAHR zurückgeben, um anzugeben, dass die Benachrichtigung verarbeitet wurde. andernfalls FALSE.
Hinweise
Das Argument vtsParams ist eine durch Leerzeichen getrennte Liste von Werten aus den VTS_ Konstanten. Mindestens einer dieser Werte, die durch Leerzeichen (keine Kommas) getrennt sind, gibt die Parameterliste der Funktion an. Beispiel:
VTS_I2 VTS_BOOL
Gibt eine Liste an, die eine kurze ganze Zahl gefolgt von einer BOOL enthält.
Eine Liste der VTS_ Konstanten finden Sie unter EVENT_CUSTOM.
ON_PROPNOTIFY_RANGE
Verwenden Sie das makro ON_PROPNOTIFY_RANGE, um einen Ereignissenkennzuordnungseintrag für die Behandlung von Eigenschaftenbenachrichtigungen von jedem OLE-Steuerelement mit einer Steuerelement-ID innerhalb eines zusammenhängenden Bereichs von IDs zu definieren.
ON_PROPNOTIFY_RANGE(theClass, idFirst, idLast, dispid, pfnRequest, pfnChanged)
Parameter
theClass
Die Klasse, zu der diese Ereignissenkennkarte gehört.
idFirst
Die Steuerelement-ID des ersten OLE-Steuerelements im Bereich.
idLast
Die Steuerelement-ID des letzten OLE-Steuerelements im Bereich.
Dispid
Die Verteiler-ID der Eigenschaft, die an der Benachrichtigung beteiligt ist.
pfnRequest
Zeiger auf eine Memberfunktion, die die OnRequestEdit Benachrichtigung für diese Eigenschaft behandelt. Diese Funktion sollte über einen BOOL Rückgabetyp und parameter BOOL*UINT verfügen. Die Funktion sollte den Parameter auf TRUE festlegen, damit die Eigenschaft geändert werden kann, und FALSE nicht zulässig ist. Die Funktion sollte WAHR zurückgeben, um anzugeben, dass die Benachrichtigung verarbeitet wurde. andernfalls FALSE.
pfnChanged
Zeiger auf eine Memberfunktion, die die OnChanged Benachrichtigung für diese Eigenschaft behandelt. Die Funktion sollte einen BOOL Rückgabetyp und einen UINT Parameter aufweisen. Die Funktion sollte WAHR zurückgeben, um anzugeben, dass die Benachrichtigung verarbeitet wurde. andernfalls FALSE.
Anforderungen
Header afxdisp.h
ON_PROPNOTIFY_REFLECT
Das ON_PROPNOTIFY_REFLECT Makro, das in der Ereignissenkenzuordnung der Wrapperklasse eines OLE-Steuerelements verwendet wird, empfängt Eigenschaftenbenachrichtigungen, die vom Steuerelement gesendet werden, bevor sie vom Container des Steuerelements behandelt werden.
ON_PROPNOTIFY_REFLECT(theClass, dispid, pfnRequest, pfnChanged)
Parameter
theClass
Die Klasse, zu der diese Ereignissenkennkarte gehört.
Dispid
Die Verteiler-ID der Eigenschaft, die an der Benachrichtigung beteiligt ist.
pfnRequest
Zeiger auf eine Memberfunktion, die die OnRequestEdit Benachrichtigung für diese Eigenschaft behandelt. Diese Funktion sollte einen BOOL-Rückgabetyp und einen BOOL-Parameter* aufweisen. Diese Funktion sollte den Parameter auf TRUE festlegen, damit die Eigenschaft geändert werden kann und FALSE nicht zulässig ist. Die Funktion sollte WAHR zurückgeben, um anzugeben, dass die Benachrichtigung behandelt wurde. andernfalls FALSE.
pfnChanged
Zeiger auf eine Memberfunktion, die die OnChanged Benachrichtigung für diese Eigenschaft behandelt. Die Funktion sollte einen BOOL-Rückgabetyp und keine Parameter aufweisen. Die Funktion sollte WAHR zurückgeben, um anzugeben, dass die Benachrichtigung behandelt wurde. andernfalls FALSE.
Anforderungen
Header afxdisp.h
Siehe auch
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für