Central implementation of the IGraph interface.
Remarks
This implementation deals with the proper firing of events and handling of default values.
This implementation has inherent support for undoability. If the undoEngineEnabled property is set to true, changes to the structure of the graph will automatically be recorded using the UndoEngine instance that can be queried from this instance's lookup method. Clients that wish to enqueue custom undo events or that need to make non-structural changes to the graph can use the UndoEngine to do so. The current instance of UndoEngine can be queried using the lookup method of this instance. Also there are several protected methods Create...UndoUnit that will be used by this instance to create the actual undo units for structural changes in the graph's structure. If clients need to customize these units they can create a subclass of DefaultGraph and override these methods.
Finally this implementation supports grouped graphs.
Related Reading in the Developer's Guide
DefaultGraph is IGraph's default implementation as described in the section The Graph Model - IGraph.Related Programming Samples
- Graph Editor
- Shows the graph editing features of the graph component.
Type Details
- yfiles module
- view-component
- yfiles-umd modules
- All view modules
- Legacy UMD name
- yfiles.graph.DefaultGraph
See Also
Constructors
Creates a new instance of a graph that provides an ILookupDecorator for all of its entities.
Parameters
A map of options to pass to the method.
- mapperRegistry - IMapperRegistry
The mapper registry that is associated with this graph instance. This option sets the mapperRegistry property on the created object.
- undoEngineEnabled - boolean
Whether or not the UndoEngine used for this instance should be enabled. This option sets the undoEngineEnabled property on the created object.
- edgeDefaults - IEdgeDefaults
- nodeDefaults - INodeDefaults
- groupNodeDefaults - INodeDefaults
- tag - Object
- nodes - Object[]
- An array of nodes to create in this graph. Each item will be passed to the createNode method.
Properties
Gets a live view of all bends contained in this IGraph.
Gets a GraphDecorator instance for use with this graph.
Gets or sets the defaults for edges.
Remarks
See Also
Implements
Gets a view of the edges contained in this graph.
Remarks
This is a live view of the edges that always represents the current state of the graph. The same reference will be returned for each invocation.
Note that even though edges can be accessed via index, the underlying graph structure in the default IGraph implementation is a linked list and indexed access can be slow. In those cases it is recommended to store the edges in your own list, if possible. This is not necessary for the first or last element or when iterating over the edges via a foreach loop.
See Also
Implements
Gets the folding view instance associated with this IGraph or null if none is associated with it.
Remarks
See Also
Defined in
Creates a GroupingSupport instance for the graph.
Remarks
See Also
Defined in
Gets or sets the defaults for group nodes.
Remarks
See Also
Implements
Gets a view of the labels contained in this graph.
Remarks
This is a live view of the labels that always represents the current state of the graph. The same reference will be returned for each invocation.
Note that even though labels can be accessed via index, the underlying graph structure in the default IGraph implementation is a linked list and indexed access can be slow. In those cases it is recommended to store the labels in your own list, if possible. This is not necessary for the first or last element or when iterating over the labels via a foreach loop.
See Also
Implements
Gets the mapper registry that is associated with this graph instance.
Remarks
See Also
Implements
Gets or sets the defaults for normal nodes.
Remarks
See Also
Implements
Gets a view of the nodes contained in this graph.
Remarks
This is a live view of the nodes that always represents the current state of the graph. The same reference will be returned for each invocation.
Note that even though nodes can be accessed via index, the underlying graph structure in the default IGraph implementation is a linked list and indexed access can be slow. In those cases it is recommended to store the nodes in your own list, if possible. This is not necessary for the first or last element or when iterating over the nodes via a foreach loop.
See Also
Implements
Gets a view of the ports contained in this graph.
Remarks
This is a live view of the ports that always represents the current state of the graph. The same reference will be returned for each invocation.
Note that even though ports can be accessed via index, the underlying graph structure in the default IGraph implementation is a linked list and indexed access can be slow. In those cases it is recommended to store the ports in your own list, if possible. This is not necessary for the first or last element or when iterating over the ports via a foreach loop.
Implements
Gets or sets the tag associated with this instance.
Remarks
See Also
Implements
Gets the UndoEngine instance associated with this IGraph or null if none is associated with it.
Remarks
See Also
Defined in
Gets or sets whether or not the UndoEngine used for this instance should be enabled.
Remarks
false. In order to enable undoability for this instance, set this property to true and lookup the UndoEngine type. Disabling this property clears and removes the current UndoEngine (and all enqueued IUndoUnits).See Also
Overrides
Methods
Adds a bend at the given index to the given edge using the coordinates provided.
Remarks
The added instance will be returned.
To retrieve the current bends of an edge, use bends
Parameters
A map of options to pass to the method.
- edge - IEdge
- The edge to which the bend will be added.
- location - Point
- the coordinates to use for the newly created bend. To change the location after the bend has been added, use setBendLocation.
- index - number
- The index for the newly added bend; a negative value (which is the default) indicates that the bend should be appended to the end of the list of bends.
Returns
- ↪IBend
- a newly created live bend
Throws
- Exception({ name: 'ArgumentError' })
edgeis not in this graph, orlocationcontains one or more NaN values.
See Also
Implements
Adds bends with the given locations to the end of the bend list of the given edge.
Parameters
A map of options to pass to the method.
- edge - IEdge
- The edge to add the bends to.
- locations - IEnumerable<Point>
- The locations of the bends.
Throws
- Exception({ name: 'ArgumentError' })
edgeis not in this graph.- Exception({ name: 'ArgumentError' })
locationscontains one or more NaN values.
See Also
Defined in
addLabel
(owner: ILabelOwner, text: string, layoutParameter?: ILabelModelParameter, style?: ILabelStyle, preferredSize?: Size, tag?: Object) : ILabelAdd a label to the given node or edge using the text as the initial label text and label model parameter, style and tag.
Parameters
A map of options to pass to the method.
- owner - ILabelOwner
- The node, edge or port to add the label to. Note that the owner cannot be changed after the label has been added.
- text - string
- The initial text of the label. To change the text after the label has been added, use setLabelText.
- layoutParameter - ILabelModelParameter
- The label model parameter instance to use. If omitted the default parameter will be set. To change the parameter after the label has been added, use setLabelLayoutParameter.
- style - ILabelStyle
- The style to use for the label. If omitted the default style will be set. To change the style after the label has been added, use setStyle.
- preferredSize - Size
- The initial values to use for the preferredSize. If omitted size will be determined automatically. To change the preferred size after the label has been added, use setLabelPreferredSize.
- tag - Object
- The initial tag to assign.
Returns
- ↪ILabel
- the newly created label
Throws
- Exception({ name: 'ArgumentError' })
owneris not in this graph orpreferredSizecontains one or more NaN values.
See Also
Implements
Adds the chain element to the lookup for this instance.
Parameters
A map of options to pass to the method.
- lookup - IContextLookupChainLink
- The lookup to decorate the current instance with.
addPort
(owner: IPortOwner, locationParameter?: IPortLocationModelParameter, style?: IPortStyle, tag?: Object) : IPortAdd a port to the given port owner using the coordinates as the new initial position of the port anchor.
Parameters
A map of options to pass to the method.
- owner - IPortOwner
- the owner to add the port instance to.
- locationParameter - IPortLocationModelParameter
- the parameter to use for the port to determine its location.
- style - IPortStyle
- the style to assign initially to the port, e.g. INSTANCE.
- tag - Object
- The tag to associate with the port, may be
null.
Returns
- ↪IPort
- the newly created port
Throws
- Exception({ name: 'NotSupportedError' })
- If this instance cannot add a port to
owner. - Exception({ name: 'ArgumentError' })
- If
owneris not in this graph.
See Also
Implements
Add a port to the given port owner using the absolute coordinates as the new initial position of the port anchor.
Parameters
A map of options to pass to the method.
- owner - IPortOwner
- the owner to add the port instance to.
- location - Point
- the location to use for the port to determine its location. This is passed to the createDefaultPortLocationParameter method to determine the initial IPortLocationModelParameter to use.
- style - IPortStyle
- tag - Object
- the initial tag to assign.
Returns
- ↪IPort
- the newly created port
Throws
- Exception({ name: 'NotSupportedError' })
- If this instance cannot add a port to
owner. - Exception({ name: 'ArgumentError' })
owneris not in this graph.- Exception({ name: 'ArgumentError' })
locationcontains one or more NaN values.
See Also
Defined in
Adds a new port to the graph at the node using a location that is relative to the center of the node.
Remarks
Parameters
A map of options to pass to the method.
- node - INode
- The owner of the port.
- relativeLocation - Point
- The offset of the port relative to the center of the layout.
Returns
- ↪IPort
- The newly added port instance.
Throws
- Exception({ name: 'ArgumentError' })
nodeis not in this graph.- Exception({ name: 'ArgumentError' })
relativeLocationcontains one or more NaN values.
See Also
Defined in
Convenience method that uses the UndoEngine from the IGraph's ILookup to add a unit.
Parameters
A map of options to pass to the method.
- undoName - string
- The name of the undo operation.
- redoName - string
- The name of the redo operation.
- undo - function():void
- The undo action.
Signature Details
function()Encapsulates a method that has no parameters and does not return a value.Parameters
- redo - function():void
- The redo action.
Signature Details
function()Encapsulates a method that has no parameters and does not return a value.Parameters
See Also
Defined in
Method to adjust the size of a group node.
Remarks
groupNode.Parameters
A map of options to pass to the method.
- groupNode - INode
- The group node to adjust the size of.
Throws
- Exception({ name: 'ArgumentError' })
groupNodeis not in this graph.
Examples
// create a group node
const group = graph.createGroupNode()
// add some child nodes
graph.createNode(group, new Rect(10, 10, 30, 30))
graph.createNode(group, new Rect(50, 10, 30, 30))
graph.createNode(group, new Rect(50, 50, 30, 30))
// adjust the group node's layout to include all its children
graph.adjustGroupNodeLayout(group)AdjustGroupNodeLayout only affects the node it is called for. To properly adjust all of its ancestors, too, one has to adjust all of them from the given node to the root:for (const nodeToAdjust of graph.groupingSupport.getPathToRoot(
innermostGroup
)) {
graph.adjustGroupNodeLayout(nodeToAdjust)
}See Also
Defined in
Adjusts the preferredSize property of a label to fit the suggested size of its ILabelStyleRenderer.
Remarks
Parameters
A map of options to pass to the method.
- label - ILabel
- The label to adjust the size for.
See Also
Defined in
applyLayout
(layout: ILayoutAlgorithm, layoutData?: LayoutData, updateContentRect?: boolean, automaticEdgeGrouping?: boolean, configureTableLayout?: boolean, considerViewportLimiter?: boolean, fixPorts?: boolean, hideEdgesAtEdges?: boolean, portAdjustmentPolicy?: PortAdjustmentPolicy, portLabelPolicies?: ItemMapping<ILabel,PortLabelPolicy>, targetBoundsInsets?: Insets, labelPreferredPlacementPolicy?: LabelPreferredPlacementPolicy)Runs an ILayoutAlgorithm synchronously on the given graph.
Remarks
Parameters
A map of options to pass to the method.
- layout - ILayoutAlgorithm
- The layout.
- layoutData - LayoutData
- The layout data.
- updateContentRect - boolean
- A value indicating whether the content rectangle property of the CanvasComponent
- automaticEdgeGrouping - boolean
- A value indicating whether edge groups are automatically created for edges that are connected to the same port.
- configureTableLayout - boolean
- considerViewportLimiter - boolean
- A value that controls whether strong port constraints are automatically created.
- fixPorts - boolean
- A value that controls whether strong port constraints are automatically created.
- hideEdgesAtEdges - boolean
- A value that controls whether edges at other edges will be hidden from the layout graph or included.
- portAdjustmentPolicy - PortAdjustmentPolicy
- The policy that specifies how port locations should be adjusted after a layout has been calculated.
- portLabelPolicies - ItemMapping<ILabel,PortLabelPolicy>
- targetBoundsInsets - Insets
- the insets (in world coordinates) that will be added to the content rectangle when calculating the target viewport.
- labelPreferredPlacementPolicy - LabelPreferredPlacementPolicy
- The policy that specifies how edge labels should be treated by the layout algorithm.
See Also
Class.ensure(LayoutExecutor) More information.Defined in
beginEdit
<T>(undoName: string, redoName: string, items: IEnumerable<T>, provider?: function(T):IMementoSupport) : ICompoundEditStarts an ICompoundEdit that uses the memento design pattern to record changes to the items in the given items collection.
Remarks
This method uses the IMementoSupport returned by the provider to record the state of an item at the beginning of the edit and when commit is called to create an IUndoUnit that can revert the item to the recorded state and back. If no provider is given, this method uses the IMementoSupport returned by the lookup implementation of the items to record the state of an item at the beginning of the edit and when commit is called to create an IUndoUnit that can revert the item to the recorded state and back.
Calling this method will immediately enqueue an IUndoUnit into the undo queue. Subsequent additions to the queue will be added after the created instance, even if they are added to the queue before the commit method has been called.
Type Parameters
- T
- The type of the items that will be modified subsequently.
Parameters
A map of options to pass to the method.
- undoName - string
- redoName - string
- items - IEnumerable<T>
- The items that will be changed after this call and before the call to commit.
- provider - function(T):IMementoSupport
- The provider for the IMementoSupport of the
items. if the provider returnsnullfor a given item, changes to this item are not being recorded.Signature Details
function(item: T) : IMementoSupportA function that is used to retrieve an IMementoSupport for any given object.Parameters
- item - T
- The item to provide the
for.
Returns
Returns
- ↪ICompoundEdit
- An implementation of the ICompoundEdit interface whose commit or cancel methods need to be called after the items have been modified.
Examples
The following is an example implementation of an item that is being managed using IMementoSupport:
class Employee extends BaseClass(ILookup) {
_name
position
age
/**
* @param {!string} name
* @param {!string} position
* @param {number} age
*/
constructor(name, position, age) {
super()
this._name = name
this.position = position
this.age = age
}
/**
* @type {!string}
*/
get name() {
return this._name
}
/**
* @template {*} T
* @param {!Class.<T>} type
* @returns {?T}
*/
lookup(type) {
if (type === IMementoSupport.$class) {
return new EmployeeMementoSupport()
}
return null
}
}class Employee extends BaseClass<ILookup>(ILookup) implements ILookup {
_name: string
position: string
age: number
constructor(name: string, position: string, age: number) {
super()
this._name = name
this.position = position
this.age = age
}
get name(): string {
return this._name
}
@typescript-eslint/no-unnecessary-type-constraint
lookup<T extends any>(type: Class<T>): T | null {
if (type === IMementoSupport.$class) {
return new EmployeeMementoSupport() as T
}
return null
}
}A collection of items from this type can then be watched using the following code snippet:
const edit = graph.beginEdit(undoName, redoName, listWithMyEmployeesToWatch)
// changes to the employees are done here
if (!success) {
// if we don't want the changes to be done after all, then we need to cancel the edit
edit.cancel()
}Alternatively, when using a specific provider, consider the following examples. The following is an example implementation of an item that is being managed using IMementoSupport:
class SimpleEmployee {
_name
position
age
/**
* @param {!string} name
* @param {!string} position
* @param {number} age
*/
constructor(name, position, age) {
this._name = name
this.position = position
this.age = age
}
/**
* @type {!string}
*/
get name() {
return this._name
}
}class SimpleEmployee {
private readonly _name: string
position: string
age: number
constructor(name: string, position: string, age: number) {
this._name = name
this.position = position
this.age = age
}
get name(): string {
return this._name
}
}A collection of items from this type can then be watched using the following code snippet, using the provider to return an appropriate IMementoSupport implementation:
const edit = graph.beginEdit(
undoName,
redoName,
listWithMyEmployeesToWatch,
(item) => new EmployeeMementoSupport()
)
// changes to the employees are done here
if (!success) {
// if we don't want the changes to be done after all, then we need to cancel the edit
edit.cancel()
}Implementing the IMementoSupport interface is quite unrestrained, the type of the state returned by getState method can by anything as long as the applyState and stateEquals methods can deal with it:
class EmployeeMementoSupport extends BaseClass(IMementoSupport) {
/**
* @param {*} subject
* @returns {?EmployeeState}
*/
getState(subject) {
if (subject instanceof Employee) {
return new EmployeeState(subject.position, subject.age)
}
return null
}
/**
* @param {*} subject
* @param {*} state
*/
applyState(subject, state) {
if (subject instanceof Employee && state instanceof EmployeeState) {
subject.position = state.position
subject.age = state.age
}
}
/**
* @param {*} state1
* @param {*} state2
* @returns {boolean}
*/
stateEquals(state1, state2) {
if (state1 instanceof EmployeeState && state2 instanceof EmployeeState) {
return state1.position === state2.position && state1.age === state2.age
}
return state1 === state2
}
}
class EmployeeState {
_position
_age
/**
* @param {!string} position
* @param {number} age
*/
constructor(position, age) {
this._position = position
this._age = age
}
/**
* @type {!string}
*/
get position() {
return this._position
}
/**
* @type {number}
*/
get age() {
return this._age
}
}class EmployeeMementoSupport
extends BaseClass<IMementoSupport>(IMementoSupport)
implements IMementoSupport
{
getState(subject: any): EmployeeState | null {
if (subject instanceof Employee) {
return new EmployeeState(subject.position, subject.age)
}
return null
}
applyState(subject: any, state: any): void {
if (subject instanceof Employee && state instanceof EmployeeState) {
subject.position = state.position
subject.age = state.age
}
}
stateEquals(state1: any, state2: any): boolean {
if (state1 instanceof EmployeeState && state2 instanceof EmployeeState) {
return state1.position === state2.position && state1.age === state2.age
}
return state1 === state2
}
}
class EmployeeState {
_position: string
_age: number
constructor(position: string, age: number) {
this._position = position
this._age = age
}
get position(): string {
return this._position
}
get age(): number {
return this._age
}
}In summary, use this concept when you want to track the state of items during certain operations for undo/redo. This is efficient if it's easier to handle an item's state than the changes to the item themselves. If you want to focus on the changes or on certain events, you should use custom IUndoUnit
See Also
Defined in
Starts an ICompoundEdit that records graph changes and custom undo units in a single compound unit.
Remarks
This method can be used to bracket several undo units. All edits added to the queue after this call and before a call to cancel or commit will be placed into the queue as a single block.
Client code needs to make sure that either the cancel or commit method is called on the returned instance.
Parameters
A map of options to pass to the method.
- undoName - string
- The undo name for the compound edit.
- redoName - string
- The redo name for the compound edit.
Returns
See Also
Defined in
calculateLabelPreferredSize
(owner: ILabelOwner, text: string, layoutParameter?: ILabelModelParameter, style?: ILabelStyle, tag?: Object) : SizeCalculates the preferred size of a label with the given properties.
Parameters
A map of options to pass to the method.
- owner - ILabelOwner
- The item that will own the label.
- text - string
- The text.
- layoutParameter - ILabelModelParameter
- The label model parameter.
- style - ILabelStyle
- The label style.
- tag - Object
- The tag for the label.
Returns
- ↪Size
- The size as calculated by the ILabelStyleRenderer.
See Also
Defined in
Clears the graph, removing all items in proper order.
Removes all bends from the given edge.
Remarks
Parameters
A map of options to pass to the method.
- edge - IEdge
- the edge whose bends will be removed
Throws
- Exception({ name: 'ArgumentError' })
edgeis not in this graph.
See Also
Defined in
Determines whether this graph contains the specified item.
Parameters
A map of options to pass to the method.
- item - IModelItem
- The item.
Returns
- ↪boolean
trueif this graph contains the specified item; otherwise,false.
Implements
Creates the label layout parameter for a given ILabelOwner.
Remarks
Parameters
A map of options to pass to the method.
- owner - ILabelOwner
- The item that is the owner of the label in question.
Returns
- ↪ILabelModelParameter
- The default label layout parameter to use for newly created labels at the item.
See Also
Defined in
createDefaultPortLocationParameter
(owner: IPortOwner, location?: Point) : IPortLocationModelParameterCreates a location model parameter for a newly created IPort at the owner that matches the location.
Remarks
location is null, this method uses the port defaults for the owner to obtain the location parameter.Parameters
A map of options to pass to the method.
- owner - IPortOwner
- The owner of the port.
- location - Point
- The location in the world coordinate system where the port should be added.
Returns
- ↪IPortLocationModelParameter
- Either a location model parameter that matches the location, or the default parameter to use for the IPortOwner as returned by getLocationParameterInstance.
Throws
- Exception({ name: 'ArgumentError' })
locationcontains one or more NaN values.
See Also
Defined in
Creates and returns an edge that connects to the given node instances using the given style instance.
Remarks
Parameters
A map of options to pass to the method.
- source - INode
- The source node the created edge will connect to. This implementation queries the getNewSourcePort method to determine which port to use.
- target - INode
- The target node the created edge will connect to. This implementation queries the getNewSourcePort method to determine which port to use.
- style - IEdgeStyle
- The style instance that will be assigned to the newly created instance. This is done by reference.
- tag - Object
- the initial tag to assign.
- labels - string[]
- An array of labels to add to the newly created node. Each item will be passed to the addLabel method.
- ports - IPortLocationModelParameter[]
- An array of ports to add to the newly created node. Each item will be passed to the addPort method.
- bends - Point[]
- An array of bends to add to the newly created edge. Each item will be passed to the addBend method.
Returns
- ↪IEdge
- the newly created edge instance
Throws
- Exception({ name: 'ArgumentError' })
- If
sourceortargetis not in this graph.
See Also
Implements
Creates and returns an edge that connects to the given port instances.
Remarks
Parameters
A map of options to pass to the method.
- sourcePort - IPort
- The source port the created edge will connect to. To change the source port after the edge has been created, use setEdgePorts.
- targetPort - IPort
- The target port the created edge will connect to. To change the target port after the edge has been created, use setEdgePorts.
- style - IEdgeStyle
- The style instance that will be assigned to the newly created instance. This is done by reference. If omitted the default style will be set. To change the style after the edge has been created, use setStyle.
- tag - Object
- The initial value of the tag that will be assigned to the new edge.
- labels - string[]
- An array of labels to add to the newly created node. Each item will be passed to the addLabel method.
- ports - IPortLocationModelParameter[]
- An array of ports to add to the newly created node. Each item will be passed to the addPort method.
- bends - Point[]
- An array of bends to add to the newly created edge. Each item will be passed to the addBend method.
Returns
- ↪IEdge
- the newly created edge instance
See Also
Implements
Creates a new group node using the provided style and layout as a child of parent.
Remarks
The group node will be a direct descendant of parent.
To create group nodes interactively use the GraphEditorInputMode as input mode and enable the grouping operations.
Parameters
A map of options to pass to the method.
- parent - INode
- layout - Rect
- The initial layout to use for the new node. If omitted the node will be placed with its top left corner at 0,0 and the default size. To change the layout after the group node has been created, use setNodeLayout.
- style - INodeStyle
- The style to use for the new node. If omitted the default style will be set. To change the style after the group node has been created, use setStyle.
- tag - Object
- labels - string[]
- An array of labels to add to the newly created node. Each item will be passed to the addLabel method.
- ports - IPortLocationModelParameter[]
- An array of ports to add to the newly created node. Each item will be passed to the addPort method.
- children - Rect[]
- An array of nodes to create as child nodes of this group node. Each item will be passed to the createNode method.
Returns
- ↪INode
- The newly created group node.
Throws
- Exception({ name: 'ArgumentError' })
- The
layoutcontains one or more NaN values.
See Also
Implements
Creates and returns a node using the specified values for the initial geometry, style, and tag.
Remarks
Parameters
A map of options to pass to the method.
- layout - Rect
- The layout to use initially. The values will be copied to the node's Layout field. To change the layout after the node has been created, use setNodeLayout.
- style - INodeStyle
- The style instance that will be assigned to the newly created instance. This is done by reference. If omitted the default style will be set. To change the style after the node has been added, use setStyle.
- tag - Object
- The initial value of the tag that will be assigned to the new node.
- labels - string[]
- An array of labels to add to the newly created node. Each item will be passed to the addLabel method.
- ports - IPortLocationModelParameter[]
- An array of ports to add to the newly created node. Each item will be passed to the addPort method.
Returns
- ↪INode
- A newly created node instance
Throws
- Exception({ name: 'ArgumentError' })
layoutcontains one or more NaN values.
See Also
Implements
Creates a new ordinary node as a direct descendant of parent using the given layout and style.
Parameters
A map of options to pass to the method.
- parent - INode
- The node to use as the parent in the grouping hierarchy or
nullif the new node should become a top-level node. To change the parent after group node has been created, use setParent. - layout - Rect
- The layout to use initially. The values will be copied to the node's Layout field. If omitted the default size will be set and the node's top left corner will be placed at 0,0. To change the layout after the group node has been created, use setNodeLayout.
- style - INodeStyle
- The style instance that will be assigned to the newly created instance. This is done by reference. If omitted the default style will be set.
- tag - Object
- labels - string[]
- An array of labels to add to the newly created node. Each item will be passed to the addLabel method.
- ports - IPortLocationModelParameter[]
- An array of ports to add to the newly created node. Each item will be passed to the addPort method.
Returns
- ↪INode
- The newly created node.
Throws
- Exception({ name: 'ArgumentError' })
parentis not in this graph, orlayoutcontains one or more NaN values.
See Also
Implements
Creates and returns a node using the specified initial center location and style, as well as the tag.
Remarks
Parameters
A map of options to pass to the method.
- location - Point
- the initial coordinates of the center of the node's Layout property
- style - INodeStyle
- The style instance that will be assigned to the newly created instance. This is done by reference.
- tag - Object
- The initial value of the tag that will be assigned to the new node.
- labels - string[]
- An array of labels to add to the newly created node. Each item will be passed to the addLabel method.
- ports - IPortLocationModelParameter[]
- An array of ports to add to the newly created node. Each item will be passed to the addPort method.
Returns
- ↪INode
- A newly created node instance
Throws
- Exception({ name: 'ArgumentError' })
locationcontains one or more NaN values.
See Also
Defined in
Creates an UndoEngine instance that automatically triggers invalidateDisplays upon each invocation of undo and redo
Creates the edge reconnection undo unit for the given edge.
Parameters
A map of options to pass to the method.
- edge - IEdge
- The edge that has been reconnected to other ports.
- oldSource - IPort
- The old source port the edge connected to before the change.
- oldTarget - IPort
- The old target port the edge connected to before the change.
Returns
- ↪IUndoUnit
- The unit that can be used to undo and redo the port change operation.
Creates the undo unit for changing the style of the given edge.
Parameters
A map of options to pass to the method.
- edge - IEdge
- The edge whose style has been changed.
- oldStyle - IEdgeStyle
- The old style used before the change.
Returns
- ↪IUndoUnit
- The unit that can be used to undo and redo the style change.
Creates the undo unit for changing the tag of the given graph.
Creates the undo unit for changing whether the given node is a group node.
createUndoUnitForLabelModelParameterChange
(label: ILabel, oldParam: ILabelModelParameter) : IUndoUnitCreates the undo unit for changing the layout parameter of the given label.
Parameters
A map of options to pass to the method.
- label - ILabel
- The label whose layout parameter has been changed.
- oldParam - ILabelModelParameter
- The old layout parameter used before the change.
Returns
- ↪IUndoUnit
- The unit that can be used to undo and redo the layout parameter change.
Creates the undo unit for changing the style of the given label.
Parameters
A map of options to pass to the method.
- label - ILabel
- The label whose style has been changed.
- oldStyle - ILabelStyle
- The old style used before the change.
Returns
- ↪IUndoUnit
- The unit that can be used to undo and redo the style change.
Creates the undo unit for changing the tag of the given label.
Creates the undo unit for changing the text of the given label.
createUndoUnitForLocationParameterChange
(port: IPort, oldParameter: IPortLocationModelParameter) : IUndoUnitCreates the undo unit for changing the location parameter of the given port.
Parameters
A map of options to pass to the method.
- port - IPort
- The port whose location parameter has been changed.
- oldParameter - IPortLocationModelParameter
- The old location parameter used before the change.
Returns
- ↪IUndoUnit
- The unit that can be used to undo and redo the location parameter change.
Creates the undo unit for changing the style of the given node.
Parameters
A map of options to pass to the method.
- node - INode
- The node whose style has been changed.
- oldStyle - INodeStyle
- The old style used before the change.
Returns
- ↪IUndoUnit
- The unit that can be used to undo and redo the style change.
Creates the parent change undo unit for the given node.
Creates the undo unit for changing the style of the given port.
Parameters
A map of options to pass to the method.
- port - IPort
- The port whose style has been changed.
- oldStyle - IPortStyle
- The old style used before the change.
Returns
- ↪IUndoUnit
- The unit that can be used to undo and redo the style change.
Creates the undo unit for changing the preferred size of the given label.
Calculates the number of edges at the given IPortOwner for this graph.
Remarks
Parameters
A map of options to pass to the method.
- owner - IPortOwner
- The port owner to count the degree of.
Returns
- ↪number
- The number of edges that are incident to the port owner.
Throws
- Exception({ name: 'ArgumentError' })
owneris not in this graph.
See Also
Defined in
Calculates the number of edges at the given IPort for this graph.
Remarks
Parameters
A map of options to pass to the method.
- port - IPort
- The port owner to count the degree of.
Returns
- ↪number
- The number of edges that are incident to the port.
Throws
- Exception({ name: 'ArgumentError' })
portis not in this graph.
See Also
Defined in
Returns an IEnumerable<T> for all edges that are adjacent to the given port as a sourcePort or targetPort.
Remarks
foreach loop.Parameters
A map of options to pass to the method.
- port - IPort
- the port to check
- type - AdjacencyTypes
- The type of adjacency to consider.
Returns
- ↪IListEnumerable<IEdge>
- An enumeration of all adjacent edges of the given type.
Throws
- Exception({ name: 'ArgumentError' })
portis not in this graph.
See Also
Implements
Returns an IListEnumerable<T> for all edges that have the given port owner as their target port's or source port's owner depending on the AdjacencyTypes
Remarks
foreach loop.Parameters
A map of options to pass to the method.
- owner - IPortOwner
- the port owner to check
- type - AdjacencyTypes
- The type of adjacency to consider.
Returns
- ↪IListEnumerable<IEdge>
- An enumeration of all adjacent edges of the given type.
Throws
- Exception({ name: 'ArgumentError' })
owneris not in this graph.
See Also
Implements
Returns an enumerable over the children of the provided node.
Remarks
This method returns the direct children, i.e. all nodes that have node as their parent. To get all descendants method getDescendants can be used.
To make a node a child of node, use setParent or create the node directly as a child with createNode
Parameters
A map of options to pass to the method.
- node - INode
- The node for which to return the children or
nullif the top-level nodes should be returned.
Returns
- ↪IListEnumerable<INode>
- All nodes that have
nodeas their parent.
Throws
- Exception({ name: 'ArgumentError' })
nodeis not in this graph.
See Also
Implements
Finds an edge that connects from and to in the given graph.
Parameters
A map of options to pass to the method.
- from - IPortOwner
- The sourcePort owner of the edge to find.
- to - IPortOwner
- The targetPort owner of the edge to find.
Returns
- ↪IEdge
- An edge that satisfies the constraints or
null, if none was found.
Throws
- Exception({ name: 'ArgumentError' })
fromortoare not in this graph.
See Also
Defined in
Finds an edge that connects sourcePort and targetPort in the given graph.
Parameters
A map of options to pass to the method.
- sourcePort - IPort
- The sourcePort of the edge to find.
- targetPort - IPort
- The targetPort of the edge to find.
Returns
- ↪IEdge
- An edge that satisfies the constraints or
null, if none was found.
Throws
- Exception({ name: 'ArgumentError' })
sourcePortortargetPortare not in this graph.
See Also
Defined in
Gets the label defaults for a given ILabelOwner in the context of the graph.
Parameters
A map of options to pass to the method.
- owner - ILabelOwner
- The item that the label defaults are returned for. If this is a group node, the groupNodeDefaults's label defaults will be returned, otherwise the nodeDefaults or edgeDefaults labels will be returned.
Returns
- ↪ILabelDefaults
- Appropriate ILabelDefaults for the provided
owner.
Defined in
Determines a IPort instance to use for the creation of a new edge that starts at the given IPortOwner.
Remarks
Parameters
A map of options to pass to the method.
- source - IPortOwner
- The source node to find a port for.
Returns
- ↪IPort
- The port to use for a newly created edge.
See Also
Determines a IPort instance to use for the creation of a new edge that ends at the given IPortOwner.
Remarks
Parameters
A map of options to pass to the method.
- targetOwner - IPortOwner
- The target node to find a port for.
Returns
- ↪IPort
- The port to use for a newly created edge.
See Also
Returns the parent node of the node or null if node is a top-level node.
Gets the port defaults for a given IPortOwner in the context of the graph.
Parameters
A map of options to pass to the method.
- owner - IPortOwner
- The item that the label defaults are returned for. If this is a group node, the groupNodeDefaults's port defaults will be returned, otherwise the nodeDefaults or edgeDefaults ports will be returned.
Returns
- ↪IPortDefaults
- Appropriate IPortDefaults for the provided
owner.
Defined in
Groups the nodes in children into the provided group node.
Remarks
parent needs to be a group node at the time of the invocation. This operation is basically the same as calling setParent for each node in children whose parent is not part of the set.// create some nodes
const children = []
for (let i = 0; i < 5; i++) {
children.push(graph.createNode())
}
// create a group node
const parent = graph.createGroupNode()
// add the nodes as children to the group
graph.groupNodes(parent, children)
// adjust the group node's layout to include all its children
graph.adjustGroupNodeLayout(parent)Parameters
A map of options to pass to the method.
- parent - INode
- The node to use as the parent in the grouping hierarchy.
- children - IEnumerable<INode>
- The children to group into the group node.
Throws
- Exception({ name: 'ArgumentError' })
parentor one ofchildrenis not in this graph.
See Also
Defined in
Groups the nodes in children into a newly created group node.
Remarks
children.// create some nodes
const children = []
for (let i = 0; i < 5; i++) {
children.push(graph.createNode())
}
// create a group node and add the given nodes as children
const group = graph.groupNodes(children)
// adjust the group node's layout to include all its children
graph.adjustGroupNodeLayout(group)Parameters
A map of options to pass to the method.
- children - IEnumerable<INode>
- The children to group into the new group node.
- labels - string[]
- An array of labels to add to the newly created node. Each item will be passed to the addLabel method.
- ports - IPortLocationModelParameter[]
- An array of ports to add to the newly created node. Each item will be passed to the addPort method.
Returns
- ↪INode
- The newly created group node.
Throws
- Exception({ name: 'ArgumentError' })
- One of
childrenis not in this graph.
See Also
Defined in
Calculates the number of incoming edges at the given IPortOwner for this graph.
Parameters
A map of options to pass to the method.
- owner - IPortOwner
- The port owner to count the incoming edges of.
Returns
- ↪number
- The number of edges that have the port owner as their target port's owner.
Throws
- Exception({ name: 'ArgumentError' })
owneris not in this graph.
See Also
Defined in
Calculates the number of incoming edges at the given IPort for this graph.
Convenience method that yields the incoming edges at the given owner.
Remarks
This method delegates to edgesAt using INCOMING.
Note that even though edges can be accessed via index, the underlying graph structure in the default IGraph implementation is a linked list and indexed access can be slow. In those cases it is recommended to store the edges in your own list, if possible. This is not necessary for the first or last element or when iterating over the incoming edges via a foreach loop.
Parameters
A map of options to pass to the method.
- owner - IPortOwner
- The owner of the edges.
Returns
- ↪IListEnumerable<IEdge>
- An enumerable for the edges.
Throws
- Exception({ name: 'ArgumentError' })
owneris not in this graph.
See Also
Defined in
Convenience method that yields the incoming edges at the given port.
Remarks
This method delegates to edgesAt using INCOMING.
Note that even though edges can be accessed via index, the underlying graph structure in the default IGraph implementation is a linked list and indexed access can be slow. In those cases it is recommended to store the edges in your own list, if possible. This is not necessary for the first or last element or when iterating over the incoming edges via a foreach loop.
Parameters
A map of options to pass to the method.
- port - IPort
- The port of the edges.
Returns
- ↪IListEnumerable<IEdge>
- An enumerable for the edges.
Throws
- Exception({ name: 'ArgumentError' })
portis not in this graph.
See Also
Defined in
The last element in the lookup chain is implemented by this method.
Triggers the DisplaysInvalidated event.
Remarks
Implements
Returns whether the given node is a group node.
Remarks
Parameters
A map of options to pass to the method.
- node - INode
- The node to check.
Returns
- ↪boolean
- Whether the node is considered a group node.
Throws
- Exception({ name: 'ArgumentError' })
nodeis not in this graph.
See Also
Implements
Returns an instance that provides another aspect of this instance of the given type or null.
Remarks
null implementations for the types, nor does it have to return the same instance any time. Also it depends on the type and context whether the instance returned stays up to date or needs to be re-obtained for subsequent use. This implementation uses the set lookup implementation if it has been set or an internal lookup chain, that can be customized using the addLookup and removeLookup methods.Type Parameters
- T: any
Parameters
A map of options to pass to the method.
- type - Class<T>
- the type for which an instance shall be returned
Returns
- ↪T
- An instance that is assignable to type or
null
See Also
Implements
Enumerates the neighbors of a given INode.
Remarks
Parameters
A map of options to pass to the method.
- node - INode
- The node.
Returns
- ↪IEnumerable<INode>
- An enumerable over all neighbors.
Throws
- Exception({ name: 'ArgumentError' })
nodeis not in this graph.
See Also
Defined in
Called when a port is going to be added to a node.
Parameters
A map of options to pass to the method.
- owner - IPortOwner
- The node.
- port - IPort
- The port to be added.
Called after a bend location has changed.
Remarks
Parameters
A map of options to pass to the method.
Called just after a bend has been removed from its edge.
Called after a bend tag has changed.
Remarks
Parameters
A map of options to pass to the method.
Called before an edge style is being changed.
Parameters
A map of options to pass to the method.
- edge - IEdge
- An edge whose the style is going to be changed.
- newStyle - IEdgeStyle
- The new edge style.
Called before the layoutParameter of a label is being changed.
Parameters
A map of options to pass to the method.
- label - ILabel
- A label whose layoutParameter is to be changed.
- newLayoutParameter - ILabelModelParameter
- The new label model parameter
Called before a label style is being changed.
Parameters
A map of options to pass to the method.
- label - ILabel
- A label whose the style is going to be changed.
- newStyle - ILabelStyle
- The new label style.
Called before a node style is being changed.
Parameters
A map of options to pass to the method.
- node - INode
- A node whose the style is going to be changed.
- newStyle - INodeStyle
- The new node style.
onChangingPortLocationModelParameter
(port: IPort, newLocationParameter: IPortLocationModelParameter)Called before the locationParameter of a port is being changed.
Parameters
A map of options to pass to the method.
- port - IPort
- A port whose locationParameter is to be changed.
- newLocationParameter - IPortLocationModelParameter
- The new location model parameter
Called before a port style is being changed.
Parameters
A map of options to pass to the method.
- port - IPort
- A port whose the style is going to be changed.
- newStyle - IPortStyle
- The new port style.
Called before the edge is added to this graph's structure.
Triggers the EdgeCreated event.
Parameters
A map of options to pass to the method.
- edge - IEdge
- The edge that has been created.
Called after a label has been added to an edge.
Remarks
This method triggers the LabelAdded event.
When overriding this method it is mandatory to call the base implementation.
Parameters
A map of options to pass to the method.
- label - ILabel
- The label that has just been added.
Called after an edge label has been removed from its edge.
Remarks
Parameters
A map of options to pass to the method.
- owner - ILabelOwner
- The previous owner of the label.
- label - ILabel
- The label that has just been removed.
Called after the ports of an edge has changed.
Remarks
Parameters
A map of options to pass to the method.
Triggers the EdgeRemoved event.
Called after the style of an edge has changed.
Remarks
Parameters
A map of options to pass to the method.
- edge - IEdge
- The edge whose style that has changed.
- oldStyle - IEdgeStyle
- The edge style before the change
Called after the tag of an edge has changed.
Remarks
Parameters
A map of options to pass to the method.
Triggers the GraphTagChanged event.
Parameters
A map of options to pass to the method.
- oldTag - Object
- The graph tag before the change.
Triggers the DisplaysInvalidated event.
Parameters
A map of options to pass to the method.
- evt - EventArgs
- The event arguments.
Called after a label model parameter has changed.
Remarks
Parameters
A map of options to pass to the method.
- label - ILabel
- The label whose model parameter has changed.
- oldLayoutParamater - ILabelModelParameter
- The label model parameter before the change
Called after the preferred size of a label has changed.
Remarks
Parameters
A map of options to pass to the method.
Called after a label style has changed.
Remarks
Parameters
A map of options to pass to the method.
- label - ILabel
- The label whose style has changed.
- oldStyle - ILabelStyle
- The label style before the change.
Called after a label tag has changed.
Remarks
Parameters
A map of options to pass to the method.
Called after a label text has changed.
Remarks
Parameters
A map of options to pass to the method.
- label - ILabel
- The label whose text has changed.
- oldText - string
- The label text before the change.
Triggers the NodeCreated event.
Parameters
A map of options to pass to the method.
- node - INode
- The node that has been created.
Called after a label has been added to a node.
Remarks
This method triggers the LabelAdded event.
When overriding this method it is mandatory to call the base implementation.
Parameters
A map of options to pass to the method.
- label - ILabel
- The label that has just been added.
Called after a label has been removed from its node.
Remarks
Parameters
A map of options to pass to the method.
- owner - ILabelOwner
- The old owner of the label.
- label - ILabel
- The label that has just been removed.
Called after a node layout has changed.
Remarks
Parameters
A map of options to pass to the method.
Triggers the NodeRemoved event.
Called after a node style has changed.
Remarks
Parameters
A map of options to pass to the method.
- node - INode
- The node whose style has changed.
- oldStyle - INodeStyle
- The node style before the change
Called after a node tag has changed.
Remarks
Parameters
A map of options to pass to the method.
Called after a label has been added to a port.
Remarks
This method triggers the LabelAdded event.
When overriding this method it is mandatory to call the base implementation.
Parameters
A map of options to pass to the method.
- label - ILabel
- The label that has just been added.
Called after a port label has been removed from its port.
Remarks
Parameters
A map of options to pass to the method.
- owner - ILabelOwner
- The old owner of the label.
- label - ILabel
- The label that has just been removed.
Called after a port location model parameter has changed.
Remarks
Parameters
A map of options to pass to the method.
- port - IPort
- The port whose location model parameter has changed.
- oldLocationParameter - IPortLocationModelParameter
- The port location model parameter before the change
Called just after a port has been removed from its owner.
Remarks
Parameters
A map of options to pass to the method.
- oldOwner - IPortOwner
- The previous owner of the port.
- port - IPort
- The port that has been removed.
Called after a port style has changed.
Remarks
Parameters
A map of options to pass to the method.
- port - IPort
- The port whose style has changed.
- oldStyle - IPortStyle
- The port style before the change
Called after a port tag has changed.
Remarks
Parameters
A map of options to pass to the method.
Called just before an edge label is removed from its edge.
Called just before a node label is removed from its node.
Called just before a port label is removed from its port.
Calculates the number of outgoing edges at the given IPortOwner for this graph.
Parameters
A map of options to pass to the method.
- owner - IPortOwner
- The port owner to count the outgoing edges of.
Returns
- ↪number
- The number of edges that have the port owner as their source port's owner.
Throws
- Exception({ name: 'ArgumentError' })
owneris not in this graph.
See Also
Defined in
Calculates the number of outgoing edges at the given IPort for this graph.
Convenience method that yields the outgoing edges at the given owner.
Remarks
This method delegates to edgesAt using OUTGOING.
Note that even though edges can be accessed via index, the underlying graph structure in the default IGraph implementation is a linked list and indexed access can be slow. In those cases it is recommended to store the edges in your own list, if possible. This is not necessary for the first or last element or when iterating over the outgoing edges via a foreach loop.
Parameters
A map of options to pass to the method.
- owner - IPortOwner
- The owner of the edges.
Returns
- ↪IListEnumerable<IEdge>
- An enumerable for the edges.
Throws
- Exception({ name: 'ArgumentError' })
owneris not in this graph.
See Also
Defined in
Convenience method that yields the outgoing edges at the given port.
Remarks
This method delegates to edgesAt using OUTGOING.
Note that even though edges can be accessed via index, the underlying graph structure in the default IGraph implementation is a linked list and indexed access can be slow. In those cases it is recommended to store the edges in your own list, if possible. This is not necessary for the first or last element or when iterating over the outgoing edges via a foreach loop.
Parameters
A map of options to pass to the method.
- port - IPort
- The owner of the edges.
Returns
- ↪IListEnumerable<IEdge>
- An enumerable for the edges.
Throws
- Exception({ name: 'ArgumentError' })
portis not in this graph.
See Also
Defined in
Enumerates the predecessors of a given INode.
Remarks
Parameters
A map of options to pass to the method.
- node - INode
- The node.
Returns
- ↪IEnumerable<INode>
- An enumerable over all predecessors.
Throws
- Exception({ name: 'ArgumentError' })
nodeis not in this graph.
See Also
Defined in
Removes the given item from this graph.
Remarks
The item must be a part of this graph.
If the item is a node the NodeRemoved event will be triggered. This will remove all adjacent edges and their corresponding ports in proper order before the node will be removed. Also this will trigger the removal of all labels owned by this instance.
If the item is an edge the EdgeRemoved event will be triggered. Also this will trigger the removal of all labels and bends owned by this instance. An implementation may decide to remove the corresponding ports from the node if no other edge connects to them after the given edge has been removed. The implementations provided by yFiles do so according to the value set to autoCleanUp in their IPortDefaults.
If the item is a bend the BendRemoved event will be triggered.
If the item is a port the PortRemoved event will be triggered. This will also remove all edges that are currently connected to the port and all labels and bends owned by this instance.
If the item is a label the LabelRemoved event will be triggered.
Parameters
A map of options to pass to the method.
- item - IModelItem
- the item to be removed from this graph instance
Throws
- Exception({ name: 'ArgumentError' })
itemis not in this graph.
See Also
Implements
Removes a previously added lookup chain element from the lookup of this.
Parameters
A map of options to pass to the method.
- lookup - IContextLookupChainLink
- The element to remove.
Reverses an edge by setting source and target port to targetPort and sourcePort.
Remarks
Parameters
A map of options to pass to the method.
- edge - IEdge
- The edge to reverse.
Throws
- Exception({ name: 'ArgumentError' })
edgeis not in this graph.
See Also
Defined in
Modifies the location of the given bend.
Remarks
Parameters
A map of options to pass to the method.
- bend - IBend
- the bend whose location is to be modified
- location - Point
- the new coordinates of the bend
Throws
- Exception({ name: 'ArgumentError' })
- If
bendis not in this graph.
See Also
Implements
Sets the ports of the given edge to the new values.
Remarks
Parameters
A map of options to pass to the method.
- edge - IEdge
- The edge to change the ports.
- sourcePort - IPort
- The new source port instance.
- targetPort - IPort
- The new target port instance.
Throws
- Exception({ name: 'ArgumentError' })
- Either
edge,sourcePort, ortargetPortare not in this graph.
See Also
Implements
Changes whether the given node is a group node or not.
Remarks
Group nodes are nodes which can have children. They may not necessarily have to, however.
Attempting to set a node to the non-group-node-status while it has children at the same time will result in an InvalidOperationError.
Parameters
A map of options to pass to the method.
- node - INode
- The node to set the group node status for.
- isGroupNode - boolean
- Whether to make the node a group node.
Throws
- Exception({ name: 'ArgumentError' })
nodeis not in this graph.- Exception({ name: 'InvalidOperationError' })
nodeisnullor currently has children andisGroupNodeisfalse.
See Also
Implements
Sets the label model parameter for the given label.
Remarks
Parameters
A map of options to pass to the method.
- label - ILabel
- The label.
- layoutParameter - ILabelModelParameter
- The new parameter.
Throws
- Exception({ name: 'ArgumentError' })
labelis not in this graph, orlayoutParametercannot be used forlabel.
See Also
Implements
Sets the preferred size of the label.
Remarks
Parameters
A map of options to pass to the method.
Throws
- Exception({ name: 'ArgumentError' })
labelis not in this graph orpreferredSizecontains one or more NaN values.
See Also
Implements
Sets the label text of the given label.
Remarks
Parameters
A map of options to pass to the method.
- label - ILabel
- the label to modify
- text - string
- the new text of the label
Throws
- Exception({ name: 'ArgumentError' })
- If
labelis not in this graph. - Exception({ name: 'ArgumentError' })
- If
textisnull.
See Also
Implements
Sets the center of a node to the given world coordinates.
Remarks
Parameters
A map of options to pass to the method.
- node - INode
- The node to recenter.
- center - Point
- The new center coordinates of the node in the world coordinate system.
Throws
- Exception({ name: 'ArgumentError' })
centercontains one or more NaN values.
See Also
Defined in
Sets the layout of the given node to the new values.
Remarks
Parameters
A map of options to pass to the method.
- node - INode
- a live node that belongs to this graph
- layout - Rect
- the new absolute layout in world coordinates of the node
Throws
- Exception({ name: 'ArgumentError' })
nodeis not in this graph, orlayoutcontains one or more NaN values.
See Also
Implements
Sets the parent node for a given node.
Remarks
Use null as parent to make node a top-level node for this graph.
This method does not move or enlarge the parent to enclose its new node. Developers have to take care to adjust the node layout after grouping, e.g. by calling adjustGroupNodeLayout.
If parent is not a group node before the call it will be converted into one.
To query the parent of a node, use getParent.
Parameters
A map of options to pass to the method.
- node - INode
- The node to assign a new parent.
- parent - INode
- The parent group node to assign to
nodeornullto makenodea top-level node.
Throws
- Exception({ name: 'ArgumentError' })
- Either
nodeorparentare not in this graph.
See Also
Implements
Convenience method that tries to set the absolute coordinates of the given port to the given values.
Remarks
Parameters
A map of options to pass to the method.
Throws
- Exception({ name: 'ArgumentError' })
portis not in this graph.- Exception({ name: 'ArgumentError' })
locationcontains one or more NaN values.
See Also
Defined in
Sets a new IPortLocationModelParameter for the given port.
Remarks
Parameters
A map of options to pass to the method.
- port - IPort
- The port to modify
- locationParameter - IPortLocationModelParameter
- the new parameter that determines the coordinates of the port
Throws
- Exception({ name: 'ArgumentError' })
portis not in this graph, orlocationParametercannot be used forport.
See Also
Implements
Tries to set the location of the port relative to its owner if the owner is a node.
Remarks
Parameters
A map of options to pass to the method.
- port - IPort
- the port
- relativeLocation - Point
- the new coordinate offsets relative to the center of the node's layout's center.
Throws
- Exception({ name: 'ArgumentError' })
portis not in this graph or has no owner.- Exception({ name: 'ArgumentError' })
relativeLocationcontains one or more NaN values.
See Also
Defined in
Assigns the given style instance by reference to the node.
Remarks
Parameters
A map of options to pass to the method.
- node - INode
- The node that will be assigned the new style
- style - INodeStyle
- The style instance that will be assigned to the node.
Throws
- Exception({ name: 'ArgumentError' })
- If
nodeis not in this graph. - Exception({ name: 'ArgumentError' })
- If
styleisnull.
See Also
Implements
Assigns the given style instance by reference to the label.
Remarks
Style instances can be shared.
This implementation will adjust the preferred size for the label if autoAdjustPreferredSize is enabled.
Parameters
A map of options to pass to the method.
- label - ILabel
- The label that will be assigned the new style
- style - ILabelStyle
- The style instance that will be assigned to the label.
Throws
- Exception({ name: 'ArgumentError' })
- If
labelis not in this graph. - Exception({ name: 'ArgumentError' })
- If
styleisnull.
See Also
Implements
Assigns the given style instance by reference to the edge.
Remarks
Style instances can be shared.
To query the edge style, use style.
Parameters
A map of options to pass to the method.
- edge - IEdge
- The edge that will be assigned the new style
- style - IEdgeStyle
- The style instance that will be assigned to the edge.
Throws
- Exception({ name: 'ArgumentError' })
edgeis not in this graph.
See Also
Implements
Assigns the given style instance by reference to the port.
Remarks
Style instances can be shared.
To query the port style, use style.
Parameters
A map of options to pass to the method.
- port - IPort
- The port that will be assigned the new style
- style - IPortStyle
- The style instance that will be assigned to the port.
Throws
- Exception({ name: 'ArgumentError' })
portis not in this graph.
See Also
Implements
Enumerates the successors of a given INode.
Remarks
Parameters
A map of options to pass to the method.
- node - INode
- The node.
Returns
- ↪IEnumerable<INode>
- An enumerable over all successors.
Throws
- Exception({ name: 'ArgumentError' })
nodeis not in this graph.
See Also
Defined in
Events
Occurs when a bend has been added to an edge in this graph.
Remarks
See Also
Overrides
Event Registration
addBendAddedListener(function(this, ItemEventArgs<IBend>):void)Event Deregistration
removeBendAddedListener(function(this, ItemEventArgs<IBend>):void)Signature Details
function(sender: this, evt: ItemEventArgs<IBend>)
Parameters
- sender - this
- The source of the event.
- evt - ItemEventArgs<IBend>
- An object that contains the event data.
Occurs when the location of a bend has been changed.
Remarks
See Also
Overrides
Event Registration
Event Deregistration
Occurs when a bend has been removed from an edge in this graph.
Remarks
This event will be triggered, too, if an edge has been removed from the graph, for each of the bends that belonged to the edge.
This event is intended to provide notification of low level changes in the graph structure. Please use the DeletedItem event if you are interested only in bend removal events that result from user interaction.
See Also
Overrides
Event Registration
addBendRemovedListener(function(this, BendEventArgs):void)Event Deregistration
removeBendRemovedListener(function(this, BendEventArgs):void)Signature Details
function(sender: this, evt: BendEventArgs)
Parameters
- sender - this
- The source of the event.
- evt - BendEventArgs
- An object that contains the event data.
Occurs when the tag of a bend has been replaced.
Remarks
See Also
Overrides
Event Registration
addBendTagChangedListener(function(this, ItemChangedEventArgs<IBend,Object>):void)Event Deregistration
removeBendTagChangedListener(function(this, ItemChangedEventArgs<IBend,Object>):void)Signature Details
function(sender: this, evt: ItemChangedEventArgs<IBend,Object>)
Parameters
- sender - this
- The source of the event.
- evt - ItemChangedEventArgs<IBend,Object>
- An object that contains the event data.
Occurs when the graph has changed visually and the display should be updated to reflect the changes.
Occurs when an edge has been created.
Remarks
See Also
Overrides
Event Registration
addEdgeCreatedListener(function(this, ItemEventArgs<IEdge>):void)Event Deregistration
removeEdgeCreatedListener(function(this, ItemEventArgs<IEdge>):void)Signature Details
function(sender: this, evt: ItemEventArgs<IEdge>)
Parameters
- sender - this
- The source of the event.
- evt - ItemEventArgs<IEdge>
- An object that contains the event data.
Occurs when an edge had its sourcePort or targetPort changed.
Remarks
See Also
Overrides
Event Registration
addEdgePortsChangedListener(function(this, EdgeEventArgs):void)Event Deregistration
removeEdgePortsChangedListener(function(this, EdgeEventArgs):void)Signature Details
function(sender: this, evt: EdgeEventArgs)
Parameters
- sender - this
- The source of the event.
- evt - EdgeEventArgs
- An object that contains the event data.
Occurs when an edge has been removed.
Remarks
This event will be triggered, too, prior to a node removal.
This event is intended to provide notification of low level changes in the graph structure. Please use the DeletedItem event if you are interested only in edge removal events that result from user interaction.
See Also
Overrides
Event Registration
addEdgeRemovedListener(function(this, EdgeEventArgs):void)Event Deregistration
removeEdgeRemovedListener(function(this, EdgeEventArgs):void)Signature Details
function(sender: this, evt: EdgeEventArgs)
Parameters
- sender - this
- The source of the event.
- evt - EdgeEventArgs
- An object that contains the event data.
Occurs when an edge style has been replaced.
Remarks
See Also
Overrides
Event Registration
addEdgeStyleChangedListener(function(this, ItemChangedEventArgs<IEdge,IEdgeStyle>):void)Event Deregistration
removeEdgeStyleChangedListener(function(this, ItemChangedEventArgs<IEdge,IEdgeStyle>):void)Signature Details
function(sender: this, evt: ItemChangedEventArgs<IEdge,IEdgeStyle>)
Parameters
- sender - this
- The source of the event.
- evt - ItemChangedEventArgs<IEdge,IEdgeStyle>
- An object that contains the event data.
Occurs when the tag of an edge has been replaced.
Remarks
See Also
Overrides
Event Registration
addEdgeTagChangedListener(function(this, ItemChangedEventArgs<IEdge,Object>):void)Event Deregistration
removeEdgeTagChangedListener(function(this, ItemChangedEventArgs<IEdge,Object>):void)Signature Details
function(sender: this, evt: ItemChangedEventArgs<IEdge,Object>)
Parameters
- sender - this
- The source of the event.
- evt - ItemChangedEventArgs<IEdge,Object>
- An object that contains the event data.
Occurs when the tag of the graph has been replaced.
Remarks
See Also
Overrides
Event Registration
addGraphTagChangedListener(function(this, ItemChangedEventArgs<IGraph,Object>):void)Event Deregistration
removeGraphTagChangedListener(function(this, ItemChangedEventArgs<IGraph,Object>):void)Signature Details
function(sender: this, evt: ItemChangedEventArgs<IGraph,Object>)
Parameters
- sender - this
- The source of the event.
- evt - ItemChangedEventArgs<IGraph,Object>
- An object that contains the event data.
Occurs if the group node status of a node has changed.
See Also
Overrides
Event Registration
addIsGroupNodeChangedListener(function(this, NodeEventArgs):void)Event Deregistration
removeIsGroupNodeChangedListener(function(this, NodeEventArgs):void)Signature Details
function(sender: this, evt: NodeEventArgs)
Parameters
- sender - this
- The source of the event.
- evt - NodeEventArgs
- An object that contains the event data.
Occurs when a label has been added to this graph instance.
Remarks
See Also
Overrides
Event Registration
addLabelAddedListener(function(this, ItemEventArgs<ILabel>):void)Event Deregistration
removeLabelAddedListener(function(this, ItemEventArgs<ILabel>):void)Signature Details
function(sender: this, evt: ItemEventArgs<ILabel>)
Parameters
- sender - this
- The source of the event.
- evt - ItemEventArgs<ILabel>
- An object that contains the event data.
Occurs when the model parameter of a label has been changed.
Remarks
See Also
Overrides
Event Registration
addLabelLayoutParameterChangedListener(function(this, ItemChangedEventArgs<ILabel,ILabelModelParameter>):void)Event Deregistration
removeLabelLayoutParameterChangedListener(function(this, ItemChangedEventArgs<ILabel,ILabelModelParameter>):void)Signature Details
function(sender: this, evt: ItemChangedEventArgs<ILabel,ILabelModelParameter>)
Parameters
- sender - this
- The source of the event.
- evt - ItemChangedEventArgs<ILabel,ILabelModelParameter>
- An object that contains the event data.
Occurs when the preferred size of a label has been changed.
Remarks
See Also
Overrides
Event Registration
addLabelPreferredSizeChangedListener(function(this, ItemChangedEventArgs<ILabel,Size>):void)Event Deregistration
removeLabelPreferredSizeChangedListener(function(this, ItemChangedEventArgs<ILabel,Size>):void)Signature Details
function(sender: this, evt: ItemChangedEventArgs<ILabel,Size>)
Parameters
- sender - this
- The source of the event.
- evt - ItemChangedEventArgs<ILabel,Size>
- An object that contains the event data.
Occurs when a label has been removed from this graph instance.
Remarks
This event will also be triggered, prior to the removal of the owner of the label.
This event is intended to provide notification of low level changes in the graph structure. Please use the DeletedItem event if you are interested only in label removal events that result from user interaction.
See Also
Overrides
Event Registration
addLabelRemovedListener(function(this, LabelEventArgs):void)Event Deregistration
removeLabelRemovedListener(function(this, LabelEventArgs):void)Signature Details
function(sender: this, evt: LabelEventArgs)
Parameters
- sender - this
- The source of the event.
- evt - LabelEventArgs
- An object that contains the event data.
Occurs when a label style has been replaced.
Remarks
See Also
Overrides
Event Registration
addLabelStyleChangedListener(function(this, ItemChangedEventArgs<ILabel,ILabelStyle>):void)Event Deregistration
removeLabelStyleChangedListener(function(this, ItemChangedEventArgs<ILabel,ILabelStyle>):void)Signature Details
function(sender: this, evt: ItemChangedEventArgs<ILabel,ILabelStyle>)
Parameters
- sender - this
- The source of the event.
- evt - ItemChangedEventArgs<ILabel,ILabelStyle>
- An object that contains the event data.
Occurs when the tag of a label has been replaced.
Remarks
See Also
Overrides
Event Registration
addLabelTagChangedListener(function(this, ItemChangedEventArgs<ILabel,Object>):void)Event Deregistration
removeLabelTagChangedListener(function(this, ItemChangedEventArgs<ILabel,Object>):void)Signature Details
function(sender: this, evt: ItemChangedEventArgs<ILabel,Object>)
Parameters
- sender - this
- The source of the event.
- evt - ItemChangedEventArgs<ILabel,Object>
- An object that contains the event data.
Occurs when the text of a label has been changed.
Remarks
See Also
Overrides
Event Registration
addLabelTextChangedListener(function(this, ItemChangedEventArgs<ILabel,string>):void)Event Deregistration
removeLabelTextChangedListener(function(this, ItemChangedEventArgs<ILabel,string>):void)Signature Details
function(sender: this, evt: ItemChangedEventArgs<ILabel,string>)
Parameters
- sender - this
- The source of the event.
- evt - ItemChangedEventArgs<ILabel,string>
- An object that contains the event data.
Occurs when a node has been created.
Remarks
See Also
Overrides
Event Registration
addNodeCreatedListener(function(this, ItemEventArgs<INode>):void)Event Deregistration
removeNodeCreatedListener(function(this, ItemEventArgs<INode>):void)Signature Details
function(sender: this, evt: ItemEventArgs<INode>)
Parameters
- sender - this
- The source of the event.
- evt - ItemEventArgs<INode>
- An object that contains the event data.
Occurs when a node layout has been changed.
Remarks
See Also
Overrides
Event Registration
Event Deregistration
Occurs when a node has been removed.
Remarks
See Also
Overrides
Event Registration
addNodeRemovedListener(function(this, NodeEventArgs):void)Event Deregistration
removeNodeRemovedListener(function(this, NodeEventArgs):void)Signature Details
function(sender: this, evt: NodeEventArgs)
Parameters
- sender - this
- The source of the event.
- evt - NodeEventArgs
- An object that contains the event data.
Occurs when a node style has been replaced.
Remarks
See Also
Overrides
Event Registration
addNodeStyleChangedListener(function(this, ItemChangedEventArgs<INode,INodeStyle>):void)Event Deregistration
removeNodeStyleChangedListener(function(this, ItemChangedEventArgs<INode,INodeStyle>):void)Signature Details
function(sender: this, evt: ItemChangedEventArgs<INode,INodeStyle>)
Parameters
- sender - this
- The source of the event.
- evt - ItemChangedEventArgs<INode,INodeStyle>
- An object that contains the event data.
Occurs when the tag of a node has been replaced.
Remarks
See Also
Overrides
Event Registration
addNodeTagChangedListener(function(this, ItemChangedEventArgs<INode,Object>):void)Event Deregistration
removeNodeTagChangedListener(function(this, ItemChangedEventArgs<INode,Object>):void)Signature Details
function(sender: this, evt: ItemChangedEventArgs<INode,Object>)
Parameters
- sender - this
- The source of the event.
- evt - ItemChangedEventArgs<INode,Object>
- An object that contains the event data.
Occurs if a node has been reparented in the model.
See Also
Overrides
Event Registration
addParentChangedListener(function(this, NodeEventArgs):void)Event Deregistration
removeParentChangedListener(function(this, NodeEventArgs):void)Signature Details
function(sender: this, evt: NodeEventArgs)
Parameters
- sender - this
- The source of the event.
- evt - NodeEventArgs
- An object that contains the event data.
Occurs when a port has been added to this graph instance.
Remarks
See Also
Overrides
Event Registration
addPortAddedListener(function(this, ItemEventArgs<IPort>):void)Event Deregistration
removePortAddedListener(function(this, ItemEventArgs<IPort>):void)Signature Details
function(sender: this, evt: ItemEventArgs<IPort>)
Parameters
- sender - this
- The source of the event.
- evt - ItemEventArgs<IPort>
- An object that contains the event data.
Occurs when the location model parameter of a port has been changed.
Remarks
See Also
Overrides
Event Registration
addPortLocationParameterChangedListener(function(this, ItemChangedEventArgs<IPort,IPortLocationModelParameter>):void)Event Deregistration
removePortLocationParameterChangedListener(function(this, ItemChangedEventArgs<IPort,IPortLocationModelParameter>):void)Signature Details
function(sender: this, evt: ItemChangedEventArgs<IPort,IPortLocationModelParameter>)
Parameters
- sender - this
- The source of the event.
- evt - ItemChangedEventArgs<IPort,IPortLocationModelParameter>
- An object that contains the event data.
Occurs when a port has been removed from its owner.
Remarks
This event will also be triggered prior to the removal of the corresponding owner of the port.
This event is intended to provide notification of low level changes in the graph structure. Please use the DeletedItem event if you are interested only in port removal events that result from user interaction.
See Also
Overrides
Event Registration
addPortRemovedListener(function(this, PortEventArgs):void)Event Deregistration
removePortRemovedListener(function(this, PortEventArgs):void)Signature Details
function(sender: this, evt: PortEventArgs)
Parameters
- sender - this
- The source of the event.
- evt - PortEventArgs
- An object that contains the event data.
Occurs when a port style has been replaced.
Remarks
See Also
Overrides
Event Registration
addPortStyleChangedListener(function(this, ItemChangedEventArgs<IPort,IPortStyle>):void)Event Deregistration
removePortStyleChangedListener(function(this, ItemChangedEventArgs<IPort,IPortStyle>):void)Signature Details
function(sender: this, evt: ItemChangedEventArgs<IPort,IPortStyle>)
Parameters
- sender - this
- The source of the event.
- evt - ItemChangedEventArgs<IPort,IPortStyle>
- An object that contains the event data.
Occurs when the tag of a port has been replaced.
Remarks
See Also
Overrides
Event Registration
addPortTagChangedListener(function(this, ItemChangedEventArgs<IPort,Object>):void)Event Deregistration
removePortTagChangedListener(function(this, ItemChangedEventArgs<IPort,Object>):void)Signature Details
function(sender: this, evt: ItemChangedEventArgs<IPort,Object>)
Parameters
- sender - this
- The source of the event.
- evt - ItemChangedEventArgs<IPort,Object>
- An object that contains the event data.
Constants
Gets an IContextLookup that provides the default implementations returned by an IBend's lookup.
Remarks
Gets an IContextLookup that provides the default implementations returned by an IEdge's lookup.
Remarks
Gets an IContextLookup that provides the default implementations returned by an ILabel's lookup.
Remarks
Gets an IContextLookup that provides the default implementations returned by an INode's lookup.
Remarks
Gets an IContextLookup that provides the default implementations returned by an IPort's lookup.