次の方法で共有


DragEventArgs クラス

定義

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

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
属性

注釈

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

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

Control クラスには、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 を基準としたドロップ ポイントを返します。

適用対象

こちらもご覧ください