The default IHandle implementation for nodes that uses IReshapeHandler for the actual reshaping.
Remarks
In addition to the ReshapeHandlerHandle this implementation supports snapping if the node provides an INodeReshapeSnapResultProvider in its lookup and an active GraphSnapContext is found.
Furthermore orthogonal edges attached to the node are kept orthogonal during the reshape gesture if an active OrthogonalEdgeEditingContext is found.
Examples
class MyNodeReshapeHandleProvider extends NodeReshapeHandleProvider {
/**
* @param {!INode} node
* @param {!IReshapeHandler} reshapeHandler
*/
constructor(node, reshapeHandler) {
super(node, reshapeHandler, HandlePositions.CORNERS)
}
/**
* @param {!IInputModeContext} inputModeContext
* @param {!HandlePositions} position
* @returns {!IHandle}
*/
getHandle(inputModeContext, position) {
const handle = new NodeReshapeHandlerHandle(
this.node,
this.reshapeHandler,
position
)
if (position === HandlePositions.SOUTH_EAST) {
// south-east handle should always keep aspect ratio
handle.reshapePolicy = ReshapePolicy.PROJECTION
handle.ratioReshapeRecognizer = EventRecognizers.ALWAYS
}
return handle
}
}class MyNodeReshapeHandleProvider extends NodeReshapeHandleProvider {
constructor(node: INode, reshapeHandler: IReshapeHandler) {
super(node, reshapeHandler, HandlePositions.CORNERS)
}
getHandle(
inputModeContext: IInputModeContext,
position: HandlePositions
): IHandle {
const handle = new NodeReshapeHandlerHandle(
this.node,
this.reshapeHandler,
position
)
if (position === HandlePositions.SOUTH_EAST) {
// south-east handle should always keep aspect ratio
handle.reshapePolicy = ReshapePolicy.PROJECTION
handle.ratioReshapeRecognizer = EventRecognizers.ALWAYS
}
return handle
}
}Type Details
- yfiles module
- view-editor
- yfiles-umd modules
- view-editor, view-table, view
- Legacy UMD name
- yfiles.input.NodeReshapeHandlerHandle
Constructors
Default constructor that creates a handle for the given position to reshape the node using the given reshapeHandler.
Parameters
A map of options to pass to the method.
- node - INode
- The node to reshape with this handle.
- reshapeHandler - IReshapeHandler
- The reshapeable to write the changes to.
- position - HandlePositions
- The position of the handle.
Properties
Gets or sets the event recognizer that determines if the center of the reshapeable is kept during the reshape gesture.
Remarks
Signature Details
function(eventSource: any, evt: EventArgs) : boolean
Parameters
- eventSource - any
- The source of the event.
- evt - EventArgs
- The arguments of the event to be decided to handle.
Returns
- boolean
trueif theevtis considered to be handled.
Examples
// always keep the center of the node
handle.centerReshapeRecognizer = EventRecognizers.ALWAYSSee Also
Defined in
Gets a view of the center of the handle.
Remarks
Implements
Gets or sets the maximal bounds this reshapeable may fill.
Remarks
Defined in
Gets or sets the maximum size allowed for the reshapeable.
Remarks
Overrides
Gets or sets the minimum enclosed area that needs to be encompassed by this reshapeable.
Remarks
Overrides
Gets or sets the minimum size allowed for the reshapeable.
Remarks
Overrides
Gets the node to reshape with this handle.
Gets the position of the handle.
Defined in
Gets or sets the event recognizer that determines if the width/height ratio of the reshapeable is kept during the reshape gesture.
Remarks
Signature Details
function(eventSource: any, evt: EventArgs) : boolean
Parameters
- eventSource - any
- The source of the event.
- evt - EventArgs
- The arguments of the event to be decided to handle.
Returns
- boolean
trueif theevtis considered to be handled.
Examples
// always keep the aspect ratio
handle.ratioReshapeRecognizer = EventRecognizers.ALWAYSSee Also
Defined in
Gets the IReshapeHandler instance to write the changes to.
Defined in
Gets or sets the policy that determines how the mouse location is interpreted when the reshape gesture shall keep the aspect ratio.
Remarks
The ratioReshapeRecognizer is used to determine whether the aspect ratio shall be kept at all.
The default value is PROJECTION.
Examples
// when keeping the aspect ratio extend the node bounds to the mouse location
handle.reshapePolicy = ReshapePolicy.MAXIMUMDefined in
Gets or sets an INodeSizeConstraintProvider that is queried in minimumSize, maximumSize and minimumEnclosedArea if no explicit value was set.
Methods
Delegates the cancel request to the IReshapeHandler.
Parameters
A map of options to pass to the method.
- inputModeContext - IInputModeContext
- The context to retrieve information about the drag from.
- originalLocation - Point
- The value of the coordinate of the location property at the time of initializeDrag.
See Also
Overrides
Delegates the finish request to the IReshapeHandler using the last bounds calculated by handleMove.
Parameters
A map of options to pass to the method.
- inputModeContext - IInputModeContext
- The context to retrieve information about the drag from.
- originalLocation - Point
- The value of the location property at the time of initializeDrag.
- newLocation - Point
- The coordinates in the world coordinate system that the client wants the handle to be at. Depending on the implementation the location may or may not be modified to reflect the new value. This is the same value as delivered in the last invocation of handleMove
See Also
Overrides
Ignore clicks
Parameters
A map of options to pass to the method.
- evt - ClickEventArgs
- Arguments describing the click.
See Also
Implements
Translates the move request into new bounds and delegates applying the new bounds to the handleReshape method.
Remarks
Parameters
A map of options to pass to the method.
- inputModeContext - IInputModeContext
- The context to retrieve information about the drag from.
- originalLocation - Point
- The value of the location property at the time of initializeDrag.
- newLocation - Point
- The coordinates in the world coordinate system that the client wants the handle to be at. Depending on the implementation the location may or may not be modified to reflect the new value.
See Also
Overrides
Called by clients to indicate that the element is going to be dragged.
Remarks
Parameters
A map of options to pass to the method.
- inputModeContext - IInputModeContext
- The context to retrieve information about the drag from.