Class ElementShape

Represents the base class for element shapes that define the visual geometry of UI elements.

Inheritance
System.Object
ElementShape
ChamferedRectShape
CircleShape
CustomShape
EllipseShape
CustomShape
RoundRectShape
DonutShape
MediaShape
QAShape
DiamondShape
GanttViewSummaryLeftElement.LeftShape
GanttViewSummaryRightElement.RightShape
GaugeVisualElement.GaugeShape
RadialGaugeBackground.GaugeBackgroundShape
HeartShape
OfficeShape
StarShape
TabEdgeShape
TabIEShape
TabItemShape
TabOffice12Shape
TabVsShape
TrackBarDThumbShape
TrackBarLThumbShape
TrackBarRThumbShape
TrackBarUThumbShape
Namespace: Telerik.WinControls
Assembly: Telerik.WinControls.dll

Syntax

public abstract class ElementShape : Component
Remarks

Provides the foundation for specialized shapes such as EllipseShape, RoundRectShape, and Office12Shape. Derived classes implement specific shape creation logic while this base class handles common functionality like bounds calculation, region creation, and RTL support.

Constructors

ElementShape()

Declaration
public ElementShape()

ElementShape(IContainer)

Declaration
public ElementShape(IContainer container)
Parameters
System.ComponentModel.IContainer container

Properties

IsRightToLeft

Gets or sets a value indicating whether the shape should be rendered for right-to-left layouts.

Declaration
public bool IsRightToLeft { get; set; }
Property Value
System.Boolean

true if the shape supports right-to-left rendering; otherwise, false.

Methods

CreateContour(Rectangle)

Declaration
protected virtual GraphicsPath CreateContour(Rectangle bounds)
Parameters
System.Drawing.Rectangle bounds

Returns
System.Drawing.Drawing2D.GraphicsPath

CreatePath(Rectangle)

Creates a GraphicsPath using the specified rectangle as bounds. This method must be implemented by derived classes.

Declaration
public abstract GraphicsPath CreatePath(Rectangle bounds)
Parameters
System.Drawing.Rectangle bounds

The rectangle defining the bounds for the shape.
Returns
System.Drawing.Drawing2D.GraphicsPath

A GraphicsPath representing the shape within the specified bounds.

CreatePath(RectangleF)

Creates a GraphicsPath using the specified rectangle as bounds with floating-point precision.

Declaration
public virtual GraphicsPath CreatePath(RectangleF bounds)
Parameters
System.Drawing.RectangleF bounds

The rectangle defining the bounds for the shape.
Returns
System.Drawing.Drawing2D.GraphicsPath

A GraphicsPath representing the shape within the specified bounds.

CreateRegion(Rectangle)

Declaration
public virtual Region CreateRegion(Rectangle bounds)
Parameters
System.Drawing.Rectangle bounds

Returns
System.Drawing.Region

DeserializeProperties(String)

Deserializes properties. Required for the deserialization mechanism of telerik framework.

Declaration
public virtual void DeserializeProperties(string propertiesString)
Parameters
System.String propertiesString

Dispose(Boolean)

Declaration
protected override void Dispose(bool disposing)
Parameters
System.Boolean disposing

GetBounds(RadElement)

Declaration
protected virtual Rectangle GetBounds(RadElement element)
Parameters
RadElement element

Returns
System.Drawing.Rectangle

GetElementContour(Rectangle)

Declaration
public GraphicsPath GetElementContour(Rectangle bounds)
Parameters
System.Drawing.Rectangle bounds

Returns
System.Drawing.Drawing2D.GraphicsPath

GetElementContour(RadElement)

Retrieves the contour path for the specified element.

Declaration
public GraphicsPath GetElementContour(RadElement element)
Parameters
RadElement element

The element for which to create the contour.
Returns
System.Drawing.Drawing2D.GraphicsPath

A GraphicsPath representing the element's contour.
Remarks

The contour typically represents the outline or border of the element's shape.

GetElementShape(RadElement)

Retrieves the shape path for the specified element.

Declaration
public GraphicsPath GetElementShape(RadElement element)
Parameters
RadElement element

The element for which to create the shape.
Returns
System.Drawing.Drawing2D.GraphicsPath

A GraphicsPath representing the element's shape.
Remarks

The GraphicsPath represents a series of connected lines and curves that define the element's geometry.

MirrorPath(GraphicsPath, RectangleF)

Mirrors the GraphicsPath. Used in RightToLeft mode.

Declaration
protected virtual void MirrorPath(GraphicsPath graphicsPath, RectangleF bounds)
Parameters
System.Drawing.Drawing2D.GraphicsPath graphicsPath

System.Drawing.RectangleF bounds

SerializeProperties()

Serializes properties. Required for serialization mechanism of telerik framework.

Declaration
public virtual string SerializeProperties()
Returns
System.String

ShouldMirrorPath()

Declaration
protected virtual bool ShouldMirrorPath()
Returns
System.Boolean

Extension Methods