ToolStripItem.DragOver イベント

.NET Framework クラス ライブラリ リファレンス

ToolStripItem.DragOver イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

この項目のクライアント領域上に、ユーザーが項目をドラッグしたときに発生します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Event DragOver As
 DragEventHandler

Visual Basic (使用法)

Dim instance As ToolStripItem
Dim handler As DragEventHandler

AddHandler instance.DragOver, handler

C#

public event DragEventHandler DragOver

C++

public:
event DragEventHandler^ DragOver {
    void add (DragEventHandler^ value);
    void remove (DragEventHandler^ value);
}

J#

/** @event */
public void add_DragOver (DragEventHandler
 value)

/** @event */
public void remove_DragOver (DragEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

DragOver イベントは、ドラッグ アンド ドロップ操作中、マウス カーソルがコントロールの範囲内で移動するときに発生します。

ドラッグ アンド ドロップ操作関連のイベントがどのように、いつ発生するかについて次に示します。

DoDragDrop メソッドは、現在のカーソル位置のアイテムを判別します。次に、アイテムが有効なドロップ ターゲットかどうかを確認します。

項目が有効なドロップ ターゲットの場合、指定したドラッグ アンド ドロップの効果が付いた状態で GiveFeedback イベントが発生します。ドラッグ アンド ドロップ効果の一覧については、DragDropEffects 列挙体を参照してください。

マウス カーソルの位置、キーボードの状態、およびマウス ボタンの状態の変更は、次の方法で監視されます。

• ユーザーがウィンドウの外に移動した場合、DragLeave イベントが生成されます。

• マウスが別の項目に移動した場合は、そのコントロールの DragEnter が生成されます。

• マウスが移動しても同じ項目内の場合は、DragOver イベントが生成されます。

キーボードまたはマウス ボタンの状態に変更があった場合、QueryContinueDrag イベントが生成され、このイベントの QueryContinueDragEventArgs の Action プロパティの値に応じて、ドラッグを継続するか、データをドロップするか、操作をキャンセルするかが判断されます。

DragAction の値が Continue の場合、操作を継続するための DragOver イベントが生成され、適切な視覚的フィードバックを設定できるように新しい効果による GiveFeedback イベントが生成されます。有効なドロップ効果の一覧については、DragDropEffects 列挙体を参照してください。

DragOver イベントおよび GiveFeedback イベントはペアになっています。したがって、次のように、マウスがドロップ ターゲットをまたがって移動した場合、マウスの位置に関する最新のフィードバックがユーザーに提示されます。

• DragAction の値が Drop の場合、ドロップ効果の値がソースに返されます。ソース アプリケーションでは、ソース データに対して適切な操作を実行できます。たとえば、移動操作だった場合は、データの切り取りなどを実行できます。

• DragAction の値が Cancel の場合、DragLeave イベントが生成されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ToolStripItem クラス
ToolStripItem メンバ
System.Windows.Forms 名前空間