DataPackage.RequestedOperation プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
操作の 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プロパティ値
ソース アプリによって要求された操作。
例
// 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) アプリとエクスプローラー間のコピーなど) では、さらに多くを含めることができます。 この場合、ターゲット アプリは最適な操作を選択する必要があります (キーボード修飾子がその選択をオーバーライドしていないと仮定)。
共有操作には、このプロパティは必要ありません。