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

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

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

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

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

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

• Класс AnnotationViewer использует композицию AnnotationVisualTool и RectangularSelectionTool для предоставления возможности выбора нескольких аннотаций.
• Демо приложение "OCR Demo" включает составной визуальный инструмент, который обеспечивает возможность выделения распознанных слов наряду с функцией множественного выбора.