WpfCompositeVisualTool - визуальный инструмент, позволяющий использовать композицию вложенных визуальных инструментов в WpfImageViewer. Массив вложенных визуальных инструментов можно получить с помощью защищенного свойства WpfCompositeVisualTool.VisualTools.

Если WpfCompositeVisualTool не имеет активного вложенного визуального инструмента, т. е. значение свойства WpfCompositeVisualTool.ActiveTool равно null:

• WpfCompositeVisualTool рисует вложенные визуальные инструменты в WpfImageViewer в порядке, обратном порядку в массиве WpfCompositeVisualTool.VisualTools. Таким образом, первый визуальный инструмент будет отрисован последним.
• WpfCompositeVisualTool передает событие с устройства ввода во вложенные визуальные инструменты в том же порядке, в котором они хранятся в массиве WpfCompositeVisualTool.VisualTools, пока один из вложенных визуальных инструментов не отметит событие как обработанное, т. е. не установит флаг e.Handled аргументов события в значение True.

Если WpfCompositeVisualTool имеет активный вложенный визуальный инструмент, т. е. значение свойства WpfCompositeVisualTool.ActiveTool не равно null:

• WpfCompositeVisualTool рисует вложенные визуальные инструменты, за исключением визуального инструмента, определенного свойством WpfCompositeVisualTool.ActiveTool, в WpfImageViewer в порядке, обратном порядку в массиве WpfCompositeVisualTool.VisualTools, и только после этого рисует визуальный инструмент, определенный свойством WpfCompositeVisualTool.ActiveTool.
• WpfCompositeVisualTool передает событие с устройства ввода только визуальному инструменту, определенному свойством WpfCompositeVisualTool.ActiveTool.

Композитные визуальные инструменты используются во многих демо приложениях VintaSoft Imaging .NET SDK, например:

• Класс WpfAnnotationViewer использует композицию WpfAnnotationVisualTool и WpfRectangularSelectionTool для предоставления возможности выбора нескольких аннотаций.