Share via


ShapeElement Class

Represents a diagram or a shape or connector in a diagram. ShapeElements encapsulate the visual presentation of model elements.

Inheritance Hierarchy

Object
  Microsoft.VisualStudio.Modeling.ModelElement
    Microsoft.VisualStudio.Modeling.Diagrams.PresentationElement
      Microsoft.VisualStudio.Modeling.Diagrams.ShapeElement
        Microsoft.VisualStudio.Modeling.Diagrams.LinkShape
        Microsoft.VisualStudio.Modeling.Diagrams.NodeShape

Namespace:  Microsoft.VisualStudio.Modeling.Diagrams
Assembly:  Microsoft.VisualStudio.Modeling.Sdk.Diagrams.11.0 (in Microsoft.VisualStudio.Modeling.Sdk.Diagrams.11.0.dll)

Syntax

'Declaration
<DisplayNameResourceAttribute("Microsoft.VisualStudio.Modeling.Diagrams.ShapeElement.DisplayName",  _
    GetType(CoreDesignSurfaceDomainModel), "Microsoft.VisualStudio.Modeling.Diagrams.GeneratedCode.DomainModelResx")> _
<DomainObjectIdAttribute("ffb3d9f5-7a47-4e12-8501-0055bd018825")> _
<DescriptionResourceAttribute("Microsoft.VisualStudio.Modeling.Diagrams.ShapeElement.Description",  _
    GetType(CoreDesignSurfaceDomainModel), "Microsoft.VisualStudio.Modeling.Diagrams.GeneratedCode.DomainModelResx")> _
<DomainModelOwnerAttribute(GetType(CoreDesignSurfaceDomainModel))> _
<CLSCompliantAttribute(True)> _
Public MustInherit Class ShapeElement _
    Inherits PresentationElement _
    Implements IGeometryHost
[DisplayNameResourceAttribute("Microsoft.VisualStudio.Modeling.Diagrams.ShapeElement.DisplayName", 
    typeof(CoreDesignSurfaceDomainModel), "Microsoft.VisualStudio.Modeling.Diagrams.GeneratedCode.DomainModelResx")]
[DomainObjectIdAttribute("ffb3d9f5-7a47-4e12-8501-0055bd018825")]
[DescriptionResourceAttribute("Microsoft.VisualStudio.Modeling.Diagrams.ShapeElement.Description", 
    typeof(CoreDesignSurfaceDomainModel), "Microsoft.VisualStudio.Modeling.Diagrams.GeneratedCode.DomainModelResx")]
[DomainModelOwnerAttribute(typeof(CoreDesignSurfaceDomainModel))]
[CLSCompliantAttribute(true)]
public abstract class ShapeElement : PresentationElement, 
    IGeometryHost
[DisplayNameResourceAttribute(L"Microsoft.VisualStudio.Modeling.Diagrams.ShapeElement.DisplayName", 
    typeof(CoreDesignSurfaceDomainModel), L"Microsoft.VisualStudio.Modeling.Diagrams.GeneratedCode.DomainModelResx")]
[DomainObjectIdAttribute(L"ffb3d9f5-7a47-4e12-8501-0055bd018825")]
[DescriptionResourceAttribute(L"Microsoft.VisualStudio.Modeling.Diagrams.ShapeElement.Description", 
    typeof(CoreDesignSurfaceDomainModel), L"Microsoft.VisualStudio.Modeling.Diagrams.GeneratedCode.DomainModelResx")]
[DomainModelOwnerAttribute(typeof(CoreDesignSurfaceDomainModel))]
[CLSCompliantAttribute(true)]
public ref class ShapeElement abstract : public PresentationElement, 
    IGeometryHost
[<AbstractClass>]
[<DisplayNameResourceAttribute("Microsoft.VisualStudio.Modeling.Diagrams.ShapeElement.DisplayName", 
    typeof(CoreDesignSurfaceDomainModel), "Microsoft.VisualStudio.Modeling.Diagrams.GeneratedCode.DomainModelResx")>]
[<DomainObjectIdAttribute("ffb3d9f5-7a47-4e12-8501-0055bd018825")>]
[<DescriptionResourceAttribute("Microsoft.VisualStudio.Modeling.Diagrams.ShapeElement.Description", 
    typeof(CoreDesignSurfaceDomainModel), "Microsoft.VisualStudio.Modeling.Diagrams.GeneratedCode.DomainModelResx")>]
[<DomainModelOwnerAttribute(typeof(CoreDesignSurfaceDomainModel))>]
[<CLSCompliantAttribute(true)>]
type ShapeElement =  
    class 
        inherit PresentationElement 
        interface IGeometryHost 
    end
public abstract class ShapeElement extends PresentationElement implements IGeometryHost

The ShapeElement type exposes the following members.

Constructors

  Name Description
Protected method ShapeElement Initializes a new instance of the ShapeElement class.

Top

Properties

  Name Description
Public property AbsoluteBoundingBox The bounding rectangle, measured relative to the Diagram.
Public property AbsoluteBoundingBoxToEnsureVisible Gets the absolute bounding rectangle for DiagramClientView.EnsureVisible.
Public property AbsoluteCenter Gets the point in the center of the shape.
Public property AccessibilityObject Gets the accessibility object for the shape.
Public property AccessibleDefaultActionDescription Gets the default action description for the shape.
Public property AccessibleDescription Gets the description for the shape.
Public property AccessibleHelp Gets the Help for the shape.
Public property AccessibleHelpTopicFileName Gets the Help topic for the shape.
Public property AccessibleHelpTopicId Gets the ID of the Help topic for the shape.
Public property AccessibleName Gets the name of the shape.
Public property AccessibleRole Gets the role of the shape.
Public property AccessibleState Gets the state of the shape.
Public property AccessibleValue Gets the value of the shape.
Public property AllowsChildrenInSelection If true, the children of this shape can be included in the current selection group.
Public property AllowsChildrenToResizeParent true if this shape can be resized when the size or position of a child shape is changed.
Public property AllowsChildrenToShrinkParent If true, this shape will reduce in size to fit around its children when they are re-sized or moved.
Public property BackgroundBrushId Gets the ID for the brush that is used to paint the background of the shape.
Public property BoundingBox The bounding rectangle, measured relative to the ParentShape.
Public property CanFocus Gets the shape and verifies whether it can receive the focus.
Public property CanMove Gets the shape and verifies whether a user can move it.
Public property CanSelect Gets the shape and verifies whether a user can select it.
Public property Center Gets the point in the center of the shape.
Protected property ClassStyleSet Gets the style set for the shape.
Public property ClipWhenDrawingFields Gets the child shape and verifies whether its clipping region should be set to the bounding box for the parent shape when the child shape is drawn.
Public property Decorators Gets the collection of decorators for the shape.
Public property DefaultShapeField Gets the default shape, which is the first shape that can receive focus.
Public property DefaultSize Gets the default size of the shape.
Public property Diagram Gets the diagram to which the shape belongs.
Public property EnsureVisiblePreference Preferences for the EnsureVisible method for this Shape. Default value is to return the VisiblePreference for the Diagram hosting this Shape.
Protected property Events Gets the list of event handlers for the shape.
Public property GeometryBackgroundBrushId Gets the ID of the brush that is used to paint the background of the geometry.
Public property GeometryBoundingBox Gets the bounding box of the shape.
Public property GeometryHasFilledBackground Gets the shape and verifies whether its background is painted.
Public property GeometryHasOutline Gets the shape and verifies whether it has an outline.
Public property GeometryHasShadow true if the shape has a shadow; otherwise, false.
Public property GeometryOutlinePenId Gets the ID of the pen that draws the outline for the shape.
Public property GeometryStyleSet Gets the style set for the shape.
Public property GridSize If non-zero, this shape and its children will snap to a grid of this size. Defaults to ParentShape.GridSize.
Public property HasChildren true if the shape has child shapes.
Protected property HasCustomToolTip Gets the shape and verifies whether it has a custom tooltip.
Public property HasDragOverToolTip Gets the shape and verifies whether it has a tooltip.
Public property HasFilledBackground Gets the shape and verifies whether it has a background.
Public property HasHighlighting Gets the shape and verifies whether it is highlighted.
Public property HasOutline Gets the shape and verifies whether it has an outline.
Public property HasShadow Gets the shape and verifies whether it has a shadow.
Public property HasToolTip Gets the shape and verifies whether it has a tooltip.
Public property Id Gets the ID of the element. (Inherited from ModelElement.)
Public property IsActive Gets the IsActive flag and verifies to see whether the element is active. (Inherited from ModelElement.)
Public property IsDeleted Gets the IsDeleted flag and checks to see whether the element has been deleted from the model. (Inherited from ModelElement.)
Public property IsDeleting Gets the IsDeleting flag and verifies whether the element is currently being deleted from the model. (Inherited from ModelElement.)
Public property IsNestedChild true if this shape element is in the NestedChildShapes of its ParentShape.
Public property IsRelativeChild true if this shape element is in the RelativeChildShapes of its ParentShape.
Public property IsVisible If true, the shape appears on the diagram; if false, it does not appear, and layout and routing algorithms ignore it. See also Hide() and Show().
Public property LineAdjustAwayDefault Gets the shape and verifies whether child link shapes should try to align when they are connected to same shape or sets this value.
Public property LineAffinityDefault Gets or sets the target location where the link shape should try to position the shape.
Public property LineToLineClearance Gets or sets the distance between child link shapes for this shape.
Public property LineToNodeClearance Gets or sets the distance between child link shapes and child node shapes.
Public propertyStatic member MaximumShadowOffset Gets the maximum offset for the shadow of the shape.
Public property MaximumSize Gets the maximum size for the shape.
Public property MinimumSize Gets the minimum size for the shape.
Public property ModelElement Gets or sets the model element that is associated with the presentation element. (Inherited from PresentationElement.)
Public property NestedChildShapes The list of shapes that are part of this shape, and are constrained to appear within the boundaries of this shape or diagram.
Public property NestedShapesMargin Gets the margin between the shape's bounding box and its nested node shapes.
Public property NodeToNodeClearance Gets or sets the margin between child node shapes.
Public property OutlinePenId Gets the ID of the pen that is used to draw the outline of the shape.
Public property OutlinePenWidth Gets the width of the outline for the shape.
Protected property PaintMoveableDecoratorSelectionLines
Protected property ParentLink Gets the relationship instance from the shape to the parent shape.
Public property ParentShape Gets the parent shape element. To appear on a diagram, a shape or connector must have a parent.
Public property Partition Gets or sets the Partition that contains the element. (Inherited from ModelElement.)
Public property Perimeter Gets the perimeter (path) around the shape.
Public property RelatedShapeToEmphasize Gets the related shape to visually emphasize to the user when this shape is selected.
Public property RelativeChildShapes The list of shapes that are part of this shape, but can appear outside the boundaries of this shape.
Public property ShapeFields Parts of a shape such as text rows and decorators.
Public property ShapeGeometry Gets the geometry for the shape, such as Rectangle, RoundedRectangle, or Ellipse, which defines operations associated with the outline of the shape.
Public property ShouldTryParentShapeForMergeOnToolboxDoubleClick If true, when the user double-clicks a toolbox item with this shape selected, if the tool cannot be merged with this shape, then a merge with the parent shape will be attempted. Defaults to true.
Public property Store Gets the Store that contains the element. (Inherited from ModelElement.)
Public property StyleSet Gets an instance of the style set for the shape.
Public property Subject Gets or sets the subject for the presentation element. Defaults to the same object as ModelElement. (Inherited from PresentationElement.)
Public property TargetToolboxItemFilterAttributes Gets a collection of attributes that determine which items are enabled or disabled in the Toolbox.
Public property ZOrder Determines the order in which this shape will be displayed relative to other shapes on the diagram. Normally set from the order of child shapes.

Top

Methods

  Name Description
Public method AccessibleDoDefaultAction Performs the default action for the accessible object.
Public method Associate Assigns a model element to the presentation element. The same effect as setting ModelElement. (Inherited from PresentationElement.)
Public methodStatic member AssociateValueWith(Store, AssociatedPropertyInfo) Associates the resource for the shape with an in-memory store property that is assigned to the shape.
Public methodStatic member AssociateValueWith(Store, Guid) Associates the resource for the shape with an in-memory store property that is assigned to the shape.
Protected method CalculateDerivedVisible Verifies whether the child shape appears.
Protected method CanMerge Verifies whether a source element can be added to this element. (Inherited from ModelElement.)
Protected method ChooseMergeTarget(ElementGroup) Selects a target element to accept as its child an element that the user wants to copy, drag, or create. (Inherited from ModelElement.)
Protected method ChooseMergeTarget(ElementGroupPrototype) Selects a target element to accept as its child an element that the user wants to copy, drag, or create. (Inherited from ModelElement.)
Public method ChooseParentShape Selects a parent shape for a new child shape, typically this shape.
Protected method ChooseRelationship Selects which child list a new child shape should be added to – NestedChildShapes or RelativeChildShapes.
Public method CoerceSelection Allows a shape to determine which other shapes are selected.
Public method Copy() Creates a copy of the element in the model. (Inherited from ModelElement.)
Public method Copy(IEnumerable<Guid>) Creates a copy of the element and its child links and elements. (Inherited from ModelElement.)
Protected method CreateChildShape Creates a shape and adds it as a child to this shape.
Protected method CreateClassStyleSet Creates a class style set for the shape type.
Protected method CreateDecorators Creates a collection of decorators for the shape type.
Protected method CreateInstanceStyleSet Creates a style set for the shape.
Protected method CreateShapeFields Creates a collection of shape fields for the shape type.
Public method Delete() Deletes an element from the model. (Inherited from ModelElement.)
Public method Delete(array<Guid[]) Deletes an element from the model. (Inherited from ModelElement.)
Protected method DetermineHighlightShape Finds the highlighted shape in a chain of shapes.
Public method DoFoldToShape Calculates the point where a connector will touch the perimeter of a shape. Override this if you define a non-rectangular shape.
Public method DoHitTest(PointD, DiagramHitTestInfo) Returns true if the specified point is within the shape.
Public method DoHitTest(PointD, DiagramHitTestInfo, Boolean) Returns true if the specified point is within the shape.
Public method DoHitTestSelection Returns true if a given point is in the selection handles around the shape.
Public method DoKeyboardNavigation Navigates the from shape to shape, using the keyboard.
Public method DrawResizeFeedback Draws the resizing feedback for the shape.
Public method Equals Determines whether the specified object is equal to the current object. (Inherited from Object.)
Public method ExcludeFromClipRegion Excludes the shape and its child shapes from the clipping region.
Public method ExcludeGeometryFromClipRegion Excludes the geometry of a shape and its child shapes from the clipping region.
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method FindDecorator(String) Finds the shape decorator that has a given name.
Public methodStatic member FindDecorator(IList<Decorator>, String) Finds the shape decorator that has a given name.
Public method FindFirstChild Searches for the first child in the navigation sequence for the shape.
Public method FindFreeArea Finds an empty area on the grid for the shape.
Public method FindLastChild Searches for the last child in the navigation sequence for the shape.
Public method FindNextChild Searches for the next child in the navigation sequence for the shape.
Public method FindNextInChildFields Searches for the next shape field in the navigation sequence.
Public method FindPreviousChild Searches for the previous child in the navigation sequence for the shape.
Public method FindPreviousInChildFields Searches for the previous shape field in the navigation sequence.
Public method FindShapeField(String) Searches for a shape field in a shape.
Public methodStatic member FindShapeField(IList<ShapeField>, String) Searches for a shape field in a shape.
Public method FixUpChildShapes Creates or adjusts the child shapes that should be created when a model element is created or updated. Called by Diagram.FixUpDiagram().
Public method Focused Verifies whether the shape has the focus.
Public method GetAccessibilityObject Gets the accessible object that is assigned to the shape.
Public method GetChildElements Gets a collection of child shapes that belong to the parent shape.
Public method GetCursor Gets the pointer that appears when the mouse is over the shape.
Public method GetDomainClass Gets the most-derived domain class for this element. (Inherited from ModelElement.)
Public method GetDragOverToolTipText Gets the tooltip text that appears when the mouse is over the shape.
Public method GetFieldAccessibleDescription Gets the description for a field in the shape.
Public method GetFieldAccessibleName Gets the name of a field in the shape.
Public method GetFieldAccessibleValue Gets the value for a field in the shape.
Public method GetFieldRepresentedElement Gets the primary element that the child shape represents.
Public method GetFieldRepresentedProperty Gets the property information for a field in the shape.
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetPotentialMouseAction Gets the mouse action to perform for a mouse down event over a specific point in the diagram.
Protected method GetRoleCollection<TCollection, TElement>(Guid) Gets or creates the linked element collection (Inherited from ModelElement.)
Public method GetShapeLuminosity Calculates the luminosity of the shape.
Public method GetSubFieldAccessibleDescription Gets the description for a child field in the shape.
Public method GetSubFieldAccessibleName Gets the name of a child field in the shape.
Public method GetSubFieldAccessibleValue Gets the value for a child field in the shape.
Public method GetSubFieldRepresentedElements Gets a collection of elements that the shape for the child field represents.
Public method GetSubFieldRepresentedProperty Gets the property for the child field.
Public method GetSubFieldRepresentedPropertyElements Gets the element that contains the property for the child field.
Public method GetToolTipText Gets the tooltip text for the shape to which the mouse is pointing.
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Protected method HasCachedDragOverResult Verifies whether the results are cached for the drag-over mouse event.
Public method Hide Hides the shape and all its children.
Protected method HideCustomToolTip Hides the custom tooltip for the shape.
Protected method InitializeDecorators Initializes and adds fields to the shape type.
Protected method InitializeInstanceResources Initializes the resources for an instance of the shape.
Protected method InitializeResources Initializes the resources for the shape.
Protected method InitializeShapeFields Initializes the list of fields that represent parts of the shape such as labels, icons, rows of text, and background images. Called once per class.
Public method Invalidate() Makes sure that the shape and its immediate surroundings will be repainted at the end of the transaction.
Public method Invalidate(Boolean) Makes sure that the shape will be repainted at the end of the transaction. Call this if you have changed properties of the shape.
Public method Invalidate(RectangleD) Makes sure that the shape and its old location will be repainted at the end of the transaction.
Public method IsDescendantOf Verifies whether the shape is a descendent of another shape.
Protected method IsNavigationKey(Char) Verifies whether the key is used as a navigational command.
Protected method IsNavigationKey(Keys) Verifies whether the key data is used as a navigational command.
Public method IterateShapes Iterates through a shape and its child shapes.
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Protected method MergeConfigure Not used for presentation elements. (Inherited from PresentationElement.)
Protected method MergeDisconnect Disconnects a source element from a target element. (Inherited from ModelElement.)
Protected method MergeRelate Creates a relationship between a model element and a group of model elements. (Inherited from PresentationElement.)
Protected method ModifyLuminosity Calculates the luminosity of the highlight for the shape.
Protected method MoveByRepositioning(DiagramDragEventArgs) Repositions the shapes in the group by the amount that the position of the mouse determines.
Public method MoveByRepositioning(ElementGroupPrototype, DiagramItemCollection, PointD, DiagramItem) Repositions the shapes in the group by the amount that the position of the mouse determines.
Public method NavigateAscend Navigates to the next ancestor in the navigation sequence and updates the focus. Called in response to user navigation keystrokes.
Public method NavigateDescend Navigates to the next descendent in the navigation sequence and updates the focus. Called in response to user navigation keystrokes.
Protected method NavigateTo Navigates to a specific shape in the navigation sequence and updates the focus.
Public method NavigateToFirst Navigates to the first shape in the navigation sequence in the parent of the current selection. Called in response to user navigation keystrokes.
Public method NavigateToLast Navigates to the last shape in the navigation sequence in the parent of the current selection. Called in response to user navigation keystrokes.
Public method NavigateToNext Navigates to the next shape in the navigation sequence. Called in response to user navigation keystrokes.
Public method NavigateToPrevious Navigates to the previously selected shape in the navigation sequence. Called in response to user navigation keystrokes.
Protected method OnAssociatedPropertyChanged Updates the shape when the value of an in-memory store property changes for a field in the shape.
Protected method OnBeforePaint Updates resources, such as pens and brushes, before they are used to paint the shape.
Public method OnBeginEdit Called when the user starts to edit a text field.
Public method OnBoundsFixup Called when the bounds position and size of the parent and children are set or adjusted. Override to modify the size or internal layout.
Protected method OnChildConfigured Called when the positions and sizes of child shapes are about to be determined. Override to set specialized rules.
Protected method OnChildConfiguring Called after the size and position of a child shape has been determined.
Public method OnClick Called when the user clicks the shape.
Protected method OnCopy Called when this element has been created as a copy of another element. (Inherited from ModelElement.)
Protected method OnDeleted Called when this element has been deleted from the model. (Inherited from ModelElement.)
Protected method OnDeleting Called when this element is about to be deleted. (Inherited from ModelElement.)
Public method OnDoubleClick Called when the user double-clicks the shape.
Public method OnDragDrop Called when the user drags an item onto the shape.
Public method OnDragEnter Called when the mouse enters a shape during a drag operation.
Public method OnDragLeave Called when the mouse moves out of a shape.
Public method OnDragOver Override this method to respond to the movement of the mouse over the shape. Set e.Effect to indicate the cursor feedback to the user.
Public method OnEndEdit Called when the user ends editing a text field.
Public method OnInitialize Called to initialize the shape. Override this to attach event handlers and rules to this object.
Public method OnKeyDown Called when a key is pressed.
Public method OnKeyPress Called when a character is typed.
Public method OnKeyUp Called when a key is released.
Public method OnMouseDown Called when the user presses a mouse key.
Public method OnMouseEnter Called when the mouse enters a shape.
Public method OnMouseHover Called when the mouse hovers over a shape.
Public method OnMouseLeave Called when the mouse leaves a shape.
Public method OnMouseMove Called repeatedly when the user moves the mouse.
Public method OnMouseUp Called when a mouse button is released.
Public method OnMouseWheel Called when the user has rotated the mouse wheel.
Public method OnOrphaned Called when a
Public method OnPaintEmphasis Called when emphasis has been applied to the selected shape.
Public method OnPaintFeedback Called when drag-and-drop feedback is painted.
Public method OnPaintSelection Called to paint the selection highlight.
Public method OnPaintShape Called to paint the basic parts of the shape.
Protected method OnResurrected Called when this element has been added back to a model. (Inherited from ModelElement.)
Protected method OnRolePlayerPositionChanged Called when the position of a role has changed. (Inherited from ModelElement.)
Protected method OnRolePlayerPositionChanging Called when a role player position is about to change. (Inherited from ModelElement.)
Public method OnShapeInserted Called when a shape has been inserted as a child of another.
Public method OnShapeRemoved Called when the shape has been removed as a child shape from its parent shape.
Public method PerformResizeParentRule() Alerts the Domain-Specific Language Designer that a parent shape must be resized to match its child shapes.
Public method PerformResizeParentRule(Boolean, ShapeElement) Alerts the Domain-Specific Language Designer that a parent shape must be resized to match its child shapes.
Protected method PermitChildVisibility Verifies whether the child shape should appear in the diagram.
Protected method ProcessVisibilityChange Updates the visibility of the child shape when a change to visibility is made.
Public method PurgeLayoutObjects Removes the objects that are used to position the shape on the diagram grid.
Public method PurgePoints Removes points for the shape on the diagram grid.
Public method RebuildShape Rebuilds the shape.
Public method RemoveLayoutObject Removes the shape, including any relative and nested child shapes, from the diagram grid.
Public method Selected Verifies whether the shape is selected in a specified view.
Protected method SetInitialGraphLayoutVisibility Sets the visibility of the graph.
Public method SetShowHideState Sets the visibility of the shape and all its children.
Protected method SetShowHideStateImplementation Sets the visibility of the shape.
Protected method ShouldAddShapeForElement Determines whether a shape should be created to represent a given domain class instance on the diagram.
Public method ShouldReparentOnMove Verifies whether a child shape should be added to a new parent when the child shape is moved.
Public method Show Makes a shape and all its children visible.
Protected method ShowCustomToolTip Makes a shape's custom tooltip visible.
Public method ToString Gets the name of the shape and its type. (Overrides Object.ToString.)
Public method TranslateGeometryToAbsoluteBounds Converts the relative bounds to absolute bounds for the shape's geometry.
Public method TranslateGeometryToRelativeBounds Converts the absolute bounds to relative bounds for the shape's geometry.
Public method TranslateToAbsoluteBounds Converts the relative bounds to absolute bounds for the shape.
Public method TranslateToRelativeBounds Converts the absolute bounds to relative bounds for the shape.
Protected method UpdateDerivedVisible Updates the visible state of the derived shape.
Public method UpdateGeometryLuminosity(DiagramClientView, Brush) Updates the luminosity for the brush.
Public method UpdateGeometryLuminosity(DiagramClientView, Pen) Updates the luminosity for the pen.

Top

Events

  Name Description
Public event Click Occurs when the user clicks the mouse over a shape.
Public event DoubleClick Occurs when the user double-clicks the mouse.
Public event KeyDown Occurs when the user presses a key.
Public event KeyPress Occurs when the user presses and releases a key.
Public event KeyUp Occurs when the user releases a key.
Public event MouseDown Occurs when the user presses the mouse button.
Public event MouseMove Occurs when the user moves the mouse.
Public event MouseUp Occurs when the user releases the mouse button.
Public event MouseWheel Occurs when the user rotates the mouse wheel.

Top

Extension Methods

  Name Description
Public Extension Method AddExtension(Guid) Overloaded. Extend this ModelElement with newly instantiated extension of the identified domain type. An InvalidOperationException will be thrown if the element already has an extension of that type. (Defined by ModelElementExtensionMethods.)
Public Extension Method AddExtension(Type) Overloaded. Extend this ModelElement with a newly instantiated extension of the specified type. An InvalidOperationException will be thrown if the element already has an extension of that type. (Defined by ModelElementExtensionMethods.)
Public Extension Method AddExtension(DomainClassInfo) Overloaded. Extend this ModelElement with a newly instantiated extension of the specified domain type. An InvalidOperationException will be thrown if the element already has an extension of that type. (Defined by ModelElementExtensionMethods.)
Public Extension Method AddExtension(ExtensionElement) Overloaded. Extend this ModelElement with a specific extension. An InvalidOperationException will be thrown if the element already has an extension of the same type. (Defined by ModelElementExtensionMethods.)
Public Extension Method AddExtension<T>() Overloaded. Extend this ModelElement with a newly instantiated extension of a particular type. An InvalidOperationException will be thrown if the element already has an extension of the same type. (Defined by ModelElementExtensionMethods.)
Public Extension Method CanDelete Deletes the element from the model. (Defined by ImmutabilityExtensionMethods.)
Public Extension Method GetAllExtensions Return an enumerable that performs a breadth first traversal across the tree of extension elements embedded in this ModelElement. (Defined by ModelElementExtensionMethods.)
Public Extension Method GetBaseElement Returns the root of the virtual MEL in which the specified ModelElement is participating. (Defined by ModelElementExtensionMethods.)
Public Extension Method GetDslDefinitionModelElement This method guarantees that the real model element corresponding to the PresentationElement is returned. For DslDesigner PELs, the corresponding subject may actually be an internal TreeNode class and not the actual MEL. This method handles those cases correctly so that the actual MEL is returned. (Defined by PresentationElementHelper.)
Public Extension Method GetExtension(Guid) Overloaded. (Defined by ModelElementExtensionMethods.)
Public Extension Method GetExtension(Type) Overloaded. Get the ExtensionElement of the specified type from the available extensions of this ModelElement. If the element has no such extension then an InvalidOperationException will be raised. (Defined by ModelElementExtensionMethods.)
Public Extension Method GetExtension(DomainClassInfo) Overloaded. (Defined by ModelElementExtensionMethods.)
Public Extension Method GetExtension<T>() Overloaded. Get the ExtensionElement of the specified type from the available extensions of this ModelElement. If the element has no such extension then an InvalidOperationException will be raised. (Defined by ModelElementExtensionMethods.)
Public Extension Method GetLocks Get the lock flags for this element. This will include any locks enabled on the Partition containing the element. (Defined by ImmutabilityExtensionMethods.)
Public Extension Method IsExtendedBy(Guid) Overloaded. Query whether this ModelElement is currently extended by an ExtensionElement of a particular type. (Defined by ModelElementExtensionMethods.)
Public Extension Method IsExtendedBy(Type) Overloaded. Query whether this ModelElement is currently extended by an ExtensionElement of a particular type. (Defined by ModelElementExtensionMethods.)
Public Extension Method IsExtendedBy(DomainClassInfo) Overloaded. Query whether this ModelElement is currently extended by an ExtensionElement of a particular type. (Defined by ModelElementExtensionMethods.)
Public Extension Method IsLocked Test whether this element has any of a specified set of locks (Defined by ImmutabilityExtensionMethods.)
Public Extension Method RemoveExtension(Type) Overloaded. Remove any extension of this ModelElement that is of a particular type. (Defined by ModelElementExtensionMethods.)
Public Extension Method RemoveExtension(Guid) Overloaded. Remove any extension of the specified ModelElement that is of a particular type. (Defined by ModelElementExtensionMethods.)
Public Extension Method RemoveExtension(DomainClassInfo) Overloaded. Remove any extension of the specified ModelElement that is of a particular type. (Defined by ModelElementExtensionMethods.)
Public Extension Method RemoveExtension(ExtensionElement) Overloaded. Remove a specified ExtensionElement from the extensions of this ModelElement. (Defined by ModelElementExtensionMethods.)
Public Extension Method SetLocks Set the lock flags of this element (Defined by ImmutabilityExtensionMethods.)
Public Extension Method TryGetExtension(Guid) Overloaded. (Defined by ModelElementExtensionMethods.)
Public Extension Method TryGetExtension(Type) Overloaded. (Defined by ModelElementExtensionMethods.)
Public Extension Method TryGetExtension(DomainClassInfo) Overloaded. (Defined by ModelElementExtensionMethods.)
Public Extension Method TryGetExtension<T>() Overloaded. Get the ExtensionElement of the specified type from the available extensions of this ModelElement. If this element has no such extension then the result will be null. (Defined by ModelElementExtensionMethods.)

Top

Fields

  Name Description
Public fieldStatic member DomainClassId Represents the ID that is assigned to the shape.

Top

Explicit Interface Implementations

  Name Description
Explicit interface implemetationPrivate method IMergeElements.CanMerge Returns true if this element can merge with the content of the prototype. (Inherited from ModelElement.)
Explicit interface implemetationPrivate method IMergeElements.ChooseMergeTarget(ElementGroup) (Inherited from ModelElement.)
Explicit interface implemetationPrivate method IMergeElements.ChooseMergeTarget(ElementGroupPrototype) (Inherited from ModelElement.)
Explicit interface implemetationPrivate method IMergeElements.MergeConfigure (Inherited from ModelElement.)
Explicit interface implemetationPrivate method IMergeElements.MergeDisconnect (Inherited from ModelElement.)
Explicit interface implemetationPrivate method IMergeElements.MergeRelate (Inherited from ModelElement.)

Top

Remarks

To navigate to the model element or relationship that the shape represents, use ModelElement.

Important subtypes include:

  • Diagram – represents a collection of shapes and connectors. The content of a Diagram is persisted in a .diagram file. If you specify a diagram class in your DSL Definition, it is derived from this class.

  • NodeShape – represents a shape that has a non-zero area, not a connector. If you specify shape classes in your DSL Definition, they are derived from NodeShape.

  • BinaryLinkShape – represents a line between two NodeShapes. If you specify connector classes in your DSL Definition, they are derived from this BinaryLinkShape.

For more information, see [redirect] How to: Navigate and Update a Diagram.

Class diagram of base shape and element types

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Microsoft.VisualStudio.Modeling.Diagrams Namespace

Other Resources

[redirect] How to: Navigate and Update a Diagram