Class ChartControl

ChartControl is the root class of the chart control.

Inheritance

System.Object

ChartControl

Implements

IChartAreaHost

IVisualStyle

Namespace: Syncfusion.Windows.Forms.Chart

Assembly: Syncfusion.Chart.Windows.dll

Syntax

public class ChartControl : Control, IChartAreaHost, IVisualStyle

Remarks

The ChartControl lets you create enterprise level charts with support for numerous chart types (see Type). A ChartSeries containing pints of X and Y values can be added to the Series collection to get a chart rendered. The chart control has a built in "nice range calculation" engine which will automatically determine the appropriate ranges for the axes based on the series data. Chart readily supports rendering multiple series.

There is also support for multiple axes, in case you want to render multiple series with each series rendered against a unique axes. Use the Axes collection to add one or more custom axis to the default set of PrimaryXAxis and PrimaryYAxis, which also can be referred from the Axes collection. Numerous customization can be done on the axis labels through the corresponding ChartAxis instance.

The default Legend renders some default ChartLegendItems representing each series in the chart. You can add custom legends to the chart through the Legends collection. You can add custom legend items to the ChartLegend instance through the CustomItems collection.

There is also a default Title and the ability to add multiple titles through the Titles collection.

The look and feel of the plot can also be customized through the ChartArea property.

There is also built in support for applying some statistical formulas and functions to the series data. Take a look at the BasicStatisticalFormulas type and the UtilityFunctions type.4

Constructors

ChartControl()

Initializes a new instance of the ChartControl class.

Declaration

public ChartControl()

ChartControl(Boolean)

Initializes a new instance of the ChartControl class.

Declaration

public ChartControl(bool addRandomData)

Parameters

Type	Name	Description
System.Boolean	addRandomData	if set to true random data will be added.

ChartControl(Boolean, Boolean)

Initializes a new instance of the ChartControl class. For internal use. Do not use this constructor directly.

Declaration

public ChartControl(bool addRandomData, bool isWindowLess)

Parameters

Type	Name	Description
System.Boolean	addRandomData	if set to true [add random data].
System.Boolean	isWindowLess	if set to true [is window less].

Fields

AspMode

The AspMode.

Declaration

[Obsolete("This member isn't used anymore.")]
public static bool AspMode

Field Value

Type	Description
System.Boolean

m_seriesHighlightIndex

Specifies the series's index when mouse hovering on the legend item and the correspnding series will be highlighted.

Declaration

public int m_seriesHighlightIndex

Field Value

Type	Description
System.Int32

Properties

AcceptFocus

Gets or sets a value indicating whether the chartcontrol is selectable.

Declaration

public bool AcceptFocus { get; set; }

Property Value

Type	Description
System.Boolean

ActiveIndex

Gets the Index of ChartRegion which was selected. For internal use.

Declaration

public int ActiveIndex { get; }

Property Value

Type	Description
System.Int32

AddRandomSeries

Gets or sets a value indicating whether random series will be added.

Declaration

public bool AddRandomSeries { get; set; }

Property Value

Type	Description
System.Boolean	true if random series will be added; otherwise, false.

AllowGapForEmptyPoints

Gets or sets a value indicating whether allow or disallow the gap when points are empty in indexed mode

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool AllowGapForEmptyPoints { get; set; }

Property Value

Type	Description
System.Boolean

AllowGradientPalette

Gets or sets a value indicating whether allow the gradient palette.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool AllowGradientPalette { get; set; }

Property Value

Type	Description
System.Boolean	true if [allow gradient palette]; otherwise, false.

AllowUserEditStyles

Gets or sets a value indicating whether allow the user to edit series styles when double clicking on a series.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool AllowUserEditStyles { get; set; }

Property Value

Type	Description
System.Boolean

AutoHighlight

Gets or sets a value indicating whether the points on the chart should be highlighted when the mouse hovers over them or not.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool AutoHighlight { get; set; }

Property Value

Type	Description
System.Boolean

Axes

Gets the collection of axes associated with this chart. You can add and remove axes from this collection. Primary X and Y axes may not be removed. Use the PrimaryXAxis and PrimaryYAxis to access the primary axes.

Declaration

public ChartAxisCollection Axes { get; }

Property Value

Type	Description
ChartAxisCollection

BackColor

Gets or sets the background color for the control.

Declaration

public override Color BackColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

BackgroundImage

Gets or sets the background image displayed in the control.

Declaration

public override Image BackgroundImage { get; set; }

Property Value

Type	Description
System.Drawing.Image

BackInterior

Gets or sets backcolor of the chart control.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public BrushInfo BackInterior { get; set; }

Property Value

Type	Description
BrushInfo

BorderAppearance

Gets or sets the border appearance.

Declaration

[ChartTemplate(ChartTemplateSet.Content)]
public ChartBorderInfo BorderAppearance { get; set; }

Property Value

Type	Description
ChartBorderInfo	The border appearance.

CalcRegions

Gets or sets a value indicating whether calculate the regions for visual update. If ToolTips, AutoHighlighting, or RegionHit events are used, set this to True (default). If the previous aren't used, for better performance set to False.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool CalcRegions { get; set; }

Property Value

Type	Description
System.Boolean

ChartArea

Gets the chart area of the ChartControl.

Declaration

[ChartTemplate(ChartTemplateSet.Content)]
public ChartArea ChartArea { get; }

Property Value

Type	Description
ChartArea

ChartAreaBackImage

The chart can display an image as its background. This property specifies the image to be used as the background.

Declaration

public Image ChartAreaBackImage { get; set; }

Property Value

Type	Description
System.Drawing.Image

ChartAreaMargins

Gets or sets a value that indicates the margins that will be deduced from the ChartArea's representation rectangle. Negative values are supported.

Declaration

public ChartMargins ChartAreaMargins { get; set; }

Property Value

Type	Description
ChartMargins

ChartAreaShadow

Gets or sets a value indicating whether display the chart area shadow.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool ChartAreaShadow { get; set; }

Property Value

Type	Description
System.Boolean	true if [chart area shadow]; otherwise, false.

ChartAreaToolTip

Gets or sets the ToolTip text that is to be displayed when the mouse is over the area of the chart but not over other elements of interest within the chart area.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public string ChartAreaToolTip { get; set; }

Property Value

Type	Description
System.String

ChartContextMenu

Gets the configuration information for the chart context menu object

Declaration

public ChartContextMenu ChartContextMenu { get; }

Property Value

Type	Description
ChartContextMenu

ChartInterior

Gets or sets the interior of the chart. Please refer to BrushInfo for more information.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public BrushInfo ChartInterior { get; set; }

Property Value

Type	Description
BrushInfo

ChartInteriorBackImage

The chart can display an image as its interior background. This property specifies the image to be used as the chart interior background.

Declaration

public Image ChartInteriorBackImage { get; set; }

Property Value

Type	Description
System.Drawing.Image

ChartRegions

Gets the list of ChartRegions. Please refer to ChartRegion for more information.

Declaration

public ChartRegionCollection ChartRegions { get; }

Property Value

Type	Description
ChartRegionCollection

ChartToolTip

Gets or sets the ToolTip text that is to be displayed when the mouse is over the chart but not over other elements of interest within the chart.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public string ChartToolTip { get; set; }

Property Value

Type	Description
System.String

ClickPoint

Gets last mouse position on the chartcontrol on mouse click.

Declaration

public Point ClickPoint { get; }

Property Value

Type	Description
System.Drawing.Point	The mouse position

Remarks

This property is used for zooming only.

ColumnDrawMode

Gets or sets the mode of drawing the column chart. See also ColumnWidthMode.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public ChartColumnDrawMode ColumnDrawMode { get; set; }

Property Value

Type	Description
ChartColumnDrawMode

ColumnFixedWidth

Gets or sets the width of each column when ColumnWidthMode is set to FixedWidthMode.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public int ColumnFixedWidth { get; set; }

Property Value

Type	Description
System.Int32

ColumnWidthMode

Gets or sets the mode of column drawing. See also ColumnDrawMode.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public ChartColumnWidthMode ColumnWidthMode { get; set; }

Property Value

Type	Description
ChartColumnWidthMode

CompatibleSeries

Gets or sets a value indicating whether the series are compatible.

Declaration

public bool CompatibleSeries { get; set; }

Property Value

Type	Description
System.Boolean

Controls

Gets the collection of controls contained within the control.

Declaration

public Control.ControlCollection Controls { get; }

Property Value

Type	Description
System.Windows.Forms.Control.ControlCollection

Crosshair

Gets or sets the Crosshair. Use this property to customize crosshair line and crosshair tooltip

Declaration

public ChartCrosshair Crosshair { get; set; }

Property Value

Type	Description
ChartCrosshair

Cursor

Gets or sets the cursor that is displayed when the mouse pointer is over the control.

Declaration

public override Cursor Cursor { get; set; }

Property Value

Type	Description
System.Windows.Forms.Cursor

CustomPalette

Gets or sets an array of custom palette colors. If Palette is Custom this colors is to be used to provide colors of series and other elements. This property duplicates CustomColors property. Palette

Declaration

public Color[] CustomPalette { get; set; }

Property Value

Type	Description
System.Drawing.Color[]

CustomPoints

Gets the collection of custom points. Please refer to ChartCustomPoint for more information.

Declaration

public ChartCustomPointCollection CustomPoints { get; }

Property Value

Type	Description
ChartCustomPointCollection

DataSourceName

Gets or sets the name of data source bound with chart control in ChartWizard

Declaration

public string DataSourceName { get; set; }

Property Value

Type	Description
System.String

DataSourceType

Gets or sets the type of object bounded with Chart in Chart Wizard.

Declaration

public string DataSourceType { get; set; }

Property Value

Type	Description
System.String

Depth

Gets or sets axes depth, "coordinate Z". Only for enabled Series3D.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public float Depth { get; set; }

Property Value

Type	Description
System.Single

DesignTimeSeriesType

This property specifies the SeriesType to be displayed during design-time. Series displayed during design-time will be reset during run-time and are provided for representative display only.

Declaration

public ChartSeriesType DesignTimeSeriesType { get; set; }

Property Value

Type	Description
ChartSeriesType

DisplayChartContextMenu

Gets or sets a value indicating whether the Chart Context menu should be shown. This is used only if ShowContextMenu is true.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool DisplayChartContextMenu { get; set; }

Property Value

Type	Description
System.Boolean

DisplaySeriesContextMenu

Gets or sets a value indicating whether the Series Context Menu should be shown. This is used only if ShowContextMenu is true.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool DisplaySeriesContextMenu { get; set; }

Property Value

Type	Description
System.Boolean

DockingManager

Gets a reference to the ChartDockingManager that manages the position of elements on the chart, like the legend.

Declaration

[ChartTemplate(ChartTemplateSet.Content)]
public ChartDockingManager DockingManager { get; }

Property Value

Type	Description
ChartDockingManager

DropSeriesPoints

When a huge amount of points are drawn on the chart and these points can't be drawn correctly because of monitor resolution. Then performance can be improved by dropping points ( not drawing ). This property controls the intelligent point dropping. Default is false.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public bool DropSeriesPoints { get; set; }

Property Value

Type	Description
System.Boolean

ElementsSpacing

Gets or sets value for spacing from border inside ChartControl e.g. space between ChartControl right border and legend right border if LegendPosition set to right.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public int ElementsSpacing { get; set; }

Property Value

Type	Description
System.Int32

EnableMouseRotation

Gets or sets a value indicating whether the mouse rotation should be enabled.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public bool EnableMouseRotation { get; set; }

Property Value

Type	Description
System.Boolean

EnableXZooming

Gets or sets a value indicating whether zooming should be enabled for the chart along the X axis.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool EnableXZooming { get; set; }

Property Value

Type	Description
System.Boolean

EnableYZooming

Gets or sets a value indicating whether zooming should be enabled for the chart along the Y axis.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool EnableYZooming { get; set; }

Property Value

Type	Description
System.Boolean

FancyToolTipController

Gets the fancy tool tip controller.

Declaration

public ChartFancyToolTipController FancyToolTipController { get; }

Property Value

Type	Description
ChartFancyToolTipController	The fancy tool tip controller.

ForeColor

Gets or sets Chart's ForeColor. This member overrides System.Windows.Forms.Control.ForeColor

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public override Color ForeColor { get; set; }

Property Value

Type	Description
System.Drawing.Color

FormatAxisLabels

Gets whether ChartFormatAxisLabel event will be fired or not

Declaration

public bool FormatAxisLabels { get; }

Property Value

Type	Description
System.Boolean

HidePartialLabels

Gets or sets a value indicating whether if a partially visible axis label should be hidden or shown. Default is false.

Declaration

[Obsolete("Use ChartAxis.HidePartialLabels instead.")]
[ChartTemplate(ChartTemplateSet.Simple)]
public bool HidePartialLabels { get; set; }

Property Value

Type	Description
System.Boolean

HighlightSymbol

Gets or sets a value indicating whether symbols on the series should be highlighted when the mouse hovers over them or not.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool HighlightSymbol { get; set; }

Property Value

Type	Description
System.Boolean	true if [highlight symbol]; otherwise, false.

ImprovePerformance

Gets or sets a value indicating whether improve the chart performance. If set this property instructs chart to calculate axes ranges only before painting, not at avery series adding or removing. So while adding a large number of points to a series, performance is improved significantly.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool ImprovePerformance { get; set; }

Property Value

Type	Description
System.Boolean

Indexed

Specifies if this chart is to be rendered in indexed mode. By default, chart points have X and Y values, both of which are taken into account for plotting. In indexed mode, the X values are ignored. The X axis purely represents the position of the points and not their X value. This mode is useful when representing data that has no real X axis value except position. For example, sales of two months side-by-side.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public bool Indexed { get; set; }

Property Value

Type	Description
System.Boolean

IndexValues

Gets a collection of all the indexed values. It's used for indexed mode.

Declaration

public ChartIndexedValues IndexValues { get; }

Property Value

Type	Description
ChartIndexedValues

InteractiveCursorMouseDown

Gets a value indicating whether the state of Interactive mouse cursor is down.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public bool InteractiveCursorMouseDown { get; }

Property Value

Type	Description
System.Boolean

InvertedSeriesIsCompatible

Gets or sets a value indicating whether the inverted series is compatible

Declaration

public bool InvertedSeriesIsCompatible { get; set; }

Property Value

Type	Description
System.Boolean

IsWindowLess

Gets or sets a value indicating whether the chart control is working as simple object. If it's true then chart don't uses functional of the control.

Declaration

public bool IsWindowLess { get; set; }

Property Value

Type	Description
System.Boolean

KeyZoom

Gets or sets a value that Enables or Disables zooming with keyboard shortcuts.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public bool KeyZoom { get; set; }

Property Value

Type	Description
System.Boolean

Legend

Gets the configuration information for the default legend object. Please refer to ChartLegend for more information.

Declaration

[ChartTemplate(ChartTemplateSet.Content)]
public ChartLegend Legend { get; }

Property Value

Type	Description
ChartLegend

LegendAlignment

Gets or sets the legend alignment.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public ChartAlignment LegendAlignment { get; set; }

Property Value

Type	Description
ChartAlignment

LegendPainted

Gets or sets a value indicating whether legend is painted.

Declaration

[Obsolete("This property isn't used anymore.")]
public bool LegendPainted { get; set; }

Property Value

Type	Description
System.Boolean	true if [legend painted]; otherwise, false.

LegendPosition

Gets or sets the position of the legend element. Please refer to Position for more information on legend positioning options. Default is Right.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public ChartDock LegendPosition { get; set; }

Property Value

Type	Description
ChartDock

Legends

Gets a collection of ChartLegends that are shown in the chart. The first one is the default Legend.

Declaration

public ChartLegendsList Legends { get; }

Property Value

Type	Description
ChartLegendsList

LegendsPlacement

Gets or sets a value indicates whether legends is located inside or outside of chart.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public ChartPlacement LegendsPlacement { get; set; }

Property Value

Type	Description
ChartPlacement	The legends placement.

Localize

Gets or sets the localize.

Declaration

public string Localize { get; set; }

Property Value

Type	Description
System.String

MinZoomFactorX

Gets or sets the minimum allowable zooming factor for X axis.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public double MinZoomFactorX { get; set; }

Property Value

Type	Description
System.Double

MinZoomFactorY

Gets or sets the minimum allowable zooming factor for Y axis.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public double MinZoomFactorY { get; set; }

Property Value

Type	Description
System.Double

Model

The model contains all the data that is associated with a chart. Models can be shared between charts. Each model can be seen as a collection of a series. Each of these series contains data points and associated style information.

Declaration

public ChartModel Model { get; set; }

Property Value

Type	Description
ChartModel

MouseAction

Gets or sets the mouse action.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public ChartMouseAction MouseAction { get; set; }

Property Value

Type	Description
ChartMouseAction	The mouse action.

MouseDownPosition

Gets the last mouse position on the chartcontrol when the any mouse button was pressed.

Declaration

public Point MouseDownPosition { get; }

Property Value

Type	Description
System.Drawing.Point

Remarks

This property is used for zooming only.

NeedPerformance

Gets or sets a value indicating whether improve the Performance. This property will automatically set to true when BeginUpdate() is called and improve the ChartType rendering time. So while adding a large number of points to a series, performance is improved significantly.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool NeedPerformance { get; set; }

Property Value

Type	Description
System.Boolean

NeedRegionUpdate

Gets or sets indicating whether the Regions are need to update. It specifies if the internal ChartRegions are to be updated. Also redraws the chart.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool NeedRegionUpdate { get; set; }

Property Value

Type	Description
System.Boolean

Palette

Gets or sets the palette that is to be used to provide default colors for series and other elements of a chart. Please refer to ChartColorPalette for available options and customization.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public ChartColorPalette Palette { get; set; }

Property Value

Type	Description
ChartColorPalette

Polar

Gets a value indicating whether the chart is Polar. This returns True if type of the first series is ChartSeriesType.Polar.

Declaration

public bool Polar { get; }

Property Value

Type	Description
System.Boolean

PrimaryXAxis

Gets the primary X axis.

Declaration

[ChartTemplate(ChartTemplateSet.Content)]
public ChartAxis PrimaryXAxis { get; }

Property Value

Type	Description
ChartAxis	The primary X axis.

PrimaryYAxis

Gets the primary Y axis.

Declaration

[ChartTemplate(ChartTemplateSet.Content)]
public ChartAxis PrimaryYAxis { get; }

Property Value

Type	Description
ChartAxis	The primary Y axis.

PrintColorMode

Gets or sets the print color mode.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public ChartPrintColorMode PrintColorMode { get; set; }

Property Value

Type	Description
ChartPrintColorMode	The print color mode.

PrintDocument

Gets the print document.

Declaration

public ChartPrintDocument PrintDocument { get; }

Property Value

Type	Description
ChartPrintDocument	The print document.

Radar

Gets a value indicating whether the chart is Radar. This returns True if type of the first series is ChartSeriesType.Radar.

Declaration

public bool Radar { get; }

Property Value

Type	Description
System.Boolean

RadarStyle

Gets or sets a value indicates the style of the radar chart.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public ChartRadarAxisStyle RadarStyle { get; set; }

Property Value

Type	Description
ChartRadarAxisStyle

RealMode3D

Gets or sets a value indicating whether the chart should be displayed in a 3D plane.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool RealMode3D { get; set; }

Property Value

Type	Description
System.Boolean

RequireAxes

Gets or sets a value indicating whether the chart requires axes.

Declaration

public bool RequireAxes { get; set; }

Property Value

Type	Description
System.Boolean

RequireInvertedAxes

Gets or sets a value indicating whether the chart requires inverted axes.

Declaration

public bool RequireInvertedAxes { get; set; }

Property Value

Type	Description
System.Boolean

ResetOnDoubleClick

Gets or sets a value indicating whether to reset the chart on double click

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public bool ResetOnDoubleClick { get; set; }

Property Value

Type	Description
System.Boolean	true if [show scroll bars]; otherwise, false.

Rotation

Gets or sets the angle rotation of axes relative to axis X.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public float Rotation { get; set; }

Property Value

Type	Description
System.Single

RoundingPlaces

Gets or sets the number of places to round data to for display (by default).

Declaration

[Obsolete("This property is useless")]
public int RoundingPlaces { get; set; }

Property Value

Type	Description
System.Int32

ScrollPrecision

Gets or sets the scroll precision. Specifies the scrolling accuracy of the scroll bars.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public int ScrollPrecision { get; set; }

Property Value

Type	Description
System.Int32	The scroll precision.

Series

Shortcut method that provides access to the ChartSeriesCollection contained in the chart's model.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleAndCollection, typeof(ChartSeries))]
public ChartSeriesCollection Series { get; }

Property Value

Type	Description
ChartSeriesCollection

Series3D

Specifies if the chart is displayed as 3D.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool Series3D { get; set; }

Property Value

Type	Description
System.Boolean

SeriesContextMenu

Gets the configuration information for the series context menu object

Declaration

public ChartSeriesContextMenu SeriesContextMenu { get; }

Property Value

Type	Description
ChartSeriesContextMenu

SeriesHighlight

Specified if series on the chart should be highlighted when the mouse hovers over them or on legend item.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool SeriesHighlight { get; set; }

Property Value

Type	Description
System.Boolean

SeriesHighlightIndex

Specifies the series's index when mouse hovering on the legend item and the correspnding series will be highlighted. It is used for internal purpose. If it is set externally, only the specified series will be others won't.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public int SeriesHighlightIndex { get; set; }

Property Value

Type	Description
System.Int32

ShadowColor

Gets or sets color of shadow.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public BrushInfo ShadowColor { get; set; }

Property Value

Type	Description
BrushInfo

ShadowWidth

Gets or sets width of shadow.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public int ShadowWidth { get; set; }

Property Value

Type	Description
System.Int32

ShowContextMenu

Gets or sets a value indicating whether show the context menu. It specifies if chart area and series context menus can be shown. See DisplayChartContextMenu and DisplaySeriesContextMenu.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool ShowContextMenu { get; set; }

Property Value

Type	Description
System.Boolean

ShowContextMenuInLegend

Gets or sets a value indicating whether show the Context menu for the Legend. It specifies if the context menu in the legend is enabled.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool ShowContextMenuInLegend { get; set; }

Property Value

Type	Description
System.Boolean

ShowLegend

Gets or sets a value indicating whether display the ChartLegend or not.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool ShowLegend { get; set; }

Property Value

Type	Description
System.Boolean

ShowScrollBars

Gets or sets a value indicating whether show the scroll bars.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public bool ShowScrollBars { get; set; }

Property Value

Type	Description
System.Boolean	true if [show scroll bars]; otherwise, false.

ShowToolbar

Gets or sets a value indicating whether show the toolbar or not.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool ShowToolbar { get; set; }

Property Value

Type	Description
System.Boolean

ShowToolbarInImage

Gets or sets a value indicating whether [show toolbar while saving the Chartcontrol as image].

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool ShowToolbarInImage { get; set; }

Property Value

Type	Description
System.Boolean	true if [show toolbar in image]; otherwise, false.

ShowToolTips

Gets or sets a value indicating whether show the tool tips.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public bool ShowToolTips { get; set; }

Property Value

Type	Description
System.Boolean	true if [show tool tips]; otherwise, false.

SizeMargins

Gets size with minimal height and width of chart control with enough places to draw chart area. This property must be used generally by parent control of chart control in order to determine the size margins.

Declaration

[Obsolete("Use properties of ChartArea.")]
public Size SizeMargins { get; }

Property Value

Type	Description
System.Drawing.Size

Skins

Gets or sets the skin wich describes the appearance of the ChartControl.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public Skins Skins { get; set; }

Property Value

Type	Description
Skins

SmoothingMode

Specified how the chart elements should be rendered. Default is AntiAlias. Please refer to SmoothingMode in the GDI+ documentation for more information.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public SmoothingMode SmoothingMode { get; set; }

Property Value

Type	Description
System.Drawing.Drawing2D.SmoothingMode

Spacing

Spacing is set as a percentage value and controls what portion of the interval partitioned for rendering gets used for empty space. Default value is 10%.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public float Spacing { get; set; }

Property Value

Type	Description
System.Single

SpacingBetweenPoints

Gets or sets the spacing between points. Default value is 10%.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public float SpacingBetweenPoints { get; set; }

Property Value

Type	Description
System.Single	The spacing between points.

SpacingBetweenSeries

Series Spacing is set as a percentage value and it controls the spacing between the series. Default value is 10%.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public float SpacingBetweenSeries { get; set; }

Property Value

Type	Description
System.Single

Style3D

Specifies if the 3D chart is displayed with 3D style.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public bool Style3D { get; set; }

Property Value

Type	Description
System.Boolean

StyleDialogOptions

Gets the style dialog options.

Declaration

public ChartStyleDialogOptions StyleDialogOptions { get; }

Property Value

Type	Description
ChartStyleDialogOptions	The style dialog options.

Text

Specifies the default title text.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public override string Text { get; set; }

Property Value

Type	Description
System.String

TextAlignment

Gets or sets a value which specifies the alignment of the chart's text.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public StringAlignment TextAlignment { get; set; }

Property Value

Type	Description
System.Drawing.StringAlignment

TextPosition

Gets or sets the position of text displayed as the chart's caption. Please refer to ChartTextPosition for available options.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public ChartTextPosition TextPosition { get; set; }

Property Value

Type	Description
ChartTextPosition

TextRenderingHint

Gets or sets the way text is drawn. Default is SystemDefault.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public TextRenderingHint TextRenderingHint { get; set; }

Property Value

Type	Description
System.Drawing.Text.TextRenderingHint

Tilt

Gets or sets the angle tilt of axes relative to axis Y.

Declaration

[ChartTemplate(ChartTemplateSet.Simple)]
public float Tilt { get; set; }

Property Value

Type	Description
System.Single

Title

Gets the default title.

Declaration

public ChartTitle Title { get; }

Property Value

Type	Description
ChartTitle

Titles

Gets the list of ChartTitle entries. The first one is the default Title.

Declaration

public ChartTitlesList Titles { get; }

Property Value

Type	Description
ChartTitlesList

ToolBar

Gets the configuration information for the toolbar object.

Declaration

[ChartTemplate(ChartTemplateSet.Content)]
public ChartToolBarInfo ToolBar { get; }

Property Value

Type	Description
ChartToolBarInfo

Tooltip

Declaration

public ChartTooltip Tooltip { get; set; }

Property Value

Type	Description
ChartTooltip

Trackball

Gets or sets the trackball. Use this property to customize trackball line, tooltip, symbol etc..,

Declaration

public ChartTrackball Trackball { get; set; }

Property Value

Type	Description
ChartTrackball

VisualTheme

Declaration

public string VisualTheme { get; set; }

Property Value

Type	Description
System.String

ZoomCancel

Gets or sets the zoom cancel. Specifies the keyboard shortcut to control ZoomCancel.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public Keys ZoomCancel { get; set; }

Property Value

Type	Description
System.Windows.Forms.Keys	The zoom cancel.

ZoomDown

Gets or sets the zoom down. Specifies the keyboard shortcut to control Zoom down.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public Keys ZoomDown { get; set; }

Property Value

Type	Description
System.Windows.Forms.Keys	The zoom down.

ZoomFactorX

Gets or sets the ZoomFactor. The zooming factor is the value by which intervals are multiplied to have the effect of a more fine grained range. For example, if the calculated interval is 5 and the zoom factor is 0.5, then the zoomed interval with this zoom factor will be 2.5. Therefore, there will be twice as many interval points across the same range. Scrollbars will automatically appear to allow any section of the zoomed range to be viewed.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public double ZoomFactorX { get; set; }

Property Value

Type	Description
System.Double

ZoomFactorY

The zooming factor is the value by which intervals are multiplied to have the effect of a more fine grained range. For example, if the calculated interval is 5 and the zoom factor is 0.5, then the zoomed interval with this zoom factor will be 2.5. Therefore, there will be twice as many interval points across the same range. Scrollbars will automatically appear to allow any section of the zoomed range to be viewed.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public double ZoomFactorY { get; set; }

Property Value

Type	Description
System.Double

ZoomIn

Gets or sets the zoom in. Specifies the keyboard shortcut to control Zoom in.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public Keys ZoomIn { get; set; }

Property Value

Type	Description
System.Windows.Forms.Keys	The zoom in.

Zooming

Gets a value indicating the chart is currently zoomed in.

Declaration

[ChartTemplate(ChartTemplateSet.ContentBehavior)]
public ChartZooming Zooming { get; }

Property Value

Type	Description
ChartZooming

ZoomLeft

Gets or sets the keyboard shortcut to control zoom left

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public Keys ZoomLeft { get; set; }

Property Value

Type	Description
System.Windows.Forms.Keys

ZoomOut

Gets or sets the zoom out. Specifies the keyboard shortcut to control zoom out.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public Keys ZoomOut { get; set; }

Property Value

Type	Description
System.Windows.Forms.Keys	The zoom out.

ZoomOutIncrement

Gets or sets what value to add to the ZoomFactors when the zoom out button is pressed.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public double ZoomOutIncrement { get; set; }

Property Value

Type	Description
System.Double

ZoomPositionX

Gets or sets the offset position when zoomed along the X axis.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public double ZoomPositionX { get; set; }

Property Value

Type	Description
System.Double

ZoomPositionY

Gets or sets the offset position when zoomed along the Y axis.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public double ZoomPositionY { get; set; }

Property Value

Type	Description
System.Double

ZoomRight

Gets or sets the zoom right keyboard shortcut..

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public Keys ZoomRight { get; set; }

Property Value

Type	Description
System.Windows.Forms.Keys	The zoom right.

ZoomType

Gets or sets the zooming type.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public ZoomType ZoomType { get; set; }

Property Value

Type	Description
ZoomType	The zooming type.

ZoomUp

Gets or sets the zoom up keyboard shortcut.

Declaration

[ChartTemplate(ChartTemplateSet.SimpleBehavior)]
public Keys ZoomUp { get; set; }

Property Value

Type	Description
System.Windows.Forms.Keys	The zoom up.

Methods

AppendSeries(ChartSeries, ChartPoint)

Append point to series.

Declaration

[Obsolete("This method is not used anymore. Use ChartSeries.Points collection.")]
public void AppendSeries(ChartSeries series, ChartPoint point)

Parameters

Type	Name	Description
ChartSeries	series	The series.
ChartPoint	point	The point.

BeginUpdate()

Call this method if you perform multiple changes in quick succession. EndUpdate()

Declaration

public void BeginUpdate()

BeginUpdate(Boolean)

When we called this method then it improves the performance by dropping some points(not drawing). This method controls the intelligent point dropping and also it disables some visual related features like tooltip. EndUpdate()

Declaration

public void BeginUpdate(bool improvePerformance)

Parameters

Type	Name	Description
System.Boolean	improvePerformance	if set to true [improve performance].

ChartAreaPointToChartControl(Point)

The ChartAreaPointToChartControl method takes a point object in ChartArea coordinates and returns a point object in ChartControl coordinates.

Declaration

public Point ChartAreaPointToChartControl(Point p)

Parameters

Type	Name	Description
System.Drawing.Point	p	The point in ChartArea coordinates.

Returns

Type	Description
System.Drawing.Point	A System.Drawing.Point value that represents the point in ChartControl coordinates.

ChartAreaRectToChartControl(RectangleF)

The ChartAreaRectToChartControl method takes a RectangleF object in ChartArea coordinates and returns a RectangleF object in ChartControl coordinates.

Declaration

public RectangleF ChartAreaRectToChartControl(RectangleF rect)

Parameters

Type	Name	Description
System.Drawing.RectangleF	rect	The RectangleF in ChartArea coordinates.

Returns

Type	Description
System.Drawing.RectangleF	A System.Drawing.RectangleF value that represents the RectangleF in ChartControl coordinates.

DisplayUserEditStylesDialog(Int32)

Displays the dialog to edit user styles for a series.

Declaration

public void DisplayUserEditStylesDialog(int seriesIndex)

Parameters

Type	Name	Description
System.Int32	seriesIndex	The index of the series.

DisplayWizard()

Displays the Wizard.

Declaration

public void DisplayWizard()

Dispose(Boolean)

Dispose this control and its children.

Declaration

protected override void Dispose(bool disposing)

Parameters

Type	Name	Description
System.Boolean	disposing	true to release both managed and unmanaged resources; false to release only unmanaged resources.

Draw(Graphics, Rectangle)

Paints the chart to graphics.

Declaration

public void Draw(Graphics g, Rectangle rc)

Parameters

Type	Name	Description
System.Drawing.Graphics	g	Instance of the System.Drawing.Graphics.
System.Drawing.Rectangle	rc	The Rectangle within which to paint.

Draw(Graphics, Size)

Paints the chart to graphics.

Declaration

public void Draw(Graphics g, Size sz)

Parameters

Type	Name	Description
System.Drawing.Graphics	g	Instance of the System.Drawing.Graphics.
System.Drawing.Size	sz	The size of rectangle within which to paint.

Draw(Image)

Paints the chart to image.

Declaration

public void Draw(Image img)

Parameters

Type	Name	Description
System.Drawing.Image	img	Instance of the System.Drawing.Image.

Draw(Image, Size)

Paints the chart to image.

Declaration

public void Draw(Image img, Size sz)

Parameters

Type	Name	Description
System.Drawing.Image	img	Instance of the System.Drawing.Image.
System.Drawing.Size	sz	The size of rectangle within which to paint.

DrawThumbnail(Image)

Paints the thumbnail of chart to image.

Declaration

public void DrawThumbnail(Image img)

Parameters

Type	Name	Description
System.Drawing.Image	img	Instance of the System.Drawing.Image.

DrawThumbnail(Image, Rectangle)

Paints the thumbnail of chart to image.

Declaration

public void DrawThumbnail(Image img, Rectangle r)

Parameters

Type	Name	Description
System.Drawing.Image	img	Instance of the System.Drawing.Image.
System.Drawing.Rectangle	r	The rectangle within which to paint.

EndUpdate()

Call this method if you called BeginUpdate() earlier and you are done with your changes. BeginUpdate()

Declaration

public void EndUpdate()

GetChartAreaBounds()

The GetChartAreaBounds method provides access to the bounds of the ChartArea.

Declaration

public Rectangle GetChartAreaBounds()

Returns

Type	Description
System.Drawing.Rectangle	A System.Drawing.Rectangle value of the bounds of the ChartArea in ChartControl coordinates.

GetChartAreaCoordinates(DateTime, DateTime)

Returns the client coordinates on ChartArea for the primary x and y axes.

Declaration

[Obsolete("This method is obsolete. Use the ChartArea.GetPointByValue or ChartAxis.GetVisibleValue methods.")]
public Point GetChartAreaCoordinates(DateTime xValue, DateTime yValue)

Parameters

Type	Name	Description
System.DateTime	xValue	An X System.DateTime value.
System.DateTime	yValue	An Y System.DateTime value.

Returns

Type	Description
System.Drawing.Point	The coordinates on ChartArea.

GetChartAreaCoordinates(DateTime, DateTime, ChartAxis, ChartAxis)

Returns the client coordinates on ChartArea for the specified data points in the specified axes.

Declaration

[Obsolete("This method is obsolete. Use the ChartArea.GetPointByValue or ChartAxis.GetVisibleValue methods.")]
public Point GetChartAreaCoordinates(DateTime xValue, DateTime yValue, ChartAxis xAxis, ChartAxis yAxis)

Parameters

Type	Name	Description
System.DateTime	xValue	An X System.DateTime value.
System.DateTime	yValue	An Y System.DateTime value.
ChartAxis	xAxis	An X axis.
ChartAxis	yAxis	An Y axis.

Returns

Type	Description
System.Drawing.Point	The coordinates on ChartArea.

GetChartAreaCoordinates(DateTime, Double)

Returns the client coordinates on ChartArea for the primary x and y axes.

Declaration

[Obsolete("This method is obsolete. Use the ChartArea.GetPointByValue or ChartAxis.GetVisibleValue methods.")]
public Point GetChartAreaCoordinates(DateTime xValue, double yValue)

Parameters

Type	Name	Description
System.DateTime	xValue	An X System.DateTime value.
System.Double	yValue	An Y value.

Returns

Type	Description
System.Drawing.Point	The coordinates on ChartArea.

GetChartAreaCoordinates(DateTime, Double, ChartAxis, ChartAxis)

Returns the client coordinates on ChartArea for the specified data points in the specified axes.

Declaration

[Obsolete("This method is obsolete. Use the ChartArea.GetPointByValue or ChartAxis.GetVisibleValue methods.")]
public Point GetChartAreaCoordinates(DateTime xValue, double yValue, ChartAxis xAxis, ChartAxis yAxis)

Parameters

Type	Name	Description
System.DateTime	xValue	An X System.DateTime value.
System.Double	yValue	An Y value.
ChartAxis	xAxis	An X axis.
ChartAxis	yAxis	An Y axis.

Returns

Type	Description
System.Drawing.Point	The coordinates on ChartArea.

GetChartAreaCoordinates(Double, DateTime)

Returns the client coordinates on ChartArea for the primary x and y axes.

Declaration

[Obsolete("This method is obsolete. Use the ChartArea.GetPointByValue or ChartAxis.GetVisibleValue methods.")]
public Point GetChartAreaCoordinates(double xValue, DateTime yValue)

Parameters

Type	Name	Description
System.Double	xValue	An X value.
System.DateTime	yValue	An Y System.DateTime value.

Returns

Type	Description
System.Drawing.Point	The coordinates on ChartArea.

GetChartAreaCoordinates(Double, DateTime, ChartAxis, ChartAxis)

Returns the client coordinates on ChartArea for the specified data points in the specified axes.

Declaration

[Obsolete("This method is obsolete. Use the ChartArea.GetPointByValue or ChartAxis.GetVisibleValue methods.")]
public Point GetChartAreaCoordinates(double xValue, DateTime yValue, ChartAxis xAxis, ChartAxis yAxis)

Parameters

Type	Name	Description
System.Double	xValue	An X value.
System.DateTime	yValue	An Y System.DateTime value.
ChartAxis	xAxis	An X axis.
ChartAxis	yAxis	An Y axis.

Returns

Type	Description
System.Drawing.Point	The coordinates on ChartArea.

GetChartAreaCoordinates(Double, Double)

Returns the client coordinates on ChartArea for the primary x and y axes.

Declaration

[Obsolete("This method is obsolete. Use the ChartArea.GetPointByValue or ChartAxis.GetVisibleValue methods.")]
public Point GetChartAreaCoordinates(double xValue, double yValue)

Parameters

Type	Name	Description
System.Double	xValue	An X value.
System.Double	yValue	An Y value.

Returns

Type	Description
System.Drawing.Point	The coordinates on ChartArea.

GetChartAreaCoordinates(Double, Double, ChartAxis, ChartAxis)

Returns the client coordinates on ChartArea for the specified data points in the specified axes.

Declaration

[Obsolete("This method is obsolete. Use the ChartArea.GetPointByValue or ChartAxis.GetVisibleValue methods.")]
public Point GetChartAreaCoordinates(double xValue, double yValue, ChartAxis xAxis, ChartAxis yAxis)

Parameters

Type	Name	Description
System.Double	xValue	An X value.
System.Double	yValue	An Y value.
ChartAxis	xAxis	An X axis.
ChartAxis	yAxis	An Y axis.

Returns

Type	Description
System.Drawing.Point	The coordinates on ChartArea.

GetChartAreaCoordinateX(DateTime)

Returns the matching X client coordinate on ChartArea for the specified X date time value in the specified axis.

Declaration

[Obsolete("This method is obsolete. Use the ChartArea.GetPointByValue or ChartAxis.GetVisibleValue methods.")]
public int GetChartAreaCoordinateX(DateTime xValue)

Parameters

Type	Name	Description
System.DateTime	xValue	An X System.DateTime value.

Returns

Type	Description
System.Int32	The X coordinate on ChartArea.

GetChartAreaCoordinateX(DateTime, ChartAxis)

Returns the matching X client coordinate on ChartArea for the specified X value in the specified axis.

Declaration

[Obsolete("This method is obsolete. Use the ChartArea.GetPointByValue or ChartAxis.GetVisibleValue methods.")]
public int GetChartAreaCoordinateX(DateTime xValue, ChartAxis xAxis)

Parameters

Type	Name	Description
System.DateTime	xValue	An X System.DateTime value.
ChartAxis	xAxis	An X axis.

Returns

Type	Description
System.Int32	The X coordinate on ChartArea.

GetChartAreaCoordinateX(Double)

Returns the matching X client coordinate on ChartArea for the specified X value.

Declaration

[Obsolete("This method is obsolete. Use the ChartArea.GetPointByValue or ChartAxis.GetVisibleValue methods.")]
public int GetChartAreaCoordinateX(double xValue)

Parameters

Type	Name	Description
System.Double	xValue	An X value.

Returns

Type	Description
System.Int32	The X coordinate on ChartArea.

GetChartAreaCoordinateX(Double, ChartAxis)

Returns the matching X client coordinate on ChartArea for the specified X value in the specified axis.

Declaration

[Obsolete("This method is obsolete. Use the ChartArea.GetPointByValue or ChartAxis.GetVisibleValue methods.")]
public int GetChartAreaCoordinateX(double xValue, ChartAxis xAxis)

Parameters

Type	Name	Description
System.Double	xValue	An X value.
ChartAxis	xAxis	An X axis.

Returns

Type	Description
System.Int32	The X coordinate on ChartArea.

GetChartAreaCoordinateY(DateTime)

Returns a Y client coordinate on ChartArea for the specified Y value.

Declaration

[Obsolete("This method is obsolete. Use the ChartArea.GetPointByValue or ChartAxis.GetVisibleValue methods.")]
public int GetChartAreaCoordinateY(DateTime yValue)

Parameters

Type	Name	Description
System.DateTime	yValue	An Y System.DateTime value.

Returns

Type	Description
System.Int32	The Y coordinate on ChartArea.

GetChartAreaCoordinateY(DateTime, ChartAxis)

Returns a Y client coordinate on ChartArea for the specified Y value on the specified axis.

Declaration

[Obsolete("This method is obsolete. Use the ChartArea.GetPointByValue or ChartAxis.GetVisibleValue methods.")]
public int GetChartAreaCoordinateY(DateTime yValue, ChartAxis yAxis)

Parameters

Type	Name	Description
System.DateTime	yValue	An Y System.DateTime value.
ChartAxis	yAxis	An Y axis.

Returns

Type	Description
System.Int32	The Y coordinate on ChartArea.

GetChartAreaCoordinateY(Double)

Returns the Y client coordinate on ChartArea for the specified Y value.

Declaration

[Obsolete("This method is obsolete. Use the ChartArea.GetPointByValue or ChartAxis.GetVisibleValue methods.")]
public int GetChartAreaCoordinateY(double yValue)

Parameters

Type	Name	Description
System.Double	yValue	An Y value.

Returns

Type	Description
System.Int32	The Y coordinate on ChartArea.

GetChartAreaCoordinateY(Double, ChartAxis)

Returns the Y client coordinate on ChartArea for the specified Y value in the specified axis.

Declaration

[Obsolete("This method is obsolete. Use the ChartArea.GetPointByValue or ChartAxis.GetVisibleValue methods.")]
public int GetChartAreaCoordinateY(double yValue, ChartAxis yAxis)

Parameters

Type	Name	Description
System.Double	yValue	An Y value.
ChartAxis	yAxis	An Y axis.

Returns

Type	Description
System.Int32	The Y coordinate on ChartArea.

GetChartRegions()

List of all ChartRegion objects that make up the ChartControl.

Declaration

[Obsolete("This method is obsolete. Use the ChartControl.ChartRegions property.")]
public IList GetChartRegions()

Returns

Type	Description
System.Collections.IList	A System.Collections.IList of the ChartRegions.

GetGraphics()

Creates the instance of Graphics for the control.

Declaration

public Graphics GetGraphics()

Returns

Type	Description
System.Drawing.Graphics	Graphics context.

GetHScrollBar(ChartAxis)

Returns the horizontal scrollbar corresponding to the axis supplied.

Declaration

public IChartScrollBar GetHScrollBar(ChartAxis axis)

Parameters

Type	Name	Description
ChartAxis	axis	Instance of ChartAxis.

Returns

Type	Description
IChartScrollBar	The object that implements interface IChartScrollBar.

GetMinSize()

Returns the minimum size needed to display the chart.

Declaration

public SizeF GetMinSize()

Returns

Type	Description
System.Drawing.SizeF	Minimal size.

GetRegionFromIndexed(Int32, Int32)

Returns the ChartRegion corresponding to the series and point indexed supplied.

Declaration

public ChartRegion GetRegionFromIndexed(int seriesIndex, int pointIndex)

Parameters

Type	Name	Description
System.Int32	seriesIndex	Index of the series.
System.Int32	pointIndex	Index of the point.

Returns

Type	Description
ChartRegion	The ChartRegion.

GetSideBySideInfo(ChartSeries, ChartSeriesRenderer)

Returns the value of side by side displacement in pixels.

Declaration

[Obsolete("This method isn't used anymore and may be deleted.")]
public PointF GetSideBySideInfo(ChartSeries ser, ChartSeriesRenderer renderer)

Parameters

Type	Name	Description
ChartSeries	ser	Instance of ChartSeries.
ChartSeriesRenderer	renderer	Instance of ChartSeriesRenderer.

Returns

Type	Description
System.Drawing.PointF	A instance of PointF where X - location of side; Y - width of side.

GetSideBySideInfoValue(ChartSeries, ChartSeriesRenderer)

Returns the value of side by side displacement in chart coordinates.

Declaration

[Obsolete("This method isn't used anymore and may be deleted.")]
public ChartPoint GetSideBySideInfoValue(ChartSeries ser, ChartSeriesRenderer renderer)

Parameters

Type	Name	Description
ChartSeries	ser	Instance of ChartSeries.
ChartSeriesRenderer	renderer	Instance of ChartSeriesRenderer.

Returns

Type	Description
ChartPoint	A instance of ChartPoint where X - location of side; Y - width of side.

GetStackInfo(ChartSeries, Int32)

This method is used when series are rendered stacked. The value returned is a cumulative value of Y from all series that are below the series passed in in the contained ChartSeriesCollection. ChartSeriesRenderer

Declaration

[Obsolete("This method isn't used anymore and may be deleted.")]
public double GetStackInfo(ChartSeries ser, int pos)

Parameters

Type	Name	Description
ChartSeries	ser	Instance of the ChartSeries.
System.Int32	pos	The index value of the point

Returns

Type	Description
System.Double	A sum of Y values from all series are below the series.

GetStackInfo(ChartSeries, Int32, Boolean)

This method is used when series are rendered stacked. The value returned is a cumulative value of Y from all series that are below the series passed in in the contained ChartSeriesCollection. ChartSeriesRenderer

Declaration

[Obsolete("This method isn't used anymore and may be deleted.")]
public double GetStackInfo(ChartSeries ser, int pos, bool isWithMe)

Parameters

Type	Name	Description
ChartSeries	ser	Instance of the ChartSeries.
System.Int32	pos	The index value of the point
System.Boolean	isWithMe	If true the value form this series added too.

Returns

Type	Description
System.Double	A sum of Y values from all series are below the series.

GetVScrollBar(ChartAxis)

Returns the vertical scrollbar corresponding to the axis supplied.

Declaration

public IChartScrollBar GetVScrollBar(ChartAxis axis)

Parameters

Type	Name	Description
ChartAxis	axis	Instance of ChartAxis.

Returns

Type	Description
IChartScrollBar	The object that implements interface IChartScrollBar.

IsRandomSeries(ChartSeries)

Checks is whether a series is added by ChartControl (Random datas).

Declaration

public static bool IsRandomSeries(ChartSeries series)

Parameters

Type	Name	Description
ChartSeries	series	Instance of the ChartSeries.

Returns

Type	Description
System.Boolean	True if the series is added by ChartControl.

NotifySeriesChanged()

Calls the SeriesChanged(Object, ChartSeriesCollectionChangedEventArgs) method.

Declaration

public void NotifySeriesChanged()

OnBackColorChanged(EventArgs)

This member overrides System.Windows.Forms.Control.OnBackColorChanged(System.EventArgs).

Declaration

protected override void OnBackColorChanged(EventArgs e)

Parameters

Type	Name	Description
System.EventArgs	e	An EventArgs that contains the event data.

OnChartFormatAxisLabel(ChartAxis, ChartFormatAxisLabelEventArgs)

Raises the ChartFormatAxisLabelevent.

Declaration

public void OnChartFormatAxisLabel(ChartAxis axis, ChartFormatAxisLabelEventArgs args)

Parameters

Type	Name	Description
ChartAxis	axis	Instance of ChartAxis.
ChartFormatAxisLabelEventArgs	args	Argument.

OnClick(EventArgs)

This member overrides System.Windows.Forms.Control.OnClick(System.EventArgs).

Declaration

protected override void OnClick(EventArgs e)

Parameters

Type	Name	Description
System.EventArgs	e	An System.EventArgs that contains the event data.

OnDoubleClick(EventArgs)

This member overrides System.Windows.Forms.Control.OnDoubleClick(System.EventArgs).

Declaration

protected override void OnDoubleClick(EventArgs e)

Parameters

Type	Name	Description
System.EventArgs	e	An System.EventArgs that contains the event data.

OnFontChanged(EventArgs)

This member overrides System.Windows.Forms.Control.OnFontChanged(System.EventArgs).

Declaration

protected override void OnFontChanged(EventArgs e)

Parameters

Type	Name	Description
System.EventArgs	e	An System.EventArgs that contains the event data.

OnForeColorChanged(EventArgs)

Raises the System.Windows.Forms.Control.ForeColorChanged event.

Declaration

protected override void OnForeColorChanged(EventArgs e)

Parameters

Type	Name	Description
System.EventArgs	e	An System.EventArgs that contains the event data.

OnLayoutCompleted(Object, EventArgs)

Raises the LayoutCompleted event.

Declaration

public void OnLayoutCompleted(object sender, EventArgs e)

Parameters

Type	Name	Description
System.Object	sender	The sender of the event.
System.EventArgs	e	An System.EventArgs object that contains the event data.

OnLostFocus(EventArgs)

This member overrides System.Windows.Forms.Control.OnLostFocus(System.EventArgs).

Declaration

protected override void OnLostFocus(EventArgs e)

Parameters

Type	Name	Description
System.EventArgs	e	An System.EventArgs that contains the event data.

OnMouseDown(MouseEventArgs)

This member overrides System.Windows.Forms.Control.OnMouseDown(System.Windows.Forms.MouseEventArgs).

Declaration

protected override void OnMouseDown(MouseEventArgs e)

Parameters

Type	Name	Description
System.Windows.Forms.MouseEventArgs	e	A System.Windows.Forms.MouseEventArgs that contains the event data.

OnMouseLeave(EventArgs)

This member overrides System.Windows.Forms.Control.OnMouseLeave(System.EventArgs).

Declaration

protected override void OnMouseLeave(EventArgs e)

Parameters

Type	Name	Description
System.EventArgs	e	An System.EventArgs that contains the event data.

OnMouseMove(MouseEventArgs)

This member overrides System.Windows.Forms.Control.OnMouseMove(System.Windows.Forms.MouseEventArgs).

Declaration

protected override void OnMouseMove(MouseEventArgs e)

Parameters

Type	Name	Description
System.Windows.Forms.MouseEventArgs	e	A System.Windows.Forms.MouseEventArgs that contains the event data.

OnMouseUp(MouseEventArgs)

This member overrides System.Windows.Forms.Control.OnMouseUp(System.Windows.Forms.MouseEventArgs).

Declaration

protected override void OnMouseUp(MouseEventArgs e)

Parameters

Type	Name	Description
System.Windows.Forms.MouseEventArgs	e	A System.Windows.Forms.MouseEventArgs that contains the event data.

OnMouseWheel(MouseEventArgs)

This member overrides System.Windows.Forms.Control.OnMouseWheel(System.Windows.Forms.MouseEventArgs).

Declaration

protected override void OnMouseWheel(MouseEventArgs e)

Parameters

Type	Name	Description
System.Windows.Forms.MouseEventArgs	e	A System.Windows.Forms.MouseEventArgs that contains the event data.

OnSeriesIncompatible(Object, EventArgs)

Raises the SeriesIncompatible event.

Declaration

public void OnSeriesIncompatible(object sender, EventArgs e)

Parameters

Type	Name	Description
System.Object	sender	The sender of the event.
System.EventArgs	e	An System.EventArgs object that contains the event data.

OnSizeChanged(EventArgs)

Raises the System.Windows.Forms.Control.SizeChanged event.

Declaration

protected override void OnSizeChanged(EventArgs e)

Parameters

Type	Name	Description
System.EventArgs	e	Argument.

OnTextChanged(EventArgs)

This member overrides System.Windows.Forms.Control.OnTextChanged(System.EventArgs).

Declaration

protected override void OnTextChanged(EventArgs e)

Parameters

Type	Name	Description
System.EventArgs	e	An System.EventArgs that contains the event data.

RecalculateSizes()

Updates necessary sizes.

Declaration

public virtual void RecalculateSizes()

RecalculateSizes(Graphics)

Updates necessary sizes.

Declaration

public virtual void RecalculateSizes(Graphics g)

Parameters

Type	Name	Description
System.Drawing.Graphics	g	Instance of Graphics.

Redraw(Boolean)

Forces the redraw of the Chart Area.

Declaration

public void Redraw(bool update)

Parameters

Type	Name	Description
System.Boolean	update	true to redraw chart area; otherwise,false to use buffered image.

Refresh()

This method overrides System.Windows.Forms.Control.Refresh

Declaration

public override void Refresh()

ResetText()

Used by the designer to reset the current value of the Text property.

Declaration

public override void ResetText()

SaveImage(String)

Saves the chart as an image in the specified format.

Declaration

public void SaveImage(string filename)

Parameters

Type	Name	Description
System.String	filename	The filename with extension that specifies the type of format to save to.

Remarks

Supported formats are bmp, jpg, gif, tiff, wmf, emf, svg and eps.

SeriesChanged(Object, ChartSeriesCollectionChangedEventArgs)

Method is called when the series was changed.

Declaration

public void SeriesChanged(object sender, ChartSeriesCollectionChangedEventArgs e)

Parameters

Type	Name	Description
System.Object	sender
ChartSeriesCollectionChangedEventArgs	e

SetLegend(ChartLegend)

This method is not used anymore. Use the Legends collection.

Declaration

[Obsolete("This method is not used anymore. Please use Legends collection.")]
public void SetLegend(ChartLegend legend)

Parameters

Type	Name	Description
ChartLegend	legend	Instance of the new legend.

WndProc(ref Message)

Declaration

protected override void WndProc(ref Message m)

Parameters

Type	Name	Description
System.Windows.Forms.Message	m

ZoomingChanged(ChartAxis)

Call this method for updated settings of the scrollbar corresponding to the axis supplied.

Declaration

public void ZoomingChanged(ChartAxis axis)

Parameters

Type	Name	Description
ChartAxis	axis	An Axis that indicates the scrollbar.

Events

ChartAreaPaint

Event that is raised when the ChartArea is painted.

Declaration

public event PaintEventHandler ChartAreaPaint

Event Type

Type	Description
System.Windows.Forms.PaintEventHandler

ChartAxisLabelClick

Event that will be raised when the mouse is clicked on an axis label.

Declaration

public event EventHandler<ChartRegionMouseEventArgs> ChartAxisLabelClick

Event Type

Type	Description
System.EventHandler<ChartRegionMouseEventArgs>

ChartFormatAxisLabel

Event for dynamic formatting of axis labels.

Declaration

public event ChartFormatAxisLabelEventHandler ChartFormatAxisLabel

Event Type

Type	Description
ChartFormatAxisLabelEventHandler

ChartImage

Event that is raised when image is created for chart.

Declaration

public event ChartAreaImageEventHandler ChartImage

Event Type

Type	Description
ChartAreaImageEventHandler

ChartRegionClick

Event that will be raised when the mouse is clicked within a chart region.

Declaration

public event ChartRegionMouseEventHandler ChartRegionClick

Event Type

Type	Description
ChartRegionMouseEventHandler

ChartRegionDoubleClick

Event that will be raised when the mouse is double clicked within a chart region.

Declaration

public event ChartRegionMouseEventHandler ChartRegionDoubleClick

Event Type

Type	Description
ChartRegionMouseEventHandler

ChartRegionMouseDown

Event that will be raised when the mouse is pressed down within a chart region.

Declaration

public event ChartRegionMouseEventHandler ChartRegionMouseDown

Event Type

Type	Description
ChartRegionMouseEventHandler

ChartRegionMouseEnter

Event that will be raised when the mouse enters a chart region.

Declaration

public event ChartRegionMouseEventHandler ChartRegionMouseEnter

Event Type

Type	Description
ChartRegionMouseEventHandler

ChartRegionMouseHover

Event that will be raised when the mouse hovers over a chart region.

Declaration

public event ChartRegionMouseEventHandler ChartRegionMouseHover

Event Type

Type	Description
ChartRegionMouseEventHandler

ChartRegionMouseLeave

Event that will be raised when the mouse leaves a chart region.

Declaration

public event ChartRegionMouseEventHandler ChartRegionMouseLeave

Event Type

Type	Description
ChartRegionMouseEventHandler

ChartRegionMouseMove

Event that will be raised when the mouse is released within a chart region.

Declaration

public event ChartRegionMouseEventHandler ChartRegionMouseMove

Event Type

Type	Description
ChartRegionMouseEventHandler

ChartRegionMouseUp

Event that will be raised when the mouse is released within a chart region.

Declaration

public event ChartRegionMouseEventHandler ChartRegionMouseUp

Event Type

Type	Description
ChartRegionMouseEventHandler

LayoutCompleted

Event that will be raised when Chart has completed laying out of axes, legend

Declaration

public event EventHandler LayoutCompleted

Event Type

Type	Description
System.EventHandler

PreChartAreaPaint

Event that is raised before the ChartArea is painted.

Declaration

public event PaintEventHandler PreChartAreaPaint

Event Type

Type	Description
System.Windows.Forms.PaintEventHandler

SeriesIncompatible

Event that will be raised when Chart completed updating series and finds out that series are incompatible.

Declaration

public event EventHandler SeriesIncompatible

Event Type

Type	Description
System.EventHandler

VisibleRangeChanged

Event that will be raised when the visible range changes during zooming.

Declaration

public event EventHandler VisibleRangeChanged

Event Type

Type	Description
System.EventHandler

VisibleRangeChanging

Event that will be raised when the visible range is changing during zooming.

Declaration

public event ChartAxisZoomingEventHandler VisibleRangeChanging

Event Type

Type	Description
ChartAxisZoomingEventHandler

Explicit Interface Implementations

IChartAreaHost.IsDesignTime

Gets a value indicating whether it's design time.

Declaration

bool IChartAreaHost.IsDesignTime { get; }

Returns

Type	Description
System.Boolean	true if it's design time; otherwise, false.

Implements

IChartAreaHost

IVisualStyle

Extension Methods

Extension.In<T>(T, T[])

DateTimeExtension.ToDateTime(Object)