Copier et coller

  • Article

Cet article explique comment prendre en charge le copier-coller dans les applications UWP en utilisant le 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 illustrant plusieurs scénarios de copie et de collage différents, consultez l’exemple de Presse-papiers.

Rechercher la prise en charge intégrée du Presse-papiers

Le plus souvent, vous n’avez pas besoin d’écrire de code supplémentaire pour fournir une prise en charge des opérations du Presse-papiers. De nombreux contrôles XAML par défaut disponibles pour créer les applications offrent déjà une prise en charge des 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 ainsi que les propriétés (telles qu’une description) que vous voulez ajouter.

DataPackage dataPackage = new DataPackage();

Copier et Couper

Copier et Couper (également appelé déplacement) fonctionne presque exactement de la même manière. 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é

Vous pouvez ensuite ajouter les données sélectionnées par l’utilisateur dans 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 le 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 statique GetContent. Cette méthode renvoie un objet DataPackageView avec son contenu. Cet objet est identique à l’objet DataPackage, sauf qu’il est en lecture seule. Avec cet objet, vous pouvez utiliser la propriété AvailableFormats ou la méthode Contains pour identifier les formats disponibles. Ensuite, appelez 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;
    }
}

Suivi des modifications dans le Presse-papiers

En plus des commandes copier et coller, vous pouvez également effectuer le suivi des modifications dans le 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;
    }
}

Voir aussi