Vcl.Controls.TControl.OnDragOver

Übergeordnet: TControl

Delphi

property OnDragOver: TDragOverEvent read FOnDragOver write FOnDragOver;

C++

__property TDragOverEvent OnDragOver = {read=FOnDragOver, write=FOnDragOver};

Inhaltsverzeichnis

1 Eigenschaften
2 Beschreibung
- 2.1 Siehe auch
- 2.2 Codebeispiele

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
event	protected	Vcl.Controls.pas Vcl.Controls.hpp	Vcl.Controls	TControl

Beschreibung

Wird beim Ziehen eines Objekts über das Steuerelement ausgelöst.

Mit Hilfe von OnDragOver können Sie angeben, dass das Steuerelement ein gezogenes Objekt akzeptieren kann, sodass es vom Benutzer abgelegt oder angedockt werden kann.

Setzen Sie in der Ereignisbehandlungsroutine für OnDragOver den Parameter Accept auf False, um das gezogene Objekt zurückzuweisen. Lassen Sie Accept auf True gesetzt, damit das gezogene Objekt im Steuerelement vom Benutzer abgelegt oder angedockt werden kann.

Durch Ändern der Cursorform können Sie deutlich machen, dass das Steuerelement das gezogene Objekt akzeptiert. Ändern Sie dazu den Wert der Eigenschaft DragCursor des Steuerelements, bevor das Ereignis OnDragOver eintritt.

Source gibt das gezogene Objekt an, Sender ist der potentielle Empfänger und X und Y bezeichnen die Bildschirmkoordinaten in Pixel. Der Parameter State legt fest, wie sich das gezogene Objekt über das Steuerelement bewegt.

Hinweis: In der Ereignisbehandlungsroutine für OnDragOver hat der Parameter Accept den Standardwert True. Ist jedoch keine Routine implementiert, wird das gezogene Objekt vom Steuerelement zurückgewiesen. Es ergibt sich ein Verhalten, als ob der Parameter Accept auf False gesetzt wird.

OnDragOver ist eine Ereignisbehandlungsroutine des Typs TDragOverEvent.