DslDefinitionModelDeleteClosure.ShouldVisitRolePlayer Method

Reference

Definition

Namespace:: Microsoft.VisualStudio.Modeling.DslDefinition

Assembly:: Microsoft.VisualStudio.Modeling.Sdk.DslDefinition.15.0.dll

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

Returns

VisitorFilterResult

Implements

ShouldVisitRolePlayer(ElementWalker, ModelElement, ElementLink, DomainRoleInfo, ModelElement)

Applies to

Partilhar via