SunnyUI/SunnyUI/Charts/UIBarChartOption.cs

426 lines
12 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/******************************************************************************
* SunnyUI 开源控件库、工具类库、扩展类库、多页面开发框架。
* CopyRight (C) 2012-2021 ShenYongHua(沈永华).
* QQ群56829229 QQ17612584 EMailSunnyUI@QQ.Com
*
* Blog: https://www.cnblogs.com/yhuse
* Gitee: https://gitee.com/yhuse/SunnyUI
* GitHub: https://github.com/yhuse/SunnyUI
*
* SunnyUI.dll can be used for free under the GPL-3.0 license.
* If you use this code, please keep this note.
* 如果您使用此代码,请保留此说明。
******************************************************************************
* 文件名称: UIBarChartOption.cs
* 文件说明: 柱状图配置类
* 当前版本: V3.0
* 创建日期: 2020-06-06
*
* 2020-06-06: V2.2.5 增加文件说明
******************************************************************************/
using System;
using System.Collections.Generic;
using System.Drawing;
namespace Sunny.UI
{
public sealed class UIBarOption : UIOption, IDisposable
{
public UIAxis XAxis { get; set; } = new UIAxis(UIAxisType.Category);
public UIBarToolTip ToolTip { get; set; } = new UIBarToolTip();
public UIAxis YAxis { get; set; } = new UIAxis(UIAxisType.Value);
public List<UIBarSeries> Series = new List<UIBarSeries>();
public UIChartGrid Grid = new UIChartGrid();
public readonly List<UIScaleLine> XAxisScaleLines = new List<UIScaleLine>();
public readonly List<UIScaleLine> YAxisScaleLines = new List<UIScaleLine>();
public bool ShowValue { get; set; }
/// <summary>
/// BarChartEx用固定每个序列Bar个数
/// </summary>
public int FixedSeriesCount { get; set; } = 0;
/// <summary>
/// BarChartEx用自动调整为显示每个Bar等宽
/// </summary>
public bool AutoSizeBars { get; set; }
public bool AutoSizeBarsCompact { get; set; }
public float AutoSizeBarsCompactValue { get; set; } = 1.0f;
public void AddSeries(UIBarSeries series)
{
Series.Add(series);
}
public void Dispose()
{
foreach (var series in Series)
{
series?.Dispose();
}
Series.Clear();
}
public int SeriesCount => Series.Count;
public UIBarSeries this[string seriesName]
{
get
{
foreach (var item in Series)
{
if (item.Name == seriesName) return item;
}
return null;
}
}
}
public class UIBarToolTip : UIChartToolTip
{
public UIAxisPointer AxisPointer = new UIAxisPointer();
public UIBarToolTip()
{
Formatter = "{{b}} : {{c}}";
ValueFormat = "F0";
}
}
public class UIAxisPointer
{
public UIAxisPointerType Type { get; set; } = UIAxisPointerType.Line;
}
public enum UIAxisPointerType
{
Line, Shadow
}
public class UIAxis
{
public UIAxis()
{
}
public UIAxis(UIAxisType axisType)
{
Type = axisType;
}
public string Name { get; set; }
public UIAxisType Type { get; }
/// <summary>
/// 坐标轴的分割段数,需要注意的是这个分割段数只是个预估值
/// 最后实际显示的段数会在这个基础上根据分割后坐标轴刻度显示的易读程度作调整。
/// 在类目轴中无效。
/// </summary>
public int SplitNumber { get; set; } = 5;
/// <summary>
/// 是否是脱离 0 值比例。设置成 true 后坐标刻度不会强制包含零刻度。在双数值轴的散点图中比较有用。
/// </summary>
public bool Scale { get; set; }
/// <summary>
/// 坐标轴刻度
/// </summary>
public UIAxisTick AxisTick = new UIAxisTick();
/// <summary>
/// 坐标轴标签
/// </summary>
public UIAxisLabel AxisLabel = new UIAxisLabel();
public bool MaxAuto { get; set; } = true;
public bool MinAuto { get; set; } = true;
public double Max { get; set; } = 100;
public double Min { get; set; } = 0;
public List<string> Data = new List<string>();
public bool ShowGridLine { get; set; } = true;
public void Clear()
{
Data.Clear();
}
public CustomLabels CustomLabels;
public bool HaveCustomLabels
{
get => CustomLabels != null && CustomLabels.Count > 0;
}
}
public class CustomLabels
{
public double Start { get; set; }
public double Interval { get; set; }
public int Count { get; set; }
public double IntervalMilliseconds { get; set; }
public UIAxisType AxisType { get; set; }
public List<string> Labels = new List<string>();
public double[] LabelValues()
{
double[] values = new double[Count + 1];
for (int i = 0; i <= Count; i++)
{
if (AxisType == UIAxisType.DateTime)
{
DateTimeInt64 dateTime = new DateTimeInt64(Start);
dateTime.AddMilliseconds(IntervalMilliseconds * i);
values[i] = dateTime.DoubleValue;
}
else
{
values[i] = Start + Interval * i;
}
}
return values;
}
public double Stop
{
get
{
if (AxisType == UIAxisType.DateTime)
{
DateTimeInt64 dateTime = new DateTimeInt64(Start);
dateTime.AddMilliseconds(IntervalMilliseconds * Count);
return dateTime.DoubleValue;
}
else
{
return Start + Interval * Count;
}
}
}
public CustomLabels(double start, double interval, int count)
{
Start = start;
Interval = Math.Abs(interval);
Count = Math.Max(2, count);
AxisType = UIAxisType.Value;
}
public CustomLabels(DateTime start, int intervalMilliseconds, int count)
{
Start = new DateTimeInt64(start);
IntervalMilliseconds = Math.Abs(intervalMilliseconds);
Count = Math.Max(2, count);
AxisType = UIAxisType.DateTime;
}
public void SetLabels(string[] labels)
{
Labels.Clear();
Labels.AddRange(labels);
}
public void AddLabel(string label)
{
Labels.Add(label);
}
public void ClearLabels()
{
Labels.Clear();
}
public string GetLabel(int i)
{
if (i < Labels.Count) return Labels[i];
else return string.Empty;
}
}
public class UIAxisLabel
{
/// <summary>
/// 是否显示刻度标签。
/// </summary>
public bool Show { get; set; } = true;
/// <summary>
/// 坐标轴刻度的显示间隔,在类目轴中有效。默认同 axisLabel.interval 一样。
/// 默认会采用标签不重叠的策略间隔显示标签。
/// 可以设置成 0 强制显示所有标签。
/// 如果设置为 1表示『隔一个标签显示一个标签』如果值为 2表示隔两个标签显示一个标签以此类推。
/// </summary>
public int Interval { get; set; } = 0;
public delegate string DoFormatter(double value, int index);
public event DoFormatter Formatter;
public int Angle { get; set; } = 0;
public string GetLabel(double value, int index, UIAxisType axisType = UIAxisType.Value)
{
switch (axisType)
{
case UIAxisType.Value:
return Formatter != null ? Formatter?.Invoke(value, index) : value.ToString("F" + DecimalCount);
case UIAxisType.DateTime:
DateTimeInt64 dt = new DateTimeInt64((long)value);
return Formatter != null ? Formatter?.Invoke(dt, index) : (DateTimeFormat.IsNullOrEmpty() ? dt.ToString() : dt.ToString(DateTimeFormat));
case UIAxisType.Category:
return Formatter != null ? Formatter?.Invoke(value, index) : value.ToString("F0");
}
return value.ToString("F2");
}
public string GetAutoLabel(double value, int decimalCount)
{
return value.ToString("F" + decimalCount);
}
/// <summary>
/// 小数位个数Formatter不为空时以Formatter为准
/// </summary>
public int DecimalCount { get; set; } = 0;
/// <summary>
/// 日期格式化字符串Formatter不为空时以Formatter为准
/// </summary>
public string DateTimeFormat { get; set; } = "HH:mm";
public bool AutoFormat { get; set; } = true;
}
public class UIAxisTick
{
/// <summary>
/// 类目轴中在为 true 的时候有效,可以保证刻度线和标签对齐。
/// </summary>
public bool AlignWithLabel { get; set; }
/// <summary>
/// 是否显示坐标轴刻度。
/// </summary>
public bool Show { get; set; } = true;
/// <summary>
/// 坐标轴刻度的长度。
/// </summary>
public int Length { get; set; } = 5;
/// <summary>
/// 坐标轴刻度的显示间隔,在类目轴中有效。默认同 axisLabel.interval 一样。
/// 默认会采用标签不重叠的策略间隔显示标签。
/// 可以设置成 0 强制显示所有标签。
/// 如果设置为 1表示『隔一个标签显示一个标签』如果值为 2表示隔两个标签显示一个标签以此类推。
/// </summary>
public int Interval { get; set; } = 0;
public int Distance { get; set; } = 0;
}
public class UIBarSeries : IDisposable
{
public string Name { get; set; }
public int MaxWidth { get; set; } = int.MaxValue;
public UISeriesType Type => UISeriesType.Bar;
public readonly List<string> BarName = new List<string>();
public readonly List<double> Data = new List<double>();
public readonly List<Color> Colors = new List<Color>();
public bool ShowBarName { get; set; }
public bool ShowValue { get; set; }
public float ShowValueFontSize { get; set; } = 0;
public void AddData(double value)
{
Data.Add(value);
if (DataColorChange != null)
{
Colors.Add(DataColorChange.Invoke(value));
}
}
public void AddData(double value, Color color)
{
Data.Add(value);
Colors.Add(color);
}
public void AddData(string name, double value)
{
BarName.Add(name);
AddData(value);
}
public void AddData(string name, double value, Color color)
{
BarName.Add(name);
AddData(value, color);
}
public void Dispose()
{
Data.Clear();
Colors.Clear();
}
public void Update(int index, double value)
{
if (Data.Count == 0) return;
if (index >= 0 && index < Data.Count)
{
Data[index] = value;
}
}
public delegate Color OnDataColorChangeEventHandler(double data);
public event OnDataColorChangeEventHandler DataColorChange;
public bool HaveCustomColor(int index)
{
return Colors.Count > 0 && index >= 0 && index < Colors.Count;
}
public void Clear()
{
BarName.Clear();
Data.Clear();
Colors.Clear();
}
}
}