WinForms

  • Code Examples
  • Upgrade Guide
  • User Guide
  • Demos
  • Support
  • Forums
  • Download
Class ChartControl

    Show / Hide Table of Contents

    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
    Back to top Generated by DocFX
    Copyright © 2001 - 2023 Syncfusion Inc. All Rights Reserved