DragEventArgs クラス

  • リファレンス

定義

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

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

public ref class DragEventArgs sealed : RoutedEventArgs
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 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(Windows.Foundation.UniversalApiContract), 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

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

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

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

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

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

バージョン履歴

Windows のバージョン SDK バージョン 追加された値
1607 14393 AllowedOperations

プロパティ

AcceptedOperation

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

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

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

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

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

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

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

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

(継承元 RoutedEventArgs)

メソッド

GetDeferral()

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

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

適用対象

こちらもご覧ください