WpfAnnotationVisualTool позволяет пользователю создавать или преобразовывать аннотации в WpfAnnotationViewer. Построение аннотации осуществляется "построителем аннотации", преобразование аннотации осуществляется "трансформером аннотации". Визуальный инструмент получает информацию о "построителе аннотации" и "трансформере аннотации" из класса WpfAnnotationView:

• WpfAnnotationView.Builder - определяет интерактивный контроллер, который необходимо использовать для построения аннотации.
• WpfAnnotationView.Transformer - определяет интерактивный контроллер, который необходимо использовать для преобразования аннотации.
• WpfAnnotationView.InteractionController - определяет текущий интерактивный контроллер.

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

Для вновь созданной аннотации значение свойства WpfAnnotationView.InteractionController равно значению свойства WpfAnnotationView.Builder, т.е. аннотации готов к построению.
Метод WpfAnnotationVisualTool.AddAndBuildAnnotation позволяет запустить процесс построения аннотации, т.е. метод добавляет аннотацию в коллекцию аннотаций сфокусированного изображения, получает текущий контроллер взаимодействия ("построитель аннотации") с помощью свойства WpfAnnotationView.InteractionController и запускает построение аннотации.
Для построения аннотаций могут использоваться следующие контроллеры взаимодействия (построители):

• WpfRectangularAnnotationBuilder - построитель для прямоугольной аннотации.
• WpfPointBasedAnnotationFreehandBuilder - построитель точечной аннотации, который создает рукописную аннотацию.
• WpfPointBasedAnnotationLineBuilder - построитель точечной аннотации, который создает аннотацию-линию.
• WpfPointBasedAnnotationPointBuilder - построитель точечной аннотации, который строит аннотацию-полилинию.

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

Преобразование аннотации, которая находится в фокусе в WpfAnnotationViewer, можно запустить с помощью мыши. Для преобразования аннотаций можно использовать следующие интерактивные контроллеры:

• WpfRectangularAnnotationTransformer - трансформер прямоугольной аннотации. Реализует перемещение, изменение размера, поворот аннотации.
• WpfRectangularTextAnnotationTransformer - трансформер прямоугольной аннотации, реализующий интерфейс IWpfRectangularTextAnnotation и определяющий прямоугольную аннотацию, содержащую свойство "Текст" строкового типа. Этот трансформер может быть производным от WpfRectangularTextAnnotationTransformer и расширять его функциональность, предоставляя окно для редактирования текста аннотации.
• WpfPointBasedAnnotationPointTransformer - трансформер для точечной аннотации. Реализует маркировку и перемещение точек аннотации.
• WpfPointBasedAnnotationRectangularTransformer - трансформер для точечной аннотации. Преобразует аннотацию, используя ограничивающий прямоугольник. Реализует перемещение, изменение размера, поворот аннотации.

Преобразование аннотации с помощью нескольких контроллеров

Класс WpfCompositeInteractionController позволяет объединять несколько интерактивных контроллеров.

Например, WpfFreeTextAnnotationView использует составной контроллер взаимодействия, поскольку WpfFreeTextAnnotationView состоит из двух аннотаций (WpfTextAnnotationView и WpfLeaderLineAnnotationView) и должен взаимодействовать с обеими аннотациями, используя разные интерактивные контроллеры:

• WpfRectangularAnnotationTransformer преобразует WpfTextAnnotationView
• WpfPointBasedAnnotationPointTransformer преобразует WpfLeaderLineAnnotationView
• WpfRectangularAnnotationTransformer преобразует WpfCompositeAnnotationView (вся аннотация)