Langage: HTML | XAML

Comment partager du texte (HTML)

Applies to Windows and Windows Phone

Le partage de texte est l’une des méthodes les plus simples et les plus courantes pour partager du contenu. Nous recommandons que votre application prenne en charge le partage du texte :

  • lorsque vous voulez rendre le contenu accessible par 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 connexes.
  • Vous devez être familiarisé avec JavaScript.

Instructions

Étape 1: Configurer votre application en tant que source de partage

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.


var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();
dataTransferManager.addEventListener("datarequested", shareTextHandler);

Les étapes restantes servent à implémenter la fonction shareTextHandler.

Étape 2: 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.


var request = e.request;


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


request.data.properties.title = "Share Text Example";
request.data.properties.description = "Demonstrates how to share.";

Étape 4: ajouter le texte à l’objet DataPackage

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


request.data.setText("Hello World!");


Exemple complet

Voici un exemple d’une fonction qui définit le texte qu’un utilisateur souhaite partager. Pour obtenir un exemple plus complet, voir l’exemple de notre bibliothèque de code.


function shareTextHandler(e) {
    var request = e.request;
    request.data.properties.title = "Share Text Example";
    request.data.properties.description = "Demonstrates how to share.";
    request.data.setText("Hello World!");
}

app.onactivated = function (args) {
    if (args.detail.kind === activation.ActivationKind.launch) {
        if (args.detail.previousExecutionState !== activation.ApplicationExecutionState.terminated) {
            // This app is newly launched. Register the app as share source.
            var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();
            dataTransferManager.addEventListener("datarequested", shareTextHandler);
        } else {
            // TODO: This app was reactivated from suspension.
            // Restore the app state here.
        }
        args.setPromise(WinJS.UI.processAll());
    }
};

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:
© 2014 Microsoft