首页 > 代码库 > 【开源EFW框架】框架中自定义控件GridBoxCard使用实例说明
【开源EFW框架】框架中自定义控件GridBoxCard使用实例说明
回《【开源】EFW框架系列文章索引》
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"]; }
总结：此控件适合于直接在网格中编辑数据的功能，下拉网格数据来源字典数据，这样用户操作起来非常直观；控件简化了对网格操作控制的代码，特别是列绑定下拉网格不需要过多代码，只要设置几个属性就行了；
【开源EFW框架】框架中自定义控件GridBoxCard使用实例说明