Пример DocumentViewer с XPS-хранилищем для заметок
Обновлен: Ноябрь 2007
В примере DocViewerAnnotationsXps демонстрируется чтение документа Формат XPS (XML Paper Specification) с помощью элемента управления DocumentViewer и включение поддержки добавления как созданных пользователем, так и рукописных примечаний, а также выделения заметок. В этом примере пользовательские заметки хранятся в файле XML как часть документа XPS.
После запуска примера отображается строка меню с пунктом "Файл | Открыть..." в командной строке. При выборе "Открыть..." отображается диалоговое окно "Открытие файла...", в котором пользователь может просматривать и выбирать файлы XpsDocument для открытия (предоставляется образец документа XPS).
При открытии документа его содержимое отображается в элементе управления DocumentViewer главного окна приложения. В элементе управления DocumentViewer можно выбрать блок текста для добавления заметки. Если щелкнуть правой кнопкой мыши выделенный текст, отображается всплывающее меню "Заметки", позволяющее выбрать тип создаваемой заметки: "Выделенная", "Текстовая заметка", "Рукописная заметка". После выбора типа примечания в элементе управления DocumentViewer отображается выделенная заметка или форма примечания. В текстовое или рукописное примечание можно добавить собственные заметки. В примере DocViewerAnnotationsXps заметки пользователей хранятся в файле XML как часть PackagePart самого документа XPS. С помощью этой конструкции пользовательские заметки располагаются вместе как часть пакета документа.
Исходный код примера DocViewerAnnotationsXps состоит из пяти файлов:
MyApp.xaml — ресурсы Язык XAML (Extensible Application Markup Language) для приложения (отсутствуют в этом примере).
MyApp.xaml.cs — код для создания и отображения окна приложения.
Window1.xaml — объявления XAML, задающие элементы окна приложения: главное меню, команды меню, элемент управления DocumentViewer, всплывающее меню заметок DocumentViewer и команды всплывающего меню.
Window1.xaml.cs — код поддержки пользовательского интерфейса команд главного меню и всплывающего меню.
AnnotationsHelperXps.cs — вспомогательный класс для поддержки пользовательских заметок, хранящихся в виде части документа XPS.
Также предоставляются файл проекта и образец документа XPS. Чтобы просмотреть содержимое документа XPS и находящийся в нем файл XML пользовательских примечаний, просто измените расширение файла документа с XPS на ZIP и откройте файл с помощью программы Zip.
В этом примере описываются специфические функции Windows Presentation Foundation, и поэтому рекомендации по разработке приложений не соблюдаются. Более полное рассмотрение Windows Presentation Foundation (WPF) и рекомендации по тактике разработки приложений Microsoft .NET Framework см. в следующих источниках:
Специальные возможности: Рекомендации по специальным возможностям
Безопасность: Безопасность Windows Presentation Foundation
Локализация: Общие сведения о глобализации и локализации WPF
Построение примера
Установите пакет средств разработки программного обеспечения для Windows и откройте окно командной строки среды его построения. В меню "Пуск" выделите пункты "Все программы", "Пакет SDK для Microsoft Windows", а затем "Оболочки CMD".
Загрузите образец, как правило из документации пакета SDK, на жесткий диск.
Чтобы построить образец из окна командной строки среды построения, перейдите в исходный каталог образца. В командной строке введите MSBUILD.
Чтобы построить образец в Microsoft Visual Studio, загрузите решение образца или файл проекта и нажмите сочетание клавиш CTRL + SHIFT + B.
Выполнение примера
Для запуска скомпилированного образца с помощью отладки в Visual Studio, нажмите клавишу F5.
Для запуска примера в окне командной строки Оболочка CMD выполните EXE-файл, расположенный в исходной папке примера.
См. также
Задачи
Пример сохранения документа XPS