DocumentViewer avec annotations stockées dans un fichier XPS, exemple
Mise à jour : novembre 2007
DocViewerAnnotationsXps illustre comment lire un document XML Paper Specification (XPS) dans un contrôle DocumentViewer puis activer la possibilité d'ajout de notes et d'annotations manuscrites par des utilisateurs, ainsi que de mettre en surbrillance des annotations. Dans cet exemple, les annotations des utilisateurs sont stockées dans un fichier XML en tant que partie du document XPS.
Lors de son exécution, l'exemple affiche une barre de menus avec l'option « Fichier | Ouvrir ». Sélectionner « Ouvrir » affiche la boîte de dialogue « Ouvrir », qui permet à l'utilisateur de parcourir des dossiers et de choisir un fichier XpsDocument à ouvrir (un document XPS est fourni à titre d'exemple).
Lors de l'ouverture d'un document, son contenu est affiché dans le contrôle DocumentViewer de la fenêtre d'application principale. Dans le contrôle DocumentViewer vous pouvez sélectionner un bloc de texte pour ajouter une annotation. En cliquant avec le bouton droit sur le texte sélectionné vous ouvrez le menu contextuel Annotations qui vous permet de choisir le type d'annotation à créer : « Surbrillance », « Note texte » ou « Note manuscrite ». Une fois le type d'annotation sélectionné, la mise en surbrillance ou la note s'affiche dans le contrôle DocumentViewer. Vous pouvez ajouter des commentaires personnels aux notes textuelles ou aux notes manuscrites. Dans l'exemple DocViewerAnnotationsXps, les annotations des utilisateurs sont stockées dans un fichier XML en tant que PackagePart faisant partie du document XPS lui-même. À l'aide de ce type de conception, les annotations sont stockées avec le package de document.
Le code source DocViewerAnnotationsXps se compose des cinq fichiers décrits ci-dessous.
MyApp.xaml – ressources XAML (Extensible Application Markup Language) destinées à l'application (aucune dans cet exemple).
MyApp.xaml.cs – code-behind pour la création et l'affichage de la fenêtre d'application.
Window1.xaml – déclarations XAML qui définissent les éléments de la fenêtre d'application : menu principal, commandes de menu et contrôle DocumentViewer, menu contextuel d'annotations DocumentViewer et commandes de menu contextuel.
Window1.xaml.cs – code-behind prenant en charge l'interface utilisateur pour les commandes du menu principal et du menu contextuel.
AnnotationsHelperXps.cs – classe d'assistance d'annotations pour prendre en charge les annotations stockées dans le cadre d'un document XPS.
Un fichier projet et un document XPS exemple sont également fournis. Pour examiner le contenu du document XPS ainsi que le fichier XML d'annotations utilisateur, il suffit de modifier l'extension du fichier de .xps en .zip et d'ouvrir le fichier dans l'utilitaire de décompression.
Cet exemple présente une fonctionnalité spécifique de Windows Presentation Foundation et, par conséquent, ne suit pas les meilleures pratiques de développement d'applications. Pour un traitement complet des meilleures pratiques de développement d'applications Windows Presentation Foundation (WPF) et Microsoft .NET Framework, reportez-vous, selon les cas, aux documents suivants :
Accessibilité - Meilleures pratiques d'accessibilité
Sécurité - Sécurité de Windows Presentation Foundation
Localisation - Vue d'ensemble de la globalisation et de la localisation WPF
Génération de l'exemple
Installez le Kit de développement logiciel (SDK) Windows et ouvrez la fenêtre Commande de son environnement de génération. Dans le menu Démarrer, pointez sur Tous les programmes et sur Microsoft Windows SDK, puis cliquez sur CMD Shell.
Téléchargez l'exemple, généralement à partir de la documentation du Kit de développement logiciel (SDK), vers votre disque dur local.
Pour générer l'exemple à partir de la fenêtre Commande de l'environnement de génération, accédez au répertoire source de l'exemple. À l'invite de commandes, tapez MSBUILD.
Pour générer l'exemple dans Microsoft Visual Studio, chargez l'exemple de solution ou de fichier projet, puis appuyez sur CTRL+MAJ+B.
Exécution de l'exemple
Pour exécuter l'exemple compilé avec le débogage dans Visual Studio, appuyez sur F5.
Pour exécuter l'exemple à partir d'une fenêtre de Commande de CMD Shell, exécutez le fichier .exe contenu dans le dossier source de l'exemple.
Voir aussi
Tâches
Création d'un document XPS, exemple
Enregistrement d'un document XPS, exemple