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

TdxCustomChartControl.Diagrams Property

Provides indexed access to all diagrams in the Chart control.

#Declaration

Delphi
property Diagrams[AIndex: Integer]: TdxChartCustomDiagram read; write; default;

#Property Value

Type Description
TdxChartCustomDiagram

A diagram.

Cast the returned object to the TdxChartXYDiagram or TdxChartSimpleDiagram class depending on the actual diagram type to access all public API members. Call the Diagrams.ClassType function to identify the target diagram type.

#Remarks

A diagram is a pane designed to display and manage series in the Chart control.

VCL Chart Control: Series in XY Diagrams

Use the DiagramCount property to obtain the number of diagrams accessible through the Diagrams property. To access only visible diagrams, use the VisibleDiagrams property.

#Available Diagram Types

Cast the Diagrams property value to the corresponding diagram class to access all diagram type-specific properties and methods. The Chart control ships with the following diagram classes:

TdxChartXYDiagram

A diagram designed to display series using the axis of arguments (X-axis) and the axis of values (Y-axis). An XY diagram can plot Area, Bar, and Line series.

VCL Chart Control: An XY Diagram Example with Area, Bar, and Line Series

TdxChartSimpleDiagram

A diagram intended to plot Pie and Doughnut series.

VCL Chart Control: A Simple Diagram Example with Pie and Doughnut Series

#Diagram Deletion

To delete a diagram, release it directly in code (call the Free procedure in Delphi or use the delete keyword in C++Builder).

See Also