An abstract base implementation of the IPortCandidateProvider interface.
Type Details
- yFiles module
- view
Properties
Gets or sets the style to use for the creation of the port in createInstance.
Remarks
A value of
null will make the implementation use the corresponding current default port style.Gets or sets the tag to assign to the port in createInstance
Methods
Adds candidates for all existing ports of the owner to the provided list.
Parameters
options - Object
A map of options to pass to the method.
A map of options to pass to the method.
- owner - IPortOwner
- The port owner whose ports should be added.
- list - IList<IPortCandidate>
- The list to add candidates for existing ports to.
createCandidate
(owner: IPortOwner, locationParameter: IPortLocationModelParameter, valid?: boolean) : PortCandidateFactory method that creates a candidate that will use the createInstance method of this instance to delegate createPort queries to.
Parameters
options - Object
A map of options to pass to the method.
A map of options to pass to the method.
- owner - IPortOwner
- The owner to use for the candidate.
- locationParameter - IPortLocationModelParameter
- The location of the candidate. This instance is assigned by reference to the candidate.
- valid - boolean
- Whether the port should be VALID.
Returns
- ↪PortCandidate
- A candidate whose createPort method delegates to this instance's createInstance.
Callback method used by the ports created using the factory methods createCandidate.
Remarks
This method can be overridden by subclasses to perform more sophisticated port creation logic.
Parameters
options - Object
A map of options to pass to the method.
A map of options to pass to the method.
- context - IInputModeContext
- The context in which the instance is created.
- candidate - PortCandidate
- The candidate to create a port for.
Returns
- ↪IPort
- The new port.
Returns all source port candidates that belong to the context of this provider.
Remarks
The enumerable may contain valid, invalid, and dynamic port candidates.
Parameters
options - Object
A map of options to pass to the method.
A map of options to pass to the method.
- context - IInputModeContext
- The context for which the candidates should be provided.
Returns
- ↪IEnumerable<IPortCandidate>
- An enumerable over all source port candidates that are associated with the current context.
This implementation simply delegates to getPortCandidates.
Implements
Returns all target port candidates that belong to the context of this provider.
Remarks
The enumerable may contain valid, invalid, and dynamic port candidates.
Parameters
options - Object
A map of options to pass to the method.
A map of options to pass to the method.
- context - IInputModeContext
- The context for which the candidates should be provided.
Returns
- ↪IEnumerable<IPortCandidate>
- An enumerable over all target port candidates that are associated with the current context.
This implementation simply delegates to getPortCandidates.
Implements
getPortCandidateAt
(context: IInputModeContext, candidate: PortCandidate, suggestedLocation: Point) : IPortCandidateCallback method used by the ports created using the factory methods createCandidate.
Remarks
This method can be overridden by subclasses to perform more sophisticated candidate creation logic.
Parameters
options - Object
A map of options to pass to the method.
A map of options to pass to the method.
- context - IInputModeContext
- The context in which the instance is created.
- candidate - PortCandidate
- The candidate to create a port for.
- suggestedLocation - Point
- The location to get a candidate for.
Returns
Creates an enumeration of possibly port candidates.
Remarks
This method is used as a callback by most of the getter methods in this class. Subclasses should override this method to provide the same candidates for all use-cases.
Parameters
options - Object
A map of options to pass to the method.
A map of options to pass to the method.
- context - IInputModeContext
- The context for which the candidates should be provided.
Returns
- ↪IEnumerable<IPortCandidate>
- An enumerable collection of port candidates.
getSourcePortCandidates
(context: IInputModeContext, target: IPortCandidate) : IEnumerable<IPortCandidate>Returns all port candidates that apply for the provided opposite port candidate.
Remarks
The enumerable may contain valid, invalid, and dynamic port candidates.
Parameters
options - Object
A map of options to pass to the method.
A map of options to pass to the method.
- context - IInputModeContext
- The context for which the candidates should be provided.
- target - IPortCandidate
- The opposite port candidate.
Returns
- ↪IEnumerable<IPortCandidate>
- An enumerable over all port candidates that are associated with the given opposite port.
This implementation simply delegates to getPortCandidates.
Implements
getTargetPortCandidates
(context: IInputModeContext, source: IPortCandidate) : IEnumerable<IPortCandidate>Returns all port candidates that apply for the provided opposite port candidate.
Remarks
The enumerable may contain valid, invalid, and dynamic port candidates.
Parameters
options - Object
A map of options to pass to the method.
A map of options to pass to the method.
- context - IInputModeContext
- The context for which the candidates should be provided.
- source - IPortCandidate
- The opposite port candidate.
Returns
- ↪IEnumerable<IPortCandidate>
- An enumerable over all port candidates that are associated with the given opposite port.
This implementation simply delegates to getPortCandidates.