/// <summary>
/// 基于.NET 3.5的Chart工具类;对应的DevExpress版本：12.1.7;
/// </summary>
public static class ChartUtilsV3
{ /// <summary>
/// 添加基本的Series
/// </summary>
/// <param name="chat">ChartControl</param>
/// <param name="seriesName">Series的名称</param>
/// <param name="seriesType">Series的类型</param>
/// <param name="dataSource">Series的绑定数据源</param>
/// <param name="argumentDataMember">ArgumentDataMember绑定字段名称</param>
/// <param name="valueDataMembers">ValueDataMembers的绑定字段数组</param>
/// <param name="visible">Series是否可见</param>
/// <returns>Series</returns>
public static Series AddBaseSeries(this ChartControl chat, string seriesName, ViewType seriesType, object dataSource, string argumentDataMember, string[] valueDataMembers, bool visible)
{
Series _baseSeries = new Series(seriesName, seriesType);
_baseSeries.ArgumentDataMember = argumentDataMember;
_baseSeries.ValueDataMembers.AddRange(valueDataMembers);
_baseSeries.DataSource = dataSource;
_baseSeries.Visible = visible;
chat.Series.Add(_baseSeries);
return _baseSeries;
}
/// <summary>
/// 设置SeriesTemplate参数
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="dataSource">SeriesTemplate的绑定数据源</param>
/// <param name="argumentDataMember">ArgumentDataMember绑定字段名称</param>
/// <param name="valueDataMembers">ValueDataMembers的绑定字段数组</param>
/// <param name="visible">SeriesTemplate是否可见</param>
/// <returns>SeriesBase</returns>
public static SeriesBase SetSeriesTemplate(this ChartControl chart, object dataSource, string argumentDataMember, string[] valueDataMembers, bool visible)
{
chart.SeriesTemplate.ValueDataMembers.AddRange(valueDataMembers);
chart.SeriesTemplate.ArgumentDataMember = argumentDataMember;
chart.SeriesTemplate.Visible = visible;
chart.DataSource = dataSource;
return chart.SeriesTemplate;
}
/// <summary>
/// 增加数据筛选
/// </summary>
/// <param name="series">SeriesBase</param>
/// <param name="columnName">列名称</param>
/// <param name="value">列名称对应的筛选数值</param>
/// <param name="dataFilterCondition">DataFilterCondition枚举</param>
public static void AddDataFilter(this SeriesBase series, string columnName, object value, DataFilterCondition dataFilterCondition)
{
series.DataFilters.Add(new DataFilter(columnName, value.GetType().FullName, dataFilterCondition, value));
} /// <summary>
/// 设置X轴Lable角度
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="angle">角度</param>
public static void SetXLableAngle(this ChartControl chart, int angle)
{
if (chart.Diagram is XYDiagram)
{
XYDiagram _xyDiagram = (XYDiagram)chart.Diagram;
if (_xyDiagram != null)
_xyDiagram.AxisX.Label.Angle = angle;
}
}
/// <summary>
/// 设置Y轴Lable角度
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="angle">角度</param>
public static void SetYLableAngle(this ChartControl chart, int angle)
{
if (chart.Diagram is XYDiagram)
{
XYDiagram _xyDiagram = (XYDiagram)chart.Diagram;
_xyDiagram.AxisY.Label.Angle = angle;
}
}
/// <summary>
/// 设置ColorEach
/// </summary>
/// <param name="series">SeriesBase</param>
/// <param name="colorEach">是否设置成ColorEach</param>
public static void SetColorEach(this SeriesBase series, bool colorEach)
{
SeriesViewColorEachSupportBase colorEachView = (SeriesViewColorEachSupportBase)series.View;
if (colorEachView != null)
{
colorEachView.ColorEach = colorEach;
}
}
/// <summary>
/// 设置是否显示十字标线
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="crosshair">是否显示十字标线</param>
public static void SetCrosshair(this ChartControl chart, bool crosshair)
{
chart.CrosshairEnabled = crosshair ? DefaultBoolean.True : DefaultBoolean.False;
chart.CrosshairOptions.ShowArgumentLabels = crosshair;
chart.CrosshairOptions.ShowArgumentLine = crosshair;
chart.CrosshairOptions.ShowValueLabels = crosshair;
chart.CrosshairOptions.ShowValueLine = crosshair;
} /// <summary>
/// 新增ChartControl的Title文字
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="title">Title文字</param>
/// <param name="titlePosition">Title位置</param>
public static void AddTitle(this ChartControl chart, string title, ChartTitleDockStyle titlePosition)
{
ChartTitle _chartTitle = new ChartTitle();
_chartTitle.Text = title;
_chartTitle.Dock = titlePosition;
chart.Titles.Add(_chartTitle);
}
/// <summary>
/// 新增ChartControl的Title文字
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="title">Title文字</param>
/// <param name="visible">是否显示</param>
/// <param name="titlePosition">Title位置</param>
public static void AddTitle(this ChartControl chart, string title, bool visible, ChartTitleDockStyle titlePosition)
{
ChartTitle _chartTitle = new ChartTitle();
_chartTitle.Text = title;
_chartTitle.Visible = visible;
_chartTitle.Dock = titlePosition;
chart.Titles.Add(_chartTitle);
}
/// <summary>
/// 先删除Chart的Title，然后添加新的Title
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="title">Title文字</param>
/// <param name="titlePosition">Title位置</param>
public static void ClearThenAddTitle(this ChartControl chart, string title, ChartTitleDockStyle titlePosition)
{
chart.Titles.Clear();
ChartTitle _chartTitle = new ChartTitle();
_chartTitle.Text = title;
_chartTitle.Dock = titlePosition;
chart.Titles.Add(_chartTitle);
}
/// <summary>
/// 创建Drill-Down样式的Title
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="title">title文字</param>
/// <param name="visible">是否可见</param>
public static void AddDrillDownTitle(this ChartControl chart, string title, bool visible)
{
ChartTitle _chartTitle = new ChartTitle();
_chartTitle.Alignment = StringAlignment.Near;
_chartTitle.Antialiasing = false;
_chartTitle.Font = new Font("Tahoma", 10F, FontStyle.Underline);
_chartTitle.Indent = 20;
_chartTitle.Text = title;
_chartTitle.TextColor = Color.RoyalBlue;
_chartTitle.Visible = false;
chart.Titles.Add(_chartTitle);
}
/// <summary>
/// 饼状Series设置成百分比显示
/// </summary>
/// <param name="series">SeriesBase</param>
/// <param name="valueLegendType">Series对应Lengend显示类型</param>
/// <param name="lengendPointView">Series对应Lengend PointView类型</param>
public static void SetPiePercentage(this SeriesBase series, NumericFormat valueLegendType, PointView lengendPointView)
{
if (series.View is PieSeriesView || series.View is Pie3DSeriesView)
{
PiePointOptions _piePointOptions = (PiePointOptions)series.Label.PointOptions;
if (_piePointOptions != null)
{
_piePointOptions.PercentOptions.ValueAsPercent = true;
_piePointOptions.ValueNumericOptions.Format = NumericFormat.Percent;
_piePointOptions.ValueNumericOptions.Precision = 0;
series.LegendPointOptions.ValueNumericOptions.Format = valueLegendType;
series.LegendPointOptions.PointView = lengendPointView;
}
}
}
/// <summary>
/// Lable格式化设置
/// 【{A} Use it to display a series point arguments 】
/// 【{V} Use it to display a series point values】
/// 【{S} Use it to display the name of the series】
/// </summary>
/// <param name="series">SeriesBase</param>
/// <param name="formatString">Lable格式化设置；【{A}{V}{S}】</param>
public static void CustomLable(this SeriesBase series, string formatString)
{
if (series.LabelsVisibility != DefaultBoolean.True)
series.LabelsVisibility = DefaultBoolean.True;
series.Label.PointOptions.Pattern = formatString;
}
/// <summary>
/// 十字标线的Lable格式化设置
/// 【{A} Use it to display a series point arguments 】
/// 【{V} Use it to display a series point values】
/// 【{S} Use it to display the name of the series】
/// </summary>
/// <param name="series">SeriesBase</param>
/// <param name="formatString">CrosshairLabel格式化设置；【{A}{V}{S}】</param>
public static void CustomCrosshairLabel(this SeriesBase series, string formatString)
{
if (series.CrosshairEnabled != DefaultBoolean.True)
series.CrosshairEnabled = DefaultBoolean.True;
series.CrosshairLabelPattern = formatString;
}
/// <summary>
/// 将X轴格式化成时间轴
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="dateTimeMeasureUnit">X轴刻度单位</param>
/// <param name="dateTimeGridAlignment">X轴刻度间距的单位</param>
public static void SetAxisXTime(this ChartControl chart, DateTimeMeasurementUnit dateTimeMeasureUnit, DateTimeMeasurementUnit dateTimeGridAlignment)
{
if (chart.Diagram is XYDiagram)
{
XYDiagram _diagram = (XYDiagram)chart.Diagram;
if (_diagram != null)
{
_diagram.AxisX.DateTimeMeasureUnit = dateTimeMeasureUnit;//X轴刻度单位
_diagram.AxisX.DateTimeGridAlignment = dateTimeGridAlignment;//X轴刻度间距
}
}
}
/// <summary>
/// 将X轴格式化成时间轴
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="dateTimeMeasureUnit">X轴刻度单位</param>
/// <param name="dateTimeGridAlignment">X轴刻度间距的单位</param>
/// <param name="formatString">时间格式；eg:yyyy-MM</param>
public static void SetAxisXTime(this ChartControl chart, DateTimeMeasurementUnit dateTimeMeasureUnit, DateTimeMeasurementUnit dateTimeGridAlignment, string formatString)
{
if (chart.Diagram is XYDiagram)
{
XYDiagram _diagram = (XYDiagram)chart.Diagram;
if (_diagram != null)
{
_diagram.AxisX.DateTimeMeasureUnit = dateTimeMeasureUnit;//X轴刻度单位
_diagram.AxisX.DateTimeGridAlignment = dateTimeGridAlignment;//X轴刻度间距
_diagram.AxisX.DateTimeOptions.Format = DateTimeFormat.Custom;
_diagram.AxisX.DateTimeOptions.FormatString = formatString;
}
}
}
/// <summary>
/// 设置ChartControl滚动条【默认X,Y轴都出现】
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="backColor">滚动条背景颜色</param>
/// <param name="barColor">滚动条颜色</param>
/// <param name="borderColor">滚动条边框颜色</param>
/// <param name="barThickness">滚动条宽度</param>
public static ScrollBarOptions SetScrollBar(this ChartControl chart, Color backColor, Color barColor, Color borderColor, int barThickness)
{
if (chart.Diagram is XYDiagram)
{
XYDiagram _diagram = (XYDiagram)chart.Diagram;
if (_diagram != null)
{
_diagram.EnableAxisXScrolling = true;
_diagram.EnableAxisYScrolling = true;
_diagram.EnableAxisXZooming = true;
_diagram.EnableAxisYZooming = true;
ScrollBarOptions _scrollBarOptions = _diagram.DefaultPane.ScrollBarOptions;
_scrollBarOptions.BackColor = backColor;
_scrollBarOptions.BarColor = barColor;
_scrollBarOptions.BorderColor = borderColor;
_scrollBarOptions.BarThickness = barThickness;
return _scrollBarOptions;
}
}
return null;
}
/// <summary>
/// 设置ChartControl X轴滚动条
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="backColor">滚动条背景颜色</param>
/// <param name="barColor">滚动条颜色</param>
/// <param name="borderColor">滚动条边框颜色</param>
/// <param name="barThickness">滚动条宽度</param>
/// <param name="barAlignment">滚动条位置</param>
public static void SetAxisXScrollBar(this ChartControl chart, Color backColor, Color barColor, Color borderColor, int barThickness, ScrollBarAlignment barAlignment)
{
ScrollBarOptions _scrollBarOptions = SetScrollBar(chart, backColor, barColor, borderColor, barThickness);
if (_scrollBarOptions != null)
{
_scrollBarOptions.XAxisScrollBarAlignment = barAlignment;
_scrollBarOptions.XAxisScrollBarVisible = true;
_scrollBarOptions.YAxisScrollBarVisible = false;
}
}
/// <summary>
/// 设置ChartControl Y轴滚动条
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="backColor">滚动条背景颜色</param>
/// <param name="barColor">滚动条颜色</param>
/// <param name="borderColor">滚动条边框颜色</param>
/// <param name="barThickness">滚动条宽度</param>
/// <param name="barAlignment">滚动条位置</param>
public static void SetAxisYScrollBar(this ChartControl chart, Color backColor, Color barColor, Color borderColor, int barThickness, ScrollBarAlignment barAlignment)
{
ScrollBarOptions _scrollBarOptions = SetScrollBar(chart, backColor, barColor, borderColor, barThickness);
if (_scrollBarOptions != null)
{
_scrollBarOptions.XAxisScrollBarVisible = false;
_scrollBarOptions.YAxisScrollBarVisible = true;
_scrollBarOptions.YAxisScrollBarAlignment = barAlignment;
}
}
/// <summary>
/// 设置X轴Title
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="titleText">Title文字</param>
/// <param name="titleColor">Title文字颜色</param>
public static void SetAxisXTitle(this ChartControl chart, string titleText, Color titleColor)
{
if (chart.Diagram is XYDiagram)
{
XYDiagram _diagram = (XYDiagram)chart.Diagram;
if (_diagram != null)
{
_diagram.AxisX.Title.Visible = true;
_diagram.AxisX.Title.Alignment = StringAlignment.Center;
_diagram.AxisX.Title.Text = titleText;
_diagram.AxisX.Title.TextColor = titleColor;
_diagram.AxisX.Title.Antialiasing = true;
_diagram.AxisX.Title.Font = new Font("Tahoma", 14, FontStyle.Bold);
}
}
}
/// <summary>
/// 设置Y轴Title
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="titleText">Title文字</param>
/// <param name="titleColor">Title文字颜色</param>
public static void SetAxisYTitle(this ChartControl chart, string titleText, Color titleColor)
{
if (chart.Diagram is XYDiagram)
{
XYDiagram _diagram = (XYDiagram)chart.Diagram;
if (_diagram != null)
{
_diagram.AxisY.Title.Visible = true;
_diagram.AxisY.Title.Alignment = StringAlignment.Center;
_diagram.AxisY.Title.Text = titleText;
_diagram.AxisY.Title.TextColor = titleColor;
_diagram.AxisY.Title.Antialiasing = true;
_diagram.AxisY.Title.Font = new Font("Tahoma", 14, FontStyle.Bold);
}
}
}
/// <summary>
/// 创建基准线ConstantLine
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="ctAxisValue">基准线数值</param>
/// <param name="ctLegendText">基准线图例文字</param>
/// <param name="ctTitle">基准线文字</param>
/// <param name="ctTitleColor">基准线字体颜色</param>
/// <param name="ctLineColor">基准线颜色</param>
/// <param name="ctLineStyle">基准线样式</param>
public static void CreateConstantLine(this ChartControl chart, int ctAxisValue, string ctLegendText, string ctTitle, Color ctTitleColor, Color ctLineColor, DashStyle ctLineStyle)
{
if (chart.Diagram is XYDiagram)
{
XYDiagram _diagram = (XYDiagram)chart.Diagram;
if (_diagram != null)
{
ConstantLine _ctLine = new ConstantLine(); _ctLine.AxisValue = ctAxisValue;
_ctLine.Visible = true;
_ctLine.ShowInLegend = true;
_ctLine.LegendText = ctLegendText;
_ctLine.ShowBehind = false; _ctLine.Title.Visible = true;
_ctLine.Title.Text = ctTitle;
_ctLine.Title.TextColor = ctTitleColor;
_ctLine.Title.Antialiasing = false;
_ctLine.Title.Font = new Font("Tahoma", 14, FontStyle.Bold);
_ctLine.Title.ShowBelowLine = true;
_ctLine.Title.Alignment = ConstantLineTitleAlignment.Far; _ctLine.Color = ctLineColor;
_ctLine.LineStyle.DashStyle = ctLineStyle;
_ctLine.LineStyle.Thickness = 2; _diagram.AxisY.ConstantLines.Add(_ctLine);
}
}
}
/// <summary>
/// 创建Strip
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="strip">Strip</param>
/// <param name="stripLable">Strip文字</param>
/// <param name="stripLengend">Strip对应的Lengend文字</param>
/// <param name="stripColor">Strip颜色</param>
/// <param name="stripStyle">Strip填充样式</param>
public static void CreateStrip(this ChartControl chart, Strip strip, string stripLable, string stripLengend, Color stripColor, FillMode stripStyle)
{
if (chart.Diagram is XYDiagram)
{
XYDiagram _diagram = (XYDiagram)chart.Diagram;
if (_diagram != null && strip != null)
{
_diagram.AxisY.Strips.Add(strip); _diagram.AxisY.Strips[0].Visible = true;
_diagram.AxisY.Strips[0].ShowAxisLabel = true;
_diagram.AxisY.Strips[0].AxisLabelText = stripLable;
_diagram.AxisY.Strips[0].ShowInLegend = true;
_diagram.AxisY.Strips[0].LegendText = stripLengend; _diagram.AxisY.Strips[0].Color = stripColor;
_diagram.AxisY.Strips[0].FillStyle.FillMode = stripStyle;
}
}
}
/// <summary>
/// 自定义ChartControl的Tooltip
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="e">MouseEventArgs</param>
/// <param name="tooltip">ToolTipController</param>
/// <param name="tooltipTitle">ToolTipController的Title</param>
/// <param name="paramter">委托</param>
public static void CustomToolTip(this ChartControl chart, MouseEventArgs e, ToolTipController tooltip, string tooltipTitle, System.Func<string, double[], string> paramter)
{
ChartHitInfo _hitInfo = chart.CalcHitInfo(e.X, e.Y);
SeriesPoint _point = _hitInfo.SeriesPoint;
if (_point != null)
{
string _msg = paramter(_point.Argument, _point.Values);
tooltip.ShowHint(_msg, tooltipTitle);
}
else
{
tooltip.HideHint();
}
}
/// <summary>
/// 设置Legend位于底部并居中
/// </summary>
/// <param name="legend">Legend</param>
public static void SetBottomCenter(this Legend legend)
{
legend.Direction = LegendDirection.LeftToRight;
legend.AlignmentHorizontal = LegendAlignmentHorizontal.Center;
legend.AlignmentVertical = LegendAlignmentVertical.BottomOutside;
}
/// <summary>
/// 设置饼状图的Lable位置
/// </summary>
/// <param name="series">SeriesBase</param>
/// <param name="lablePosition">PieSeriesLabelPosition枚举</param>
public static void SetLablePosition(this SeriesBase series, PieSeriesLabelPosition lablePosition)
{
if (series.Label is PieSeriesLabel)
{
PieSeriesLabel _label = series.Label as PieSeriesLabel;
_label.Position = lablePosition;
}
//if (series.Label is Pie3DSeriesLabel)
//{
// Pie3DSeriesLabel _label = series.Label as Pie3DSeriesLabel;
// _label.Position = lablePosition;
//}
}
/// <summary>
/// 饼状图突出设置
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="pieSeries">Series【仅仅适用于PieSeriesView】</param>
/// <param name="explodeMode">突出模式【枚举】</param>
/// <param name="explodedValue">突出间距</param>
/// <param name="dragPie">是否可以拖动突出饼状</param>
public static void SetPieExplode(this ChartControl chart, SeriesBase pieSeries, PieExplodeMode explodeMode, int explodedValue, bool dragPie)
{
if (pieSeries.View is PieSeriesView)
{
if (!chart.RuntimeHitTesting)
chart.RuntimeHitTesting = true; PieSeriesView _pieView = pieSeries.View as PieSeriesView;
_pieView.ExplodeMode = explodeMode;
_pieView.ExplodedDistancePercentage = explodedValue;
_pieView.RuntimeExploding = dragPie;
}
}
/// <summary>
/// chart钻取实现【在MouseClick事件中实现】
/// </summary>
/// <param name="chart">ChartControl</param>
/// <param name="e">MouseEventArgs</param>
/// <param name="backKeyWord">返回主Series的关键字</param>
/// <param name="gotoHandler">向下钻取委托</param>
/// <param name="backHandler">返回主Series的委托</param>
public static void DrillDownHelper(this ChartControl chart, MouseEventArgs e, string backKeyWord, Action<SeriesPoint> gotoHandler, Action<SeriesPoint> backHandler)
{
//eg:
//private void chartLh_MouseClick(object sender, MouseEventArgs e)
//{
// ChartControl _curChart = sender as ChartControl;
// _curChart.DrillDownHelper(
// e,
// "返回",
// point =>
// {
// string _argument = point.Argument.ToString();
// if (_curChart.Series["pieSeries"].Visible)
// {
// _curChart.Series["pieSeries"].Visible = false;
// _curChart.SeriesTemplate.Visible = true;
// if (_curChart.SeriesTemplate.DataFilters.Count == 0)
// _curChart.SeriesTemplate.AddDataFilter("categoryName", _argument, DataFilterCondition.Equal);
// else
// _curChart.SeriesTemplate.DataFilters[0].Value = _argument;
// _curChart.Titles[1].Visible = true;
// _curChart.Titles[0].Visible = false;
// }
// },
// point =>
// {
// _curChart.Titles[0].Visible = true;
// _curChart.Series["pieSeries"].Visible = true;
// _curChart.SeriesTemplate.Visible = false;
// });
//}
ChartHitInfo _hitInfo = chart.CalcHitInfo(e.X, e.Y);
SeriesPoint _point = _hitInfo.SeriesPoint;
if (_point != null)
{
gotoHandler(_point);
}
ChartTitle link = _hitInfo.ChartTitle;
if (link != null && link.Text.StartsWith(backKeyWord))
{
link.Visible = false;
backHandler(_point);
}
}
}
}