CurrentTool Property

Gets or sets the current Northwoods.GoXam.Tool.IDiagramTool that handles the diagram's input events.

Syntax

[Browsable(false)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
public IDiagramTool CurrentTool {get; set;}

Property Value

Initially this is set to the value of DefaultTool. Setting this to a null value is treated as if it were set to the DefaultTool, because there should always be a currently running tool, except when the diagram is being initialized.

Remarks

Setting this property to a new tool stops the previous current tool. If the old tool was Northwoods.GoXam.Tool.IDiagramTool.Active, this calls its Northwoods.GoXam.Tool.IDiagramTool.DoDeactivate method. Then it calls Northwoods.GoXam.Tool.IDiagramTool.DoStop on it.

This starts the new tool by calling Northwoods.GoXam.Tool.IDiagramTool.DoStart on it.

Normally this is a Northwoods.GoXam.Tool.ToolManager ready to select and run a mode-less tool from the lists of mouse tools (MouseDownTools, MouseMoveTools, MouseUpTools).

You can run a modal tool just by setting this property. When that tool is finished it should call Northwoods.GoXam.Tool.DiagramTool.StopTool or it can set this property to the value of DefaultTool.

Because this property is frequently set, it cannot be used as a data-binding target.

Reference

Diagram Class
Diagram Members