ElementPosition Class

Definition

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).

public ref class ElementPosition : System::Windows::Forms::DataVisualization::Charting::ChartElement
public class ElementPosition : System.Windows.Forms.DataVisualization.Charting.ChartElement
type ElementPosition = class
    inherit ChartElement
Public Class ElementPosition
Inherits ChartElement
Inheritance
ElementPosition

Remarks

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.

Constructors

ElementPosition()

Initializes a new instance of the ElementPosition class.

ElementPosition(Single, Single, Single, Single)

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

Properties

Auto

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

Bottom

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

Height

Gets or sets the height of a chart element.

Right

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

Size

Gets the size of a chart element.

Tag

Gets or sets an object associated with this chart element.

(Inherited from ChartElement)
Width

Gets or sets the width of a chart element.

X

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

Y

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

Methods

Dispose()

Releases the resources used by the ChartElement.

(Inherited from ChartElement)
Dispose(Boolean)

Releases the unmanaged resources used by the ChartElement and optionally releases the managed resources.

(Inherited from ChartElement)
Equals(Object)

Determines whether the specified Object is equal to the current ChartElement.

(Inherited from ChartElement)
FromRectangleF(RectangleF)

Initializes an ElementPosition object from a RectangleF structure.

GetHashCode()

Returns a hash function for a particular type.

(Inherited from ChartElement)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ToRectangleF()

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

ToString()

Returns a string that represents the current Object.

(Inherited from ChartElement)

Applies to