BeforeDropOrPaste-Ereignis
Tritt ein, wenn der Benutzer Daten in einem Objekt ablegen oder einfügen möchte.
Syntax
Für Frame
PrivateSub-Objekt _BeforeDropOrPaste( ByValCancelAs MSForms.ReturnBoolean,
STRGAls Steuerelement,
ByValActionAs fmAction,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValEffectAs MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Für MultiPage
PrivateSub-Objekt _BeforeDropOrPaste(indexAs Long,
ByValCancelAs MSForms.ReturnBoolean,
STRGAls Steuerelement,
ByValActionAs fmAction,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValEffectAs MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Für TabStrip
PrivateSub-Objekt _BeforeDropOrPaste(indexAs Long,
ByValCancelAs MSForms.ReturnBoolean,
ByValActionAs fmAction,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValEffectAs MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Für andere Steuerelemente
PrivateSub-Objekt _BeforeDropOrPaste( ByValCancelAs MSForms.ReturnBoolean,
ByValActionAs fmAction,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValEffectAs MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Die Syntax des BeforeDropOrPaste-Ereignisses umfasst die folgenden Teile:
| Bestandteil | Beschreibung |
|---|---|
| Objekt | Erforderlich. Ein gültiger Objektname. |
| Index | Erforderlich. Der Index der Seite in einem MultiPage-Objekt , auf den sich der Vorgang zum Ablegen oder Einfügen 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 Zielsteuerelement. |
| Aktion | Erforderlich. Gibt das Ergebnis des ausstehenden Drag-/Drop-Vorgangs basierend auf den aktuellen Tastatureinstellungen an. |
| Daten | Erforderlich. Die bei einem Drag-/Drop-Vorgang verschobenen Daten. Die Daten werden in einem DataObject gepackt. |
| X, Y | Erforderlich. Die horizontale und vertikale Position des Mauszeigers beim Ausführen des Ablegens. Beide Koordinaten werden in Punkt gemessen. X wird vom linken Rand des Steuerelements gemessen; Y wird vom oberen Rand des Steuerelements gemessen. |
| Effect | Erforderlich. Effekt des Drag-/Drop-Vorgangs auf das Zielsteuerelement. |
| Shift | Erforderlich. Gibt den Zustand der UMSCHALTTASTE, der STRG- und der ALT-TASTE an. |
Einstellungen
Die Einstellungen für die Aktion lauten wie folgt:
| Konstante | Wert | Beschreibung |
|---|---|---|
| fmActionPaste | 2 | Fügt das ausgewählte Objekt in das Ablageziel ein. |
| fmActionDragDrop | 3 | Gibt an, dass der Benutzer das Objekt von der zugehörigen Quelle zum Ablageziel gezogen und dort abgelegt hat. |
Die Einstellungen für den Effekt lauten wie folgt:
| Konstante | Wert | Beschreibung |
|---|---|---|
| fmDropEffectNone | 0 | Kopiert oder verschiebt die Drop-Quelle nicht in das Drop-Ziel. |
| 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
Bei einem MultiPage- oder TabStrip-Objekt initiiert Visual Basic for Applications dieses Ereignis, wenn ein Datenobjekt an das Steuerelement übertragen wird.
Bei anderen Steuerelementen initiiert das System dieses Ereignis sofort vor dem Vorgang zum Ablegen oder Einfügen.
Wenn dieses Ereignis durch ein Steuerelement behandelt wird, können Sie das Argument für die Aktion aktualisieren, sodass die auszuführende Drag-/Drop-Aktion angegeben wird.
Wenn der Effekt auf fmDropEffectCopyOrMove festgelegt ist, können Sie die Aktion der Konstante fmDropEffectNone, fmDropEffectCopy oder fmDropEffectMove zuordnen.
Wenn der Effekt auf fmDropEffectCopy oder fmDropEffectMove festgelegt ist, können Sie die Aktion der Konstante fmDropEffectNone zuordnen. Eine Neuzuordnung der Aktion ist nicht möglich, wenn der Effekt auf fmDropEffectNone 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.