本篇博客主要对 HslControls 组件做一个大概的总览介绍，更详细的内容可以参照页面里的子链接，还有github上的源代码，然后进行相关的学习，和使用。

Prepare

在Visual Studio 中的NuGet管理器中可以下载安装，也可以直接在NuGet控制台输入下面的指令安装：

Install-Package HslControls

NuGet安装教程  http://www.cnblogs.com/dathlin/p/7705014.html

技术支持QQ群：群1：592132877（满）  群2：948305931（组件的版本更新细节也将第一时间在群里发布）

如果你在使用控件的过程中有什么疑问，或是发现了BUG，或是功能建议，等等都可以加入上面的QQ群进行讨论。文章更新时间：2019年1月5日 16:51:41

Demo

所支持的控件信息如下：

Use

常用控件

1. 圆角按钮，主要是有一个圆角的效果，和自带的按钮基本差不多，还带有一个 Selected 属性，用于获取或设置按钮是否处于选中状态。

2. HslPlay 控件，有点像一个播放器，各种颜色可调，需要注意的是有个事件 OnPlayChanged  当播放状态改变的时候，就会触发（比onclick事件要好）。

3. 开关控件，主要实现两个状态的切换，上面有个属性可以设置文本 SwitchStatusDescription = "关;开";  用分号区别即可，也有个事件OnSwitchChanged可以用来做状态的改变。

进度条控件

特性支持，属性如下：

共有两种进度条的样式，一个是矩形的，一个是圆角的。都可以设置，背景色，前景色，是否使用动画效果。动画的速度都可以设置。也可以竖着的控件摆放样式

信号灯控件

支持纯色的信号灯，和渐变色的信号灯，当然，我们可以设置任意的颜色，根据自己的需求进行设计。

数码管控件

BackColor  就是整个LED的背景

DisplayBackColor 就是数据吗数字的背景

DisplayNumber  就是数码管显示的位数

DisplayText  就是最终显示的文本

ForeColor 就是最终显示文本的前景色

LedNumberSize  就是数码管单个显示的粗细

我们可以随意拖动数码管的大小，然后设置显示的数据量大小，颜色，粗细等等细节。一般所有的参数调整好后，我们使用 DisplayText  赋值就行。

时钟控件

主要的属性如下

ClockBackColor  就是时钟控件中间的背景色。

ForeColor  就是所有的文本的颜色

HourColor  就是小时那根针的颜色

IsSecondStep  设置秒针是否一秒一秒走动还是连续走动。

MiniteColor 就是分钟的那根针的颜色

SecondColor 就是秒针的颜色

Text  就是在时钟上显示的额外的信息

曲线控件

在使用前，先进行一些基本的设置信息，

IntervalAbscissaText  指示纵向的虚线方向的分割点数，如果为100，那就是每隔100个像素点绘制一条虚线

IsAbscissaStrech 如果设置为true，那么曲线就占满整个控件，比如强制这个曲线控件显示100个点，而无关控件的宽度。如果设置为true，那么控件显示的点数信息，将取决于控件的宽度界面。

IsRenderDashLine 是否显示虚线的辅助线。

IsRenderRightCoordinate 是否显示右侧的坐标轴

StrechDataCountMax   当IsAbscissaStrech 为true的时候，曲线控件强制规定的显示数据点数。这时候和控件无关。

TextAddFormat  获取或设置实时数据新增时文本相对应于时间的格式化字符串，默认HH:mm

Title   曲线控件显示的标题

ValueMaxLeft  左侧坐标轴的最大值

ValueMinLeft 左侧坐标轴的最小值

ValueMaxRight 右侧坐标轴的最大值

ValueMinRight  右侧坐标轴的最小值

ValueSegment 获取或设置图形的纵轴分段数

使用说明，先定义一个获取随机数据的方法

        private float[] GetRandomData( int length, int max )
        {
            float[] buffer = new float[length];
            for (int i = 0; i < buffer.Length; i++)
            {
                buffer[i] = random.Next( max );
            }
            return buffer;
        }

简单的设置固定的曲线

hslCurve1.SetCurveText( new string[] { "一", "二", "三", "四", "五", "六", "七", "八", "九", "十", "十一", "十二" } );
hslCurve1.SetLeftCurve( "A", GetRandomData( 12, 100 ), Color.Blue );

如果你想要显示一个实时的曲线信息，就要分两步走，先预设定曲线的基本信息，关键字，颜色，宽度，是否平滑等等信息

            hslCurve5.SetLeftCurve( "A", null, Color.DodgerBlue, true );
            hslCurve5.SetLeftCurve( "B", null, Color.DarkOrange, true );
            hslCurve5.SetLeftCurve( "C", null, Color.LimeGreen, true );

此处的例子就是设置了三条曲线，数据为空，颜色，和平滑效果

然后你实时读取到数据后，增加进曲线就行了。

hslCurve5.AddCurveData(
                new string[] { "A", "B", "C" },
                new float[]
                {
                    random1*10 + 80,
                    random2*20+50,
                    random2*30,
                }
            );

此处需要注意的是，如果你有三条曲线，就需要三条一起新增。

当然，本曲线控件支持双坐标，多曲线的显示情况。更多的信息，参照demo的源代码来开发。

仪表盘控件

这个是旧版的仪表盘，如下：

相关的属性点击属性标签就会在下方显示出来。

新版的如下：

管道控件

直接拖出来的控件是横向的，如果想要拐角，需要设置属性

左端点和右端点的属性设置

瓶子控件

饼图控件

传送带控件

传送带滚筒

温度计控件

鼓风机控件

阀门控件

电池控件

分类器控件

原文地址：https://www.cnblogs.com/dathlin/p/10226072.html