Language

DragEventArgs クラス

定義

名前空間:
Microsoft.UI.Xaml
編集

ドラッグ アンド ドロップ イベントのデータを提供します。

public ref class DragEventArgs sealed : RoutedEventArgs
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DragEventArgs final : RoutedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DragEventArgs : RoutedEventArgs
Public NotInheritable Class DragEventArgs
Inherits RoutedEventArgs
継承
Object Platform::Object IInspectable RoutedEventArgs DragEventArgs
属性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

注釈

DragEventArgs は、次のイベントのイベント データとして使用されます。

これらのイベントはルーティング イベントです。 イベント ハンドラーから DragEventArgs の Handled プロパティの値を変更すると、ルーティング イベントの動作に影響する可能性があります。 ルーティング イベントの概念の詳細については、「 イベントとルーティング イベントの概要」を参照してください。

Control クラスには、ドラッグ ドロップ イベントのクラス ベースの処理を提供するためにコントロール派生型がオーバーライドできる事前ワイヤード イベント ハンドラーがあり、これらのメソッドはパラメーターとしてDragEventArgsも使用します。 これらのメソッドは次のとおりです。

ドラッグ アンド ドロップの概念のWindows ランタイム実装では、特定のコントロールと入力アクションのみがドラッグ ドロップ アクションを開始できます。 UI 要素がドラッグ ドロップ アクションを開始できるようにする一般化された DoDragDrop メソッドはありません。 ドラッグ ドロップ アクションの主なソースは、 GridView などのリストの項目をドラッグする場合です。 リスト アイテムのドラッグ アンド ドロップ アクションの場合、イベント データの データ 値は、アイテムに関するコントロール定義の既定のデータから変更される可能性があります。 これを行うには、DragItemsStarting イベントを処理し、イベント データの DragItemsStartingEventArgs.Data プロパティから取得した DataPackage オブジェクトを操作します。

プロパティ

名前 説明
AcceptedOperation

ドラッグ イベントのターゲットが受け入れることができる操作 (なし、移動、コピー、リンク) を指定する値を取得または設定します。
AllowedOperations

ドラッグ イベントのソースで許可される操作 (なし、移動、コピー、リンク) を指定する値を取得します。
Data

対応するドラッグ イベントに関連付けられたデータを含むデータ オブジェクト (DataPackage) を取得または設定します。 この値は、すべてのイベント ケースで役に立つわけではありません。具体的には、イベントは有効なドロップ ターゲットによって処理される必要があります。
DataView

Data オブジェクトの読み取り専用コピーを取得します。
DragUIOverride

ドラッグされるデータの視覚的表現を取得します。
Handled

ルーティング イベントがルートを移動する際のイベント処理の現在の状態を示す値を取得または設定します。
Modifiers

Shift キー、Ctrl キー、Alt キーの現在の状態、およびマウス ボタンの状態を示すフラグ列挙体を取得します。
OriginalSource

イベントを発生させたオブジェクトへの参照を取得します。 これは、多くの場合、アプリ UI で宣言された要素ではなく、コントロールのテンプレート部分です。

(継承元 RoutedEventArgs)

メソッド

名前 説明
GetDeferral()

DragOperationDeferral オブジェクトを作成して返すことで、非同期のドラッグ アンド ドロップ操作をサポートします。
GetPosition(UIElement)

指定した UIElement を基準とするドロップ ポイントを返します。

適用対象

こちらもご覧ください