Démarrage rapide : intégration aux contrats du sélecteur de fichiers (applications Windows Runtime)
[ 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 ]
Fournissez l’accès à du contenu d’application, à un emplacement de sauvegarde ou à des mises à jour de fichiers via le sélecteur de fichiers en intégrant votre application au contrat de sélecteur d’ouverture de fichier, au contrat de sélecteur d’enregistrement de fichier ou au contrat de programme de mise à jour des fichiers mis en cache.
Prérequis
- JavaScript : comment activer une application
- C#/C++/VB : comment activer une application
- Recommandé : contrats d’applications Windows
Déterminer quels services seront fournis par votre application à partir des fenêtres de sélecteur de fichiers
Votre application peut fournir les services suivants à d’autres applications via une intégration au contrat d’application associé. Pour participer à un contrat, vous devez déclarer ce contrat dans le manifeste de votre application, répondre à l’événement activé correspondant, puis créer une vue d’application spécialisée.
Fournir l’accès aux fichiers
Rendez les fichiers accessibles à partir d’un sélecteur de fichiers si votre application offre une vue unique ou utile de ces fichiers, ou si les utilisateurs n’ont pas d’autre moyen d’accéder rapidement aux fichiers.
Contrat d’application : contrat de sélecteur d’ouverture de fichier
Informations sur l’événement activé : fileOpenPickerActivatedEventArgs
Fournir un emplacement d’enregistrement
Fournissez un emplacement d’enregistrement à partir d’un sélecteur de fichiers pour permettre aux utilisateurs qui le souhaitent d’enregistrer des fichiers en vue de les ouvrir ou de les utiliser ultérieurement dans votre application.
Contrat d’application : contrat de sélecteur d’enregistrement de fichier
Informations sur l’événement activé : fileSavePickerActivatedEventArgs
Fournir des mises à jour de fichiers en temps réel
Effectuez le suivi et la mise à jour des fichiers par le biais d’un sélecteur de fichiers afin de permettre aux utilisateurs d’utiliser votre application comme référentiel central pour les fichiers accessibles depuis votre application, ou pour ceux qui sont enregistrés avec votre application en tant qu’emplacement d’enregistrement.
Contrat d’application : contrat de programme de mise à jour des fichiers mis en cache
Informations sur l’événement activé : cachedFileUpdaterActivatedEventArgs
Pour en savoir plus sur les services que votre application peut fournir via un sélecteur de fichiers, voir Accès aux fichiers à l’aide de sélecteurs de fichiers.
Déclarer le contrat dans le manifeste de votre application
Ouvrez votre projet dans Microsoft Visual Studio, puis suivez ces étapes pour ajouter un contrat d’application dans le manifeste :
Ajoutez un contrat d’application. Pour ce faire, ouvrez la fenêtre Ajouter un nouvel élément de votre projet, sélectionnez le contrat dans le volet central, puis cliquez sur le bouton Ajouter.
Vous pouvez accéder à la fenêtre Ajouter un nouvel élément dans Visual Studio de plusieurs façons :
- En sélectionnant l’option de menu Projet > Ajouter un nouvel élément...
- En sélectionnant l’option de menu Ajouter > Nouvel élément... dans le menu contextuel du projet
- En utilisant le raccourci clavier Ctrl+Maj+A
Astuce Quand vous ajoutez ces contrats, Visual Studio met automatiquement à jour votre fichier manifeste "package.appmanifest". Il ajoute à votre projet les fichiers dont vous avez besoin pour définir la disposition et le comportement de l’affichage stocké dans la fenêtre de sélecteur de fichiers durant l’appel du service de votre application.
Personnalisez vos paramètres de contrat dans Visual Studio si les paramètres par défaut ne conviennent pas pour votre application.
Ouvrez "package.appmanifest".
Ouvrez l’onglet Déclarations.
Sélectionnez le nom de votre contrat dans la liste Déclarations prises en charge.
Ajoutez la prise en charge des types de fichiers spécifiques.
Dans la zone Types de fichiers pris en charge, désactivez la case à cocher Prend en charge tout type de fichier.
Ajoutez un nouveau champ FileType pour chaque type de fichier supplémentaire à prendre en charge. Pour ce faire, suivez ces étapes :
- Cliquez sur le bouton Ajouter.
- Dans le champ FileType, entrez l’extension associée au type de fichier à prendre en charge, comme ceci :
*.ext
Astuce Ajoutez uniquement les types de fichiers qui présentent une utilité pour votre application, vos utilisateurs et le contrat. En limitant le nombre de types de fichiers pris en charge, vous conservez une vue de sélecteur de fichiers aérée et facile à utiliser.
Vous pouvez aussi supprimer la prise en charge d’un type de fichier spécifique en suivant les étapes ci-dessus et en cliquant sur le bouton Supprimer pour le type à supprimer. Le bouton Supprimer se trouve juste au-dessus du champ FileType.
Votre fichier manifeste est mis à jour avec le balisage correspondant au contrat ajouté. Un élément représentant le contrat que vous avez ajouté est inséré dans le balisage XML du manifeste en tant qu’enfant de l’élément Extensions. Par exemple, le balisage d’un contrat de sélecteur d’ouverture de fichier qui prend en charge tous les types de fichiers ressemble à ceci :
<Extension Category="windows.filePicker" StartPage="filePicker.html">
<FileOpenPicker>
<SupportedFileTypes SupportsAnyFileType="true" />
</FileOpenPicker>
</Extension>
Répondre lorsque votre application est activée à partir d’un sélecteur de fichiers
Ajoutez au gestionnaire d’événements activés le code qui vérifie que l’objet transmis à votre gestionnaire est associé au contrat que vous avez déclaré dans votre manifeste, puis qui affiche la vue du sélecteur de fichiers de votre application.
Chaque contrat est associé à un objet dont le rôle est de fournir des informations sur l’événement activé qui est déclenché quand l’un des services fournis par votre application est appelé à l’aide d’un sélecteur de fichiers.
Contrat de sélecteur d’ouverture de fichier : fileOpenPickerActivatedEventArgs
Contrat de sélecteur d’enregistrement de fichier :fileSavePickerActivatedEventArgs
Contrat de programme de mise à jour des fichiers mis en cache : cachedFileUpdaterActivatedEventArgs
Créer la vue spécialisée de votre application qui sera hébergée dans le sélecteur de fichiers
Les conseils prodigués dans Recommandations et liste de vérification sur les sélecteurs de fichiers peuvent vous aider à concevoir la vue d’application hébergée dans le sélecteur de fichiers.
Au final, votre vue doit être constituée des éléments suivants :
le code qui personnalise le cadre du sélecteur de fichiers de manière appropriée ;
le balisage et les styles qui définissent la disposition de la zone encadrée du sélecteur de fichiers (zone d’affichage des fichiers) ;
le code qui lie votre source de données au balisage afin que les fichiers s’affichent dans la zone encadrée.
Tester les services fournis par votre application à partir d’un sélecteur de fichiers qui est appelé par une autre application
Pour tester un service fourni par votre application à partir d’un sélecteur de fichiers, vous devez déclencher l’événement activé correspondant au service testé. Vous ne pouvez pas déclencher cet événement directement en exécutant votre application.
Suivez ces étapes pour déclencher l’événement activé correspondant à chaque contrat.
Pour tester la participation de votre application au contrat de sélecteur d’ouverture de fichier :
Lancez une application autre que la vôtre.
Utilisez l’interface utilisateur de cette autre application pour appeler une fenêtre de sélecteur de fichiers permettant d’accéder aux fichiers.
Sélectionnez votre application dans la liste des emplacements proposés dans le sélecteur de fichiers pour retrouver votre application hébergée dans le sélecteur.
Pour tester la participation de votre application au contrat de sélecteur d’enregistrement de fichier :
Lancez une application autre que la vôtre.
Utilisez l’interface utilisateur de cette autre application pour appeler une fenêtre de sélecteur de fichiers permettant d’enregistrer un fichier.
Sélectionnez votre application dans la liste des emplacements proposés dans le sélecteur de fichiers pour retrouver votre application hébergée dans le sélecteur.
Pour tester la participation de votre application au contrat de programme de mise à jour des fichiers mis en cache :
Lancez une application autre que la vôtre.
Utilisez l’interface utilisateur de cette autre application pour appeler une fenêtre de sélecteur de fichiers permettant d’accéder à un fichier, ou de l’enregistrer, qui a été marqué pour mise à jour.
Récapitulatif
Votre application peut fournir des services à d’autres applications en participant à un contrat d’application. Pour participer à un contrat, vous devez déclarer ce contrat dans le manifeste de votre application, répondre à l’événement activé correspondant, puis créer une vue d’application spécialisée.
Rubriques associées
Accès aux données et aux fichiers
Intégration aux contrats du sélecteur de fichiers
exemples de contrats du sélecteur de fichiers
Recommandations et liste de vérification sur les contrats du sélecteur de fichiers
Comment activer une application
Contrats d’applications Windows
Référence
Windows.Storage.Pickers.Provider namespace
Windows.ApplicationModel.Activation.fileOpenPickerActivatedEventArgs class
Windows.ApplicationModel.Activation.fileSavePickerActivatedEventArgs class
Windows.ApplicationModel.Activation.cachedFileUpdaterActivatedEventArgs class
Utilisation des sélecteurs de fichiers
Démarrage rapide : accès aux fichiers à l’aide de sélecteurs de fichiers
Comment enregistrer des fichiers via les sélecteurs de fichiers
Recommandations et liste de vérification sur les sélecteurs de fichiers