Determines how bridges shall be rendered during a move or drag.

Setting this property will update the bridgeUpdateMode property on the current HandleInputMode and MoveInputMode. This property can be overridden by setting the bridgeUpdateMode directly on the submodes. Also, if a new HandleInputMode or MoveInputMode is set after setting this property the new mode's bridgeUpdateMode property won't be changed.

If no BridgeManager is set as CanvasComponent.bridgeManager this setting has no effect.

One of the constants defined in class BridgeUpdateMode:

• BridgeUpdateMode.ALWAYS: the bridges will be updated during the drag.
• BridgeUpdateMode.ON_START_AND_END: the bridges will be removed before and updated after the drag.
• BridgeUpdateMode.ON_END: the bridges will be updated after the drag.

Note that bridge rendering may dramatically reduce the performance for larger graphs during a move gesture which is why it is disabled per default.

The default value is BridgeUpdateMode.ON_END.

See also

The ClickInputMode property.

If the field has not yet been initialized upon first access, the factory method createClickInputMode will be called. Upon change the onClickInputModeChanged method will be called.

Setting a new ClickInputMode is not allowed after the MainInputMode is installed and will throw an exception.

Whether the click input mode is enabled.

The default value is true.

This property can be used as the source for data binding.

The click mode priority.

The default value is 10.

Gets or sets the ICollectionModel of the IModelItem that make up the elements in the view this mode is acting upon.

The contextMenuInputMode property.

If the field has not yet been initialized upon first access, the factory method createContextMenuInputMode will be called. Upon change the onContextMenuInputModeChanged method will be called.

Setting a new ContextMenuInputMode is not allowed after the MainInputMode is installed and will throw an exception.

Whether the context menu input mode is enabled.

The default value is true.

This property can be used as the source for data binding.

The context menu mode priority.

The HandleInputMode property.

If the field has not yet been initialized upon first access, the factory method createHandleInputMode will be called. Upon change the onHandleInputModeChanged method will be called.

Setting a new HandleInputMode is not allowed after the MainInputMode is installed and will throw an exception.

Whether the handle input mode is enabled.

The default value is true.

This property can be used as the source for data binding.

The handle mode priority.

The default value is 0.

The canvas group that can be used by input modes to add temporary top-level canvas objects to.

This group should be placed in front of the content elements in the canvas object tree.

Gets or sets the input mode controller helper instance.

The input mode controller is an helper object that collects IHandle and provides meta-IMovable, IReshapeable, and IHitTestable instances that depend on the current selection and collection model.

The keyboard input mode.

Setting a new KeyboardInputMode is not allowed after the MainInputMode is installed and will throw an exception.

Whether the keyboard input mode is enabled.

The default value is true.

This property can be used as the source for data binding.

The keyboard mode priority.

The default value is 0.

The MarqueeSelectionInputMode property.

If the field has not yet been initialized upon first access, the factory method createMarqueeSelectionInputMode will be called. Upon change the onMarqueeSelectionInputModeChanged method will be called.

Setting a new MarqueeSelectionInputMode is not allowed after the MainInputMode is installed and will throw an exception.

Whether the marquee selection input mode is enabled.

The default value is true.

This property can be used as the source for data binding.

The marquee selection mode priority.

The default value is 50.

The MoveInputMode property.

If the field has not yet been initialized upon first access, the factory method createMoveInputMode will be called. Upon change the onMoveInputModeChanged method will be called.

Setting a new MoveInputMode is not allowed after the MainInputMode is installed and will throw an exception.

Whether the move input mode is enabled.

The default value is true.

This property can be used as the source for data binding.

The move mode priority.

The default value is 40.

Gets or sets the selectionModel property

The SnapContext instance which handles snapping of moving items to distinct coordinates. Setting this property to SnapContext.voidInstance will disable snapping, whereas setting it to null will make the child modes use the context from their IInputModeContexts, if available. Upon change the onSnapContextChanged method is called, which will as a side effect configure the snap context to display the SnapResults in the CanvasComponent.

The default value is null.

See also

Constructs a new input mode using the given collection of items and a selection model.

When no collection and no selection model is provided, they will be set when the input mode is installed on a GraphCanvasComponent.

Callback lookup method that will be used by the child IInputModeContext

Parameters

Clears the selection on the current selectionModel.

This implementation may be overridden for customizations. All it does is call selectionModel.clear.

Factory method for the ClickInputMode property. This method will be called upon first access to the clickInputMode property.

Factory method for the contextMenuInputMode property. This method will be called upon first access to the contextMenuInputMode property.

Factory method for the HandleInputMode property. This method will be called upon first access to the handleInputMode property.

Creates the inputModeController that will be used to coordinate the selection and the handles, etc.

The input mode controller is an helper object that collects IHandle and provides meta-IMovable, IReshapeable, and IHitTestable instances that depend on the current selection and collection model.

Factory method that creates the keyboard input mode instance.

Factory method for the marqueeSelectionInputMode property. This method will be called upon first access to the marqueeSelectionInputMode property.

Factory method for the MoveInputMode property.

This method will be called upon first access to the MoveInputMode property.

Factory method which creates and configures a MoveInputMode which can move items without selecting them first.

This input mode cannot be set with the moveInputMode but has to be added via the addConcurrent() method:

The following code adds the created input mode such that pressing the shift key will deactivate the input mode and thus restore the default behaviour (create edge on drag, move only selected items):

         var mr:Function = function( event:Event ):Boolean {
                     return event is CanvasMouseEvent && !CanvasMouseEvent(event).shiftKey;
                 };
         var moveMode:MoveInputMode = mainInputMode.createMoveUnselectedInputMode(mr);
         mainInputMode.addConcurrent(moveMode, mainInputMode.moveModePriority - 10);
         

If the created input mode should only be active when the shift key is set, set the modifierRecognizer to EventRecognizers.MOUSE_SHIFT_DOWN

Parameters

See also

Disables all submodes.

This method disables the submodes

• clickInputMode
• contextMenuInputMode
• handleInputMode
• keyboardInputMode
• marqueeSelectionInputMode
• moveInputMode

Returns an ICanvasGroupProvider instance for this input mode

Called automatically by the MXML compiler when the instance is created using an MXML tag.

This implementation does nothing.

Parameters

Installs this mode into the given context.

Installation ususally means registering some event listeners on the canvasComponent or on canvasComponent.root.

Parameters

Selects the given elements in the editor inside the provided marquee selection rectangle.

This implementation iterates over the items and queries them for an implementation of IMarqueeTestable using their ILookup.lookup. This instance will be used to determine whether the item should be selected.

Parameters

Callback that selects the elements in the editor inside the marquee selection rectangle.

This implementation iterates over all items in the CollectionModel and queries them for an implementation of IMarqueeTestable using their ILookup.lookup. This instance will be used to determine whether the item should be selected.

Parameters

Called when the clickInputMode property value changes and after initialization of the field.

Parameters

Callback that is triggered once clickInputMode triggers the ClickInputMode.CLICK event.

Parameters

Callback that gets triggered once the collectionModel property changes.

This implementation sets the new collectionModel on the inputModeController

Parameters

Called when the contextMenuInputMode property value changes

Parameters

Callback that is triggered on a CanvasContextMenuEvent

Parameters

Called when the handleInputMode property value changes and after initialization of the field.

Parameters

Called when the inputModeCanvasGroup property changes.

Parameters

Called when the keyboard input mode changed.

Parameters

Called when the marqueeSelectionInputMode property value changes and after initialization of the field.

Parameters

Callback used by MarqueeSelectionInputMode if the user has finished creating the marquee selection.

This method delegats its work to marqueeSelectElements( IRectangle )

Parameters

Called when the moveInputMode property value changes

Parameters

Callback method that will be triggered when a drag has been finished.

Parameters

Callback that gets triggered once the selectionModel property changes.

This implementation sets the new selectionModel on the inputModeController

Parameters

Parameters

Uses the selectionModel to select the given item.

Parameters

Callback that determines whether the provided IModelItem should be selected upon marquee selection.

This implementation always returns true.

Parameters

Callback method that is used for InputModeController's shouldBeMovableFunction.

This implementation always yields true.

Parameters

Callback method that is used for InputModeController's shouldShowHandlesFunction.

This implementation always yields true.

Parameters

See also