Beispiel für DocumentViewer mit Anmerkungen im XPS-Speicher
Aktualisiert: November 2007
DocViewerAnnotationsXps veranschaulicht, wie ein XML Paper Specification (XPS)-Dokument in ein DocumentViewer-Steuerelement gelesen wird und wie die Unterstützung für das Hinzufügen von durch die Benutzer erstellten Textanmerkungen, Freihandanmerkungen und hervorgehobenen Anmerkungen hinzugefügt wird. In diesem Beispiel werden Benutzeranmerkungen in einer XML-Datei als Teil des XPS-Dokuments gespeichert.
Bei der Ausführung des Beispiels wird eine Menüleiste mit der Option "File | Open..." angezeigt. Durch Auswahl von "Open..." wird das Dialogfeld "File Open..." angezeigt, in dem der Benutzer Dateien durchsuchen und eine XpsDocument-Datei zum Öffnen auswählen kann (ein XPS-Bespieldokument ist bereitgestellt).
Wenn ein Dokument geöffnet wird, wird dessen Inhalt im DocumentViewer des Hauptanwendungsfensters angezeigt. Innerhalb des DocumentViewer-Steuerelements können Sie einen Textblock auswählen, um eine Anmerkung hinzuzufügen. Wenn Sie mit der rechten Maustaste auf den ausgewählten Text klicken, wird das Kontextmenü Annotations angezeigt. Hier können Sie auswählen, welche Art von Anmerkung erstellt werden soll: "Highlight", "Text Note" oder "Ink Note". Nach dem Auswählen des Anmerkungstyps wird die Anmerkungshervorhebung oder Notizform im DocumentViewer-Steuerelement angezeigt. Sie können Anmerkungen in Text- oder Freihandform persönliche Kommentare hinzufügen. Im Beispiel DocViewerAnnotationsXps werden Benutzeranmerkungen einer XML-Datei als PackagePart im XPS-Dokument selbst gespeichert. Bei diesem Entwurf werden Benutzeranmerkungen als Teil des Dokumentpakets zusammengehalten.
Der Quellcode im Beispiel DocViewerAnnotationsXps besteht aus fünf Dateien:
MyApp.xaml - Extensible Application Markup Language (XAML)-Ressourcen für die Anwendung (keine in diesem Beispiel).
MyApp.xaml.cs - CodeBehind zum Erstellen und Anzeigen des Anwendungsfensters.
Window1.xaml - XAML-Deklarationen, die die Elemente des Anwendungsfensters definieren: Hauptmenü, Menübefehle, DocumentViewer-Steuerelement, DocumentViewer-Kontextmenü für Anmerkungen und Kontextmenübefehle.
Window1.xaml.cs - CodeBehind, der die Benutzeroberfläche für das Hauptmenü und die Kontextmenübefehle unterstützt.
AnnotationsHelperXps.cs - Hilfsklasse für Anmerkungen zum Unterstützen von Benutzeranmerkungen, die als Teil eines XPS-Dokuments gespeichert werden.
Außerdem werden eine Projektdatei und ein XPS-Beispieldokument bereitgestellt. Zum Überprüfen des Inhalts des XPS-Dokuments und der darin enthaltenen XML-Datei mit Benutzeranmerkungen ändern Sie einfach die Dateierweiterung des Dokuments von .xps in .zip, und öffnen Sie die Datei anschließend mit dem Zip-Dienstprogramm.
In diesem Beispiel soll nur ein bestimmtes Feature von Windows Presentation Foundation veranschaulicht werden, daher werden die bewährten Methoden für die Anwendungsentwicklung nicht befolgt. Ausführliche Informationen über empfohlene Vorgehensweisen bei der Anwendungsentwicklung für Windows Presentation Foundation (WPF) und Microsoft .NET Framework finden Sie unter folgenden Themen:
Eingabehilfen – Bewährte Methoden für Eingabehilfen
Sicherheit – Windows Presentation Foundation-Sicherheit
Lokalisierung – Übersicht über WPF-Globalisierung und -Lokalisierung
Erstellen des Beispiels
Installieren Sie das Windows Software Development Kit (SDK) und öffnen Sie dessen Buildumgebungs-Befehlsfenster. Zeigen Sie im Startmenü auf Alle Programme und Microsoft Windows SDK, und klicken Sie dann auf CMD Shell.
Laden Sie das Beispiel, normalerweise aus der Software Development Kit (SDK)-Dokumentation, auf Ihre Festplatte herunter.
Um das Beispiel über das Buildumgebungs-Befehlsfenster zu erstellen, wechseln Sie zum Quellverzeichnis des Beispiels. Geben Sie an der Eingabeaufforderung MSBUILD ein.
Um das Beispiel mit in Microsoft Visual Studio zu erstellen, laden Sie die Projektmappe oder Projektdatei des Beispiels, und drücken Sie STRG+UMSCHALT+B.
Ausführen des Beispiels
Um das kompilierte Beispiel in Visual Studio mit Debuggen auszuführen, drücken Sie F5.
Um das Beispiel über ein CMD Shell-Befehlsfenster auszuführen, führen Sie die EXE-Datei aus, die sich im Quellordner des Beispiels befindet.
Siehe auch
Aufgaben
Beispiel zum Erstellen eines XPS-Dokuments
Beispiel zum Speichern eines XPS-Dokuments