If set, this effect will be applied if a view is created (e.g. while a node becomes visible or if a new node is created).

Provide access to the center point of the VGraph's drawing surface, used by layouters to properly center their layout.

This was added for testing. It may be removed again.

Set or get the current root node (or focused node). Setting this property will result in a redraw of the graph to reflect the change (if it was actually a change).

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

Specify whether to display edge labels or not. If no edge label renderer is present a default will be used.

This property controls whether the mouse cursor should be locked in the dragged node's center or not.

Allow to provide an EdgeLabelRenderer in order to display edge labels. The created instances must be UIComponents.

Allow the provision of an EdgeRenderer to allow drawing of edges in a customised way. The edgeRenderer has to implement the IEdgeRenderer interface.

This property allows access and setting of the underlying graph object. If set, it will automatically initialise the VGraph from the Graph object, i.e. create VNodes and VEdges for each Graph node and Graph edge. If there was already a Graph present, the VGraph is purged, but no other cleanup is done, which means that there could still be some references floating around thus leaking memory. For now, avoid setting it more than once in the same VGraph.

Access to a parameter Object to preset various settings for the drawing of Edges. The Object is a hash with the following properties: "alpha" "thickness" "color" "distcolor" which are to be used by an Edge Renderer

Access to the layouter to be used for the layout of the graph.

Limit the currently visible nodes to those in a limited distance (in terms of degrees of separation) from the current root node. If showHistory is enabled, the previous root nodes will be shown regardless of this limit.

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

Default visibility setting for new nodes. If set all new nodes are created visible and with a view component. Beware of that if you have many nodes.

Returns the number of currently visible nodes.

Provide access to the current origin of the of the Visual Graph which is required for proper drawing.

If set, this effect will be applied if a view is removed (e.g. a node becomes invisible or is removed).

The scale property of VGraph will affect the scaleX and scaleY properties and also will ensure drag&drop works properly.

This property controls whether to show the history of root nodes (or focused nodes) or not. If enabled, these previous root nodes will be shown even though they are are now more degrees of separation away from the current root node than the limit allows. Also any intermediate node from a previous root node to the current root node will be shown to have a complete link and not a disconnected graph.

Specifies if any visibility limits should be active or not. If not active, always all nodes are visible. If you have many nodes, this could have a severe impact on your performance so handle with care.

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

Provide access to a list of currently visible edges, i.e. edges whose both nodes are visible and thus need to be drawn. Likewise this can save a lot of CPU if the layouter only needs to consider the currently visible edges.

Provide access to a list of currently visible VNodes. This is very important for layouters, if we have many many nodes, but only a few of them are visible at a time. Layouters typically will only layout the currently visible nodes.

The constructor just initialises most data structures, but not all required. Currently it does neither set a Graph object, nor a Layouter object. Reasonable defaults may be added as an option.

Calculate and return the current bounding box of all visible nodes. This is required by some layouters.

Clears the current history of root nodes.

Create a new Node in this VisualGraph, this automatically creates an underlying Node in the Graph object. It does not link the node to any other node, yet and it does not trigger a layout pass. The reason is that currently all layouters require a CONNECTED graph, since the new node would create a disconnected graph (since it is not linked, yet) this would break things.

Calling this forces a full calculation and redraw of the layout including all edges.

This initialises a VGraph from a Graph object. I.e. it crates a VNode for every Node found in the Graph and a VEdge for every Edge in the Graph. Careful, this currently does not check if the VGraph was already initialised and it does not purge anything. Things could break of used on an already initialized VGraph.

Links two nodes, thus creating an edge. If the underlying Graph is directional, the order matters, not otherwise. If the nodes are already linked, simply returns the existing edge between them.

Redraw all edges, this is called from the updateDisplayList() method. This forces a redraw of all edges

Removes a node from this VisualGraph. This removes any associated VEdges and Edges with the node and of course the underlying Node from the Graph datastructure.

Scrolls all objects according to the specified coordinates (used as an offset).

Unlinks two nodes, thus removing the edge between them, if it exists. Does nothing if the nodes were not linked. Again, order matters of the graph is directional.

This calls the base updateDisplayList() method of the Canvas and in addition redraws all edges if the layouter indicates that the layout has changed.

Dispatched when there is any change to the nodes and/or links of this graph.