Copier et coller
Cet article explique comment prendre en charge la copie et le collage dans des applications plateforme Windows universelle (UWP) à l’aide du Presse-papiers. Le copier-coller est la méthode classique utiliser pour échanger des données entre les applications, ou dans une application, et presque chaque application peut prendre en charge les opérations du Presse-papiers dans une certaine mesure. Pour obtenir des exemples de code complets qui illustrent plusieurs scénarios de copie et de collage différents, consultez l’exemple de Presse-papiers.
Vérifier la prise en charge intégrée du Presse-papiers
Dans de nombreux cas, vous n’avez pas besoin d’écrire du code pour prendre en charge les opérations du Presse-papiers. La plupart des contrôles XAML par défaut que vous pouvez utiliser pour créer des applications prennent déjà en charge les opérations du Presse-papiers.
Se préparer
Tout d’abord, incluez l’espace de noms Windows.ApplicationModel.DataTransfer dans votre application. Ensuite, ajoutez une instance de l’objet DataPackage . Cet objet contient les données que l’utilisateur souhaite copier et toutes les propriétés (telles qu’une description) que vous souhaitez inclure.
DataPackage dataPackage = new DataPackage();
Copier et couper
Copier et couper (également appelé déplacement) fonctionnent presque exactement de la même façon. Choisissez l’opération souhaitée à l’aide de la propriété RequestedOperation.
// copy
dataPackage.RequestedOperation = DataPackageOperation.Copy;
// or cut
dataPackage.RequestedOperation = DataPackageOperation.Move;
Définir le contenu copié
Ensuite, vous pouvez ajouter les données qu’un utilisateur a sélectionnées à l’objet DataPackage . Si ces données sont prises en charge par la classe DataPackage, vous pouvez utiliser l’une des méthodes correspondantes de l’objet DataPackage. Voici comment ajouter du texte à l’aide de la méthode SetText :
dataPackage.SetText("Hello World!");
La dernière étape consiste à ajouter dataPackage au Presse-papiers en appelant la méthode SetContent statique.
Clipboard.SetContent(dataPackage);
Coller
Pour obtenir le contenu du Presse-papiers, appelez la méthode GetContent statique. Cette méthode retourne un DataPackageView qui contient le contenu. Cet objet est presque identique à un objet DataPackage , sauf que son contenu est en lecture seule. Avec cet objet, vous pouvez utiliser la méthode AvailableFormats ou Contains pour identifier les formats disponibles. Ensuite, vous pouvez appeler la méthode DataPackageView correspondante pour obtenir les données.
async void OutputClipboardText()
{
DataPackageView dataPackageView = Clipboard.GetContent();
if (dataPackageView.Contains(StandardDataFormats.Text))
{
string text = await dataPackageView.GetTextAsync();
// To output the text from this example, you need a TextBlock control
TextOutput.Text = "Clipboard now contains: " + text;
}
}
Suivre les modifications apportées au Presse-papiers
Outre les commandes copier-coller, vous pouvez également suivre les modifications du Presse-papiers. Pour ce faire, gérez l’événement ContentChanged du Presse-papiers.
Clipboard.ContentChanged += async (s, e) =>
{
DataPackageView dataPackageView = Clipboard.GetContent();
if (dataPackageView.Contains(StandardDataFormats.Text))
{
string text = await dataPackageView.GetTextAsync();
// To output the text from this example, you need a TextBlock control
TextOutput.Text = "Clipboard now contains: " + text;
}
}