WPFUI LiveCharts使用记录（一）柱状图

前言：LiveCharts是一个图标控件库集，可以实现柱状图、折线图、饼图、仪表盘等图表控件。而且最新版本支持全平台使用，实现的样例展示可以点击查看作者Alberto Rodríguez的 github仓库

1.背景

1.1 新建项目

这篇文章使用的是.NET framework4.7框架作为演示，使用MVVM的方式去绑定后台数据自定义柱状图的展示

1.2 引用NuGet包

2. 定义柱状图

2.1xmal代码

一、添加livecharts的引用

xmlns:lvc="clr-namespace:LiveCharts.Wpf;assembly=LiveCharts.Wpf"

二、新建柱状图

	<Grid>
        <lvc:CartesianChart />
    </Grid>

当然现在这样子还是不能满足我们的使用需求。下面对柱状图相关的属性进行讲解，这样子大家可以自定义的去修改自己想要修改的属性。

3. 属性

3.1Series

定义柱状图中可用数据，可以绑定一个或者多个，每个都可以自定义数值、颜色等属性

3.1.1 代码：

xaml：

		<lvc:CartesianChart Series="{Binding Achievement, UpdateSourceTrigger=PropertyChanged}">
            <lvc:CartesianChart.AxisX>
                <lvc:Axis Labels="{Binding StudentNameList}" />
            </lvc:CartesianChart.AxisX>
            <lvc:CartesianChart.AxisY>
                <lvc:Axis />
            </lvc:CartesianChart.AxisY>
        </lvc:CartesianChart>

ViewModel：

    public class MainViewModel
    {
        #region 属性
        private SeriesCollection achievement = new SeriesCollection();
        /// <summary>
        /// 成绩柱状图
        /// </summary>
        public SeriesCollection Achievement
        {
            get { return achievement; }
            set { achievement = value; }
        }

        private List<string> studentNameList;
        /// <summary>
        /// 学生名字
        /// </summary>
        public List<string> StudentNameList
        {
            get { return studentNameList; }
            set { studentNameList = value; }
        }

        #endregion


        #region 方法
        /// <summary>
        /// 成绩初始化
        /// </summary>
        public void Init()
        {
            //名字集合
            StudentNameList = new List<string>()
            {
                "张三",
                "李四",
                "王五",
                "赵六",
                "小明",
            };
            //成绩分数集合
            ChartValues<double> achievement = new ChartValues<double>();
            Random random = new Random();
            for (int i = 0; i < 5; i++)
            {
                achievement.Add(random.Next(60, 100));
            }
            var column = new ColumnSeries();
            column.DataLabels = true;
            column.Title = "成绩";
            column.Values = achievement;
            Achievement.Add(column);
        }
        #endregion
        public MainViewModel()
        {
            Init();
        }

    }

3.1.2 备注：

这里的代码直接复制是不能使用的，只是展示的作用，可以到示例代码中直接复制。Series是一个数据的集合类，柱状图的话使用的是ColumnSeries的集合类，下面说一下ColumnSeries使用的属性

3.1.3 ColumnSeries

属性	备注
Title	数据的标题，即图例上面的标题
Fill	柱状图颜色的前置颜色填充
DataLabels	是否显示数据，即在柱状图上显示数值
LabelsPosition	枚举值，数据显示的位置。Top:上端；Parallel：显示在中间，数值是横向显示；Perpendicular：显示在中间，数值是竖向显示。
Values	数据值的绑定，ChartValues是泛型，可以自己定义类型
LabelPoint	自定义数据显示方式，是一个委托，传入ChartPoint，返回string类型（即显示的数据）

3.2 LegendLocation

自定义数据标签显示的位置

值	备注
None	不显示标签
Top	在上面显示
Bottom	在下面显示
Left	在左边显示
Right	在右边显示

3.3 ChartLegend

自定义标签的样式，可以修改样式字体大小、字体颜色、字体显示方式等，也可以通过继承的方式，自己自定义相关的类来使用。

代码

<lvc:CartesianChart.ChartLegend>
     <lvc:DefaultLegend />
</lvc:CartesianChart.ChartLegend>

3.4 AxisX

定义X轴的属性

常用属性	备注
Labels	string集合。X轴显示的数据绑定
Separator	设定每个轴分隔符的大小，默认是自动根据图表大小和值的范围自动计算的，但是有时候是需要显示所有的标签的，这种情况下就要把step属性设置为1
Position	指定轴定位堆叠的位置

3.4.1 示例代码

 <lvc:CartesianChart.AxisX>
 	<lvc:Axis Labels="{Binding StudentNameList}" Position="LeftBottom"> 
 		<lvc:Axis.Separator>
 			<lvc:Separator Step="1" />
 		</lvc:Axis.Separator>
 	</lvc:Axis>
 </lvc:CartesianChart.AxisX>

3.5 AxisY

定义Y轴的属性，和X轴是一致的，这里不做过多的叙述

3.6 Zoom

定义用户可以滚动缩放的方向

枚举值	备注
X	X轴可以滚动
Y	Y轴可以滚动
XY	XY轴可以同时滚动
None	不能滚动

3.7 DataTooltip

自定义提示框显示内容

<lvc:CartesianChart.DataTooltip>
    <lvc:DefaultTooltip/>
</lvc:CartesianChart.DataTooltip>

可以通过继承的方式，去自定义显示的内容。需要IChartTooltip接口，实现里面的方法就可以自定义显示的内容了。属性可能需要自行挖掘一下，一般直接的修改是没有办法满足显示的需求的，还是自定义的比较好

4. 示例

xaml：

<Window
    x:Class="LivechartDemo.MainWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:local="clr-namespace:LivechartDemo"
    xmlns:lvc="clr-namespace:LiveCharts.Wpf;assembly=LiveCharts.Wpf"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    Title="MainWindow"
    Width="800"
    Height="450"
    mc:Ignorable="d">
    <Grid Margin="20,10">
        <lvc:CartesianChart LegendLocation="Bottom" Series="{Binding Achievement, UpdateSourceTrigger=PropertyChanged}" Zoom="None" >
            <lvc:CartesianChart.AxisX>
                <lvc:Axis Labels="{Binding StudentNameList}" Position="LeftBottom"> 
                    <lvc:Axis.Separator>
                        <lvc:Separator Step="1" />
                    </lvc:Axis.Separator>
                </lvc:Axis>
            </lvc:CartesianChart.AxisX>
            <lvc:CartesianChart.AxisY>
                <lvc:Axis />
            </lvc:CartesianChart.AxisY>
            <lvc:CartesianChart.ChartLegend>
                <lvc:DefaultLegend />
            </lvc:CartesianChart.ChartLegend>
            <lvc:CartesianChart.DataTooltip>
                <lvc:DefaultTooltip/>
            </lvc:CartesianChart.DataTooltip>
        </lvc:CartesianChart>
    </Grid>
</Window>

cs：

using LivechartDemo.ViewModels;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;

namespace LivechartDemo
{
    /// <summary>
    /// MainWindow.xaml 的交互逻辑
    /// </summary>
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            MainViewModel viewModel = new MainViewModel();
            InitializeComponent();
            this.DataContext = viewModel;
        }
    }
}

viewmodel:

using LiveCharts;
using LiveCharts.Wpf;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace LivechartDemo.ViewModels
{
    public class MainViewModel
    {
        #region 属性
        private SeriesCollection achievement = new SeriesCollection();
        /// <summary>
        /// 成绩柱状图
        /// </summary>
        public SeriesCollection Achievement
        {
            get { return achievement; }
            set { achievement = value; }
        }

        private List<string> studentNameList;
        /// <summary>
        /// 学生名字
        /// </summary>
        public List<string> StudentNameList
        {
            get { return studentNameList; }
            set { studentNameList = value; }
        }

        #endregion


        #region 方法
        /// <summary>
        /// 成绩初始化
        /// </summary>
        public void Init()
        {
            //名字集合
            StudentNameList = new List<string>()
            {
                "张三",
                "李四",
                "王五",
                "赵六",
                "小明",
            };
            //成绩分数集合
            ChartValues<double> achievement = new ChartValues<double>();
            Random random = new Random();
            for (int i = 0; i < 5; i++)
            {
                achievement.Add(random.Next(60, 100));
            }
            var column = new ColumnSeries();
            column.DataLabels = true;
            column.LabelsPosition = BarLabelPosition.Perpendicular;
            column.Title = "成绩";
            column.Values = achievement;
            Achievement.Add(column);
        }
        #endregion
        public MainViewModel()
        {
            Init();
        }

    }
}

5.写在最后

使用柱状图的时候，如果有每一列数据都想显示不同的数据和颜色的需求时。提供一个思路，一个数据的集合，每一个数据都是一个ColumnSeries对象，把SharesPosition设置为false，指定对应的填充颜色Fill，把DataLabels 设置成false，然后添加数据集合数量的数值为0的ChartValues 数据，然后在当前数据在数据集中所对应的位置的ChartValues 中数据附上值，这样子就可以只显示一个独立的数值和独立的颜色了。但是DataTooltip要改成自己自定义的。

6. 推荐博客

LiveCharts 系列
WPF LiveChart 图表详解