BeforeDragOver-Ereignis
Occurs when a drag-and-drop operation is in progress.
Syntax
Für Frame
PrivateSub-Objekt _BeforeDragOver( ByValCancelAs MSForms.ReturnBoolean,
STRGAls Steuerelement,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValDragStateAs fmDragState,
ByValEffectAs MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Für MultiPage
PrivateSub-Objekt _BeforeDragOver(indexAs Long,
ByValCancelAs MSForms.ReturnBoolean,
STRGAls Steuerelement,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValDragStateAs fmDragState,
ByValEffectAs MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Für TabStrip
PrivateSub-Objekt _BeforeDragOver(indexAs Long,
ByValCancelAs MSForms.ReturnBoolean,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValDragStateAs fmDragState,
ByValEffectAs MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Für andere Steuerelemente
PrivateSub-Objekt _BeforeDragOver( ByValCancelAs MSForms.ReturnBoolean,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValDragStateAs fmDragState,
ByValEffectAs MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Die Syntax des BeforeDragOver-Ereignisses besteht aus den folgenden Komponenten:
| Bestandteil | Beschreibung |
|---|---|
| Objekt | Erforderlich. Ein gültiger Objektname. |
| Index | Erforderlich. Der Index der Seite in einem MultiPage-Objekt , auf den sich der Drag-and-Drop-Vorgang auswirkt. |
| Cancel | Erforderlich. Ereignisstatus. False gibt an, dass das Ereignis vom Steuerelement behandelt werden soll (Standard). True gibt an, dass das Ereignis durch die Anwendung behandelt wird. |
| Strg | Erforderlich. Das Steuerelement, auf das die Daten gezogen werden. |
| Daten | Erforderlich. Die bei einem Drag-/Drop-Vorgang verschobenen Daten. Die Daten werden in einem DataObject gepackt. |
| X, Y | Erforderlich. Die horizontalen und vertikalen Koordinaten der Steuerelementposition. Beide Koordinaten werden in Punkt gemessen. X wird vom linken Rand des Steuerelements aus gemessen, und Y wird vom oberen Rand des Steuerelements aus gemessen. |
| DragState | Erforderlich. Übergangsstatus der Daten, die gezogen werden. |
| Effect | Erforderlich. Vorgänge, die von der Quelle des Drop-Vorgangs unterstützt werden. |
| Shift | Erforderlich. Gibt den Zustand der UMSCHALTTASTE, der STRG- und der ALT-TASTE an. |
Einstellungen
Die Einstellungen für DragState lauten:
| Konstante | Wert | Beschreibung |
|---|---|---|
| fmDragStateEnter | 0 | Der Mauszeiger liegt innerhalb des Bereichs eines Ziels. |
| fmDragStateLeave | 1 | Der Mauszeiger liegt außerhalb des Bereichs eines Ziels. |
| fmDragStateOver | 2 | Der Mauszeiger befindet sich an einer neuen Position, verbleibt aber innerhalb des Bereichs desselben Ziels. |
Die Einstellungen für Effect lauten:
| Konstante | Wert | Beschreibung |
|---|---|---|
| fmDropEffectNone | 0 | Die Quelle des Drop-Vorgangs wird nicht an das Ziel des Vorgangs kopiert oder verschoben. |
| fmDropEffectCopy | 1 | Kopiert die Drop-Quelle in das Drop-Ziel. |
| fmDropEffectMove | 2 | Verschiebt die Drop-Quelle in das Drop-Ziel. |
| fmDropEffectCopyOrMove | 3 | Kopiert oder verschiebt die Ablagequelle in das Ablageziel. |
Die Einstellungen für Shift lauten:
| Konstante | Wert | Beschreibung |
|---|---|---|
| fmShiftMask | 1 | UMSCHALT wurde gedrückt. |
| fmCtrlMask | 2 | STRG wurde gedrückt. |
| fmAltMask | 4 | ALT wurde gedrückt. |
Hinweise
Verwenden Sie dieses Ereignis, um den Mauszeiger zu überwachen, wenn dieser in ein gültiges Ziel eintritt, es verlässt oder direkt darauf ruht. Während eines Drag & Drop-Vorgangs initiiert das System dieses Ereignis, wenn Benutzer die Maus bewegen oder eine oder mehrere Maustasten drücken oder loslassen. Die Position des Mauszeigers bestimmt das Zielobjekt, das dieses Ereignis erhält. Sie können den Status des Mauszeigers ermitteln, indem Sie das Argument DragState untersuchen.
Wenn ein Steuerelement dieses Ereignis behandelt, können Sie das Argument Effect verwenden, um die durchzuführende Drag & Drop-Aktion zu ermitteln.
Wenn Effect auf fmDropEffectCopyOrMove festgelegt ist, unterstützt die Quelle des Drop-Vorgangs einen Kopiervorgang (fmDropEffectCopy), Verschiebevorgang (fmDropEffectMove) oder Abbruch (fmDropEffectNone).
Wenn Effect auf fmDropEffectCopy festgelegt ist, unterstützt die Quelle des Drop-Vorgangs einen Kopiervorgang oder Abbruch (fmDropEffectNone).
Wenn Effect auf fmDropEffectMove festgelegt ist, unterstützt die Quelle des Drop-Vorgangs einen Verschiebevorgang oder Abbruch (fmDropEffectNone).
Wenn Effect auf fmDropEffectNone festgelegt ist, unterstützt die Ablagequelle einen Abbruchvorgang.
Die meisten Steuerelemente unterstützen drag-and-drop nicht, während Cancel auf False festgelegt ist, was die Standardeinstellung ist. Dies bedeutet, dass das Steuerelement Versuche ablehnt, etwas auf das Steuerelement zu ziehen oder zu löschen, und dass das Steuerelement das BeforeDropOrPaste-Ereignis nicht initiiert. Die Steuerelemente TextBox und ComboBox sind ausnahmen. Diese Steuerelemente unterstützen Drag-and-Drop-Vorgänge auch dann, wenn Cancelauf False festgelegt ist.
Siehe auch
Support und Feedback
Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.