Vcl.Controls.TControl.OnStartDrag
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.