Winform 通过FlowLayoutPanel及自定义的编辑控件，实现快速构建C/S版的编辑表单页面 z

http://www.cnblogs.com/zuowj/p/4504130.html

不论是B/S或是C/S结构类型，无非就是实现可供用户进行查、增、改、删，其中查询用到最多，开发设计的场景也最为复杂，包括但不限于：表格记录查询、报表查询、导出文件查询等等，其次就是增加、更改、删除，我这里统称为编辑，而编辑在开发设计中的场景就显得较为通用，大多都采用编辑组件（文本框、下拉框、选择框、数字框等）来供用户进行编辑操作，由于查询的开发设计场景需与实际的数据及客户要求来进行的，所以在此不作讨论，本文主要讲述的是如何利用FlowLayoutPanel及我（梦在旅途）自定义的编辑控件来实现快速构建C/S版的编辑表单页面。

有经历过开发ASP.NET MVC网站的人都知道，在构建编辑页面时，我们可以通过HtmlHelper扩展类相关方法来快速生成相应的编辑控件，如：Html.LabelFor,Html.TextBoxFor等等，而在Winform 项目中却并没有类似的方法可以让我们快速构建编辑表单页面，所以为了减轻我们经常遇到，又比较耗时，且没有任何技术含量的开发工作量，我开发了类似的编辑控件系列，包括：CTextBox【文本框】、CPictureBox【图片框】、CNumberBox【数字框】、CDropDownBox【下拉框】、CDisplayBox【显示框】、CCheckBox【勾选框】,这些控件都一些共有特性，如：Label：显示编辑项目名称，Value：控件的值，ValueFor<TEntity>：快速设置控件相关属性的方法，这些共有特性是实现快速构造编辑控件的关键，当然每种编辑控件还有自己独特的属性，如：CTextBox可以设置是否显示按钮，是否只读，是否多行等，CNumberBox可以设置小数位、最大值与最小值等，由于这些控件的代码加起来可能比较多，我这里仅以CTextBox为例来进行分析与说明，CTextBox是属性最多的控件。

首先还是看一下CTextBox控件的界面设计，如下图：

从图中可以看出，CTextBox控件由一个TableLayouPanel、一个Label、一个TextBox、一个Button共同组成：

TableLayouPanel作为控件的顶层容器，其DOCK属性设置为Fill，实现占据整个控件，另外分别设有一行三列，第一列宽度设为自动调整，第二列宽度设为100%，第三列宽度设为自动调整，如下图：

TableLayouPanel这样设计的目的是：实现第一列的宽度依据LABEL的内容自动调整，第二列的宽度为TextBox的宽度，第三列的宽度为Button的宽度，这样一来，我们在改变CTextBox的整个大小时，确保布局一致性（即：在CTextBox总宽度内，TextBox的宽度是CTextBox总宽度-LABEL与Button的实际宽度）

Label控件作为显示编辑项目名称部份，它的属性AutoSize设为True,Anchor设为Left，设计目的：实现在第一列中向左居中，且宽度依据实际内容而改变

TextBox控件作为可供编辑内容部份，它的属性设Anchor设为Top, Bottom, Left, Right，设计目的：实现 TextBox控件占据整个第二列，即若控件的宽度与高度改变，TextBox控件也会跟着改变，这个很重要哦！

Button控件为可选部份，若需要用到控件的值来源于其它选项（如：浏览文件、保存文件等），则可将其 CTextBox.DispalyOpenButton设为True即可，同样，它的属性Anchor设为Left，并调整好固定的宽度与高度，设计目的：实现在第三列中向左居中，且宽度不变

实现的整体效果如下图示：

我这里用红线框出来了，大家看出效果来了吗？也就是我直接拖放了三个CTextBox控件，然后分别将LABEL的内容设置为不相同，除非手动改变控件宽度，否则每个控件宽度均相同，这样再结合FlowLayoutPanel控件的流式布局（即：每个控件按照顺序依次排列，若宽度与高度发生变化，控件的排列就会改变），就能很好的快速构建编辑页面，看看最终用在我的项目中的效果吧，有没有觉得不错呢：

这是改变宽度前的布局，有5列，我有红框标出来了，都是对齐的

这是我缩小宽度后的布局，有2列，我有红框标出来了，仍然都是对齐的

以上布局效果是不需要编写任何代码的，代码部份仅是设置相应的属性与方法，如下：

CTextBox控件源码：

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;
using System.Linq.Expressions;
using Zwj.TEMS.Common;
 
 
namespace TEMS.Controls
{
    public partial class CTextBox : UserControl,IZwjDefControl
    {
        [Description("当点击按钮时触发该事件")]
        public event EventHandler OnOpen;
 
        public CTextBox()
        {
            InitializeComponent();
            this.DispalyOpenButton = false;
        }
 
        [Browsable(true)]
        [Description("设置文本框的值")]
        public string Value
        {
            get
            {
                return textBox1.Text;
            }
            set
            {
                textBox1.Text = value;
            }
        }
 
        [Browsable(true)]
        [Description("设置标签的值")]
        public string Label
        {
            get
            {
                return label1.Text;
            }
            set
            {
                label1.Text = value;
            }
        }
 
        [Browsable(true)]
        [Description("设置是否显示打开按钮")]
        public bool DispalyOpenButton
        {
            get
            {
                return button1.Visible;
            }
            set
            {
                button1.Visible = value;
                textBox1.ReadOnly = button1.Visible;
            }
        }
 
        [Browsable(true)]
        [Description("设置是否允许多行")]
        public bool AllowMultiline
        {
            get
            {
               return textBox1.Multiline;
            }
            set
            {
                textBox1.Multiline = value;
                if (textBox1.Multiline)
                {
                    textBox1.ScrollBars = ScrollBars.Vertical;
                }
            }
        }
 
        public void ValueFor<TEntity>(Expression<Func<TEntity, dynamic>> selectField, string fieldValue, bool displayBtn = false, bool allowMultiline=false) where TEntity : class
        {
            var fieldInfo = General.GetPropertyInfo(selectField);
            this.Label = General.GetDisplayName(fieldInfo);
            this.Value = fieldValue;
            this.DispalyOpenButton = displayBtn;
            this.AllowMultiline = allowMultiline;
        }
 
        private void button1_Click(object sender, EventArgs e)
        {
            if (this.OnOpen != null)
            {
                this.OnOpen(this, null);
            }
        }
    }
}

以下是系统自动生成的源码：

代码就比较简单了，在此就不再详细说明了，只是其中用到了两个我自定义的方法：

General.GetPropertyInfo ---根据LINQ表达式获取属性信息；

General.GetDisplayName ---根据属性信息获取显示的名称；

方法定义代码如下(我以前的博文及个人网站www.zuowenjun.cn中也有说明)：

/// <summary>
/// 获取属性需要显示的名称
/// </summary>
/// <param name="p"></param>
/// <returns></returns>
public static string GetDisplayName(PropertyInfo p)
{
    string displayName = null;
    DisplayAttribute attr = p.GetAttribute<DisplayAttribute>();
    if (attr != null)
    {
        displayName = attr.Name;
    }
    else
    {
        displayName = p.Name;
    }
    return displayName;
}
 
/// <summary>
/// 获取指定属性信息（非String类型存在装箱与拆箱）
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="select"></param>
/// <returns></returns>
public static PropertyInfo GetPropertyInfo<T>(Expression<Func<T, dynamic>> select)
{
    var body = select.Body;
    if (body.NodeType == ExpressionType.Convert)
    {
        var o = (body as UnaryExpression).Operand;
        return (o as MemberExpression).Member as PropertyInfo;
    }
    else if (body.NodeType == ExpressionType.MemberAccess)
    {
        return (body as MemberExpression).Member as PropertyInfo;
    }
    return null;
}

如果觉得可以给个推荐吧，如果觉得有不足的地方，欢迎指出，谢谢！

另外为了方便大家学习与使用系列控件，我已将源码打包上传，大家可以点以下链接下载：

Zwj-Controls.rar

posted on 2016-01-16 15:49 武胜-阿伟阅读(1645) 评论(0) 编辑收藏举报