Визуальный инструмент AnnotationVisualTool предназначен для просмотра, редактирование и взаимодействия с коллекцией аннотаций активного изображения в просмотрщике изображений.

AnnotationVisualTool класс позволяет:

• получить доступ к коллекции аннотаций изображения
• отобразить коллекцию аннотаций изображения
• определить режим взаимодействия между пользователем и аннотациями
• выбрать одну или несколько аннотаций
• определить область изображения, где аннотация может быть построена или преобразована
• построить аннотацию
• преобразовать аннотацию
• расширить существующую функциональность

Программный доступ к аннотациям в WinForms просмотрщике изображений с аннотациями

Коллекцию видов аннотаций можно получить с помощью свойства AnnotationViewCollection. Вид выделенной аннотации можно получить с помощью свойства AnnotationVisualTool.FocusedAnnotationView.

Отображение и взаимодействие с аннотациями в WinForms просмотрщике изображений с аннотациями.

Класс AnnotationVisualTool позволяет выполнять 3 группы операций с коллекцией аннотаций одного изображения:

1. отображать коллекцию аннотаций
2. реализовать взаимодействие между пользователем и аннотацией
   • генерировать событие, когда указатель мыши перемещается над аннотацией
   • генерировать событие, когда пользователь направляет указатель мыши на аннотацию
   • генерировать событие, когда пользователь нажимает на аннотацию
   • выполнять переход по гиперссылке, когда пользователь нажимает на аннотацию-ссылку
   • выполнить любое другое взаимодействие между пользователем и аннотацией
3. преобразовать одну аннотацию или группу аннотаций
   • создать и добавить аннотацию в коллекцию аннотаций
   • преобразовать аннотацию (переместить, изменить размер, повернуть, отразить, применить пользовательскую трансформацию)
   • удалить аннотация из коллекции аннотаций

Использование различных режимов взаимодействия аннотаций в WinForms просмотрщике изображений с аннотациями

Класс AnnotationVisualTool позволяет выбирать режим взаимодействия между пользователем и аннотациями с помощью свойства AnnotationVisualTool.AnnotationInteractionMode. Доступны следующие режимы:

• None - визуальный инструмент просто отображает аннотации, взаимодействие с аннотациями НЕ возможно, редактирование аннотаций НЕ возможно
• View - визуальный инструмент отображает аннотации и возможно с ними взаимодействовать, редактирование аннотаций НЕ возможно
• Author - визуальный инструмент отображает аннотации и возможно их редактирование, взаимодействие с аннотациями НЕ возможно

Ниже приведена диаграмма, иллюстрирующая события, происходящие в движке аннотаций:

Выбор одной или нескольких аннотаций в WinForms просмотрщике изображений с аннотациями

По умолчанию класс AnnotationVisualTool позволяет выбрать несколько аннотаций. Выбранную коллекцию аннотаций можно получить с помощью свойства AnnotationVisualTool.SelectedAnnotations. Возможность выбора нескольких аннотаций можно отключить с помощью AnnotationVisualTool.MultiSelect. Свойство AnnotationVisualTool.AnnotationSelectionPen позволяет указать перо, которое должно использоваться для рисования выделения аннотации.

Одну аннотацию можно программно выбрать с помощью метода AnnotationVisualTool.SetFocusedAnnotationView.

Ограничение построения/преобразования аннотаций в области изображения в WinForms просмотрщике изображений с аннотациями.

AnnotationVisualTool позволяет ограничить область, в которой аннотации могут быть построены или преобразованы. Эту функцию можно включить с помощью свойства AnnotationVisualTool.IsAnnotationBoundingRectEnabled. Свойство AnnotationVisualTool.AnnotationBoundingRect позволяет задать область изображения, в которой можно построить или преобразовать аннотацию.

Построение аннотации в WinForms просмотрщике изображений с аннотациями

Метод AnnotationVisualTool.AddAndBuildAnnotation позволяет запустить процесс построения аннотации, метод AnnotationVisualTool.FinishAnnotationBuilding позволяет завершить процесс построения аннотации, метод AnnotationVisualTool.CancelAnnotationBuilding позволяет отменить процесс создания аннотации.
AnnotationVisualTool вызывает событие AnnotationVisualTool.AnnotationBuildingStarted при запуске процесса создания аннотации, AnnotationVisualTool вызывает событие AnnotationVisualTool.AnnotationBuildingFinished при завершении процесса создания аннотации, AnnotationVisualTool вызывает событие AnnotationVisualTool.AnnotationBuildingCanceled, когда процесс построения аннотации отменяется.

Преобразование аннотации в WinForms просмотрщике изображение с аннотациями

Преобразование выделенной аннотации можно запустить с помощью мыши.
AnnotationVisualTool вызывает событие AnnotationVisualTool.AnnotationTransformingStarted при запуске процесса преобразования примечаний, AnnotationVisualTool вызывает событие AnnotationVisualTool.AnnotationTransformingFinished при завершении процесса трансформации аннотации.

Визуальный инструмент позволяет преобразовать одну аннотацию или группу аннотаций. При преобразовании группы аннотаций можно выполнить преобразование группы целиком или каждой аннотации отдельно.

Используйте помощник вращения аннотаций для вращения аннотаций в WinForms просмотрщике изображений с аннотациями.

Класс AnnotationVisualTool содержит помощник вращения, который может помочь, когда аннотацию необходимо повернуть на дискретный угол. Помощник вращения доступен с помощью свойства AnnotationVisualTool.RotationAssistant.
Помощник вращения работает следующим образом:

• Аннотация поворачивается на дискретный угол, когда указатель мыши находится над областью помощника по аннотациям (смотрите изображение ниже)
• Аннотация плавно вращается, когда указатель мыши находится за пределами области помощника вращения (см. изображение ниже)

Расширение существующей функциональности

Класс AnnotationVisualTool имеет открытую архитектуру и позволяет изменять практически любую функциональность в производных классах.