OLEDragOver-Ereignis

Artikel
04/01/2008

Tritt auf, wenn Daten über ein Dropziel gezogen und die OLEDropMode-Eigenschaft des Dropziels auf 1 (Aktiviert) gesetzt ist.

PROCEDURE Object.OLEDragOver
LPARAMETERS oDataObject, nEffect, nButton,
 nShift,   nXCoord, nYCoord, nState

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 OLEGiveFeedback-Ereignis zurückgegebener 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 bezeichnet. Die folgende Tabelle listet die Werte für nEffect zusammen mit einer Beschreibung der einzelnen Aktionen auf.

nEffect	Foxpro.h-Konstante	Beschreibung
0	DROPEFFECT_NONE	Dropziel akzeptierte die Daten nicht, oder die Drop-Operation wurde abgebrochen.
1	DROPEFFECT_COPY	Daten wurden von der Drag-Quelle auf das Dropziel kopiert.
2	DROPEFFECT_MOVE	Daten wurden von der Drag-Quelle auf das Dropziel verschoben.
4	DROPEFFECT_LINK	Es wurde eine Verknüpfung für Daten von der Drag-Quelle zum Dropziel erstellt.

nButton
Enthält eine Zahl, die angibt, welche Maustaste gedrückt wurde, wenn die Daten auf dem Dropziel abgelegt werden: 1 (links), 2 (rechts) oder 4 (Mitte).
nShift
Enthält eine Zahl, die den Zustand der Zusatztasten (Steuerungstasten) zu dem Zeitpunkt angibt, zu dem Daten über das Dropziel gezogen werden. 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 Daten über das Dropziel gezogen werden. Diese Koordinaten werden in Ausdrücken des Koordinatensystems des Formulars und in den durch die ScaleMode-Eigenschaft des Formulars festgelegten Maßeinheiten angegeben.

nShift	Zusatztaste
1	UMSCHALTTASTE
2	STRG
4	ALT

nState
Enthält eine Zahl, die die Richtung angibt, in die die Daten gezogen werden: in das Steuerelement oder Objekt hinein, innerhalb des Steuerelements oder Objekts oder aus dem Steuerelement oder Objekt heraus. Die Werte für nState sind in der folgenden Tabelle aufgeführt.

nState	Beschreibung
0	Daten werden in das Steuerelement oder Objekt hineingezogen. Wenn nState den Wert Null (0) hat, können die Eigenschaften OLEDropEffects und OLEDropHasData festgelegt werden.
1	Daten werden aus dem Steuerelement oder Objekt herausgezogen.
2	Daten werden innerhalb des Steuerelements oder Objekts gezogen.

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.

Beachten Sie, dass Sie es vermeiden sollten, mit Befehlen oder Funktionen, wie etwa WAIT WINDOW und MESSAGEBOX( ), Wartezustände im OLEDragOver-Ereignis hervorzurufen.

Siehe auch

OLE-Drag & Drop - Überblick | OLEGiveFeedBack-Ereignis | OLEDropEffects-Eigenschaft | OLEDropHasData-Eigenschaft | OLEDropMode-Eigenschaft

Freigeben über

OLEDragOver-Ereignis

Eigenschaftswerte

Hinweise

Siehe auch

Zusätzliche Ressourcen