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 要素である場合があります。ただし、ドロップターゲットは、ドラッグソースによって渡されるデータを処理する方法を認識している必要があります。

注意

UIElementクラスと ContentElement クラスには、ドラッグアンドドロップイベントのエイリアスが含まれているため、これらのクラスが基底クラスとして継承されるときに、イベントがクラスメンバーリストに表示されます。これらのクラスの 1 つのドラッグアンドドロップイベントにイベントハンドラーをアタッチすると、ハンドラーは基になる 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

次の方法で共有