DataPackage.RequestedOperation プロパティ

  • リファレンス

定義

名前空間:
Windows.ApplicationModel.DataTransfer
編集

操作の DataPackageOperation (なし、移動、コピー、またはリンク) を指定します。

public:
 property DataPackageOperation RequestedOperation { DataPackageOperation get(); void set(DataPackageOperation value); };
DataPackageOperation RequestedOperation();

void RequestedOperation(DataPackageOperation value);
public DataPackageOperation RequestedOperation { get; set; }
var dataPackageOperation = dataPackage.requestedOperation;
dataPackage.requestedOperation = dataPackageOperation;
Public Property RequestedOperation As DataPackageOperation

プロパティ値

DataPackageOperation

ソース アプリによって要求された操作。

例

// Request a copy operation 
datapackage.RequestedOperation = DataPackageOperation.Copy;

// find what the requested operation is
DataPackageOperation operation = dataPackageView.RequestedOperation;

注釈

このプロパティは、データ パッケージのコンシューマーがクリップボードまたはドラッグ アンド ドロップのシナリオで実行する操作を指定します。 サポートされているオプションは、 DataPackageOperation 列挙で指定されます。

クリップボード機能を実装する場合、 DataPackageOperation.Move は "Cut" コマンドと DataPackageOperation.Copy to "Copy" コマンドに対応します。 この値を尊重し、適切な値を指定して DataPackageView.ReportOperationComplete を呼び出して切り取りまたはコピーを実行したことを報告するのは、操作の責任のターゲットです。

ドラッグ アンド ドロップのシナリオでは、 CoreDragOperation.AllowedOperations はソースで許可される操作の完全なセットを指定し、DataPackage.RequestedOperation はソースの目的の既定値を指定する必要があります。 ユーザーは、 Shift キーと Ctrl キーを使用して、この選択肢をオーバーライドできます。 ターゲット アプリでは、キーの状態を調べて、ユーザーが選択した操作を確認する必要があります。

注意

CoreDragOperation.AllowedOperations は XAML ではサポートされていません。 XAML で複数の許可される操作を指定するには、代わりに DataPackage.RequestedOperation プロパティに複数のフラグを渡します。 その場合は、 CoreDragOperation.AllowedOperations を他の 場所に設定しないでください。 これにより、例外がスローされ、DataPackage.RequestedOperation の指定されたフラグが 1 にリセットされます。

通常、DataPackage.RequestedOperation プロパティでは、1 つの操作のみを指定する必要があります。 ただし、一部の相互運用シナリオ (ユニバーサル Windows プラットフォーム (UWP) アプリとエクスプローラー間のコピーなど) では、さらに多くを含めることができます。 この場合、ターゲット アプリは最適な操作を選択する必要があります (キーボード修飾子がその選択をオーバーライドしていないと仮定)。

共有操作には、このプロパティは必要ありません。

適用対象

こちらもご覧ください