Remarks
Predefined LookupDecorator<TDecoratedType, TInterface> are made available through properties like e.g. highlightRenderer. Note that the list of possible decorations that are available using this class is not exhaustive in any way. This is merely a way to provide access to those interfaces that are more commonly being decorated by the developer.
Typically, a configured instance of this class is available through ports on the GraphDecorator which is returned by decorator on an IGraph.
This decorator can be used to conveniently decorate the lookup of IPorts in an IGraph. It serves as a factory for predefined LookupDecorator<TDecoratedType, TInterface> instances that are specifically useful for the IPort type.
Examples
The port can be decorated in various ways. addConstant decorates the port's lookup to return the same instance for each port.
graph.decorator.ports.handleProvider.addConstant(
new ConstantHandleProvider(),
)addConstant with a predicate decorates the port's lookup only to return the same instance for each port for which the predicate returns true.
graph.decorator.ports.handleProvider.addConstant(
(port) => port.tag !== null,
new ConstantHandleProvider(),
)addFactory calls the provided factory method to return a new instance of the queried type created for the given port or for ports for which the predicate returns true, respectively:
graph.decorator.ports.handleProvider.addFactory(
(port) => new CustomHandleProvider(port),
)
graph.decorator.ports.handleProvider.addFactory(
(port) => port.tag !== null,
(port) => new CustomHandleProvider(port),
)addWrapperFactory calls the provided factory method to return a new instance of the queried type which wraps the default implementation, once for all ports and once only for ports for which the predicate returns true.
graph.decorator.ports.handleProvider.addWrapperFactory(
(port, original) => new HandleProviderWrapper(port!, original),
)
graph.decorator.ports.handleProvider.addWrapperFactory(
(port) => port.tag !== null,
(port, original) => new HandleProviderWrapper(port!, original),
)Finally hide hides the default implementation by letting the lookup always return null for all ports and for ports for which the predicate returns true, respectively
graph.decorator.ports.handleProvider.hide()
graph.decorator.ports.handleProvider.hide((port) => port.tag !== null)Each of these methods returns a IContextLookupChainLink which can be used to remove the modified behavior again:
registerLookup(graph: IGraph): void {
this.chainLink = graph.decorator.ports.handleProvider.addFactory(
(port) => new CustomHandleProvider(port),
)!
}
deregisterLookup(graph: IGraph): void {
graph.decorator.ports.remove(this.chainLink)
}See Also
Developer's Guide
API
- GraphDecorator, LookupDecorator
Members
Constructors
Initializes a new instance of the PortDecorator class.
Parameters
- decorator: ILookupDecorator
- The decorator to use.
Properties
Gets a LookupDecorator<TDecoratedType, TInterface> that decorates the IClipboardHelper type for IPorts this instance has been created for.
Property Value
Gets a LookupDecorator<TDecoratedType, TInterface> that decorates the IEdgePathCropper type for IPorts this instance has been created for.
Property Value
Gets a LookupDecorator<TDecoratedType, TInterface> that decorates the IFocusRenderer<IPort> type for IPorts this instance has been created for.
Property Value
Gets a LookupDecorator<TDecoratedType, TInterface> that decorates the IHandle type for IPorts this instance has been created for.
Custom IHandle implementations can be used to change the way the user can drag a IPort interactively to change its position in a GraphComponent. This interface is mainly used by the HandleInputMode in GraphEditorInputMode which obtains the IHandle from the IPort by querying the IHandleProvider from it, which in turn will query the IHandle from itself. Alternatively, selected nodes can put the IHandle of their ports into their IHandleProvider implementation. This is a convenient alternative to the direct usage of the ILookupDecorator that is provided by the IGraph's lookup.
When the decorated IHandle is sometimes present, and sometimes not, a call to requeryHandles may be necessary to refresh the displayed handles.
Property Value
Gets a LookupDecorator<TDecoratedType, TInterface> that decorates the IHandleProvider type for IPorts this instance has been created for.
Custom IHandleProvider implementations provide interactive draggable handles for the user to change the geometry or other aspects of IPorts in the GraphComponent. This interface is mainly used by the HandleInputMode in the GraphEditorInputMode. This is a convenient alternative to the direct usage of the ILookupDecorator that is provided by the IGraph's lookup.
When the decorated IHandleProvider provides a set of handles that may change over time, a call to requeryHandles may be necessary to refresh the displayed handles.
Property Value
Gets a LookupDecorator<TDecoratedType, TInterface> that decorates the IHighlightRenderer<IPort> type for IPorts this instance has been created for.
Property Value
Gets a LookupDecorator<TDecoratedType, TInterface> that decorates the ILassoTestable type for IPorts this instance has been created for.
Property Value
Gets a LookupDecorator<TDecoratedType, TInterface> that decorates the IMarqueeTestable type for IPorts this instance has been created for.
Property Value
Gets a LookupDecorator<TDecoratedType, TInterface> that decorates the IMementoSupport type for IPorts this instance has been created for.
Property Value
Gets a LookupDecorator<TDecoratedType, TInterface> that decorates the IObstacleProvider type for IPorts this instance has been created for.
Property Value
See Also
Gets a LookupDecorator<TDecoratedType, TInterface> that decorates the IPositionHandler type for IPorts this instance has been created for.
Property Value
Gets a LookupDecorator<TDecoratedType, TInterface> that decorates the ISelectionRenderer<IPort> type for IPorts this instance has been created for.
Property Value
Gets a LookupDecorator<TDecoratedType, TInterface> that decorates the ISnapReferenceProvider type for IPorts this instance has been created for.
Property Value
Gets a LookupDecorator<TDecoratedType, TInterface> that decorates the IPortSnapResultProvider type for IPorts this instance has been created for.
Property Value
Methods
Adds an IContextLookupChainLink.
Parameters
- link: IContextLookupChainLink
- The lookup chain link to add.
getDecoratorFor
<TInterface> (interfaceType: Constructor<TInterface>): LookupDecorator<IPort, TInterface>Creates a LookupDecorator<TDecoratedType, TInterface> for IPorts that can be used to decorate TInterface types of the ports.
getDecoratorFor
<TInterface> (interfaceType: Constructor<TInterface>): LookupDecorator<IPort, TInterface>TInterface types of the ports.Parameters
- interfaceType: Constructor<TInterface>
- The type of the interface that should be decorated of the instances' lookup.
Return Value
- LookupDecorator<IPort, TInterface>
- A new LookupDecorator<TDecoratedType, TInterface> for the specified interface.
Removes an IContextLookupChainLink that has been added by one of the various decorators for ports.
Parameters
- link: IContextLookupChainLink
- The lookup chain link to remove.
Examples
registerLookup(graph: IGraph): void {
this.chainLink = graph.decorator.ports.handleProvider.addFactory(
(port) => new CustomHandleProvider(port),
)!
}
deregisterLookup(graph: IGraph): void {
graph.decorator.ports.remove(this.chainLink)
}