Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

ChartControl.AutoLayout Property

Gets or sets a value, which specifies whether the adaptive layout feature is enabled for chart elements in the chart control.

Namespace: DevExpress.XtraCharts

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

NuGet Package: DevExpress.Win.Charts

#Declaration

public bool AutoLayout { get; set; }

#Property Value

Type Description
Boolean

true, to apply the adaptive layout algorithm to the chart; otherwise, false.

#Remarks

The adaptive layout feature is used to maintain a better chart appearance and layout when the chart becomes smaller.

To accomplish this task, the chart elements that have a Visibility property (e.g., a legend (LegendBase.Visibility), an axis (Axis2D.Visibility), an axis title (AxisTitle.Visibility) or a chart title (DockableTitle.Visibility)) are hidden.

Elements are hidden in the following order:

  1. Legends
  2. Axis Titles
  3. Series Titles
  4. Pane Titles
  5. Axes
  6. Chart Title
  7. Breadcrumbs

In addition, the label position inside bars can be changed for those labels for which the BarSeriesLabel.Position property is set to BarSeriesLabelPosition.Auto mode (the default value).

The following images demonstrate the AutoLayout property in action for SideBySideBarSeriesView.

AutoLayout =true (the default value) AutoLayout = false
AutoLayout_true AutoLayout_false

In the case of pie and donut charts, the Dimension property for SimpleDiagram and SimpleDiagram3D is calculated automatically during resizing. For instance, when you decrease chart size, all pies (donuts) are placed in one line horizontally (by row) or vertically (by column) in the diagram to occupy all the available free space.

#Example

The following code disables AutoLayout:

chartControl1.AutoLayout = false;
See Also