C#创建windows组合控件

傷城~ 2023-01-13 05:43 299阅读 0赞

# 一 创建窗体库控件 #

1.  创建一个新的Windows Forms Control Library项目，命名为LabelTextbox。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70]
2.  单击设计界面，打开控件的属性。把控件的Name属性改为ctLabelTextbox。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 1]
3.  双击工具箱中的标签，把它添加到用户控件中，放在界面的左上角，把它的Name属性改为lblTextBox,把Text属性设置为Label。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 2]
4.  双击工具箱中的文本框，把它添加到用户控件中，把它的Name属性改为txtLabelText。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 3]

# 二 编写代码 给标签和文本框定位。 #

需要添加两个属性，Position：允许用户二选一（Right和Below）.TextboxMargin，是一个int，表示控件左边界到文本框的像素数。

## 1. 添加属性： ##

Position属性，为了让用户可以选择Right和Below，先用这两个值定义一个枚举类型，返回控件项目，添加代码：

//定义位置选择的两个枚举类型
            public enum PositionEnum
            {
                Right, Below
            }
            //添加Position字段
            private PositionEnum mPosition = PositionEnum.Right;
    
            //添加Position属性
            public PositionEnum Position
            {
                get { return mPosition; }
                set
                {
                    mPosition = value;
                    MoveControls();
                }
            }

TextboxMargin属性是一样的，但它处理的是一个整数。

//添加TextboxMargin字段
           private int mTextboxMargin = 0;
    
            //添加TextboxMargin属性
            public int TextboxMargin
            {
                get { return mTextboxMargin; }
                set
                {
                    mTextboxMargin = value;
                    MoveControls();
                }
            }

## 2. 添加事件处理。 ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 4]  
可以看到函数已经添加进来了。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 5]

添加Load函数处理

//初始化控件和该控件的所有资源
            private void ctLabelTextbox_Load(object sender, EventArgs e)
            {
                lblTextBox.Text = this.Name;//设置label显示的文字
                //设置控件高度
                this.Height = txtLabelText.Height > lblTextBox.Height ? txtLabelText.Height : lblTextBox.Height;
                MoveControls();//移动控件
            }

添加SizeChanged函数处理

//改变控件大小时，重新绘制控件
            private void ctLabelTextbox_SizeChanged(object sender, EventArgs e)
            {
                MoveControls();
            }

//MoveControls函数

private void MoveControls()
            {
                switch (mPosition)
                {
                    case PositionEnum.Below:
                        //设置Textbox的顶部在Label的底部
                        this.txtLabelText.Top = this.lblTextBox.Bottom;
                        this.txtLabelText.Left = this.lblTextBox.Left;
    
                        //修改Textbox的宽度与控件宽度一致
                        this.txtLabelText.Width = this.Width;
    
                        this.Height = txtLabelText.Height + lblTextBox.Height;
                        break;
                    case PositionEnum.Right:
                        //设置textbox的顶部与label一平
                        txtLabelText.Top = lblTextBox.Top;
    
                        //如果margin值为零，将textbox与label紧挨着放
                        if (mTextboxMargin == 0)
                        {
                            int width = this.Width - lblTextBox.Width - 3;
                            txtLabelText.Left = lblTextBox.Right + 3;
                            txtLabelText.Width = width;
                        }
                        else
                        {
                            //如果margin值不为零，将textbox 放置在用户定义的位置
                            txtLabelText.Left = mTextboxMargin;
                            txtLabelText.Width = this.Width - mTextboxMargin;
                        }
                        this.Height = txtLabelText.Height > lblTextBox.Height ? txtLabelText.Height : lblTextBox.Height;
                        break;
                }
            }

# 三 调试用户控件 #

## 1. 新建测试项目 ##

从File菜单中选择Add|New Project对话框中创建一个新的Windows Application项目，命名为LabelTextboxTest。在Solution Explorer中，已打开了两个项目。第一个项目是前面创建的LabelTextbox，以黑体字显示。如果要运行解决方案。调试程序就会把该控件用作启动项目，这将会失败，因为控件不是一个独立的项目。为了更正这个问题，右击项目名LabelTextboxTest,选择Set as Startup Project。再运行解决方案，就会运行Windows应用程序项目，且不会报错。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 6]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 7]  
右键LabelTextboxTest——设为启动项目  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 8]

## 2. 使用控件 ##

现在，在工具箱的顶部应有一个选项卡LabelTextBox Components。Visual Studio知道在解决方案中有一个Windows Control Library，在其他项目中也可能使用这个库提供控件。所以双击控件ctLabelTextbox,把它添加到窗体中。（如果没有看到LabelTextBox Components，就重新生成一下解决方案就可以看见了）  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 9]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 10]  
双击ctLabelTextbox，将控件添加到界面中。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 11]

## 3. 运行项目 ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 12]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 13]

# 四 扩展控件功能 #

到现在为止，还不能对这个控件做什么操作，因为它还不能改变标签和文本框的文本。

## 1. 添加LabelText和TextboxText两个属性。 ##

private string mLabelText = "";
            public string LabelText
            {
                get
                {
                    return mLabelText;
                }
                set
                {
                    lblTextBox.Text = value;
                }
            }
    
            private string mTextboxText = "";
            public string TextboxText
            {
                get
                {
                    return mTextboxText;
                }
                set
                {
                    mTextboxText = value;
                    txtLabelText.Text = mTextboxText;
                    MoveControls();
                }
            }

## 2. 为txtLabelText文本框添加KeyDown KeyPress和KeyUp事件。 ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 14]

private void txtLabelText_KeyDown(object sender, KeyEventArgs e)
            {
                OnKeyDown(e);
            }
    
            private void txtLabelText_KeyPress(object sender, KeyPressEventArgs e)
            {
                OnKeyPress(e);
            }
    
            private void txtLabelText_KeyUp(object sender, KeyEventArgs e)
            {
                OnKeyUp(e);
            }

## 3. 添加定制事件处理PositionChanged,当Position属性改变时，引发事件。 ##

### （1）创建委托 ###

需要一个合适的委托，用于调用用户赋给事件的方法。委托是由.NET Framework提供的EventHandler委托。

//声明PositionChanged事件，允许用户订阅该事件。
    public event System.EventHandler PositionChanged;

## （2）赋值事件 ##

用户必须把一个方法赋给事件，以订阅事件。

//添加Position属性
            public PositionEnum Position
            {
                get { return mPosition; }
                set
                {
                    mPosition = value;
                    MoveControls();
                    if (PositionChanged != null)
                    {
                        PositionChanged(this, new EventArgs());
                    }
                }
            }

## （3）调用用户赋给事件的方法。 ##

private void ctLabelTextbox1_PositionChanged(object sender, EventArgs e)
            {
                MessageBox.Show("Chnaged");
            }

## 4. 重新生成解决方案，就可以看见控件的新属性及方法。 ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 15]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 16]

在LabelTextboxTest窗体上添加一个按钮，双击它，给项目添加按钮Click事件。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 17]

private void button1_Click(object sender, EventArgs e)
            {
                ctLabelTextbox1.Position = ctLabelTextbox1.Position ==
                    LabelTextBox.ctLabelTextbox.PositionEnum.Right ?
                    LabelTextBox.ctLabelTextbox.PositionEnum.Below :
                    LabelTextBox.ctLabelTextbox.PositionEnum.Right;
            }

## 5. 运行程序，便可以改变文本框的位置啦。 ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 18]  
点击button1  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 19]

# 五 完整代码 #

控件完整代码

using System;
    using System.Collections.Generic;
    using System.ComponentModel;
    using System.Drawing;
    using System.Data;
    using System.Linq;
    using System.Text;
    using System.Windows.Forms;
    
    namespace LabelTextBox
    {
        public partial class ctLabelTextbox : UserControl
        {
            //定义位置选择的两个枚举类型
            public enum PositionEnum
            {
                Right, Below
            }
            //添加两个成员字段
            private PositionEnum mPosition = PositionEnum.Right;
            private int mTextboxMargin = 0;
    
            //声明PositionChanged事件，允许用户订阅该事件。
            public event System.EventHandler PositionChanged;
            //添加Position属性
            public PositionEnum Position
            {
                get { return mPosition; }
                set
                {
                    mPosition = value;
                    MoveControls();
                    if (PositionChanged != null)
                    {
                        PositionChanged(this, new EventArgs());
                    }
                }
            }
            //添加TextboxMargin属性
            public int TextboxMargin
            {
                get { return mTextboxMargin; }
                set
                {
                    mTextboxMargin = value;
                    MoveControls();
                }
            }
    
            private string mLabelText = "";
            public string LabelText
            {
                get
                {
                    return mLabelText;
                }
                set
                {
                    lblTextBox.Text = value;
                }
            }
    
            private string mTextboxText = "";
            public string TextboxText
            {
                get
                {
                    return mTextboxText;
                }
                set
                {
                    mTextboxText = value;
                    txtLabelText.Text = mTextboxText;
                    MoveControls();
                }
            }
    
            public ctLabelTextbox()
            {
                InitializeComponent();
            }
    
            //初始化控件和该控件的所有资源
            private void ctLabelTextbox_Load(object sender, EventArgs e)
            {
                lblTextBox.Text = this.Name;//设置label显示的文字
                //设置控件高度
                this.Height = txtLabelText.Height > lblTextBox.Height ? txtLabelText.Height : lblTextBox.Height;
                MoveControls();//移动控件
            }
    
            //改变控件大小时，重新绘制控件
            private void ctLabelTextbox_SizeChanged(object sender, EventArgs e)
            {
                MoveControls();
            }
    
            private void MoveControls()
            {
                switch (mPosition)
                {
                    case PositionEnum.Below:
                        //设置Textbox的顶部在Label的底部
                        this.txtLabelText.Top = this.lblTextBox.Bottom;
                        this.txtLabelText.Left = this.lblTextBox.Left;
    
                        //修改Textbox的宽度与控件宽度一致
                        this.txtLabelText.Width = this.Width;
    
                        this.Height = txtLabelText.Height + lblTextBox.Height;
                        break;
                    case PositionEnum.Right:
                        //设置textbox的顶部与label一平
                        txtLabelText.Top = lblTextBox.Top;
    
                        //如果margin值为零，将textbox与label紧挨着放
                        if (mTextboxMargin == 0)
                        {
                            int width = this.Width - lblTextBox.Width - 3;
                            txtLabelText.Left = lblTextBox.Right + 3;
                            txtLabelText.Width = width;
                        }
                        else
                        {
                            //如果margin值不为零，将textbox 放置在用户定义的位置
                            txtLabelText.Left = mTextboxMargin;
                            txtLabelText.Width = this.Width - mTextboxMargin;
                        }
                        this.Height = txtLabelText.Height > lblTextBox.Height ? txtLabelText.Height : lblTextBox.Height;
                        break;
                }
            }
    
            private void txtLabelText_KeyDown(object sender, KeyEventArgs e)
            {
                OnKeyDown(e);
            }
    
            private void txtLabelText_KeyPress(object sender, KeyPressEventArgs e)
            {
                OnKeyPress(e);
            }
    
            private void txtLabelText_KeyUp(object sender, KeyEventArgs e)
            {
                OnKeyUp(e);
            }
    
        }
    }

LabelTextboxTest窗体完整代码

using System;
    using System.Collections.Generic;
    using System.ComponentModel;
    using System.Data;
    using System.Drawing;
    using System.Linq;
    using System.Text;
    using System.Windows.Forms;
    
    namespace LabelTextboxTest
    {
        public partial class Form1 : Form
        {
            public Form1()
            {
                InitializeComponent();
            }
    
            private void ctLabelTextbox1_PositionChanged(object sender, EventArgs e)
            {
                MessageBox.Show("Chnaged");
            }
    
            private void button1_Click(object sender, EventArgs e)
            {
                ctLabelTextbox1.Position = ctLabelTextbox1.Position ==
                    LabelTextBox.ctLabelTextbox.PositionEnum.Right ?
                    LabelTextBox.ctLabelTextbox.PositionEnum.Below :
                    LabelTextBox.ctLabelTextbox.PositionEnum.Right;
            }
        }
    }

# 六 项目源码 #

[项目源码下载地址][Link 1]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70]: /images/20221022/9a2eba7b24884a978203b8c3d732d751.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 1]: /images/20221022/2037acbe8a704775afb5709a2a5ab666.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 2]: /images/20221022/942e73a1e01f4a1b9e4d0b7e10ad8255.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 3]: /images/20221022/47e37767d3d148f1bf5f4c1121bd9a9d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 4]: /images/20221022/545f43223f074bbdad06ad8e14b2b127.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 5]: /images/20221022/d2ade8fd15e841318f2a8e199ef27331.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 6]: /images/20221022/b16553591bd245ccb94a577cc303d7ac.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 7]: /images/20221022/f9dca1b7e1454bb991c4a96a92e52e0b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 8]: /images/20221022/39debb33715d4866a321858120452c4b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 9]: /images/20221022/551c0facf99a4e1da1875b1c78cc93cf.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 10]: /images/20221022/39a667a7bb3b4e83a6effbc310cc4124.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 11]: /images/20221022/3408b1b7fe3049ac8209ba3a31d9475b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 12]: /images/20221022/d07b4b9e6d2e485e8f9f5b8d6977a02b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 13]: /images/20221022/0211286210814b5a9b94a465f7958928.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 14]: /images/20221022/fca4f4a4f9bc4b239ca0d0118562db87.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 15]: /images/20221022/13d3a0b781064eb58c0b923b6da2161d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 16]: /images/20221022/5c59bc4a5d5945c7b3889f443d49b967.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 17]: /images/20221022/c5fdde63a9fa4e54beaa81259aa5a7c3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 18]: /images/20221022/2f4b4a17c1f14e3aaac8ff2c9b88008a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pjbjU5Njc4NTE1NA_size_16_color_FFFFFF_t_70 19]: /images/20221022/07292b96e84d4f3ea4cb2fac85bf2bfa.png
[Link 1]: https://download.csdn.net/download/zcn596785154/16788207