This implementation uses the hitTestable to determine where the user can begin dragging the selection. It will then use the positionHandler to delegate the actual work of moving the elements to.
If one needs to execute some code after some items have been moved by the MoveInputMode, they can register a handler to its drag-finished event. The moved items can be retrieved from the affectedItems property:
mode.moveSelectedItemsInputMode.addEventListener('drag-finished', () => { for (const item of mode.moveSelectedItemsInputMode.affectedItems) { // these items have been moved }})
The following example shows how to configure touch gestures without a long press.Configure touch gestures without long press
Client code can register with the drag-started event, as well as the drag-finished event to get notified of the elements that may be or have been affected respectively by this input mode.
readonlyfinal
Property Value
A snapshot of the current collection of the items that are affected by the move operation.
Examples
If one needs to execute some code after some items have been moved by the MoveInputMode he can register a handler to its drag-finished event. The moved items can be retrieved from the affectedItems property:
mode.moveSelectedItemsInputMode.addEventListener('drag-finished', () => { for (const item of mode.moveSelectedItemsInputMode.affectedItems) { // these items have been moved }})
Gets or sets the event recognizer that determines whether to start moving the selection via TOUCH input.
The default recognizer is TOUCH_PRIMARY_DOWN which reacts to the user making touch contact with the main touch device. Using TOUCH_PRIMARY_LONG_PRESS allows for an intuitive alternative configuration, specifically, when panning the viewport is a more frequent use-case.
Gets or sets the enabled state of this input mode.
Clients can use this property to disable or reenable this instance. This will set the enabled property of the installed controller so a disabled instance should never try to acquire the input mutex.
Examples
Disabling the MoveInputMode on its parent input mode
Gets or sets a value indicating whether this mode will be the only one running when it has the mutex.
The value of this property will be delegated to the exclusive property of the controller.
If this mode is marked as exclusive and has the mutex, all other modes added to the same MultiplexingInputMode will be deactivated. Otherwise, it will always run concurrently with all other modes.
The priority will influence the order in which the modes will be installed into the CanvasComponent. The lower the priority value, the earlier it will be installed. If two modes are using the same priority value, the first one to be registered will be installed earlier.
Gets or sets the GraphSnapContext which manages snapping model items to certain coordinates (for instance, other items).
If set to null (the default) this input mode tries to obtain the GraphSnapContext from the IInputModeContext. To explicitly disable snapping, a GraphSnapContext implementation that is disabled needs to be set.
Installs this mode into the given context that is provided by the canvas.
In general a mode can only be installed into a single canvas at all times.
This method is called to initialize this instance. Subclasses should override this method to register the corresponding event handler delegates for the various input events they need to register with.
Overriding implementations should call the base implementation first.
The context that this instance shall be installed into. The same instance will be passed to this instance during uninstall. A reference to the context may be kept and queried during the time the mode is installed.
A task that represents the asynchronous drag operation. The result of the task contains the affected items or null if the drag was canceled.
tryStop
(): boolean
Will be called to request a stop of the current editing progress.
This should stop the current edit, if one is in progress, and possibly commit all pending changes. If stopping is not possible, this method can return false
Return Value
boolean
true if and only if the editing has been stopped or there was no edit in progress
This code should clean up all changes made to the canvas in the install method. After a mode has been uninstalled it can be installed again into the same or another canvas.
Overriding implementations should call the base implementation after their own code.
If one needs to execute some code after some items have been moved by the MoveInputMode he can register a handler to its drag-finished event. The moved items can be retrieved from the affectedItems property:
mode.moveSelectedItemsInputMode.addEventListener('drag-finished', () => { for (const item of mode.moveSelectedItemsInputMode.affectedItems) { // these items have been moved }})
Occurs when a drag is recognized for the MoveInputMode.
If the event args are handled, the IPositionHandler that is carried with the event args is used to actually move the items. Otherwise the pre-set positionHandler property is used.