C#用户控件之转换开关

如何自定义一个转换键（Toggle）？

三步绘制一个精美控件：

定义属性；
画布重绘；
添加事件；

主要技能：

如何自定义属性；
画布重绘的一般格式；
控件的事件触发过程；
技能扩展
1. 转换按钮使能时添加二次确认弹框？
2. 在From窗体中应用控件时，点击事件没有触发？
3. 属性名称在控件属性树中的排列如何定义？
4. 添加一个字体更改属性？

1.定义属性

字体（Font）
颜色（Color）
字符串（String）
枚举（Enum）
属性说明 [Browsable(true)]

#region 属性

private Font displayFont = new Font("Segoe UI", 12);
[Browsable(true)]
[Category("布局_G")]
[Description("字体格式")]
public Font DisplayFont
{
get { return displayFont; }
set
{
if (value != null)
{
displayFont = value;
this.Invalidate(); // Trigger redraw
}
}
}

private bool _checked = false;
[Browsable(true)] //说明（需放在属性前边）：是否选中
[Category("布局_G")]
[Description("是否选中")]
public bool Checked
{
get { return _checked; }
set
{
_checked = value;
this.Invalidate();
```
      //激活触发事件
      this.MouseDown_G?.Invoke(this, null);

  }
```
}

private string falseText = "关闭";
[Browsable(true)] //说明：文本关闭
[Category("布局_G")]
[Description("文本关闭")]
public string FalseText
{
get { return falseText; }
set { falseText = value; this.Invalidate(); }
}

//样式切换
public enum SwType
{
Ellipse, //椭圆
Rectangle, //矩形
}

private SwType switchType = SwType.Ellipse;
[Browsable(true)] //说明：切换样式
[Category("布局_G")]
[Description("切换样式")]
public SwType SwitchType
{
get { return switchType; }
set { switchType = value; this.Invalidate(); }
}

private Color sliderColor = Color.White; //Color.White
[Browsable(true)] //说明：滑块颜色
[Category("布局_G")]
[Description("滑块颜色")]
public Color SliderColor
{
get { return sliderColor; }
set { sliderColor = value; this.Invalidate(); }
}

#endregion

属性名称在控件属性树中的排列如何定义？

答：根据属性说明安装A~Z的字母顺序排列

2.画布重绘

画带四角圆弧的矩形、滑块、文本；

画椭圆、滑块、文本

    #region 画布

    private Graphics graphics;
    private int width;
    private int height;

    //矩形绘制
    protected override void OnPaint(PaintEventArgs e)
    {
        base.OnPaint(e);
        graphics = e.Graphics;
        graphics.TextRenderingHint = System.Drawing.Text.TextRenderingHint.AntiAlias;
        graphics.TextRenderingHint = System.Drawing.Text.TextRenderingHint.ClearTypeGridFit;
        graphics.SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.AntiAlias;
        graphics.SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.HighQuality;

        this.width = this.Width;
        this.height = this.Height;

        if (this.switchType == SwType.Rectangle)  //字段选择为矩形时
        {
            //填充色
            Color fillColor = this._checked ? trueColor : falseColor;

            //带四角圆弧的矩形
            GraphicsPath path = new GraphicsPath();
            int diameter = 10;  //默认圆弧直径
            //左上角圆弧：起始坐标，宽，高，开始角度，扫描角度
            path.AddArc(0, 0, diameter, diameter, 180f, 90f);
            path.AddArc(this.width - diameter, 0, diameter, diameter, 270f, 90f);  //右上角
            path.AddArc(this.width - diameter, this.height - diameter, diameter, diameter, 0f, 90f);  //右下角
            path.AddArc(0, this.height - diameter, diameter, diameter, 90f, 90f);  //左下角
            graphics.FillPath(new SolidBrush(fillColor), path);  //填充色

            //文本
            string strText = this._checked ? trueText : falseText;

            //滑块(true\false 两种形态)
            if (_checked)
            {
                //绘制滑块
                path = new GraphicsPath();
                int sliderwidth = this.height - 4;
                path.AddArc(this.width - sliderwidth - 2, 2, diameter, diameter, 180f, 90f);
                path.AddArc(this.width - diameter - 2, 2, diameter, diameter, 270f, 90f);
                path.AddArc(this.width - diameter - 2, this.height - diameter - 2, diameter, diameter, 0f, 90f);
                path.AddArc(this.width - sliderwidth - 2, this.height - diameter - 2, diameter, diameter, 90f, 90f);
                graphics.FillPath(new SolidBrush(sliderColor), path);

                //绘制文本
                Rectangle rec = new Rectangle(0, 0, this.width - sliderwidth - 2, this.height);
                StringFormat sf = new StringFormat();
                sf.Alignment = StringAlignment.Center;
                sf.LineAlignment = StringAlignment.Center;

                graphics.DrawString(strText, DisplayFont, new SolidBrush(sliderColor), rec, sf);

            }
            else
            {
                //绘制滑块
                path = new GraphicsPath();
                int sliderwidth = this.height - 4;
                path.AddArc(2, 2, diameter, diameter, 180f, 90f);
                path.AddArc(sliderwidth - diameter + 2, 2, diameter, diameter, 270f, 90f);
                path.AddArc(sliderwidth - diameter + 2, sliderwidth - diameter + 2, diameter, diameter, 0f, 90f);
                path.AddArc(2, sliderwidth - diameter + 2, diameter, diameter, 90f, 90f);
                graphics.FillPath(new SolidBrush(sliderColor), path);

                //绘制文本
                Rectangle rec = new Rectangle(sliderwidth + 2, 0, this.width - sliderwidth - 2, this.height);
                StringFormat sf = new StringFormat();
                sf.Alignment = StringAlignment.Center;
                sf.LineAlignment = StringAlignment.Center;
                graphics.DrawString(strText, DisplayFont, new SolidBrush(sliderColor), rec, sf);
            }
        }
        else if (this.switchType == SwType.Ellipse)  //字段选择为椭圆时
        {
            //填充色
            Color fillColor = this._checked ? trueColor : falseColor;

            //椭圆形
            GraphicsPath path = new GraphicsPath();

            path.AddArc(1, 1, this.height - 2, this.height - 2, 90f, 180f);
            path.AddArc(this.width - (this.height - 2) - 1, 1, this.height - 2, this.height - 2, 270f, 180f);
            graphics.FillPath(new SolidBrush(fillColor), path);  //填充色

            //文本
            string strText = this._checked ? TrueText : falseText;

            //滑块(true\false 两种形态)
            if (_checked)
            {
                //绘制滑块
                int ciclewidth = this.height - 6;
                graphics.FillEllipse(new SolidBrush(sliderColor), new Rectangle(this.width - ciclewidth - 3, 3, ciclewidth, ciclewidth));

                //绘制文本
                Rectangle rec = new Rectangle(0, 0, this.width - ciclewidth - 3, this.height);
                StringFormat sf = new StringFormat();
                sf.Alignment = StringAlignment.Center;
                sf.LineAlignment = StringAlignment.Center;
                graphics.DrawString(strText, DisplayFont, new SolidBrush(sliderColor), rec, sf);
            }
            else
            {
                //绘制滑块
                int ciclewidth = this.height - 6;

                graphics.FillEllipse(new SolidBrush(sliderColor), new Rectangle(3, 3, ciclewidth, ciclewidth));

                //绘制文本
                Rectangle rec = new Rectangle(ciclewidth + 3, 0, this.width - ciclewidth - 3, this.height);
                StringFormat sf = new StringFormat();
                sf.Alignment = StringAlignment.Center;
                sf.LineAlignment = StringAlignment.Center;
                graphics.DrawString(strText, DisplayFont, new SolidBrush(sliderColor), rec, sf);
            }
        }
    }

    #endregion

3.添加事件

理解：在From中控件的鼠标点击事件的执行过程

先执行控件内部的MouseDown方法------其方法内部的属性------其属性中的触发事件------最后执行From后台的点击生成的自定义方法（可自定义）

其他技巧：应用控件时拉出来双击即可生成自定义方法

<From中双击控件默认是Load方法，想让他自动生成自己设置的事件需要在控件代码中添加：[DefaultEvent("MouseDown_G")]>。

//指定默认事件（双击控件进入）
[DefaultEvent("MouseDown_G")]

关键代码：点击控件弹出框确认后再执行From的事件中的代码

//事件声明 public event EventHandler MouseDown_G;

//激活事件 this.MouseDown_G?.Invoke(this, null); ------执行完成跳转到From中的双击事件方法中

//构造函数添加鼠标点击事件------点击控件事件处理
this.MouseDown += Toggle_MouseDown;

//构造函数添加事件处理后自动生成此方法（无需在控件的属性中双击）
private void Toggle_MouseDown(object sender, MouseEventArgs e)
  {
      DialogResult dr = MessageBox.Show("二次确认操作？", "提示您", MessageBoxButtons.OKCancel, MessageBoxIcon.Question);
      if (dr == DialogResult.OK)
      {
          Checked = !Checked;
      }
      else return;
  }

发现一个错误，当应用该控件时，在From中点击无效；经过两天的查询（断点查询）才发现问题所在，在Form的设计器中的From属性的Enable为False ，改为true才可使能

原因：控件更新后没有及时生成导致From崩盘后（空窗口后没在意），导致Designer的默认代码更改。

End

讨论交流请留言

C#自定义控件—转换开关