Beispiel für DocumentViewer mit Anmerkungen im XML-Speicher
Aktualisiert: November 2007
DocViewerAnnotationsXml 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 separat vom XPS-Dokument in einer XML-Datei 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-Containerdatei öffnen kann (eine XML Paper Specification (XPS)-Bespieldokumentdatei ist bereitgestellt).
Wenn ein Dokument geöffnet wird, wird dessen Inhalt im DocumentViewer-Steuerelement des Hauptanwendungsfensters angezeigt. Innerhalb des DocumentViewer-Steuerelements können Sie einen Blocktext zum Hinzufügen von Kommentaren und Anmerkungen auswählen. 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". Nachdem der Anmerkungstyp ausgewählt wurde, wird die Anmerkungshervorhebung oder -form im DocumentViewer-Steuerelement angezeigt. Sie können Anmerkungen in Text- oder Freihandform persönliche Kommentare hinzufügen. Im Beispiel DocViewerAnnotationsXml werden Benutzeranmerkungen in der separaten Datei annotations.xml in demselben Ordner wie das XML Paper Specification (XPS)-Dokument gespeichert.
Der Quellcode im Beispiel DocViewerAnnotationsXml besteht aus vier 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.
Außerdem werden eine Projektdatei und ein XPS-Beispieldokument bereitgestellt. Zum Überprüfen des Inhalts des XPS-Dokuments und der darin enthaltenen Dateien ä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