Version

Creating Chart in XAML Code

Topic Overview

Purpose

This topic provides detailed instruction on how to create the XamDataChart™ control in XAML code

Required Background

The following topics are prerequisites to understanding this topic:

Topic Purpose

This topic provides a general overview of the XamDataChart control

This topic explains how to create application project to use with Ultimate UI for Xamarin controls.

This topic provides information on how to get started with the XamDataChart control.

This topic provides information on requirements of Series objects in the XamDataChart control.

In this topic

This topic contains the following sections:

Overview

Preview

The following is the preview of the result of creating chart control in XAML code.

DataChart Creating Chart In Code Behind 1.png

Chart Requirements

The chart control supports various types of data visualizations called Series. These series objects can visualize wide range of data source. Refer to the Series Types topic for complete list of series supported in the chart control. Each type of series can plot data that meets certain requirements (such as number of data column and their types) as well as what type of axis can be used with it. Refer to the Series Requirements topic for requirements for each of the series.

For demonstration purpose, this topic uses Sample Energy Data with only one AreaSeries and two axes: CategoryXAxis and NumericYAxis.

Creating Application

  1. Create Xamarin.Forms application project using Visual Studio 2015+ or latest and call it SampleApp

  1. Add the following namespace declarations to the main XAML file:

In XAML:

xmlns:ig="clr-namespace:Infragistics.XamarinForms.Controls.Charts;assembly=Infragistics.XF.Charts"
xmlns:local="clr-namespace:SampleApp;assembly=SampleApp"

Adding Assembly References

See Add References Through NuGet Packages.

Creating Chart

Create an instance an instance of the chart control with settings for one series and two axes.

In XAML:

<ig:XamDataChart x:Name="Chart" >
    <ig:XamDataChart.Axes>
        <!-- axes here -->
    </ig:XamDataChart.Axes>
    <ig:XamDataChart.Series>
        <!-- series here  -->
    </ig:XamDataChart.Series>
</ig:XamDataChart >

Creating Data Source

  1. Copy sample data code from the Sample Energy Data resource and add it to the SampleApp project

  1. Create an instance of category sample data:

In XAML:

<ig:XamDataChart.Resources>
    <ResourceDictionary>
        <local:EnergyDataSource x:Key="data"/>
    </ResourceDictionary>
</ig:XamDataChart.Resources>

Creating Axes

Create category x-axis for displaying labels and numeric y-axis for displaying values

In XAML:

<ig:XamDataChart.Axes>
    <ig:CategoryXAxis x:Name="xAxis" ItemsSource="{StaticResource data}" Label="Country" />
    <ig:NumericYAxis  x:Name="yAxis" />
</ig:XamDataChart.Axes>

Creating Series

Create an instance of a series and with bounding to the sample data source and set data mapping. In addition, the series must have settings for two axes created in previous section.

In XAML:

<ig:XamDataChart.Series>
    <ig:AreaSeries ItemsSource="{StaticResource data}"
                  ValueMemberPath="Coal"
                  XAxis="{x:Reference xAxis}"
                  YAxis="{x:Reference yAxis}">
    </ig:AreaSeries>
</ig:XamDataChart.Series>

Related Content

Topics

The following topics provide additional information related to this topic.

Topic Purpose

This topic provides a general overview of the XamDataChart control

This topic provides information on how to get started with the XamDataChart control.

This topic provides information on requirements of Series objects in the XamDataChart control.