Vcl.Controls.TControl.OnStartDrag

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property OnStartDrag: TStartDragEvent read FOnStartDrag write FOnStartDrag;

C++

__property TStartDragEvent OnStartDrag = {read=FOnStartDrag, write=FOnStartDrag};

Eigenschaften

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

Beschreibung

Tritt ein, wenn der Benutzer mit dem Ziehen des Steuerelements oder eines in ihm enthaltenen Objekts beginnt.

Mit Hilfe einer Ereignisbehandlungsroutine für OnStartDrag können Sie spezielle Aktionen durchführen, sobald der Benutzer mit dem Ziehen des Steuerelements oder eines in ihm enthaltenen Objekts beginnt. OnStartDrag kann nur eintreten, wenn DragKind den Wert dkDrag hat.

Der Parameter Sender gibt das beteiligte Steuerelement an.

In der Routine kann für den Parameter DragObject eine TDragControlObjectEx-Instanz erzeugt werden, um einen speziellen Cursor und (optional) ein Imagelist-Objekt für die Operation anzugeben. Wenn Sie eine TDragControlObjectEx-Instanz erzeugen, ist nach der Beendigung des Ziehvorgangs kein Aufruf der Methode Free für DragObject nötig. Dagegen ist bei einer TDragControlObject-Instanz die Anwendung für die Freigabe des gezogenen Objekts verantwortlich.

Wenn die Ereignisbehandlungsroutine für OnStartDrag den Parameter DragObject auf nil (Delphi) bzw. NULL (C++) setzt, wird automatisch ein TDragControlObject-Objekt erzeugt, und der Ziehvorgang beginnt mit dem Steuerelement selbst.

Hinweis: Bei bestimmten Steuerelementen (z.B. TRichEdit) werden interne Ziehoperationen vom zugrunde liegenden Windows-Steuerelement verarbeitet. Für Ziehoperationen innerhalb des Steuerelements werden in diesem Fall keine OnStartDrag- oder OnEndDrag-Ereignisse ausgelöst.

OnStartDrag ist eine Ereignisbehandlungsroutine des Typs TStartDragEvent.

Siehe auch