ShapeElement.Invalidate Method

Definition

Overloads

Invalidate()

Invalidates the ShapeElement.

Invalidate(RectangleD)

Invalidates the ShapeElement with the specified rectangle used as its absolute bounds.

Invalidate(Boolean)

Invalidates the ShapeElement.

Invalidate()

Invalidates the ShapeElement.

C++
public:
 virtual void Invalidate();

Remarks

This method will invalidate the ShapeElement including (1) the outline pen that exceeds the bounds of the ShapeElement and (2) the the shadow of the ShapeElement.

Applies to

Visual Studio SDK 2022 and other versions
Product Versions
Visual Studio SDK 2017, 2019, 2022

Invalidate(RectangleD)

Invalidates the ShapeElement with the specified rectangle used as its absolute bounds.

C++
public:
 void Invalidate(Microsoft::VisualStudio::Modeling::Diagrams::RectangleD absoluteShapeBounds);

Parameters

absoluteShapeBounds
RectangleD

The ShapeElement bounds relative to the diagram's top left corner and in world units.

Remarks

This method will invalidate the ShapeElement including (1) the outline pen that exceeds the bounds of the ShapeElement and (2) the the shadow of the ShapeElement.

The bounds passed in will be used as the ShapeElement bounds. This method is particularly useful for invalidating this ShapeElement at a previous location and size. The bounds passed in is relative to the diagram's top left corner and is in world units.

Applies to

Visual Studio SDK 2022 and other versions
Product Versions
Visual Studio SDK 2017, 2019, 2022

Invalidate(Boolean)

Invalidates the ShapeElement.

C++
public:
 virtual void Invalidate(bool refreshBitmap);

Parameters

refreshBitmap
Boolean

Whether backing bitmap also needs to be refreshed as part of this invalidate.

Remarks

This method will invalidate the ShapeElement including (1) the outline pen that exceeds the bounds of the ShapeElement and (2) the the shadow of the ShapeElement.

Applies to

Visual Studio SDK 2022 and other versions
Product Versions
Visual Studio SDK 2017, 2019, 2022