Partage et réception de contenu (HTML)

[ 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 découvrent souvent des informations qu’ils ont hâte de partager avec quelqu’un ou d’utiliser dans une autre application. Le partage est une fonctionnalité contextuelle légère que vous pouvez ajouter facilement à votre application.

Une application peut prendre en charge la fonctionnalité de partage de deux manières. En premier lieu, il peut s’agir d’une application source qui fournit le contenu que l’utilisateur veut partager. En second lieu, l’application peut être une application cible que l’utilisateur sélectionne en tant que destination du contenu partagé. Notez qu’une application peut à la fois être une application source ou une application cible. Si vous voulez que votre application partage du contenu en tant qu’application source, vous devez déterminer quels formats données votre application peut fournir. Nous vous recommandons d’essayer de prendre en charge autant de formats de données que possible, mais en fin de compte il est préférable de choisir ceux qui sont les plus significatifs pour votre application. Une fois que vous avez pris cette décision, utilisez les classes de l’espace de noms Windows.ApplicationModel.DataTransfer pour empaqueter les données.

Si vous voulez que votre application reçoive du contenu partagé en tant qu’application cible, vous devez d’abord configurer le fichier manifeste de l’application pour indiquer qu’elle prend en charge le contrat de partage.

Remarque  

Les utilisateurs peuvent partager du contenu dans votre application en un seul mouvement de balayage, à partir de l’icône Partager. Un utilisateur peut partager un fichier ou une URL de votre application avec un autre appareil via la commande Toucher et envoyer à partir de l’icône Périphériques.

Remarque  

Comme la barre Icônes n’existe pas sur Windows Phone 8.1, les options de partage doivent être incluses par programmation par le développeur dans une barre d’application ou tout autre contrôle.

Ce contrat de partage permet à votre application d’être présentée en tant qu’option quand l’utilisateur appelle l’option Partager dans les situations où des formats de données pris en charge sont partagés. Quand vous choisissez des formats de données devant être pris en charge par votre application cible, n’inscrivez que les formats que votre application peut effectivement prendre en charge. Pour plus d’assistance, consultez Choix de formats de données. Quand l’utilisateur appelle l’option Partager, seules les applications cibles qui prennent en charge les données partagées apparaissent.

Si vous utilisez Visual Studio, ajoutez le contrat de partage à votre application en cliquant dans le menu Projet sur Ajouter un nouvel élément, puis en sélectionnant Contrat de partage cible dans la liste. Pour ce processus, vous devez indiquer la liste des formats de données et des types de fichier que votre application peut accepter. Vous devez spécifier les formats sous l’onglet Déclarations quand vous modifiez le fichier package.appxmanifest dans Visual Studio.

Pour en savoir plus sur la prise en charge du contrat de partage dans le fichier manifeste de votre application, voir Démarrage rapide : réception d’un contenu partagé et ShareTarget dans le guide de Référence de schéma de manifeste de package.

Pour obtenir un exemple de partage de contenu, voir notre Exemple de partage de contenu source entre applications et notre Exemple de partage de contenu cible entre applications. Vous pouvez aussi consulter nos rubriques Démarrage rapide : partage de contenu et Démarrage rapide : réception de contenu partagé.

Le diagramme suivant montre une vue globale du fonctionnement du partage.

Remarque  

Les liens rapides ne sont pas pris en charge sur Windows Phone 8.1. Si une application cible retourne un lien rapide, l’application source l’ignore automatiquement.

Vous pouvez spécifier le formulaire à ouvrir durant l’activation de l’application via le contrat de partage. Ainsi, vous pouvez créer une expérience personnalisée propre au partage. Vous trouverez plus d’informations à ce propos et sur d’autres considérations liées à la conception dans Recommandations et liste de vérification pour le partage de contenu.

Remarque  

Si vous implémentez une application cible, réfléchissez à l’utilisation de l’interface utilisateur. Sur Windows, quand l’utilisateur sélectionne votre application, celle-ci est présentée avec le menu volant Partager. Cet état d’affichage constitue l’un des modes d’affichage d’une application à l’écran. Assurez-vous que votre application présente une interface claire pour partager du contenu dans le menu volant Partager.

Le contenu que votre application reçoit d’une application source ne peut pas être changé. En revanche, vous pouvez indiquer au système que votre application a reçu les données et le moment où elles ont été traitées. Ce point est important, en particulier pour le contenu tel que les images, qui peuvent demander un certain temps de téléchargement et de traitement. Notre Exemple de partage de contenu cible entre applications vous en montre le fonctionnement. Vous pouvez aussi consulter notre rubrique Démarrage rapide : réception de contenu partagé pour plus d’informations.

N’oubliez pas que même si ces rôles source et cible sont différents, vous pouvez les prendre en charge tous les deux dans une même application. Par exemple, une application de partage de photos peut jouer le rôle d’application source afin que les utilisateurs puissent envoyer leurs photos par messagerie électronique, et aussi celui d’application cible afin qu’ils puissent mettre à jour leurs albums avec de nouvelles photos.

Pour ajouter un partage à votre application, consultez les rubriques et les exemples d’applications ci-après :

• Recommandations et liste de vérification sur le partage de contenu. Que vous écriviez une application source ou cible, cette rubrique fournit des informations utiles qui peuvent vous aider à offrir la meilleure expérience utilisateur possible pour ce qui est du partage de contenu.
• Sélection des formats de données pour le partage. Découvrez les formats standard pour le partage, et comment créer et utiliser des formats personnalisés lorsque les formats standard ne s’appliquent pas.
• Partage de contenu. Vous apprendrez les principes de l’implémentation d’une application source. Nous aborderons également des scénarios plus spécifiques et fournirons quelques détails à considérer lors de leur implémentation.
• Réception de contenu partagé. Ces rubriques décrivent comment ajouter le contrat de partage à votre application, comment détecter si un utilisateur sélectionne votre application pour partager du contenu et comment traiter les données partagées. Nous décrivons également quelques scénarios spécifiques pour vous aider à devenir rapidement opérationnel.
• Exemple de partage de contenu source entre applications. Cet exemple montre comment lancer une opération de partage et empaqueter du contenu pour le partage.
• Exemple de partage de contenu cible entre applications. Cet exemple montre comment recevoir du contenu partagé à partir d’une autre application.
• Recommandations pour le débogage des applications cibles. Découvrez les problèmes liés au débogage d’une application cible de partage.