DataPackage.RequestedOperation Propriété

Définition

Espace de noms:

Windows.ApplicationModel.DataTransfer

Spécifie le DataPackageOperation (aucun, déplacement, copie ou lien) pour l’opération.

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

Valeur de propriété

DataPackageOperation

Opération demandée par l’application source.

Exemples

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

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

Remarques

Cette propriété spécifie l’opération que le consommateur d’un package de données doit effectuer dans le Presse-papiers ou les scénarios de glisser-déplacer. Les options prises en charge sont spécifiées dans l’énumération DataPackageOperation .

Lors de l’implémentation de la fonctionnalité du Presse-papiers, DataPackageOperation.Move correspond à la commande « Couper » et à la commande DataPackageOperation.Copy to « Copy ». Il est de la responsabilité de l’opération de respecter cette valeur et de signaler qu’elle a effectué une coupure ou une copie en appelant DataPackageView.ReportOperationComplete avec la valeur appropriée.

Dans les scénarios de glisser-déplacer, CoreDragOperation.AllowedOperations doit spécifier l’ensemble complet des opérations autorisées par la source, et DataPackage.RequestedOperation doit spécifier la valeur par défaut souhaitée de la source. Les utilisateurs peuvent remplacer ces choix à l’aide des touches Maj et Ctrl . Les applications cibles doivent inspecter l’état de la clé pour déterminer l’opération sélectionnée par l’utilisateur.

Notes

CoreDragOperation.AllowedOperations n’est pas pris en charge en XAML. Pour spécifier plusieurs opérations autorisées en XAML, passez plusieurs indicateurs à la propriété DataPackage.RequestedOperation à la place. Dans ce cas, vous ne devez pas définir CoreDragOperation.AllowedOperations ailleurs. Cela lève une exception et réinitialise les indicateurs spécifiés de DataPackage.RequestedOperation à un.

Normalement, la propriété DataPackage.RequestedOperation ne doit spécifier qu’une seule opération. Toutefois, dans certains scénarios d’interopérabilité (comme la copie entre une application plateforme Windows universelle (UWP) et Explorateur de fichiers), il peut en contenir davantage. Dans ce cas, l’application cible doit sélectionner la meilleure opération (en supposant que les modificateurs de clavier n’ont pas remplacé ce choix).

Vous n’avez pas besoin de cette propriété pour les opérations de partage.

Voir aussi

• DataPackageOperation