DslDefinitionModelDeleteClosure.ShouldVisitRolePlayer Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
This method is called to ask the filter if a particular role player associated with an ElementLink should be Visited during traversal. This overrides the generated ShouldVisitRolePlayer() method, which examines the PropagateDelete attribute on the ElementLink to decide whether to visit the associated role players. In this case the RelationshipPort, the shape drawn as a little square where a relationship is connected to a class, was not deleted with the relationship. The reason is that the link used to connect the RelationshipPort (a shape) to the RoleConnector (also a shape) is a subtype of ElementLink called LinkConnectsToNode. Instances of this link type are used to associate various NodeShapes with LinkShapes and so do not propagate deletes, although in the case of the RelationshipPort it should. The same problem existed for InheritancePort, which like RelationshipPort extends TogglePort.
This method is called for every ElementLink visited during a delete. If the link in question is an instance of LinkConnectsToNode and the roleplayer is a TogglePort, then the port shape may not be needed anymore. By checking how many links are left to the target role player this method returns VisitorFilterResult.YES if there is exactly one link to the port, VisitorFilterResult.DoNotCare otherwise. This ensures that when the last link to the node is deleted the port shape is deleted as well.
public:
override Microsoft::VisualStudio::Modeling::VisitorFilterResult ShouldVisitRolePlayer(Microsoft::VisualStudio::Modeling::ElementWalker ^ walker, Microsoft::VisualStudio::Modeling::ModelElement ^ sourceElement, Microsoft::VisualStudio::Modeling::ElementLink ^ elementLink, Microsoft::VisualStudio::Modeling::DomainRoleInfo ^ targetDomainRole, Microsoft::VisualStudio::Modeling::ModelElement ^ targetRolePlayer);
public override Microsoft.VisualStudio.Modeling.VisitorFilterResult ShouldVisitRolePlayer (Microsoft.VisualStudio.Modeling.ElementWalker walker, Microsoft.VisualStudio.Modeling.ModelElement sourceElement, Microsoft.VisualStudio.Modeling.ElementLink elementLink, Microsoft.VisualStudio.Modeling.DomainRoleInfo targetDomainRole, Microsoft.VisualStudio.Modeling.ModelElement targetRolePlayer);
override this.ShouldVisitRolePlayer : Microsoft.VisualStudio.Modeling.ElementWalker * Microsoft.VisualStudio.Modeling.ModelElement * Microsoft.VisualStudio.Modeling.ElementLink * Microsoft.VisualStudio.Modeling.DomainRoleInfo * Microsoft.VisualStudio.Modeling.ModelElement -> Microsoft.VisualStudio.Modeling.VisitorFilterResult
Public Overrides Function ShouldVisitRolePlayer (walker As ElementWalker, sourceElement As ModelElement, elementLink As ElementLink, targetDomainRole As DomainRoleInfo, targetRolePlayer As ModelElement) As VisitorFilterResult
Parameters
- walker
- ElementWalker
ElementWalker that is traversing the model
- sourceElement
- ModelElement
Model Element playing the source role
- elementLink
- ElementLink
Element Link that forms the relationship to the role player in question
- targetDomainRole
- DomainRoleInfo
DomainRoleInfo of the target role
- targetRolePlayer
- ModelElement
Model Element that plays the target role in the relationship