Freigeben über

DragDrop-Ereignis

  • Artikel

Wird ausgelöst, wenn ein Drag & Drop-Vorgang abgeschlossen wird.

PROCEDURE Object.DragDrop
LPARAMETERS [nIndex,] oSource, nXCoord, nYCoord

Parameter

Sie müssen in der Ereignisprozedur eine LPARAMETERS- oder eine PARAMETERS-Anweisung sowie einen Namen für jeden Parameter angeben. Visual FoxPro übergibt dem DragDrop-Ereignis drei bis vier Parameter in der folgenden Reihenfolge:

  • nIndex
    Kennzeichnet ein Steuerelement eindeutig, wenn es sich in einem Steuerelementarray befindet.
  • oSource
    Spricht das Steuerelement an, das gezogen wird. Sie können mit diesem Parameter Eigenschaften und Methoden des Steuerelements ansprechen.
  • nXCoord, nYCoord
    Enthält die horizontale (nXCoord) und vertikale (nYCoord) Position des Mauszeigers innerhalb des Formulars, wenn Daten auf einem Dropziel abgelegt werden. Diese Koordinaten beziehen sich auf das Koordinatensystem des Formulars. Die Maßeinheit wird durch die ScaleMode-Eigenschaft des Formulars festgelegt.

Hinweise

Ein Drag & Drop-Vorgang gilt als beendet, wenn ein Steuerelement über ein anderes Steuerelement oder Formular gezogen wird und Sie anschließend die Maustaste loslassen oder wenn die Drag-Methode, bei der das nAction-Argument auf 2 (Ablegen) gesetzt ist, aufgerufen wird.

Mit einem DragDrop-Ereignis können Sie steuern, was nach Beendigung eines Drag-Vorgangs geschieht. Sie können z. B. die Quellcodeverwaltung an eine neue Position oder eine Datei aus einem Verzeichnis in ein anderes kopieren.

Anmerkung   Das DragDrop-Ereignis enthält zwei Objekte, nämlich ein Steuerelement, das gezogen wird, und ein Zielobjekt. Das DragDrop-Ereignis wird für das Zielobjekt und nicht für das Steuerelement, das gezogen wird, ausgelöst. Mit der DragMode-Eigenschaft und der Drag-Methode können Sie angeben, wie das Ziehen eingeleitet werden soll. Nachdem das Ziehen eingeleitet wurde, können Sie Ereignisse, die vor einem DragDrop-Ereignis auftreten, mit einem DragOver-Ereignis abfangen.

Siehe auch

Drag-Methode | DragIcon-Eigenschaft | DragMode-Eigenschaft | DragOver-Ereignis | MouseDown-Ereignis | MouseUp-Ereignis | MouseMove-Ereignis

Betrifft: Kontrollkästchen-Steuerelement (CheckBox) | Kombinationsfeld-Steuerelement (ComboBox) | Befehlsschaltflächen-Steuerelement (CommandButton) | Schaltflächengruppe-Steuerelement (CommandGroup) | Container-Objekt | Control-Objekt | Bearbeitungsfeld-Steuerelement (EditBox) | Formularobjekt (Form) | Datenraster-Steuerelement (Grid) | Bild-Steuerelement (Image) | Bezeichnungs-Steuerelement | Linien-Steuerelement (Line) | Listenfeld-Steuerelement (ListBox) | Gebundenes OLE-Steuerelement | OLE-Container-Steuerelement | Optionsfeld-Steuerelement (OptionButton) | Optionsgruppen-Steuerelement (OptionGroup) | Seitenobjekt (Page) | Seitenrahmen-Steuerelement (PageFrame) | Form-Steuerelement (Shape) | Drehfeld-Steuerelement (Spinner) | Textfeld-Steuerelement (TextBox) | Symbolleisten-Objekt