DragEventArgs クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ドラッグ アンド ドロップ イベントのデータを提供します。
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 : RoutedEventArgsPublic NotInheritable Class DragEventArgs
Inherits RoutedEventArgs- 継承
- 属性
注釈
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 を基準としたドロップ ポイントを返します。 |