C#：为详情查看界面设计的万用TextBox自定义控件

最新推荐文章于 2023-06-30 23:11:55 发布
最新推荐文章于 2023-06-30 23:11:55 发布
阅读量239 收藏
点赞数
文章标签： c#
原文链接：https://my.oschina.net/Tsybius2014/blog/682240
版权

在写C#的Winform页面的时候，经常会遇到下面的问题：

一个详情查看类的页面，控件是从相关录入页面复制来的。为了让控件不可编辑，经常要设置控件的Enabled属性为False，或ReadOnly属性为True（如TextBox）等。但这样做最大的坏处就是造成了界面风格的不统一，如果字体、字号、风格、颜色都不统一，界面就会显得非常难看。

为此我设计了一个自定义控件，继承自TextBox，目的是让界面风格统一，原型效果如下：

（以上两张原型图使用Balsamiq绘制）

我设计的控件MultiFuncViewTextBox代码如下：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Text.RegularExpressions;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace CustuomControl
{
    public class MultiFuncViewTextBox : TextBox
    {
        public MultiFuncViewTextBox()
        {
            this.SuspendLayout();
            this.ReadOnly = true;
            this.ResumeLayout(false);
        }

        /// <summary>
        /// 控件是否已初始化
        /// </summary>
        private bool _isInitialized;
        /// <summary>
        /// 控件是否已初始化：可设定如果已初始化不允许再次初始化
        /// 如不需设定则将set置为永远返回false即可
        /// </summary>
        public bool IsInitialized
        {
            get
            {
                return _isInitialized;
            }
            private set
            {
                _isInitialized = value;
            }
        }

        /// <summary>
        /// 控件功能
        /// </summary>
        private FuncType _textFuncType;
        /// <summary>
        /// 控件功能：不同的功能会对传入的参数进行不同的处理
        /// </summary>
        public FuncType TextFuncType
        {
            get
            {
                return _textFuncType;
            }
            private set
            {
                _textFuncType = value;
            }
        }

        /// <summary>
        /// 初始化时传入的原始数据
        /// </summary>
        private object _coreValue;
        /// <summary>
        /// 初始化时传入的原始数据
        /// </summary>
        public object CoreValue
        {
            get
            {
                return _coreValue;
            }
            private set
            {
                _coreValue = value;
            }
        }

        /// <summary>
        /// 精度 - 保留小数位数（仅作用于BigChnNum和BigChnCash）
        /// </summary>
        private int _precision = 2;
        /// <summary>
        /// 精度 - 保留小数位数（仅作用于BigChnNum和BigChnCash）
        /// </summary>
        public int Precision
        {
            get
            {
                return _precision;
            }
            set
            {
                if (value < 0)
                {
                    throw new Exception("精度值不能小于0");
                }
                if (value > 10) //可根据项目情况酌情修改最大容忍精度
                {
                    throw new Exception("精度值不能大于10");
                }
                _precision = value;
            }
        }

        /// <summary>
        /// 是否需要显示汉字大写数字（仅作用于BigChnNum和BigChnCash）
        /// </summary>
        private bool _needChineseNumerals;
        /// <summary>
        /// 是否需要显示汉字大写数字（仅作用于BigChnNum和BigChnCash）
        /// </summary>
        public bool NeedChineseNumerals
        { 
            get
            {
                return _needChineseNumerals;
            }
            set
            {
                _needChineseNumerals = value;
            }
        }

        /// <summary>
        /// 数据字典主项（仅作用于DataDic）
        /// </summary>
        private string _dataDicEntry;
        /// <summary>
        /// 数据字典主项（仅作用于DataDic）
        /// </summary>
        public string DataDicEntry
        {
            get
            {
                return _dataDicEntry;
            }
            set
            {
                _dataDicEntry = value;
            }
        }

        private ToolTip toolTip = new ToolTip();
        
        /// <summary>
        /// 初始化控件
        /// </summary>
        /// <param name="val"></param>
        /// <param name="funcType"></param>
        public void InitCoreValue(object val, FuncType funcType)
        {
            if (IsInitialized && funcType != TextFuncType)
            {
                throw new Exception("不能改变控件用途");
            }

            switch (funcType)
            {
                case FuncType.Simple:
                    {
                        this.Text = "";

                        if (val != null)
                        {
                            this.CoreValue = val;
                            this.TextFuncType = FuncType.Simple;
                            this.Text = val.ToString();
                        }
                    }
                    break;
                case FuncType.BigChnNum:
                    {
                        this.Text = "";

                        if (val is decimal)
                        {
                            this.CoreValue = val;
                            this.TextFuncType = FuncType.BigChnNum;
                            decimal dVal = (decimal)val;
                            this.Text = String.Format("{0:N" + Precision + "}", dVal);
                            if (!IsInitialized && NeedChineseNumerals)
                            {
                                toolTip = new ToolTip();// 气泡弹窗
                                toolTip.IsBalloon = false;// 不显示为气泡弹窗，气泡的箭头会乱跑
                                toolTip.SetToolTip(this, "");
                                toolTip.ShowAlways = true;// 总是显示
                                toolTip.UseAnimation = true;
                                toolTip.UseFading = true;
                                this.Enter += (arg, obj) =>
                                {
                                    try
                                    {
                                        toolTip.Hide(this);
                                        toolTip.Show(RMBToChr2(decimal.Parse(this.Text)), this, 0, -22, 3000);
                                    }
                                    catch (Exception ex)
                                    {
                                        MessageBox.Show(ex.Message);
                                    }
                                };
                                this.Leave += (arg, obj) =>
                                {
                                    try
                                    {
                                        toolTip.Hide(this);
                                    }
                                    catch (Exception ex)
                                    {
                                        MessageBox.Show(ex.Message);
                                    }
                                };
                            }
                        }
                    }
                    break;
                case FuncType.BigChnCash:
                    {
                        this.Text = "";

                        if (val is decimal)
                        {
                            this.CoreValue = val;
                            this.TextFuncType = FuncType.BigChnCash;
                            decimal dVal = (decimal)val;
                            this.Text = String.Format("{0:N" + Precision + "}", dVal);
                            if (!IsInitialized && NeedChineseNumerals)
                            {
                                ToolTip toolTip = new ToolTip();// 气泡弹窗
                                toolTip.IsBalloon = false;// 不显示为气泡弹窗，气泡的箭头会乱跑
                                toolTip.SetToolTip(this, "");
                                toolTip.ShowAlways = true;// 总是显示
                                toolTip.UseAnimation = true;
                                toolTip.UseFading = true;

                                this.Enter += (arg, obj) =>
                                {
                                    try
                                    {
                                        toolTip.Hide(this);
                                        toolTip.Show(RMBToChr(decimal.Parse(this.Text)), this, 0, -22, 3000);
                                    }
                                    catch (Exception ex)
                                    {
                                        MessageBox.Show(ex.Message);
                                    }
                                };
                                this.Leave += (arg, obj) =>
                                {
                                    try
                                    {
                                        toolTip.Hide(this);
                                    }
                                    catch (Exception ex)
                                    {
                                        MessageBox.Show(ex.Message);
                                    }
                                };
                            }
                        }
                    }
                    break;
                case FuncType.Date:
                    {
                        this.Text = "";

                        DateTime dtVal = new DateTime();
                        if (val is int || val is long)
                        {
                            this.CoreValue = val;
                            this.TextFuncType = FuncType.Date;
                            dtVal = DateTime.ParseExact(val.ToString(), "yyyyMMdd", null);
                            this.Text = dtVal.ToLongDateString();
                        }
                        else if (val is DateTime)
                        {
                            this.CoreValue = val;
                            this.TextFuncType = FuncType.Date;
                            dtVal = (DateTime)val;
                            this.Text = dtVal.ToLongDateString();
                        }
                    }
                    break;
                case FuncType.Time:
                    {
                        this.Text = "";

                        DateTime dtVal = new DateTime();
                        if (val is int || val is long)
                        {
                            this.CoreValue = val;
                            this.TextFuncType = FuncType.Time;
                            dtVal = DateTime.ParseExact(val.ToString(), "HHmmss", null);
                            this.Text = dtVal.ToLongTimeString();
                        }
                        else if (val is DateTime)
                        {
                            this.CoreValue = val;
                            this.TextFuncType = FuncType.Time;
                            dtVal = (DateTime)val;
                            this.Text = dtVal.ToLongTimeString();
                        }
                    }
                    break;
                case FuncType.DataDic:
                    {
                        this.Text = "";

                        string dicEntry = "";
                        string subDicEntry = "";
                        if (val is KeyValuePair<string, string>)
                        {
                            this.CoreValue = val;
                            this.TextFuncType = FuncType.DataDic;
                            KeyValuePair<string, string> pair = (KeyValuePair<string, string>)val;
                            dicEntry = pair.Key;
                            subDicEntry = pair.Value;
                        }
                        else if (val is string)
                        {
                            this.CoreValue = val;
                            this.TextFuncType = FuncType.DataDic;
                            dicEntry = DataDicEntry;
                            subDicEntry = val.ToString();
                        }
                        if (!string.IsNullOrWhiteSpace(dicEntry) && !string.IsNullOrWhiteSpace(subDicEntry))
                        {
                            //TODO：获取对应数据字典值
                            this.Text = "TODO：获取对应数据字典值";
                        }
                    }
                    break;
            }

            IsInitialized = true;
        }

        public static string RMBToChr(decimal x)
        {
            string s = x.ToString("#L#E#D#C#K#E#D#C#J#E#D#C#I#E#D#C#H#E#D#C#G#E#D#C#F#E#D#C#.0B0A");
            string d = Regex.Replace(s, @"((?<=-|^)[^1-9]*)|((?'z'0)[0A-E]*((?=[1-9])|(?'-z'(?=[F-L\.]|$))))|((?'b'[F-L])(?'z'0)[0A-L]*((?=[1-9])|(?'-z'(?=[\.]|$))))", "${b}${z}");
            return Regex.Replace(d, ".", m => "负元空零壹贰叁肆伍陆柒捌玖空空空空空空空分角拾佰仟萬億兆京垓秭穰"[m.Value[0] - '-'].ToString());
        }

        public static string RMBToChr2(decimal x)
        {
            string s = x.ToString("#L#E#D#C#K#E#D#C#J#E#D#C#I#E#D#C#H#E#D#C#G#E#D#C#F#E#D#C#");
            string d = Regex.Replace(s, @"((?<=-|^)[^1-9]*)|((?'z'0)[0A-E]*((?=[1-9])|(?'-z'(?=[F-L\.]|$))))|((?'b'[F-L])(?'z'0)[0A-L]*((?=[1-9])|(?'-z'(?=[\.]|$))))", "${b}${z}");
            string integerPart = Regex.Replace(d, ".", m => "负元空零壹贰叁肆伍陆柒捌玖空空空空空空空分角拾佰仟萬億兆京垓秭穰"[m.Value[0] - '-'].ToString());
            if (integerPart == "")
            {
                integerPart = "零";
            }

            string fractionalPart = "";
            if (x.ToString().IndexOf('.') != -1)
            {
                fractionalPart = x.ToString().Substring(x.ToString().IndexOf('.'));
                fractionalPart = fractionalPart.Replace(".", "点");
                fractionalPart = fractionalPart.Replace("0", "零");
                fractionalPart = fractionalPart.Replace("1", "壹");
                fractionalPart = fractionalPart.Replace("2", "贰");
                fractionalPart = fractionalPart.Replace("3", "叁");
                fractionalPart = fractionalPart.Replace("4", "肆");
                fractionalPart = fractionalPart.Replace("5", "伍");
                fractionalPart = fractionalPart.Replace("6", "陆");
                fractionalPart = fractionalPart.Replace("7", "柒");
                fractionalPart = fractionalPart.Replace("8", "捌");
                fractionalPart = fractionalPart.Replace("9", "玖");
            }

            return integerPart + fractionalPart;
        }
    }
}

其中FuncType是一个枚举，包括以下类型：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace CustuomControl
{
    /// <summary>
    /// 多功能显示文本框功能类型
    /// </summary>
    public enum FuncType
    {
        /// <summary>
        /// 普通类型
        /// </summary>
        Simple = 0,
        /// <summary>
        /// 大写汉字（普通）
        /// </summary>
        BigChnNum = 1,
        /// <summary>
        /// 大写汉字（金额）
        /// </summary>
        BigChnCash = 2,
        /// <summary>
        /// 日期
        /// </summary>
        Date = 3,
        /// <summary>
        /// 时间
        /// </summary>
        Time = 4,
        /// <summary>
        /// 数据字典类型
        /// </summary>
        DataDic = 5
    }
}

上面的控件有如下特点：

1、控件风格统一。平心而论，详情查看类页面只需要显示结果，不需要放置很多功能性控件（如下拉菜单ComboBox、日期时间选择控件DateTimePicker等），只需要一个TextBox控件就可以了。

2、CoreValue存储了用户存入控件的原始数据，通过控件的Text属性可取出控件处理后的数据。

3、BigChnNum和BigChnCash两种控件使用类型，支持Precision（精度）和NeedChineseNumerals（是否需要用气泡展示汉字大写金额）。

4、如果控件用途设置为BigChnNum，则气泡中显示大写数字； 如果控件用途设置为 BigChnCash ，则气泡中显示大写数字金额，并添加单位圆、角、分。

5、如果控件用途设置为DataDic，可手动设置DataDicEntry属性，指定数据字典号。

6、初始化统一使用函数InitCoreValue，使用方法为InitCoreValue(要传入的数据，控件用途)

public void InitCoreValue(object val, FuncType funcType)

下面用一个例子说明这个控件的用法。

界面控件放置如下：

代码如下：

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace UserControlTest
{
    public partial class FormMain : Form
    {
        public FormMain()
        {
            InitializeComponent();
        }

        private void FormMain_Load(object sender, EventArgs e)
        {
            try
            {
                //查看类界面万用控件
                //一般使用
                mfvNormal.InitCoreValue("你好", CustuomControl.FuncType.Simple);
                //为数字增加千位符
                mfvChnNum.InitCoreValue(123456789.1234M, CustuomControl.FuncType.BigChnNum);
                mfvChnCash.InitCoreValue(123456789.1234M, CustuomControl.FuncType.BigChnCash);
                //为数字增加千位符，并在上方增加汉字大写气泡
                mfvChnNumWithTip.Precision = 3;
                mfvChnNumWithTip.NeedChineseNumerals = true;
                mfvChnNumWithTip.InitCoreValue(123456789.1234M, CustuomControl.FuncType.BigChnNum);
                mfvChnCashWithTip.Precision = 3;
                mfvChnCashWithTip.NeedChineseNumerals = true;
                mfvChnCashWithTip.InitCoreValue(123456789.1234M, CustuomControl.FuncType.BigChnCash);
                //显示日期
                mfvDate1.InitCoreValue(20160524, CustuomControl.FuncType.Date);
                mfvDate2.InitCoreValue(20160524L, CustuomControl.FuncType.Date);
                mfvDate3.InitCoreValue(new DateTime(2016, 5, 24), CustuomControl.FuncType.Date);
                //显示时间
                mfvTime1.InitCoreValue(140430, CustuomControl.FuncType.Time);
                mfvTime2.InitCoreValue(140430, CustuomControl.FuncType.Time);
                mfvTime3.InitCoreValue(new DateTime(2016, 5, 24, 14, 4, 30), CustuomControl.FuncType.Time);
                //显示数据字典
                mfvDataDic1.InitCoreValue(new KeyValuePair<string, string>("1001", "3"), CustuomControl.FuncType.DataDic);
                mfvDataDic2.DataDicEntry = "1001";
                mfvDataDic2.InitCoreValue("3", CustuomControl.FuncType.DataDic);
            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.Message);
            }

            btnDummy.Select(); //这是一个无用的Button按钮
        }
    }
}

运行效果如下：

END

转载于:https://my.oschina.net/Tsybius2014/blog/682240

chenzai1946
关注
自定义控件C# TextBox
11-24
只可输入数字，屏蔽其他字符，用正则表达式
c# 自定义webTextBox控件
07-23
自定义webTextBox
C#编写组件类TextBox
biyusr的专栏
10-21 506
2.显示组件的属性窗口，看下组件新添加的属性。1.写好后组件类后，拖动到Form上。
使用C#语言实现的查询条件界面展开/收起方案
11-21 871
先简单说一下应用场景，现有一个C#客户端的查询界面，上方放置查询条件，下方放置查询结果。因为实际情况中查询条件可能占了好几行的位置，所以希望在界面上默认只保留一行最主要的查询条件，并在右侧有一个“展开/收起”功能。 收起时界面： 展开时界面： 最开始我的实现方式是这样的，在界面上...
C#sql帮助类(登录查询界面)语句实例
u011555996的博客
01-06 1504
using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; using System.Data.SqlClient; using System.Data; namespace SQLHelp//数据库操作help类
C#自定义控件库
01-22
"C#自定义控件库"是指使用C#语言编写的、由开发者自定义的控件集合，这些控件可以扩展.NET Framework的标准控件集，为用户提供更丰富的界面元素和功能。自定义控件是软件开发中的一个重要环节，特别是在UI设计和用户...
C#自定义控件实现TextBox禁止粘贴的方法
08-30
知识点1：C#自定义控件的创建 C#自定义控件是指通过继承现有控件类来创建新的控件，在本文中，我们继承了TextBox类来创建一个名为UC_TextBox_NoPaste的自定义控件。在创建自定义控件时，我们需要使用继承的方式来...
Winform TextBox支持垂直居中自定义控件
03-05
在Windows Forms开发中，TextBox控件是最常用的输入控件之一，用于显示和接收文本输入。然而，系统默认的TextBox控件并不支持文字的垂直居中显示。为了满足这个需求，我们可以自定义一个控件，继承自TextBox类，并...
C#实现图书管理系统（课程设计）——第五步、查询界面及操作
Npe_xl_violet的博客
05-22 4357
C#实现图书管理系统（课程设计）——第五步、查询界面及操作 上一篇：借书界面 （1）界面设计： 前三个框为DataGridView控件，具体的使用方法自行百度，以下简单讲解： 1.创建后点击，右上角会有个小三角，点下它，会出现一个数据源的选择 2.在里面找到你需要的那一个表，是表，表，表，说三遍。不是数据库，具体到“表”，第四遍。 3.他就会直接显示出来表的所有数据 4.在框体load函数中会出现类似于this.studentTableAdapter.Fill(this.for_LoginDataSet.
数据库查询页面C#
weixin_54192903的博客
11-21 507
using System; using System.Collections.Generic; using System.ComponentModel; using System.Data; using System.Drawing; using System.Linq; using System.Text; using System.Threading.Tasks; using System.Data.SqlClient; using System.Windows.Forms; namespace 连.
C# 自定义控件实现时间轴
09-06
C# 自定义控件实现时间轴，C# 自定义控件实现时间轴，C# 自定义控件实现时间轴，C# 自定义控件实现时间轴，C# 自定义控件实现时间轴
datalist实现点击查看详细信息
零落年华的专栏
12-28 1302
续实现效果：后台：code：c#protected void DataList1_ItemCommand(object source, DataListCommandEventArgs e)    {                            if (e.CommandName == "select")                 //显示详细信息         
C#中的自定义组件（单一组件和复杂组件）
最新发布
dawn0718的专栏
06-30 1739
　　在C#中完成自定义组件（单一组件和复杂组件）的制作。
C#winform自定义控件——textBox美化(二)
奔跑的郑的博客
04-12 2086
实现textBoxt说有属性和方法的重写，可以实现textBox的美化功能，纯代码编写，完全不使用任何第三方库文件，后面的文章还会写其他控件的重构，基本原理都是差不太多的，希望大家学习这些思路从而重构属于自己的控件 我们接着上一篇文章继续。 我会用很多篇文章来讲自定义控件，大家可以放在一个项目中，这样后面大家在做其他项目的时候只需要把我们做好的控件复制到其它项目中并添加就可以了 设置是否多行显示和设置背景颜色，我这里就不放原代码了，希望大家自己对着图片敲出来，不是简单的复制，当然如果大家真的不想敲
25、C#里面TextBox编辑框的使用
奕奕微笑的开发世界
10-13 5028
不论是在C#里面，还是在其它编程语言中，编辑框都是常用的组件之一。编辑框组件最重用的属性和事件也就那么几个。虽然TextBox组件的属性和事件很多很多。 下面对TextBox组件的属性和事件进行下使用说明。 1、Multiline。该属性有2个值，一个是true，一个是false。如果为true，就是表示可以在编辑框中输入多行；如果为false，就是表示可以在编辑框中输入一行。 如下图：
如何在VS2015查看C#界面窗体里的控件层次？
woshihufan的专栏
07-06 4972
C#工程界面中，窗口层次怎么看，怎么知道控件是放哪个容器内的？ 通过 视图→其他窗口→文档大纲，查看界面控件的整个层次 针对对应的控件，可以拖到切换到其他控件容器中 ...
C#/Winform 自定义控件-可以调节尺寸的TextBox
XXXXX_AAAAA的博客
03-25 3509
自定义控件-可以调节尺寸的TextBox
C# Winform 自定义控件——TextBox
dkjp59834的博客
08-01 1240
效果： 描述： 类似html标签里input标签里的placeHolder属性，控件继承TextBox，拥有一个描述提示信息的字段_txtPlaceHolder，重写了消息处理函数WndProc，如果windows送出来的消息是绘制控件，就开始绘制，这里要注意的是TxtPlaceHolder的Set方法里的this.Invalidate();这个是如果控件绘制失败，将重绘绘...
WinForm自定义控件–TextBox扩展
斌哥的博客
05-07 4104
一、简单回顾 在前两节中，对Panel和GroupBox控件进行了相关的扩展应用，主要都是设置控件的边框以及边框颜色等。本节，继续对WinForm现有的控件TextBox进行扩展，来满足实际开发中的需要。   二、TextBox扩展 WinForm现有的TextBox控件功能已然相当强大了，但有些时候仍然不能满足一些实际开发的需要，本节针对开发中的需求问题，对控件进行了以下
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值