ChartControl.BeginInit() Method

Starts the ChartControl initialization.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v23.2.UI.dll

NuGet Package: DevExpress.Win.Charts

Declaration

C#

public void BeginInit()

VB.NET

Public Sub BeginInit

Remarks

To finish the control initialization, use the ChartControl.EndInit method. Call the BeginInit and EndInit methods to prevent the chart layout’s recalculation until the initialization is complete.

Note

The BeginInit method prevents any validation until the ChartControl.EndInit method is called.

The chart’s layout is recalculated in the following cases:

• A chart is being rendered

• When you use the following properties:

  • DateTimeScaleOptions.MeasureUnit, DateTimeScaleOptions.MeasureUnitMultiplier
  • DateTimeSummaryOptions.MeasureUnit, DateTimeSummaryOptions.MeasureUnitMultiplier
  • Range.Auto
  • Range.AutoSideMargins
  • Range.EndSideMargin, Range.StartSideMargin
  • Range.MaxValue, Range.MinValue
  • Range.MaxValueInternal, Range.MinValueInternal
  • Range.SideMarginSizeUnit
  • Range.SideMarginsValue
  • Range.Tag
  • SeriesBase.ActualArgumentScaleType
  • TimeSpanScaleOptions.MeasureUnit, TimeSpanScaleOptions.MeasureUnitMultiplier

• When you call the following methods:

  • ChartControl.CalcHitInfo
  • ChartControl.DrillDownToArgument, ChartControl.DrillDownToSeries, ChartControl.DrillDownToSeriesPoint, ChartControl.DrillUp
  • ChartControl.EndInit
  • ChartControl.SaveToFile, ChartControl.SaveToStream
  • Range.SetMinMaxValues
  • RadarDiagram.DiagramToPoint, RadarDiagram.PointToDiagram
  • WorkspaceManager.SaveLayout with a ChartControl object passed as a parameter
  • XYDiagram2D.DiagramToPoint, XYDiagram2D.PointToDiagram
  • XYDiagram2D.ShowCrosshair

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the BeginInit() method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-chart-create-custom-legend-radio-buttons-to-control-visibility-of-a-chart-series/CS/MainForm.cs#L16

InitializeComponent();
chartControl.BeginInit(); {
    chartControl.LegendItemChecked += OnLegendItemChecked;

VB.NET

winforms-chart-create-custom-legend-radio-buttons-to-control-visibility-of-a-chart-series/VB/MainForm.vb#L22

InitializeComponent()
chartControl.BeginInit()
If True Then