Просмотр и преобразование аннотаций, взаимодействие с аннотациями в WPF
В этом разделе
Визуальный инструмент WpfAnnotationVisualTool предназначен для просмотра, редактирования и взаимодействия с коллекцией аннотаций сфокусированного изображения в просмотрщике.
Класс WpfAnnotationVisualTool позволяет:
- получить доступ к коллекции аннотаций изображения
- отобразить коллекцию аннотаций изображения
- определить режим взаимодействия между пользователем и аннотациями
- выбрать одну или несколько аннотаций
- определить область изображения, где аннотация может быть построена или преобразована
- построить аннотацию
- преобразовать аннотацию
- расширить существующую функциональность
Программный доступ к аннотациям в WPF просмотрщике изображений с аннотациями
Можно получить коллекцию визуальных представлений аннотаций используя свойство WpfAnnotationViewCollection. Вид выбранной аннотации можно получить с помощью свойства WpfAnnotationVisualTool.FocusedAnnotationView.Отображение аннотаций и взаимодействие с ними в WPF просмотрщике изображений с аннотациями.
Класс WpfAnnotationVisualTool позволяет выполнять 3 группы операций с коллекцией аннотаций одного изображения:- отображать коллекцию аннотаций
-
реализовать взаимодействие между пользователем и аннотацией
- генерировать событие, когда указатель мыши перемещается над аннотацией
- генерировать событие, когда пользователь направляет указатель мыши на аннотацию
- генерировать событие, когда пользователь нажимает на аннотацию
- выполнять переход по гиперссылке, когда пользователь нажимает на аннотацию-ссылку
- выполнить любое другое взаимодействие между пользователем и аннотацией
-
преобразовать одну аннотацию или группу аннотаций
- создать и добавить аннотацию в коллекцию аннотаций
- преобразовать аннотацию (переместить, изменить размер, повернуть, отразить, применить пользовательскую трансформацию)
- удалить аннотация из коллекции аннотаций
Использование различных режимов взаимодействия с аннотациями в WPF просмотрщике изображений с аннотациями.
Класс WpfAnnotationVisualTool позволяет выбрать режим взаимодействия между пользователем и аннотациями с помощью свойства WpfAnnotationVisualTool.AnnotationInteractionMode. Доступны следующие режимы:- None - визуальный инструмент просто отображает аннотации, взаимодействие с аннотациями НЕ возможно, редактирование аннотаций НЕ возможно
- View - визуальный инструмент отображает аннотации и возможно с ними взаимодействовать, редактирование аннотаций НЕ возможно
- Author - визуальный инструмент отображает аннотации и возможно их редактирование, взаимодействие с аннотациями НЕ возможно
Ниже приведена диаграмма, иллюстрирующая события, происходящие в движке аннотаций:
Выбор одной или несколькчх аннотаций в WPF просмотрщике изображений с аннотациями.
По умолчанию класс WpfAnnotationVisualTool позволяет выбрать несколько аннотаций. Выбранную коллекцию аннотаций можно получить с помощью свойства WpfAnnotationVisualTool.SelectedAnnotations. Возможность выбора нескольких аннотаций можно отключить с помощью свойства WpfAnnotationVisualTool.MultiSelect. Свойство WpfAnnotationVisualTool.AnnotationSelectionPen позволяет указать перо, которое должно использоваться для рисования выделения аннотации.Одну аннотацию можно программно выбрать с помощью метода WpfAnnotationVisualTool.SetFocusedAnnotationView.
Ограничение построения/преобразования аннотаций в области изображения в WPF просмотрщике изображений с аннотациями
WpfAnnotationVisualTool позволяет ограничить область, в которой аннотации могут быть построены или преобразованы. Эту функцию можно включить с помощью свойства WpfAnnotationVisualTool.IsAnnotationBoundingRectEnabled. Свойство WpfAnnotationVisualTool.AnnotationBoundingRect позволяет указать область изображения, в которой можно создавать или трансформировать аннотации.Построение аннотации в WPF просмотрщике изображений с аннотациями
Метод WpfAnnotationVisualTool.AddAndBuildAnnotation позволяет начать процесс построения аннотации, метод WpfAnnotationVisualTool.FinishAnnotationBuilding позволяет завершить процесс построения аннотации, метод WpfAnnotationVisualTool.CancelAnnotationBuilding позволяет отменить процесс построения аннотации.WpfAnnotationVisualTool вызывает событие WpfAnnotationVisualTool.AnnotationBuildingStarted при запуске процесса создания аннотации, WpfAnnotationVisualTool вызывает событие WpfAnnotationVisualTool.AnnotationBuildingFinished при завершении процесса создания аннотации, WpfAnnotationVisualTool вызывает WpfAnnotationVisualTool.AnnotationBuildingCanceled при отмене процесса построения аннотации.
Преобразование аннотации в WPF просмотрщике изображений с аннотациями
Преобразование выделенной аннотации можно запустить с помощью мыши.WpfAnnotationVisualTool вызывает событие WpfAnnotationVisualTool.AnnotationTransformingStarted при запуске процесса преобразования аннотации, WpfAnnotationVisualTool вызывает событие WpfAnnotationVisualTool.AnnotationTransformingFinished событие при завершении процесса преобразования аннотации.
Визуальный инструмент позволяет преобразовать одну аннотацию или группу аннотаций. При преобразовании группы аннотаций можно выполнить преобразование группы целиком или каждой аннотации отдельно.
Использование помощника поворота аннотации для вращения аннотации в WPF просмотрщике изображений с аннотациями.
Класс WpfAnnotationVisualTool содержит помощник поворота, который может помочь, когда аннотацию необходимо повернуть на дискретный угол. Доступ к помощнику поворота осуществляется с помощью свойства WpfAnnotationVisualTool.RotationAssistant.Помощник вращения работает следующим образом:
- Аннотация поворачивается на дискретный угол, когда указатель мыши находится над областью помощника по аннотациям (смотрите изображение ниже)
- Аннотация плавно вращается, когда указатель мыши находится за пределами области помощника вращения (см. изображение ниже)
