ChartControl.Diagram Property

Gets the chart control’s diagram and provides access to its settings.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v19.2.dll

Declaration

C#

public Diagram Diagram { get; set; }

VB.NET

Public Property Diagram As Diagram

Property Value

Type	Description
Diagram	A Diagram object that represents the chart control’s diagram.

Remarks

The Diagram is one of the basic chart elements, because it represents series data. Its most significant characteristic is type, allowing representation of only those series that are compatible with this diagram, within it.

To learn more on diagrams of different types, and to see which series types are compatible with each diagram types, refer to Diagram.

Example

The following example demonstrates how to create a 2D Side-by-Side Bar. To do this, it is necessary to assign the ChartControl.Diagram property to XYDiagram2D, and then add two series with points to the diagram’s Diagram.Series collection.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-create-a-2d-side-by-side-bar-chart-e1257.

Window1.xaml

<Window x:Class="SideBySideBar2DChart.Window1" 
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
        xmlns:dxc="http://schemas.devexpress.com/winfx/2008/xaml/charts" 
        Title="Window1" Height="350" Width="620">
    <Grid>
        <dxc:ChartControl Name="chartControl1">
            <dxc:ChartControl.Diagram>
                <dxc:XYDiagram2D>
                    <dxc:XYDiagram2D.Series>
                        <dxc:BarSideBySideSeries2D DisplayName="First Series" BarWidth="0.5">
                            <!--region #Model-->
                            <dxc:BarSideBySideSeries2D.Model>
                                <dxc:Quasi3DBar2DModel />
                            </dxc:BarSideBySideSeries2D.Model>
                            <!--endregion #Model-->
                            <dxc:BarSideBySideSeries2D.Points>
                                <dxc:SeriesPoint Argument="A" Value="1" />
                                <dxc:SeriesPoint Argument="B" Value="2" />
                                <dxc:SeriesPoint Argument="C" Value="3" />
                                <dxc:SeriesPoint Argument="D" Value="4" />
                            </dxc:BarSideBySideSeries2D.Points>
                        </dxc:BarSideBySideSeries2D>
                        <dxc:BarSideBySideSeries2D DisplayName="Second Series" BarWidth="0.5">
                            <!--region #Model2-->
                            <dxc:BarSideBySideSeries2D.Model>
                                <dxc:Quasi3DBar2DModel />
                            </dxc:BarSideBySideSeries2D.Model>
                            <!--endregion #Model2-->
                            <dxc:BarSideBySideSeries2D.Points>
                                <dxc:SeriesPoint Argument="A" Value="4" />
                                <dxc:SeriesPoint Argument="B" Value="3" />
                                <dxc:SeriesPoint Argument="C" Value="2" />
                                <dxc:SeriesPoint Argument="D" Value="1" />
                            </dxc:BarSideBySideSeries2D.Points>
                        </dxc:BarSideBySideSeries2D>
                    </dxc:XYDiagram2D.Series>
                </dxc:XYDiagram2D>
            </dxc:ChartControl.Diagram>
            <dxc:ChartControl.Legend>
                <dxc:Legend />
            </dxc:ChartControl.Legend>
        </dxc:ChartControl>
    </Grid>
</Window>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Diagram property.

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-integrate-dxchart-with-rangecontrol/CS/WpfApplication45/MainWindow.xaml#L17

<dxc:ChartControl Name="chartControl1" DataSource="{Binding  ElementName=mainWindow, Path=ChartData}" BoundDataChanged="chartControl1_BoundDataChanged">
    <dxc:ChartControl.Diagram>
        <dxc:XYDiagram2D   >

how-to-create-a-gadget-style-application-with-a-chart-e2464/VB/MainWindow.xaml#L7

</dxc:ChartControl.Effect>
<dxc:ChartControl.Diagram>
    <dxc:XYDiagram2D Margin="-15,-15,-10,-15">

pivotgridcontrol-and-gaugecontrol-integration-e3332/CS/PivotGauges/MainWindow.xaml#L10

<dxc:ChartControl Name="chartControl1" DataSource="{Binding ElementName=pivot, Path=ChartDataSource}">
    <dxc:ChartControl.Diagram>
        <dxc:XYDiagram2D  SeriesDataMember="Series">

how-to-display-custom-tooltips-over-the-data-point-currently-hovered-by-the-mouse-pointer-e1376/CS/Window1.xaml#L9

              MouseLeave="chartControl1_MouseLeave">
<dxc:ChartControl.Diagram>
    <dxc:XYDiagram2D>

how-to-apply-a-watermark-to-chartcontrol-e3767/VB/Q357477/MainWindow.xaml#L11

<dxc:ChartControl Name="chartControl1">
    <dxc:ChartControl.Diagram>
        <dxc:XYDiagram2D>

VB.NET

how-to-update-chart-data-at-runtime-e3554/VB/DXCharts_Runtime/MainWindow.xaml.vb#L26

diagram.ActualAxisX.ActualRange.SideMarginsEnabled = False
chart.Diagram = diagram

how-to-programmatically-create-a-chart-e3553/VB/DXCharts_Runtime/MainWindow.xaml.vb#L20

Dim diagram As New XYDiagram2D()
chart.Diagram = diagram

how-to-show-the-crosshair-cursor-programmatically-t466164/VB/ShowCrosshairExample/MainWindow.xaml.vb#L15

Private Sub OnChartControlMouseUp(ByVal sender As Object, ByVal e As MouseButtonEventArgs)
    Dim xyDiagram As XYDiagram2D = TryCast(chartControl.Diagram, XYDiagram2D)
    If xyDiagram Is Nothing Then

how-to-save-and-restore-chart-layout/VB/SaveLayoutSample/MainWindow.xaml.vb#L52

BindingOperations.SetBinding(seriesDataMemberEdit, BarEditItem.EditValueProperty, New Binding("SeriesDataMember") With {.Source = chartControl.Diagram})
BindingOperations.SetBinding(argumentDataMemberEdit, BarEditItem.EditValueProperty, New Binding("ArgumentDataMember") With {.Source = seriesTemplate})

wpf-dashboard-how-to-obtain-clicked-item-data/VB/Dashboard_ClientDataCards_Wpf/MainWindow.xaml.vb#L60

Dim diagram As New XYDiagram2D()
chart.Diagram = diagram
Dim series1 As New SplineAreaSeries2D()