ドラッグ アンド ドロップ ジェスチャを認識する

.NET Multi-platform App UI (.NET MAUI) ドラッグ アンド ドロップ ジェスチャ認識エンジンを使用すると、項目とそれに関連付けられているデータ パッケージを、連続するジェスチャを使用して、画面上のある位置から別の位置にドラッグできます。 ドラッグ アンド ドロップは 1 つのアプリケーション内で行うことも、あるアプリケーションで開始して別で終了することもできます。

ドラッグ ジェスチャが開始される要素である "ドラッグ ソース" では、データ パッケージ オブジェクトを設定することにより、転送されるデータを提供できます。 ドラッグ ソースが解放されると、ドロップが発生します。 その後、ドラッグ ソースの下にある要素である "ドロップ ターゲット" により、データ パッケージが処理されます。

アプリでドラッグ アンド ドロップを有効にする手順は次のとおりです。

1. DragGestureRecognizer オブジェクトを GestureRecognizers コレクションに追加することによって、要素のドラッグを有効にします。 詳細については、「ドラッグを有効にする」を参照してください。
2. (省略可能) データ パッケージを構築します。 画像コントロールやテキスト コントロールの場合は、.NET MAUI によってデータ パッケージを自動的に入力しますが、他のコンテンツについては、ユーザー独自のデータ パッケージを作成する必要があります。 詳細については、「データ パッケージを作成する」を参照してください。
3. DropGestureRecognizer オブジェクトを GestureRecognizers コレクションに追加することによって、要素のドロップを有効にします。 詳細については、「ドロップを有効にする」を参照してください。
4. (省略可能) DropGestureRecognizer.DragOver イベントを処理することにより、ドロップ ターゲットによって許可される操作の種類を示します。 詳細については、「DragOver イベントを処理する」を参照してください。
5. (省略可能) データ パッケージを処理し、ドロップされたコンテンツを受け取ります。 画像データとテキスト データは .NET MAUI によってデータ パッケージから自動的に取得されますが、他のコンテンツについてはユーザーがデータ パッケージを処理する必要があります。 詳細については、「データ パッケージを処理する」を参照してください。

ドラッグを有効にする

.NET MAUI では、ドラッグ ジェスチャの認識機能は DragGestureRecognizer クラスで提供されます。 このクラスでは、次のプロパティが定義されています。

• CanDrag: bool 型、ジェスチャ認識エンジンがアタッチされている要素をドラッグ ソースにすることができるかどうかを示します。 このプロパティの既定値は true です。
• DragStartingCommand: ICommand型、ドラッグ ジェスチャが最初に認識されたときに実行されます。
• DragStartingCommandParameter: object 型、DragStartingCommand に渡されるパラメーター。
• DropCompletedCommand: ICommand型、ドラッグ ソースがドロップされたときに実行されます。
• DropCompletedCommandParameter: object 型、DropCompletedCommand に渡されるパラメーター。

これらのプロパティは、BindableProperty オブジェクトが基になっています。つまり、これらは、データ バインディングの対象にすることができ、スタイルを設定できます。

DragGestureRecognizer クラスは、CanDrag プロパティが true の場合に発生する DragStarting イベントと DropCompleted イベントも定義します。 DragGestureRecognizer オブジェクトによってドラッグ ジェスチャが検出されると、DragStartingCommand が実行されて、DragStarting イベントが呼び出されます。 その後、DragGestureRecognizer オブジェクトによってドロップ ジェスチャの完了が検出されると、DropCompletedCommand が実行されて、DropCompleted イベントが呼び出されます。

DragStarting イベントに付随する DragStartingEventArgs オブジェクトでは、次のプロパティが定義されています。

• Cancel: bool 型、イベントを取り消す必要があるかどうかを示します。
• Data: DataPackage 型、ドラッグ ソースに付随するデータ パッケージを示します。 これは、読み取り専用プロパティです。
• PlatformArgs: PlatformDragStartingEventArgs? 型、イベントに関連付けられているプラットフォーム固有の引数を表します。

Android

Android では、PlatformDragStartingEventArgs クラスは次のプロパティを定義します。

• Sender (View 型): イベントにアタッチされたネイティブ ビューを表します。
• MotionEvent: MotionEvent 型、ドラッグ アンド ドロップ状態の情報を含むイベントを表します。

さらに、Android では、PlatformDragStartingEventArgs クラスは次のメソッドを定義します。

• SetDragShadowBuilder: ドラッグの開始時に使用する View.DragShadowBuilder を設定します。
• SetClipData: ドラッグの開始時に使用する ClipData を設定します。
• SetLocalData: ドラッグの開始時に使用するローカル データを設定します。
• SetDragFlags: ドラッグの開始時に使用する DragFlags を設定します。

たとえば、ドラッグした項目に ClipData を関連付けるには、SetClipData メソッドを使用します。

void OnDragStarting(object sender, DragStartingEventArgs e)
{
#if ANDROID
    string content = "insert your content here";
    e.PlatformArgs.SetClipData(Android.Content.ClipData.NewPlainText("Drag data", content));
#endif
}

iOS/Mac Catalyst

iOS と Mac Catalyst では、PlatformDragStartingEventArgs クラスは次のプロパティを定義します。

• Sender: UIView 型、イベントにアタッチされたネイティブ ビューを表します。
• GestureRecognizer: UIGestureRecognizer 型、ビューにアタッチされたネイティブ イベントまたはハンドラーを示します。

さらに、iOS と Mac Catalyst では、PlatformDragStartingEventArgs クラスは次のメソッドを定義します。

• SetItemProvider: ドラッグの開始時に使用する NSItemProvider を設定します。
• SetPreviewProvider: ドラッグの開始時に使用する UIDragPreview を設定します。
• SetDragItems: ドラッグの開始時に使用する UIDragItem の配列を設定します。
• SetPrefersFullSizePreview: ドラッグの開始時にドラッグ プレビューがフルサイズになるように要求する Func を設定します。

たとえば、ドラッグ中の項目のプレビューとして使用するオブジェクトを設定するには、SetPreviewProvider メソッドを使用します。

void OnDragStarting(object sender, DragStartingEventArgs e)
{
#if IOS || MACCATALYST
    Func<UIKit.UIDragPreview> action = () =>
    {
        var image = UIKit.UIImage.FromFile("dotnet_bot.png");
        UIKit.UIImageView imageView = new UIKit.UIImageView(image);
        imageView.ContentMode = UIKit.UIViewContentMode.Center;
        imageView.Frame = new CoreGraphics.CGRect(0, 0, 250, 250);
        return new UIKit.UIDragPreview(imageView);
    };

    e.PlatformArgs.SetPreviewProvider(action);
#endif
}

この例では、ドラッグされる項目のプレビューが画像に置き換えられています。

ドラッグ プレビューをフルサイズに設定するには、SetPrefersFullSizePreview メソッドを使用します。

void OnDragStarting(object sender, DragStartingEventArgs e)
{
#if IOS || MACCATALYST
    e.PlatformArgs.SetPrefersFullSizePreviews((interaction, session) => { return true; });
#endif
}

Windows

Windows では、PlatformDragStartingEventArgs クラスは次のプロパティを定義します。

• Sender (FrameworkElement 型): イベントにアタッチされたネイティブ ビューを表します。
• DragStartingEventArgs (DragStartingEventArgs 型): ネイティブ イベントのイベント データを提供します。
• Handled (bool 型): イベント引数が変更されたかどうかを指定します。 DragStartingEventArgs を変更する場合は、このプロパティを true に設定して、変更がオーバーライドされないようにしてください。

DropCompleted イベントに付随する DropCompletedEventArgs オブジェクトには、このイベントに関連付けられているプラットフォーム固有の引数を表す、PlatformDropCompletedEventArgs? 型の PlatformArgs プロパティを定義します。

Android

Android では、PlatformDropCompletedEventArgs クラスは次のプロパティを定義します。

• Sender (View 型): イベントにアタッチされたネイティブ ビューを表します。
• DragEvent (DragEvent 型): ドラッグ アンド ドロップ操作中のさまざまな時点で送信されるイベントを表します。

iOS/Mac Catalyst

iOS と Mac Catalyst では、PlatformDropCompletedEventArgs クラスは次のプロパティを定義します。

• Sender (UIView 型): イベントにアタッチされたネイティブ ビューを表します。
• DragInteraction (UIDragInteraction 型): 項目のドラッグに使用される相互作用を示します。 SessionWillEnd から PlatformDropCompletedEventArgs が呼び出されると、このプロパティが使用されます。
• DragSession (IUIDragSession 型): ドラッグ セッションから関連情報を取得します。 SessionWillEnd から PlatformDropCompletedEventArgs が呼び出されると、このプロパティが使用されます。
• DropOperation (UIDropOperation 型): ドロップに対する応答を表します。 SessionWillEnd から PlatformDropCompletedEventArgs が呼び出されると、このプロパティが使用されます。
• DropInteraction (UIDropInteraction 型): 項目のドロップに使用される相互作用を示します。 PerformDrop から PlatformDropCompletedEventArgs が呼び出されると、このプロパティが使用されます。
• DropSession (IUIDropSession 型): ドロップ セッションから関連情報を取得します。 PerformDrop から PlatformDropCompletedEventArgs が呼び出されると、このプロパティが使用されます。

Windows

Windows では、PlatformDropCompletedEventArgs クラスは次のプロパティを定義します。

• Sender (FrameworkElement 型): イベントにアタッチされたネイティブ ビューを表します。
• DropCompletedEventArgs (DropCompletedEventArgs 型): ネイティブ イベントのイベント データを提供します。

次に示す XAML の例は、Image に関連付けられている DragGestureRecognizer です。

<Image Source="monkeyface.png">
    <Image.GestureRecognizers>
        <DragGestureRecognizer />
    </Image.GestureRecognizers>
</Image>

この例では、Image でドラッグ ジェスチャを開始できます。

ヒント

ドラッグ ジェスチャは、長押しした後にドラッグすると開始されます。

データ パッケージを作成する

次のコントロールの場合、ドラッグを開始すると、.NET MAUI によりデータ パッケージが自動的に作成されます。

• テキスト コントロール。 CheckBox、DatePicker、Editor、Entry、Label、RadioButton、Switch、TimePicker の各オブジェクトから、テキスト値をドラッグできます。
• 画像コントロール。 Button、Image、ImageButton の各コントロールから、画像をドラッグできます。

次の表では、テキスト コントロールでドラッグが開始されたときに読み取られるプロパティと、試みられる変換を示します。

コントロール	プロパティ	変換
CheckBox	IsChecked	bool は string に変換されます。
DatePicker	Date	DateTime は string に変換されます。
Editor	Text
Entry	Text
Label	Text
RadioButton	IsChecked	bool は string に変換されます。
Switch	IsToggled	bool は string に変換されます。
TimePicker	Time	TimeSpan は string に変換されます。

テキストと画像以外のコンテンツの場合は、データ パッケージを自分で作成する必要があります。

データ パッケージは DataPackage クラスによって表され、次のプロパティが定義されています。

• Properties: DataPackagePropertySet型、DataPackage に含まれるデータを構成するプロパティのコレクションです。 このプロパティは、読み取り専用のプロパティです。
• Image: ImageSource 型、DataPackage に含まれる画像です。
• Text: string 型、DataPackage に含まれるテキストです。
• View: DataPackageView 型、DataPackage の読み取り専用バージョンです。

DataPackagePropertySet クラスは、Dictionary<string,object> として格納されるプロパティ バッグを表します。 DataPackageView クラスの詳細については、「データ パッケージを処理する」を参照してください。

画像データまたはテキスト データを格納する

画像データまたはテキスト データをドラッグ ソースと関連付けるには、DataPackage.Image または DataPackage.Text プロパティにデータを格納します。 DragStarting イベントのハンドラーにデータを追加できます。

次の XAML の例では、DragStarting イベントのハンドラーを登録する DragGestureRecognizer を示します。

<Path Stroke="Black"
      StrokeThickness="4">
    <Path.GestureRecognizers>
        <DragGestureRecognizer DragStarting="OnDragStarting" />
    </Path.GestureRecognizers>
    <Path.Data>
        <!-- PathGeometry goes here -->
    </Path.Data>
</Path>

この例では、DragGestureRecognizer が Path オブジェクトにアタッチされます。 Path でドラッグ ジェスチャが検出されると DragStarting イベントが発生し、OnDragStarting イベント ハンドラーが実行されます。

void OnDragStarting(object sender, DragStartingEventArgs e)
{
    e.Data.Text = "My text data goes here";
}

DragStarting イベントに付随する DragStartingEventArgs オブジェクトには、DataPackage 型の Data プロパティがあります。 この例では、DataPackage オブジェクトの Text プロパティが string に設定されます。 その後、ドロップ時に DataPackage にアクセスして、string を取得できます。

プロパティ バッグにデータを格納する

画像やテキストを含むどのようなデータでも、DataPackage.Properties コレクションにデータを格納することにより、ドラッグ ソースと関連付けることができます。 DragStarting イベントのハンドラーにデータを追加できます。

次の XAML の例では、DragStarting イベントのハンドラーを登録する DragGestureRecognizer を示します。

<Rectangle Stroke="Red"
           Fill="DarkBlue"
           StrokeThickness="4"
           HeightRequest="200"
           WidthRequest="200">
    <Rectangle.GestureRecognizers>
        <DragGestureRecognizer DragStarting="OnDragStarting" />
    </Rectangle.GestureRecognizers>
</Rectangle>

この例では、DragGestureRecognizer が Rectangle オブジェクトにアタッチされます。 Rectangle でドラッグ ジェスチャが検出されると DragStarting イベントが発生し、OnDragStarting イベント ハンドラーが実行されます。

void OnDragStarting(object sender, DragStartingEventArgs e)
{
    Shape shape = (sender as Element).Parent as Shape;
    e.Data.Properties.Add("Square", new Square(shape.Width, shape.Height));
}

DragStarting イベントに付随する DragStartingEventArgs オブジェクトには、DataPackage 型の Data プロパティがあります。 Dictionary<string, object> コレクションである DataPackage オブジェクトの Properties コレクションを変更して、任意の必要なデータを格納することができます。 この例では、"Square" キーに対する Rectangle のサイズを表す Square オブジェクトを格納するために、Properties ディクショナリが変更されています。

ドロップを有効にする

.NET MAUI では、ドロップ ジェスチャの認識は DropGestureRecognizer クラスによって提供されます。 このクラスでは、次のプロパティが定義されています。

• AllowDrop: bool 型、ジェスチャ認識エンジンがアタッチされている要素をドロップ ターゲットにすることができるかどうかを示します。 このプロパティの既定値は true です。
• DragOverCommand: ICommand型、ドラッグ ソースがドロップ ターゲット上にドラッグされたときに実行されます。
• DragOverCommandParameter: object 型、DragOverCommand に渡されるパラメーター。
• DragLeaveCommand: ICommand 型、ドラッグ ソースがドロップ ターゲット外にドラッグされたときに実行されます。
• DragLeaveCommandParameter: object 型、DragLeaveCommand に渡されるパラメーター。
• DropCommand: ICommand型、ドラッグ ソースがドロップ ターゲットにドロップされたときに実行されます。
• DropCommandParameter: object 型、DropCommand に渡されるパラメーター。

これらのプロパティは、BindableProperty オブジェクトが基になっています。つまり、これらは、データ バインディングの対象にすることができ、スタイルを設定できます。

また、DropGestureRecognizer クラスには、AllowDrop プロパティが true の場合に発生する DragOver、DragLeave、Drop の各イベントも定義されます。 DropGestureRecognizer によってドロップ ターゲット上でドラッグ ソースが認識されると、DragOverCommand が実行されて、DragOver イベントが呼び出されます。 次に、ドラッグ ソースがドロップ ターゲット外にドラッグされると、DropGestureRecognizer によって DragLeaveCommand が実行され、DragLeave イベントが呼び出されます。 最後に、DropGestureRecognizer によってドロップ ターゲット上でドロップ ジェスチャが認識されると、DropCommand が実行されて、Drop イベントが呼び出されます。

DragOver と DragLeave のイベントに付随する DragEventArgs クラスでは、次のプロパティが定義されています。

• Data (DataPackage 型): ドラッグ ソースに関連付けられたデータが格納されます。 このプロパティは読み取り専用です。
• AcceptedOperation (DataPackageOperation 型): ドロップ ターゲットによって許可されている操作を指定します。
• PlatformArgs (PlatformDragEventArgs? 型): イベントに関連付けられているプラットフォーム固有の引数を表します。

Android

Android では、PlatformDragEventArgs クラスは次のプロパティを定義します。

• Sender (View 型): イベントにアタッチされたネイティブ ビューを表します。
• DragEvent (DragEvent 型): ドラッグ アンド ドロップ操作中のさまざまな時点で送信されるイベントを表します。

iOS/Mac Catalyst

iOS と Mac Catalyst では、PlatformDragEventArgs クラスは次のプロパティを定義します。

• Sender (UIView 型): イベントにアタッチされたネイティブ ビューを表します。
• DropInteraction (UIDropInteraction 型): 項目のドロップに使用される相互作用を示します。
• DropSession (IUIDropSession 型): ドロップ セッションから関連情報を取得します。

さらに、iOS と Mac Catalyst では、PlatformDragEventArgs クラスに SetDropProposal メソッドが定義されています。 このメソッドは、ビュー上で項目をドラッグするときに使用する UIDropProposal を設定します。

void OnDragOver(object sender, DragEventArgs e)
{
#if IOS || MACCATALYST
    e.PlatformArgs.SetDropProposal(new UIKit.UIDropProposal(UIKit.UIDropOperation.Move));
#endif
}

この例では、ドラッグ項目で表されるデータをコピーするのではなく移動することを UIDropOperation で指定しています。

Windows

Windows では、PlatformDragEventArgs クラスに次のプロパティが定義されています。

• Sender (FrameworkElement 型): イベントにアタッチされたネイティブ ビューを表します。
• DragEventArgs (DragEventArgs 型): ネイティブ イベントのイベント データを提供します。
• Handled (bool 型): イベント引数が変更されたかどうかを指定します。 DragEventArgs を変更する場合は、このプロパティを true に設定して、変更がオーバーライドされないようにしてください。

例えば、DragEventArgs プロパティをネイティブ プロパティへのアクセスに使用できます。

void OnDragOver(object sender, DragEventArgs e)
{
#if WINDOWS
    var dragUI = e.PlatformArgs.DragEventArgs.DragUIOverride;
    dragUI.IsCaptionVisible = false;
    dragUI.IsGlyphVisible = false;
#endif
}

この例では、ドラッグ グリフが無効になり、ドラッグ ビジュアルをオーバーレイするキャプション テキストも無効になります。

DataPackageOperation 列挙型の詳細については、「DragOver イベントを処理する」を参照してください。

Drop イベントに付随する DropEventArgs クラスでは、次のプロパティが定義されています。

• Data (DataPackageView 型): データ パッケージの読み取り専用バージョンです。
• Handled (bool 型): イベント ハンドラーでイベントが処理されたか、または .NET MAUI で独自の処理を続行する必要があるかを示します。
• PlatformArgs (PlatformDropEventArgs? 型): イベントに関連付けられているプラットフォーム固有の引数を表します。

Android

Android では、PlatformDropEventArgs クラスは次のプロパティを定義します。

• Sender (View 型): イベントにアタッチされたネイティブ ビューを表します。
• DragEvent (DragEvent 型): ドラッグ アンド ドロップ操作中のさまざまな時点で送信されるイベントを表します。

iOS/Mac Catalyst

iOS と Mac Catalyst では、PlatformDropEventArgs クラスは次のプロパティを定義します。

• Sender (UIView 型): イベントにアタッチされたネイティブ ビューを表します。
• DropInteraction (UIDropInteraction 型): 項目のドロップに使用される相互作用を示します。
• DropSession (IUIDropSession 型): ドロップ セッションから関連情報を取得します。

Windows

Windows では、PlatformDropEventArgs クラスに次のプロパティが定義されています。

• Sender (FrameworkElement 型): イベントにアタッチされたネイティブ ビューを表します。
• DragEventArgs (DragEventArgs 型): ネイティブ イベントのイベント データを提供します。 -->

次に示す XAML の例は、Image に関連付けられている DropGestureRecognizer です。

<Image BackgroundColor="Silver"
       HeightRequest="300"
       WidthRequest="250">
    <Image.GestureRecognizers>
        <DropGestureRecognizer />
    </Image.GestureRecognizers>
</Image>

この例では、ドラッグ ソースが Image ドロップ ターゲットにドロップされると、ドラッグ ソースが ImageSource である場合は、ドラッグ ソースがドロップ ターゲットにコピーされます。 .NET MAUI は、ドラッグされた画像とテキストを互換性のあるドロップ ターゲットに自動的にコピーします。

DragOver イベントを処理する

必要に応じて DropGestureRecognizer.DragOver イベントを処理し、ドロップ ターゲットによって許可されている操作の種類を示すことができます。 DragOver イベントに付随する DragEventArgs オブジェクトに対して DataPackageOperation 型の AcceptedOperation プロパティを設定することで、許容される操作を指定できます。

DataPackageOperation 列挙型には、次のメンバーが定義されています。

• None は、何も実行されないことを示します。
• Copy は、ドラッグ ソースのコンテンツがドロップ ターゲットにコピーされることを示します。

重要

DragEventArgs オブジェクトが作成されるとき、AcceptedOperation プロパティの既定値は DataPackageOperation.Copy に設定されます。

次の XAML の例では、DragOver イベントのハンドラーを登録する DropGestureRecognizer を示します。

<Image BackgroundColor="Silver"
       HeightRequest="300"
       WidthRequest="250">
    <Image.GestureRecognizers>
        <DropGestureRecognizer DragOver="OnDragOver" />
    </Image.GestureRecognizers>
</Image>

この例では、DropGestureRecognizer が Image オブジェクトにアタッチされます。 DragOver イベントは、ドラッグ ソースがドロップ ターゲットの上にドラッグされ、まだドロップされていない場合に発生し、OnDragOver イベント ハンドラーが実行されます。

void OnDragOver(object sender, DragEventArgs e)
{
    e.AcceptedOperation = DataPackageOperation.None;
}

この例では、DragEventArgs オブジェクトの AcceptedOperation プロパティが DataPackageOperation.None に設定されます。 この値により、ドラッグ ソースがドロップ ターゲット上にドロップされても、アクションが実行されなくなります。

データ パッケージを処理する

Drop イベントは、ドロップ ターゲットの上でドラッグ ソースがリリースされた場合に発生します。 ドラッグ ソースが次のコントロールにドロップされると、.NET MAUI はデータ パッケージからのデータの取得を自動的に試行します。

• テキスト コントロール。 CheckBox、DatePicker、Editor、Entry、Label、RadioButton、Switch、TimePicker の各オブジェクトに、テキスト値をドロップできます。
• 画像コントロール。 Button、Image、ImageButton の各コントロールに、画像をドロップできます。

次の表では、テキスト コントロールにテキスト ベースのドラッグ ソースがドロップされた場合に設定されるプロパティやどのような変換が試行されるかを示します。

コントロール	プロパティ	変換
CheckBox	IsChecked	string は bool に変換されます。
DatePicker	Date	string は DateTime に変換されます。
Editor	Text
Entry	Text
Label	Text
RadioButton	IsChecked	string は bool に変換されます。
Switch	IsToggled	string は bool に変換されます。
TimePicker	Time	string は TimeSpan に変換されます。

テキストと画像以外のコンテンツの場合は、データ パッケージを自分で処理する必要があります。

Drop イベントに付随する DropEventArgs クラスでは、DataPackageView 型の Data プロパティが定義されています。 このプロパティは、データ パッケージの読み取り専用バージョンを表します。

画像データまたはテキスト データを取得する

DataPackageView クラスで定義されているメソッドを使用して、Drop イベントのハンドラー内でデータ パッケージから画像データまたはテキスト データを取得できます。

DataPackageView クラスには、GetImageAsync メソッドと GetTextAsync メソッドが含まれています。 GetImageAsync メソッドは、DataPackage.Image プロパティに格納されたデータ パッケージから画像を取得し、Task<ImageSource> を返します。 同様に、GetTextAsync メソッドは、DataPackage.Text プロパティに格納されたデータ パッケージからテキストを取得し、Task<string> を返します。

次の例では、Path に対するデータ パッケージからテキストを取得する Drop イベント ハンドラーが示されています。

async void OnDrop(object sender, DropEventArgs e)
{
    string text = await e.Data.GetTextAsync();

    // Perform logic to take action based on the text value.
}

この例では、GetTextAsync メソッドを使用してデータ パッケージからテキスト データが取得されます。 その後、テキスト値に基づくアクションを実行できます。

プロパティ バッグからデータを取得する

データ パッケージの Properties コレクションにアクセスすることにより、Drop イベントのハンドラー内でデータ パッケージから任意のデータを取得できます。

DataPackageView クラスでは、DataPackagePropertySetView 型の Properties プロパティが定義されています。 DataPackagePropertySetView クラスは、Dictionary<string, object> として格納される読み取り専用のプロパティ バッグを表します。

次の例では、Rectangle に対するデータ パッケージのプロパティ バッグからデータを取得する Drop イベント ハンドラーが示されています。

void OnDrop(object sender, DropEventArgs e)
{
    Square square = (Square)e.Data.Properties["Square"];

    // Perform logic to take action based on retrieved value.
}

この例では、"Square" ディクショナリ キーを指定することにより、データ パッケージのプロパティ バッグから Square オブジェクトを取得します。 その後、取得された値に基づくアクションを実行できます。

アプリケーション間のドラッグ アンド ドロップ

iOS、Mac Catalyst、および Windows では、.NET MAUI アプリケーションで終わる対応するドロップ操作を使用して、1 つのアプリケーションでドラッグを開始できます。 項目のドラッグ元となるアプリは source アプリケーションであり、項目がドロップされる .NET MAUI アプリは destination アプリケーションです。

Android

source アプリケーションから Android 上の .NET MAUI destination アプリケーションにドラッグすることはできません。

iOS/Mac Catalyst

iPhone では、サポートされているアプリケーション (ファイルや写真など) から項目をドラッグし、その項目をアプリケーションのドロップ 先にドラッグする必要があります。 iPad では、分割ビューのアプリを使用して、アプリケーション間で項目をドラッグできます。

次の例は、source アプリケーションから .NET MAUI destination アプリケーションにドラッグされた項目を処理するDropGestureRecognizer.Drop イベントのイベント ハンドラーを示しています。

#if IOS || MACCATALYST
using UIKit;
using Foundation;
#endif

async void OnDropGestureRecognizerDrop(object? sender, DropEventArgs e)
{
    var filePaths = new List<string>();

#if IOS || MACCATALYST
    var session = e.PlatformArgs?.DropSession;
    if (session == null)
        return;

    foreach (UIDragItem item in session.Items)
    {
        var result = await LoadItemAsync(item.ItemProvider, item.ItemProvider.RegisteredTypeIdentifiers.ToList());
        if (result is not null)
            filePaths.Add(result.FileUrl?.Path!);
    }
    foreach (var item in filePaths)
    {
        Debug.WriteLine($"Path: {item}");
    }

    static async Task<LoadInPlaceResult?> LoadItemAsync(NSItemProvider itemProvider, List<string> typeIdentifiers)
    {
        if (typeIdentifiers is null || typeIdentifiers.Count == 0)
            return null;

        var typeIdent = typeIdentifiers.First();

        if (itemProvider.HasItemConformingTo(typeIdent))
            return await itemProvider.LoadInPlaceFileRepresentationAsync(typeIdent);

        typeIdentifiers.Remove(typeIdent);
        return await LoadItemAsync(itemProvider, typeIdentifiers);
    }
#endif

    string filePath = filePaths.FirstOrDefault();

    // Process the dropped file
}

Windows

次の例は、source アプリケーションから destination アプリケーションにドラッグされた項目を処理するDropGestureRecognizer.Drop イベントのイベント ハンドラーを示しています。

#if WINDOWS
using Windows.ApplicationModel.DataTransfer;
using Windows.Storage;
#endif

async void OnDropGestureRecognizerDrop(object? sender, DropEventArgs e)
{
    var filePaths = new List<string>();

#if WINDOWS
    if (e.PlatformArgs is not null && e.PlatformArgs.DragEventArgs.DataView.Contains(StandardDataFormats.StorageItems))
    {
        var items = await e.PlatformArgs.DragEventArgs.DataView.GetStorageItemsAsync();
        if (items.Any())
        {
            foreach (var item in items)
            {
                if (item is StorageFile file)
                    filePaths.Add(item.Path);
            }
        }
    }
#endif

    string filePath = filePaths.FirstOrDefault();

    // Process the dropped file
}

ジェスチャの位置を取得する

ドラッグ アンド ドロップ ジェスチャが発生した位置は、GetPosition メソッドを、DragEventArgs、DragStartingEventArgs、DropEventArgs オブジェクトで呼び出すことによって取得できます。 GetPosition メソッドは Element? 引数を受け取り、Point? オブジェクトとして位置を返します。

void OnDragStarting(object sender, DragStartingEventArgs e)
{
    // Position relative to screen
    Point? screenPosition = e.GetPosition(null);

    // Position relative to specified element
    Point? relativeToImagePosition = e.GetPosition(image);
}

Element? 引数は、位置を取得する必要がある要素を定義します。 この引数として null 値を指定すると、GetPosition メソッドは画面に対するドラッグ または ドロップ ジェスチャの位置を定義する Point? オブジェクトを返します。