Class LayoutNetwork

GoJS® Diagramming Components
version 3.0.16
by Northwoods Software®

Hierarchy (view full)

This provides an abstract view of a diagram as a network (graph) of vertexes and directed edges. The network contains vertexes and edges corresponding to Nodes and Links.

This class provides a framework for manipulating the state of nodes and links without modifying the structure of the diagram. Having a separate representation also permits adding or removing vertexes or edges from the network so that the graph that is laid out is not isomorphic to the diagram's graph.

For each kind of layout that uses a LayoutNetwork there is a subclass of LayoutVertex and a subclass of LayoutEdge:

Modifying a LayoutNetwork or a LayoutVertex or a LayoutEdge does not invalidate the Layout or raise any changed events.

Index

Constructors

Accessors

Methods

  • Adds a LayoutEdge to the network. Although this method is provided for completeness, linkVertexes provides a more efficient manner of linking vertexes already in the network.

    Parameters

    Returns void

  • Creates a network of LayoutVertexes and LayoutEdges corresponding to the given Nodes and Links. This is usually more convenient than repeatedly calling addNode and addLink. This method ignores all instances of Parts that are not Nodes or Links. This will recurse through Groups that have no Group.layout.

    Parameters

    • parts: Iterable<Part>

      A collection of Nodes or Links.

    • Optional toplevelonly: boolean

      whether to skip Parts in the given collection that are contained by Groups; default is false

    • Optional pred: ((a: Part) => boolean)

      optional predicate to apply to each Part -- if it returns false do not include Vertex or Edge in the network; default ignores link label nodes or links connecting with them

        • (a: Part): boolean
        • Parameters

          Returns boolean

    Returns void

  • Allocate a new instance of LayoutEdge. This is overridden in LayoutNetwork subclasses to create instances of subclasses of LayoutEdge. Please read the Introduction page on Extensions for how to override methods and how to call this base method.

    Returns LayoutEdge

  • Allocate a new instance of LayoutVertex. This is overridden in LayoutNetwork subclasses to create instances of subclasses of LayoutVertex. Please read the Introduction page on Extensions for how to override methods and how to call this base method.

    Returns LayoutVertex

  • Deletes all vertexes and edges that have no Part associated with them.

    Returns void

  • This convenience method deletes from this network any LayoutEdge corresponding to a Link.

    Parameters

    Returns void

  • This convenience method deletes any LayoutVertex corresponding to a Node.

    Parameters

    Returns void

  • Deletes all LayoutEdges whose "to vertex" and "from vertex" are the same vertex.

    Returns void

  • Removes a LayoutVertex from the network. This function also deletes all edges to or from the vertex.

    Parameters

    Returns void

  • Modify this network by splitting it up into separate subnetworks, each of which has all of its vertexes connected to each other, but not to any vertexes in any other subnetworks.

    This method will first delete from this network all artificial vertexes and all edges that do not connect two different vertexes. Afterwards, this original network may be empty or may contain all of the singleton vertexes, each of which had no edges connecting it to any other vertexes.

    Parameters

    • Optional clean: boolean

      whether to delete artificial vertexes and edges, disconnected edges, and reflexive edges; default is true

    Returns List<LayoutNetwork>

    a collection of LayoutNetworks, sorted in order of decreasing vertex count.