Class DragSelectingTool

You do not normally need to create an instance of this tool because one already exists as the ToolManager.dragSelectingTool, which you can modify.

The Tool.name of this tool is "DragSelecting".

Gets or sets the Part used as the "rubber-band selection box" that is stretched to follow the mouse, as feedback for what area will be passed to selectInRect upon a mouse-up.

Initially this is a Part containing only a simple magenta rectangular Shape. The object to be resized during dragging should be named "SHAPE". Setting this property does not raise any events.

Here is an example of changing the selection box to be a thicker bright green rectangle:

  myDiagram.toolManager.dragSelectingTool.box =
    $(go.Part,
      { layerName: "Tool", selectable: false },
      $(go.Shape,
        { name: "SHAPE", fill: null, stroke: "chartreuse", strokeWidth: 3 }));
Copy

Note that the Part should be put into a Layer that Layer.isTemporary.

Modifying this property while this tool Tool.isActive might have no effect.

Gets or sets the time in milliseconds for which the mouse must be stationary before this tool can be started. The default value is 175 milliseconds. Setting this property does not raise any events.

Gets or sets whether a selectable Part may be only partly or must be completely enclosed by the rectangle given to selectInRect. The default value is false: parts must be completely inside the rectangle. Setting this property does not raise any events.

This tool can run when the diagram allows selection, there has been delay of at least delay milliseconds after the mouse-down before a mouse-move, there has been a mouse-drag far enough away not to be a click, and there is no selectable part at the mouse-down point.

The delay required to start this tool enables both this tool and the ToolManager.panningTool to co-exist as mode-less mouse-move tools.

This method may be overridden. Please read the Introduction page on Extensions for how to override methods and how to call this base method.

This just returns a Rect stretching from the mouse-down point to the current mouse point.

This method may be overridden. Please read the Introduction page on Extensions for how to override methods and how to call this base method.

Capture the mouse and show the box.

Release the mouse and remove any box.

Update the box's position and size according to the value of computeBoxBounds.

Call selectInRect with the value of a call to computeBoxBounds.

This method changes the cursor to "wait" and raises the "ChangingSelection" DiagramEvent before calling selectInRect, and raises the "ChangedSelection" DiagramEvent afterward.

This method is called to select some parts within the area of a given rectangle.

The normal behavior is to set the diagram's selection collection to only those parts in the given rectangle according to the isPartialInclusion policy. However, if the Shift key modifier is used, no parts are deselected -- this adds to the selection the parts in the rectangle not already selected. If the Control key (Command on Mac) modifier is used, this toggles the selectedness of the parts in the rectangle. If the Control key (Command on Mac) and Shift key modifiers are both used, this deselects the parts in the rectangle.

This method may be overridden. Please read the Introduction page on Extensions for how to override methods and how to call this base method.