Vcl.Controls.TControl.OnDragOver
Delphi
property OnDragOver: TDragOverEvent read FOnDragOver write FOnDragOver;
C++
__property TDragOverEvent OnDragOver = {read=FOnDragOver, write=FOnDragOver};
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| event | protected | Vcl.Controls.pas Vcl.Controls.hpp |
Vcl.Controls | TControl |
説明
ユーザーが、コントロール上にオブジェクトをドラッグした際に発生します。
OnDragOver イベントを使用すると、コントロールがドラッグされたオブジェクトを受け入れられる、つまりユーザーはオブジェクトをドロップまたはドッキングできることを、示すことができます。
OnDragOver イベント ハンドラ内で、Accept パラメータを False に変更し、ドラッグされたオブジェクトを拒否することも可能です。 Accept を True のままにしておくと、ユーザーはドラッグしたオブジェクトをコントロール上にドロップまたはドッキングすることができます。
カーソルの形を変更して、コントロールがドラッグされたオブジェクトを受け入れられると示すには、OnDragOver イベントが発生する前に、コントロールの DragCursor プロパティの値を変更します。
Source は、ドラッグされているオブジェクトで、Sender は、可能性のあるドロップまたはドッキングされるサイト、X および Y は画面座標でピクセルで表します。 State パラメータは、ドラッグされたオブジェクトがコントロールに対してどのように移動されるかを示します。
メモ： OnDragOver イベント ハンドラ内で、
Acceptパラメータはデフォルトで True に設定されます。 しかし、OnDragOver イベント ハンドラがない場合には、Acceptパラメータが False に変更されるのと同様に、コントロールがドラッグされたオブジェクトを拒否します。
OnDragOver は、TDragOverEvent 型のイベント ハンドラです。
関連項目