DragDrop クラス

定義

名前空間:: System.Windows

アセンブリ:: PresentationCore.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ドラッグアンドドロップ操作を開始するメソッドや、ドラッグアンドドロップ関連のイベントハンドラーを追加および削除するための機能など、ドラッグアンドドロップ操作を開始するためのヘルパーメソッドとフィールドを提供します。

public ref class DragDrop abstract sealed

public static class DragDrop

type DragDrop = class

Public Class DragDrop

継承: Object
DragDrop

注釈

ドラッグアンドドロップとは、一般的に、マウス (またはその他のポインティングデバイス) を使用して 1 つ以上のオブジェクトを選択し、ユーザーインターフェイス (UI) で目的のドロップターゲットの上にこれらのオブジェクトをドラッグしてドロップする方法を指します。ドラッグアンドドロップ操作は、あるオブジェクトまたはアプリケーションから別のオブジェクトまたはアプリケーションにデータを転送するために使用されるコピー (または切り取り) および貼り付け操作に似ています。ドラッグアンドドロップ操作には、通常、ドラッグされたデータの発生元のドラッグソースと、ドロップされたデータを受け取るドロップターゲットの 2 つの関係者が含まれます。ドラッグアンドドロップ操作に必要なイベントとメソッドは、 DragDrop クラスで定義されます。ドラッグアンドドロップイベントは、任意の UIElement または ContentElementにアタッチできる添付イベントです。ドラッグソースとドロップターゲットは、同じアプリケーションまたは異なるアプリケーションの UI 要素である場合があります。ただし、ドロップターゲットは、ドラッグソースによって渡されるデータを処理する方法を認識している必要があります。

Note

UIElementクラスとContentElement クラスには、ドラッグアンドドロップイベントのエイリアスが含まれているため、これらのクラスが基底クラスとして継承されるときに、イベントがクラスメンバーリストに表示されます。これらのクラスのいずれかのドラッグアンドドロップイベントにイベントハンドラーをアタッチすると、ハンドラーは基になる DragDrop イベントにアタッチされ、イベントデータの同じインスタンスを受け取ります。例については、「 UIElement.Drop」を参照してください。

ドラッグソースは、静的な DoDragDrop メソッドを呼び出し、転送されたデータをそのメソッドに渡すことによって、ドラッグアンドドロップ操作を開始します。要素は、通常、ドラッグソースである場合に次のイベントを処理します。

通常、要素はドロップターゲットである場合に次のイベントを処理します。

詳細と例については、「ドラッグアンドドロップの概要」を参照してください。

フィールド

名前	説明
DragEnterEvent	DragEnter添付イベントを識別します。
DragLeaveEvent	DragLeave添付イベントを識別します。
DragOverEvent	DragOver添付イベントを識別します。
DropEvent	Drop添付イベントを識別します。
GiveFeedbackEvent	GiveFeedback添付イベントを識別します。
PreviewDragEnterEvent	PreviewDragEnter添付イベントを識別します。
PreviewDragLeaveEvent	PreviewDragLeave添付イベントを識別します。
PreviewDragOverEvent	PreviewDragOver添付イベントを識別します。
PreviewDropEvent	PreviewDrop添付イベントを識別します。
PreviewGiveFeedbackEvent	PreviewGiveFeedback添付イベントを識別します。
PreviewQueryContinueDragEvent	PreviewQueryContinueDrag添付イベントを識別します。
QueryContinueDragEvent	QueryContinueDrag添付イベントを識別します。

メソッド

名前	説明
AddDragEnterHandler(DependencyObject, DragEventHandler)	指定した依存関係オブジェクトに DragEnter イベントハンドラーを追加します。
AddDragLeaveHandler(DependencyObject, DragEventHandler)	指定した依存関係オブジェクトに DragLeave イベントハンドラーを追加します。
AddDragOverHandler(DependencyObject, DragEventHandler)	指定した依存関係オブジェクトに DragOver イベントハンドラーを追加します。
AddDropHandler(DependencyObject, DragEventHandler)	指定した依存関係オブジェクトに Drop イベントハンドラーを追加します。
AddGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	指定した依存関係オブジェクトに GiveFeedback イベントハンドラーを追加します。
AddPreviewDragEnterHandler(DependencyObject, DragEventHandler)	指定した依存関係オブジェクトに PreviewDragEnter イベントハンドラーを追加します。
AddPreviewDragLeaveHandler(DependencyObject, DragEventHandler)	指定した依存関係オブジェクトに PreviewDragLeave イベントハンドラーを追加します。
AddPreviewDragOverHandler(DependencyObject, DragEventHandler)	指定した依存関係オブジェクトに PreviewDragOver イベントハンドラーを追加します。
AddPreviewDropHandler(DependencyObject, DragEventHandler)	指定した依存関係オブジェクトに PreviewDrop イベントハンドラーを追加します。
AddPreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	指定した依存関係オブジェクトに PreviewGiveFeedback イベントハンドラーを追加します。
AddPreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	指定した依存関係オブジェクトに PreviewQueryContinueDrag イベントハンドラーを追加します。
AddQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	指定した依存関係オブジェクトに QueryContinueDrag イベントハンドラーを追加します。
DoDragDrop(DependencyObject, Object, DragDropEffects)	ドラッグアンドドロップ操作を開始します。
RemoveDragEnterHandler(DependencyObject, DragEventHandler)	指定した依存関係オブジェクトから DragEnter イベントハンドラーを削除します。
RemoveDragLeaveHandler(DependencyObject, DragEventHandler)	指定した依存関係オブジェクトから DragLeave イベントハンドラーを削除します。
RemoveDragOverHandler(DependencyObject, DragEventHandler)	指定した依存関係オブジェクトから DragOver イベントハンドラーを削除します。
RemoveDropHandler(DependencyObject, DragEventHandler)	指定した依存関係オブジェクトから Drop イベントハンドラーを削除します。
RemoveGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	指定した依存関係オブジェクトから GiveFeedback イベントハンドラーを削除します。
RemovePreviewDragEnterHandler(DependencyObject, DragEventHandler)	指定した依存関係オブジェクトから PreviewDragEnter イベントハンドラーを削除します。
RemovePreviewDragLeaveHandler(DependencyObject, DragEventHandler)	指定した依存関係オブジェクトから PreviewDragLeave イベントハンドラーを削除します。
RemovePreviewDragOverHandler(DependencyObject, DragEventHandler)	指定した依存関係オブジェクトから PreviewDragOver イベントハンドラーを削除します。
RemovePreviewDropHandler(DependencyObject, DragEventHandler)	指定した依存関係オブジェクトから PreviewDrop イベントハンドラーを削除します。
RemovePreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	指定した依存関係オブジェクトから PreviewGiveFeedback イベントハンドラーを削除します。
RemovePreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	指定した依存関係オブジェクトから PreviewQueryContinueDrag イベントハンドラーを削除します。
RemoveQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	指定した依存関係オブジェクトから QueryContinueDrag イベントハンドラーを削除します。

添付イベント

名前	説明
DragEnter	オブジェクトがドロップターゲットとして機能する要素の境界にドラッグされたときに発生します。
DragLeave	ドロップ先として動作している要素の境界からオブジェクトがドラッグされ、ドロップされずに発生します。
DragOver	オブジェクトがドロップターゲットとして機能する要素の境界内でドラッグされている間、連続して発生します。
Drop	ドロップターゲットとして機能する要素の境界内でオブジェクトがドロップされたときに発生します。
GiveFeedback	ドラッグアンドドロップ操作の実行中に継続的に発生し、ドラッグソースがユーザーにフィードバックを提供できるようにします。
PreviewDragEnter	オブジェクトがドロップターゲットとして機能する要素の境界にドラッグされたときに発生します。
PreviewDragLeave	ドロップ先として動作している要素の境界からオブジェクトがドラッグされ、ドロップされずに発生します。
PreviewDragOver	オブジェクトがドロップターゲットとして機能する要素の境界内でドラッグされている間、連続して発生します。
PreviewDrop	ドロップターゲットとして機能する要素の境界内でオブジェクトがドロップされたときに発生します。
PreviewGiveFeedback	ドラッグアンドドロップ操作の実行中に継続的に発生し、ドラッグソースがユーザーにフィードバックを提供できるようにします。
PreviewQueryContinueDrag	ドラッグアンドドロップ操作の実行中に継続的に発生し、ドロップソースがキー/ボタンの状態に応じてドラッグアンドドロップ操作を終了できるようにします。
QueryContinueDrag	ドラッグアンドドロップ操作の実行中に継続的に発生し、ドロップソースがキー/ボタンの状態に応じてドラッグアンドドロップ操作を終了できるようにします。

適用対象

こちらもご覧ください

DataObject

フィードバック

このページはお役に立ちましたか?