【开源EFW框架】框架中自定义控件GridBoxCard使用实例说明
EFW框架源代码下载V1.3:http://pan.baidu.com/s/1c0dADO0
EFW框架实例源代码下载:http://pan.baidu.com/s/1eQCc69G
在《二十五、EFW框架Winform前端开发之自定义控件》中列出了EFW框架中的强大自定义控件及每个控件的API说明,但是对如何使用这些控件还不是很明白,本章通过实例的方式详细说明GridBoxCard控件的使用方法;
本文要点:
1.实例功能说明
2.控件属性设置
3.编写后台代码
1.实例功能说明
效果图:
制作一个书单在网格中,点击“新增”按钮网格新增空白行,焦点定位在书籍名称列,并弹出下拉书籍目录,可以通过拼音五笔码过滤书籍,回车选定书籍添加到网格中,再选择下一本书籍,如此在网格中生成了一个自定义的书单。
2.控件属性设置
1)将工具栏中的GridBoxCard控件拖入窗体,并设置好网格的列;其中ReadOnly属性为false,打开Columns属性中“书籍名称”列的ReadOnly设置为false,其他的几列都设置为true;
2)设置GridBoxCard控件的一些自定义属性,特别是SelectionCards属性,点击添加一个成员,如果有多列需要绑定下拉网格,那么这里就要添加多个成员,此处只需要将“书籍名称“这列 绑定下拉网格;
3)需要设置DataGridViewSelectionCard成员的属性,其中BindColumnIndex为列索引,”书籍名称“此列的索引是1,所以此处设置为1。其中CardColumn属性指定下拉网格显示的列”code|编码|50,name|名称|auto“表示显示两列”编码“和”名称“。其中QueryFieldsString属性指定过滤网格数据的列名”name,pym,wbm“表示可以通过名称、拼音码、五笔码三个字段进行过滤书籍;
3.编写后台代码
1)构建数据源“书籍字典”
//数据源 private DataTable GetData() { DataTable dt = new DataTable(); dt.Columns.Add("code"); dt.Columns.Add("name"); dt.Columns.Add("pym"); dt.Columns.Add("wbm"); dt.Columns.Add("price"); dt.Columns.Add("buydate"); dt.Rows.Add("01", "人月神话", "rysh", "rysh", "12.00", "2014-02-21"); dt.Rows.Add("02", "浪潮之巅", "lczd", "lczd", "12.00", "2014-03-11"); dt.Rows.Add("03", "人件", "rj", "rj", "12.00", "2014-08-01"); dt.Rows.Add("04", "面向对象设计", "mxdxsj", "mxdxsj", "12.00", "2014-12-01"); dt.Rows.Add("05", "架构之美", "jgzm", "jzzm", "12.00", "2014-12-21"); dt.Rows.Add("06", "设计原本", "sjyb", "sjyb", "12.00", "2014-05-21"); dt.Rows.Add("07", "敏捷项目管理", "mjxmgl", "mjxmgl", "12.00", "2014-01-11"); dt.Rows.Add("08", "代码之美", "dmzm", "dmzm", "12.00", "2014-04-21"); dt.Rows.Add("09", "大道至简", "dzzj", "ddzj", "12.00", "2014-01-01"); dt.Rows.Add("10", "走出软件作坊", "zcrjzh", "zcfjzh", "22.00", "2014-02-11"); return dt; }
2)控件绑定数据源,分别给控件的DataSource和控件列的下拉网格绑定数据源
private void Form1_Load(object sender, EventArgs e) { DataTable dtsource = GetData().Clone(); //绑定数据源 gridBoxCard1.DataSource = dtsource; //绑定下拉网格数据源 gridBoxCard1.BindSelectionCardDataSource(0, GetData().Copy()); }
3)点击“新增”开始编辑网格数据
//新增 private void button1_Click(object sender, EventArgs e) { gridBoxCard1.AddRow(); }
4)选定下拉网格数据赋值给网格控件
//选定下拉网格行,数据赋值 private void gridBoxCard1_SelectCardRowSelected(object SelectedValue, ref bool stop, ref int customNextColumnIndex) { DataTable dt = (DataTable)this.gridBoxCard1.DataSource; int rowindex = gridBoxCard1.CurrentCell.RowIndex; dt.Rows[rowindex]["code"] = ((DataRow)SelectedValue)["code"]; dt.Rows[rowindex]["name"] = ((DataRow)SelectedValue)["name"]; dt.Rows[rowindex]["price"] = ((DataRow)SelectedValue)["price"]; dt.Rows[rowindex]["buydate"] = ((DataRow)SelectedValue)["buydate"]; }
总结:此控件适合于直接在网格中编辑数据的功能,下拉网格数据来源字典数据,这样用户操作起来非常直观;控件简化了对网格操作控制的代码,特别是列绑定下拉网格不需要过多代码,只要设置几个属性就行了;