Comment partager du texte
Langage: HTML | XAML

Comment partager du texte (XAML)

[ Cet article est destiné aux développeurs de Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]

Le partage de texte est l’une des méthodes les plus simples et les plus courantes pour partager du contenu. Outre son utilisation pour les messages de texte brut, tels que les mises à jour d’état, nous recommandons que votre application prenne aussi en charge le partage de texte :

  • lorsque vous voulez rendre le contenu accessible à un grand nombre d’applications cibles ;
  • en tant que deuxième source lors du partage de liens ou de contenu HTML.

Ce que vous devez savoir

Technologies

Prérequis

  • Vous devez être familiarisé avec Visual Studio et ses modèles.
  • Vous devez être familiarisé avec le développement en C#/C++.

Instructions

Étape 1: Ajout de l’espace de noms DataTransfer

Vous devez ajouter les espaces de noms appropriés à votre application afin de pouvoir créer et traiter les objets associés au partage. Vous devez ajouter au minimum l’espace de noms Windows.ApplicationModel.DataTransfer :


using Windows.ApplicationModel.DataTransfer;


Cet espace de noms comporte tous les éléments nécessaires pour le partage de base. Gardez cependant à l’esprit que, si vous voulez partager un contenu tel que des images ou fichiers, vous devez également ajouter ces espaces de noms. Voici une liste des espaces de noms dont vous pouvez avoir besoin :

Étape 2: Obtenir l’objet DataTransferManager

L’objet DataTransferManager est le point de départ de toute opération de partage.


DataTransferManager dataTransferManager = DataTransferManager.GetForCurrentView();


Étape 3: ajouter un gestionnaire d’événements pour l’événement DataRequested

Ajoutez un gestionnaire d’événements DataRequested qui se déclenche quand l’utilisateur souhaite appeler le partage. Dans une application du Windows Store, cela se produit automatiquement quand l’utilisateur appelle l’icône Partager. Si vous développez une application pour Windows Phone, aucune icône Partager n’est intégrée, donc vous devez ajouter un contrôle sur lequel l’utilisateur peut appuyer pour déclencher le gestionnaire.


dataTransferManager.DataRequested += new TypedEventHandler<DataTransferManager, 
    DataRequestedEventArgs>(this.ShareTextHandler);

Étape 4: obtenir un objet DataRequest

Lorsqu’un événement DataRequested survient, votre application reçoit un objet DataRequest. Cet objet contient une classe DataPackage que vous pouvez utiliser pour fournir le contenu qu’un utilisateur souhaite partager.


DataRequest request = e.Request;


Étape 5: Définir les propriétés de titre et de description

La propriété title est obligatoire et doit être définie.



// The title is mandatory
request.Data.Properties.Title = "Share Text Example";
request.Data.Properties.Description = "A demonstration that shows how to share text.";

Étape 6: Ajouter le texte à l’objet DataPackage

Pour ajouter le texte, utilisez la méthode setText.


request.Data.SetText("Hello World!");


Remarques

Pour télécharger le code qui illustre le partage de texte, voir l’exemple de notre bibliothèque de code.

Terminer l’exemple


private void RegisterForShare()
{
    DataTransferManager dataTransferManager = DataTransferManager.GetForCurrentView();
    dataTransferManager.DataRequested += new TypedEventHandler<DataTransferManager, 
        DataRequestedEventArgs>(this.ShareTextHandler);
}

private void ShareTextHandler(DataTransferManager sender, DataRequestedEventArgs e)
{
    DataRequest request = e.Request;
    request.Data.Properties.Title = "Share Text Example";
    request.Data.Properties.Description = "A demonstration that shows how to share text.";
    request.Data.SetText("Hello World!");
}

Rubriques associées

Exemple de partage de contenu source entre applications
Partage et échange de données
Comment partager des fichiers
Comment partager du contenu HTML
Comment partager un lien
Démarrage rapide : partage de contenu
DataPackage
Windows.ApplicationModel.DataTransfer
Windows.ApplicationModel.DataTransfer.Share

 

 

Afficher:
© 2017 Microsoft