ElementPosition Class

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Represents the base class for many visual elements of the chart such as the legend, title, and chart areas. Defines the position of the chart element in relative coordinates, which range from (0,0) to (100,100).

Namespace:   System.Windows.Forms.DataVisualization.Charting
Assembly:  System.Windows.Forms.DataVisualization (in System.Windows.Forms.DataVisualization.dll)


public class ElementPosition : ChartElement


Initializes a new instance of the ElementPosition class.

System_CAPS_pubmethodElementPosition(Single, Single, Single, Single)

Initializes a new instance of the ElementPosition class with the specified x, y, width and height parameters.


Gets or sets a value that indicates whether an applicable chart element will be positioned automatically by the Chart control.


Gets the bottom position of a chart element, in relative coordinates.


Gets or sets the height of a chart element.


Gets the position of the right side of a chart element, in relative coordinates.


Gets the size of a chart element.


Gets or sets an object associated with this chart element.(Inherited from ChartElement.)


Gets or sets the width of a chart element.


Gets or sets the relative X-coordinate of the top-left corner of an applicable chart element.


Gets or sets the relative Y-coordinate of the top-left corner of an applicable chart element.


Releases the resources used by the ChartElement.(Inherited from ChartElement.)


Releases the unmanaged resources used by the ChartElement and optionally releases the managed resources.(Inherited from ChartElement.)


Determines whether the specified Object is equal to the current ChartElement.(Inherited from ChartElement.)


Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)


Initializes an ElementPosition object from a RectangleF structure.


Returns a hash function for a particular type.(Inherited from ChartElement.)


Gets the Type of the current instance.(Inherited from Object.)


Creates a shallow copy of the current Object.(Inherited from Object.)


Returns a RectangleF object that uses the coordinates of an ElementPosition object.


Returns a string that represents the current Object.(Inherited from ChartElement.)

The ElementPosition class is used to define the position of a chart element, and represents one rectangle using the X, Y, Width and Height properties.

The ElementPosition class is always exposed as a Position property, such as Position, Position, and so forth. It is also exposed in the PrePaint and PostPaint events of the Chart control as a property of the ChartPaintEventArgs object.

The position of the applicable chart elements can be set automatically by setting the Auto property to true; chart elements can also be positioned at design time in the Design View.

There are two major differences between this class and a RectangleF structure:

  • This class can use automatic positioning.

  • This class only uses coordinates ranging from 0 to 100, otherwise an exception is thrown.

The position of chart elements is described using relative coordinates, with the top-left corner of an element having coordinates of (0,0) and the bottom-right corner of an element having coordinates of (100,100).

Elements that are plotted within a chart area use coordinates that are relative to the chart area, whereas elements outside a chart area use coordinates that are relative to the chart image.

.NET Framework
Available since 4.0

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

Return to top