Comment créer un objet QuickLink (HTML)

Article
12/11/2015

[ 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 ]

Les utilisateurs souhaitent pouvoir partager du contenu avec leurs amis et leur famille aussi simplement qu’ils effectuent d’autres tâches sur leur ordinateur. Les applications conçues autour de ce concept présentent un environnement adapté qui permet aux utilisateurs de partager du contenu rapidement et facilement. En prenant en charge le contrat de partage cible, vous pouvez rendre l’expérience de partage encore plus simple à l’aide d’un raccourci personnalisé appelé QuickLink. Un objet QuickLink définit un lien vers votre application qui est personnalisé pour un ensemble donné d’actions utilisateur.

Lorsque les utilisateurs partagent des contenus, ils veulent en général pourvoir choisir comment et avec qui partager leurs contenus. Le partage par courrier électronique est un exemple caractéristique. Pour partager des informations par courrier électronique, les utilisateurs doivent indiquer les adresses de messagerie des contacts avec lesquels ils souhaitent les partager. Même si l’utilisateur peut n’être pas gêné de fournir les adresses de messagerie la première fois, les ajouter manuellement à chaque nouvelle session est souvent fastidieux. Pour améliorer l’expérience utilisateur de l’application de messagerie, vous pouvez créer un objet QuickLink qui applique la fois suivante les dernières sélections que l’utilisateur a effectuées.

Un objet QuickLink ne stocke pas de données. Cet objet contient à la place un identificateur qui, lorsqu’il est sélectionné, est envoyé à votre application. Pour que les liens rapides fonctionnent, votre application doit stocker les données avec l’identificateur associé au même endroit (par exemple, dans le cloud ou sur l’ordinateur de l’utilisateur). Il existe de nombreuses façons de stocker les données. Pour obtenir un exemple de stockage des données, voir Gestion des données d’application.

Pour en savoir plus sur la prise en charge du contrat de partage cible, voir Démarrage rapide : réception de contenu partagé. Cette rubrique décrit les étapes de base que votre application doit exécuter lorsque les utilisateurs la sélectionnent pour partager du contenu.

Ce que vous devez savoir

Technologies

Prérequis

Vous devez être familiarisé avec Microsoft Visual Studio et ses modèles connexes.
Vous devez être familiarisé avec JavaScript.
Vous devez savoir comment recevoir du contenu partagé, tel que décrit dans Démarrage rapide : réception de contenu partagé.

Instructions

Étape 1: Créer un objet QuickLink

L’objet QuickLink fait partie de la classe ShareOperation.

var quickLink = new Windows.ApplicationModel.DataTransfer.ShareTarget.QuickLink();

Étape 2: Ajouter un identificateur à l’objet QuickLink

Lorsque vous disposez d’une instance de l’objet QuickLink, vous devez d’abord le configurer avec une chaîne d’identificateur cible que le système peut renvoyer à votre application lorsque l’utilisateur sélectionne le QuickLink. L’exemple suivant montre comment configurer un ID cible.

quickLink.id = "123456789";

Étape 3: Ajouter un titre à l’objet QuickLink

Spécifiez ensuite un titre pour l’objet QuickLink. Un titre aide l’utilisateur à identifier l’objet QuickLink et son rôle.

quickLink.title = document.getElementById("quickLinkTitle").value;

// For quicklinks, the supported FileTypes and DataFormats are set 
// independently from the manifest.
var dataFormats = Windows.ApplicationModel.DataTransfer.StandardDataFormats;
quickLink.supportedFileTypes.replaceAll(["*"]);
quickLink.supportedDataFormats.replaceAll([dataFormats.text, dataFormats.uri, 
    dataFormats.bitmap, dataFormats.storageItems, dataFormats.html, customFormatName]);

Windows.ApplicationModel.Package.current.installedLocation.getFileAsync("images\\user.png").then(function (iconFile) {
    quickLink.thumbnail = Windows.Storage.Streams.RandomAccessStreamReference.createFromFile(iconFile);
});

Étape 4: Spécifier les types de fichiers pris en charge

Vous devez ensuite spécifier les types de fichiers et les formats de données qui sont pris en charge par l’objet QuickLink. Le système montre l’objet QuickLink uniquement lorsque le DataPackage partagé depuis l’application source de partage contient un de ces types de fichiers ou formats de données.

var dataFormats = Windows.ApplicationModel.DataTransfer.StandardDataFormats;
quickLink.supportedFileTypes.replaceAll(["*"]);
quickLink.supportedDataFormats.replaceAll([dataFormats.text, dataFormats.uri, 
    dataFormats.bitmap, dataFormats.storageItems, dataFormats.html, customFormatName]);

Étape 5: Ajouter une miniature à l’objet QuickLink.

Nous vous recommandons d’utiliser la même icône que celle que les utilisateurs verraient en sélectionnant votre application par un autre biais que l’objet QuickLink. De cette façon, l’utilisateur sait que le lien est associé à votre application.

Windows.ApplicationModel.Package.current.installedLocation.getFileAsync("images\\user.png").then(function (iconFile) {
    quickLink.thumbnail = Windows.Storage.Streams.RandomAccessStreamReference.createFromFile(iconFile);
});

Étape 6: Envoyer l’objet QuickLink au système

Lorsque vous avez terminé de créer l’objet QuickLink, vous pouvez l’envoyer au système en appelant la méthode ShareOperation.reportCompleted.

shareOperation.reportCompleted(quickLink);

Terminer l’exemple

La fonction suivante crée et renvoie un objet QuickLink. Appelez cette fonction à la fin de l’opération de partage dans votre application au lieu d’appeler directement la méthode ShareOperation.reportCompleted.

function reportCompleted() {
    var quickLink = new Windows.ApplicationModel.DataTransfer.ShareTarget.QuickLink();
    quickLink.id = "123456789";
    quickLink.title = document.getElementById("quickLinkTitle").value;
    
    // For quicklinks, the supported FileTypes and DataFormats are set 
    // independently from the manifest.
    var dataFormats = Windows.ApplicationModel.DataTransfer.StandardDataFormats;
    quickLink.supportedFileTypes.replaceAll(["*"]);
    quickLink.supportedDataFormats.replaceAll([dataFormats.text, dataFormats.uri, 
        dataFormats.bitmap, dataFormats.storageItems, dataFormats.html, customFormatName]);

    Windows.ApplicationModel.Package.current.installedLocation.getFileAsync("images\\user.png").then(function (iconFile) {
        quickLink.thumbnail = Windows.Storage.Streams.RandomAccessStreamReference.createFromFile(iconFile);
        shareOperation.reportCompleted(quickLink);
    });
}