首页 > 代码库 > [DevExpress]图表开发工具类 ChartUtils V1.0

[DevExpress]图表开发工具类 ChartUtils V1.0

关键代码:

using DevExpress.Utils;using DevExpress.XtraCharts;using System;using System.Drawing;using System.Windows.Forms;namespace DevExpressUtilHelpV3{    /// <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 = http://www.mamicode.com/ctAxisValue;"kwrd">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 = http://www.mamicode.com/_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);            }        }    }}
<style type="text/css">.csharpcode, .csharpcode pre{ font-size: small; color: black; font-family: consolas, "Courier New", courier, monospace; background-color: #ffffff; /*white-space: pre;*/}.csharpcode pre { margin: 0em; }.csharpcode .rem { color: #008000; }.csharpcode .kwrd { color: #0000ff; }.csharpcode .str { color: #006080; }.csharpcode .op { color: #0000c0; }.csharpcode .preproc { color: #cc6633; }.csharpcode .asp { background-color: #ffff00; }.csharpcode .html { color: #800000; }.csharpcode .attr { color: #ff0000; }.csharpcode .alt { background-color: #f4f4f4; width: 100%; margin: 0em;}.csharpcode .lnum { color: #606060; }</style>

[DevExpress]图表开发工具类 ChartUtils V1.0