OLEDragDrop-Ereignis

Tritt auf, wenn Daten auf dem Dropziel abgelegt werden und die OLEDropMode-Eigenschaft des Dropziels auf 1 (Aktiviert) eingestellt ist.

PROCEDURE Object.OLEDragDrop
LPARAMETERS oDataObject, nEffect, nButton,
 nShift,   nXCoord, nYCoord

Eigenschaftswerte

• oDataObject
  Ein Objektverweis auf ein OLE-Drag & Drop-Datenobjekt, der bei der GetData- und der GetFormat-Methode zur Rückgabe von Daten und Datenformaten im Datenobjekt verwendet wird.

• nEffect
  Ein an das OLECompleteDrag-Ereignis übergebener Wert, der die beim Ablegen der Daten auf das Dropziel ausgeführte Aktion bezeichnet. nEffect ist anfangs ein Wert, der die von der Drag-Quelle unterstützten OLE-Drag & Drop-Operationen unterstützt. Im OLEDragDrop-Ereignis können Sie den Wert von nEffect ändern, der an das OLECompleteDrag-Ereignis übergeben wird. Stellen Sie beim Ändern des Wertes von nEffect sicher, dass NODEFAULT in den Ereigniscode übernommen wird, damit das Standardverhalten nicht zur Anwendung kommt. Die folgende Tabelle zeigt die Werte für nEffect, die Sie an das OLECompleteDrag-Ereignis übergeben können, zusammen mit einer Beschreibung der jeweiligen Aktion.

  nEffect	Foxpro.h-Konstante	Beschreibung
  0	DROPEFFECT_NONE	Dropziel hat Daten nicht akzeptiert, oder der Vorgang wurde abgebrochen.
  1	DROPEFFECT_COPY	Daten wurden aus der Drag-Quelle in das Dropziel kopiert.
  2	DROPEFFECT_MOVE	Daten wurden aus der Drag-Quelle in das Dropziel verschoben.
  4	DROPEFFECT_LINK	Daten wurden aus der Drag-Quelle mit dem Dropziel verknüpft.

• nButton
  Enthält eine Zahl, die angibt, welche Maustaste freigegeben wurde, um die Daten auf dem Ziel abzulegen: 1 (links), 2 (rechts) oder 4 (Mitte).

• nShift
  Enthält eine Zahl, die den Zustand der Zusatztasten (Steuerungstasten) angibt, als die Maus freigegeben wurde, um die Daten auf dem Dropziel abzulegen. Gültige Zusatztasten sind die UMSCHALTTASTE, STRG und die ALT-Tasten. In der folgenden Tabelle sind die Werte zusammengestellt, die in nShift für die einzelnen Zusatztasten zurückgegeben werden.

  nShift	Zusatztaste
  1	UMSCHALTTASTE
  2	STRG
  4	ALT

  Waren mehrere Zusatztasten gedrückt, als die Maustaste gedrückt wurde, enthält das Argument nShift die Summe der Werte dieser Zusatztasten. Wenn Benutzer beispielsweise beim Freigeben der Maustaste die STRG-Taste gedrückt halten, enthält das nShift-Argument 2. Wenn Benutzer jedoch beim Freigeben der Maustaste STRG+ALT gedrückt halten, enthält das nShift-Argument 6.

• nXCoord, nYCoord
  Enthält die horizontale (nXCoord) und vertikale (nYCoord) Position des Mauszeigers innerhalb des Formulars, wenn die Maustaste freigegeben wird, um Daten auf dem Dropziel abzulegen. Diese Koordinaten werden in Ausdrücken des Koordinatensystems des Formulars und in den durch die ScaleMode-Eigenschaft des Formulars festgelegten Maßeinheiten angegeben.

Hinweise

OLEDragDrop ist ein Dropziel-Ereignis, das nur dann auftritt, wenn die OLEDropMode-Eigenschaft für das Steuerelement oder Objekt auf 1 (Aktiviert) gesetzt ist. Dieses Ereignis tritt nicht auf, wenn die OLEDropMode-Eigenschaft auf 0 (Deaktiviert) oder 2 (Übergabe an Container) gesetzt ist.

Wenn Sie Ihre eigene Dropverarbeitung im OleDragDrop-Ereignis vornehmen, müssen Sie NODEFAULT angeben, um zu verhindern, dass der Standarddrop ausgeführt wird. In diesem Fall müssen Sie dann den resultierenden nEffect-Wert angeben.

Siehe auch

OLE-Drag & Drop - Überblick | OLECompleteDrag-Ereignis | OLEDropMode-Eigenschaft

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