ChartControl.BeginInit() Method

Starts the ChartControl‘s initialization. Initialization occurs at runtime.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v19.1.UI.dll

Declaration

C#

public void BeginInit()

VB.NET

Public Sub BeginInit

Remarks

The Visual Studio .NET design-time environment calls this method to start initializing a component used on a form, or by another component. The ChartControl.EndInit method ends the initialization. Use the BeginInit and EndInit methods to prevent the control from recalculating its layout.

Note

Calling the BeginInit method prevents any validation from being performed until the ChartControl.EndInit method is called. This may lead to unexpected results in the case of any initialization errors.

Note that chart’s layout is recalculated in the following cases:

• A chart is being rendered.
• When getting the Range.MinValue, Range.MaxValue, Range.MinValueInternal, Range.MaxValueInternal, Range.Auto, Range.AutoSideMargins, Range.SideMarginsValue, DateTimeScaleOptions.MeasureUnit and SeriesBase.ActualArgumentScaleType property values.
• The ChartControl.EndInit, XYDiagram2D.DiagramToPoint, RadarDiagram.DiagramToPoint and XYDiagram2D.ShowCrosshair methods are called.

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#

how-to-create-custom-legend-radio-buttons-to-control-visibility-of-a-chart-series-e4951/CS/MainForm.cs#L17

InitializeComponent();
chartControl.BeginInit();
{

VB.NET

how-to-create-custom-legend-radio-buttons-to-control-visibility-of-a-chart-series-e4951/VB/MainForm.vb#L19

initializationFlag = True
chartControl.BeginInit()
chartControl.Legend.UseCheckBoxes = True