Cet article explique comment recevoir dans votre application UWP du contenu partagé à partir d’une autre application à l’aide du contrat de partage. Ce contrat de partage permet à votre application d’être présentée en tant qu’option quand l’utilisateur appelle l’option Partager.
Déclaration de votre application comme cible de partage
Le système affiche une liste des applications cibles possibles quand un utilisateur appelle l’option Partager. Pour figurer dans la liste, votre application doit déclarer qu’elle prend en charge le contrat de partage. Cela indique au système que votre application est apte à recevoir du contenu.
- Ouvrez le fichier manifeste. Il doit normalement porter un nom similaire à package.appxmanifest.
- Ouvrez l’onglet Déclarations.
- Choisissez Cible du partage dans la liste Déclarations disponibles, puis sélectionnez Ajouter.
Choix des types et formats de fichier
Ensuite, déterminez les types de fichiers et les formats de données qui sont pris en charge. Les API de partage prennent en charge plusieurs formats standard, parmi lesquels les formats texte, HTML et bitmap. Vous pouvez également spécifier des types de fichiers et formats de données personnalisés. Dans ce cas, vérifiez que les applications sources connaissent ces types et formats afin qu’elles puissent les utiliser pour partager des données.
Enregistrez uniquement les formats gérés par votre application. Seules les applications cibles qui prennent en charge les données partagées apparaissent quand l’utilisateur appelle l’option Partager.
Pour définir les types de fichier:
- Ouvrez le fichier manifeste. Il doit normalement avoir un nom similaire à package.appxmanifest.
- Dans la section Types de fichiers pris en charge de la page Déclarations, sélectionnez Ajouter nouveau.
- Tapez l’extension de nom de fichier que vous voulez prendre en charge, par exemple, «.docx». Vous devez inclure le point. Pour prendre en charge tous les types de fichiers, cochez la case SupportsAnyFileType.
Pour définir les formats de données:
- Ouvrez le fichier manifeste.
- Ouvrez la section Formats de données de la page Déclarations et sélectionnez Ajouter nouveau.
- Tapez le nom du format de données à prendre en charge, par exemple, «Texte».
Gestion de l’activation du partage
Quand un utilisateur sélectionne votre application (généralement en la choisissant dans une liste d’applications cibles disponibles dans l’interface utilisateur de partage), un événement OnShareTargetActivated est déclenché. Votre application doit gérer cet événement afin de traiter les données que l’utilisateur veut partager.C#Copier
protected override async void OnShareTargetActivated(ShareTargetActivatedEventArgs args)
{
// Code to handle activation goes here.
}
Les données que l’utilisateur souhaite partager sont stockées dans un objet ShareOperation. Vous pouvez utiliser cet objet pour vérifier le format des données qu’il contient.C#Copier
ShareOperation shareOperation = args.ShareOperation;
if (shareOperation.Data.Contains(StandardDataFormats.Text))
{
string text = await shareOperation.Data.GetTextAsync();
// To output the text from this example, you need a TextBlock control
// with a name of "sharedContent".
sharedContent.Text = "Text: " + text;
}
État de partage de rapports
Dans certains cas, votre application peut avoir besoin de plus de temps pour traiter les données à partager. Il s’agit, par exemple, des partages de collections de fichiers ou d’images. Ces éléments sont plus volumineux qu’une simple chaîne de texte, ce qui explique leur temps de traitement plus long.C#Copier
shareOperation.ReportStarted();
Après avoir appelé la méthode ReportStarted, ne prévoyez aucune interaction avec votre application de la part de l’utilisateur. Par conséquent, vous ne devez appeler cette méthode que si votre application est parvenue à un stade de l’opération où elle peut être masquée par l’utilisateur.
Avec un partage étendu, l’utilisateur peut être amené à masquer l’application source avant que votre application n’ait reçu toutes les données de l’objet DataPackage. Pour cette raison, nous recommandons que votre application avertisse le système quand elle a obtenu toutes les données nécessaires. Cela permet au système de suspendre ou d’arrêter l’application source selon les besoins.C#Copier
shareOperation.ReportSubmittedBackgroundTask();
En cas de problème, appelez ReportError pour envoyer un message d’erreur au système. L’utilisateur voit le message quand il vérifie l’état du partage. À ce stade, votre application est arrêtée et le partage est terminé. L’utilisateur devra recommencer pour partager le contenu vers votre application. Selon la situation, vous pouvez décider qu’un certain type d’erreur ne suffit pas pour mettre fin à l’opération de partage. Dans ce cas, vous pouvez omettre d’appeler ReportError et continuer le partage.C#Copier
shareOperation.ReportError("Could not reach the server! Try again later.");
Enfin, lorsque votre application a terminé de traiter le contenu partagé, appelez la méthode ReportCompleted qui notifie au système la fin de l’opération.C#Copier
shareOperation.ReportCompleted();
Généralement, vous appelez ces méthodes selon l’ordre indiqué, une seule fois chacune. Toutefois, une application cible peut parfois appeler ReportDataRetrieved avant ReportStarted. Par exemple, l’application peut récupérer les données dans le cadre d’une tâche dans le gestionnaire d’activation, mais ne pas appeler ReportStarted tant que l’utilisateur ne sélectionne pas un bouton Partager.
Renvoi d’un QuickLink si le partage a réussi
Lorsqu’un utilisateur sélectionne votre application pour recevoir du contenu, nous vous recommandons de créer un QuickLink. Un objet QuickLink est une sorte de raccourci qui permet à l’utilisateur de partager plus facilement des informations avec votre application. Par exemple, vous pouvez créer un QuickLink qui ouvre un nouveau message électronique dans lequel l’adresse de messagerie du destinataire est déjà indiquée.
Un QuickLink doit avoir un titre, une icône et un Id. Le titre (comme «message pour maman») et l’icône s’affichent lorsque l’utilisateur appuie sur l’icône partager. L’ID est utilisé par l’application pour accéder à des informations personnalisées, telles qu’une adresse de messagerie ou des informations d’identification. Quand votre application crée un QuickLink, elle renvoie ce QuickLink au système en appelant ReportCompleted.
Un QuickLink ne stocke pas de données. Cet objet contient à la place un identificateur qui, lorsqu’il est sélectionné, est envoyé à votre application. Votre application stocke l’ID de QuickLink ainsi que les données utilisateur correspondantes. Quand l’utilisateur appuie sur l’objet QuickLink, vous pouvez obtenir l’ID de ce dernier à l’aide de la propriété QuickLinkId.C#Copier
async void ReportCompleted(ShareOperation shareOperation, string quickLinkId, string quickLinkTitle)
{
QuickLink quickLinkInfo = new QuickLink
{
Id = quickLinkId,
Title = quickLinkTitle,
// For quicklinks, the supported FileTypes and DataFormats are set
// independently from the manifest
SupportedFileTypes = { "*" },
SupportedDataFormats = { StandardDataFormats.Text, StandardDataFormats.Uri,
StandardDataFormats.Bitmap, StandardDataFormats.StorageItems }
};
StorageFile iconFile = await Windows.ApplicationModel.Package.Current.InstalledLocation.CreateFileAsync(
"assets\\user.png", CreationCollisionOption.OpenIfExists);
quickLinkInfo.Thumbnail = RandomAccessStreamReference.CreateFromFile(iconFile);
shareOperation.ReportCompleted(quickLinkInfo);
}