C#DevExpress使用GridLookUpEdit实现订单明细选择商品
一、功能需求
ERP系统的《客户报价单》、《销售订单》，用户在开单时需要快速检索商品历史，下拉选择商品快速开单，提高工作效率及用户体验。
如下图所示：
有两种解决方案：
1、使用LookupEdit，组件比较简单，但效果不佳。
2、使用GridLookupEdit，丰富的下拉表格组件，支持每个列检索数据。
本文采用第2种方案。
二、上硬货
需要使用DevExpress的 RepositoryItemGridLookUpEdit 组件，下面给大家提供完整版源码。
2.1 给GridColumn列绑定 RepositoryItemGridLookUpEdit 组件
选择列，属性标签页ColumnEdit属性，点击右侧的下拉按钮，双击选择GridLookUpEdit组件。
改名，输入新的名称，按回车改名。
目前已完成创建RepositoryItemGridLookUpEdit组件，命名： rep_SelectProduct
2.2 初始化 RepositoryItemGridLookUpEdit 组件 及绑定数据源
我们采用硬编码方式初始化 RepositoryItemGridLookUpEdit 组件，其优点是能直观看到重要属性设置。
/// <summary>
/// 初始化 RepositoryItemGridLookUpEdit 组件
/// </summary>
private void InitGridLookUpEdit_SelectProduct()
{
GridView view = rep_SelectProduct.View;
view.Columns.Clear();
view.Columns.Add(new GridColumn { Caption = "产品编号", FieldName = nameof(tb_SOs.ProductCode), Width = 100, VisibleIndex = 0 });
view.Columns.Add(new GridColumn { Caption = "品名", FieldName = nameof(tb_SOs.ProductName), Width = 150, VisibleIndex = 1 });
view.Columns.Add(new GridColumn { Caption = "规格", FieldName = nameof(tb_SOs.Spec), Width = 150, VisibleIndex = 2 });
view.Columns.Add(new GridColumn { Caption = "配方", FieldName = nameof(tb_SOs.Formula), Width = 60, VisibleIndex = 3 });
view.Columns.Add(new GridColumn { Caption = "长度", FieldName = nameof(tb_SOs.Length), Width = 60, VisibleIndex = 4 });
view.Columns.Add(new GridColumn { Caption = "米重", FieldName = nameof(tb_SOs.UnitWeight), Width = 60, VisibleIndex = 5 });
var width = view.Columns.ToList().Sum(i => i.Width) + 10;
rep_SelectProduct.AcceptEditorTextAsNewValue = DevExpress.Utils.DefaultBoolean.True; //重要！！！接受文本框的值作为新值显示
rep_SelectProduct.NullText = "";
rep_SelectProduct.PopupFormSize = new Size(width, 400);//下拉窗体尺寸
rep_SelectProduct.View.RowHeight = 22; //行高
rep_SelectProduct.ImmediatePopup = true;//输入值立即弹出下拉窗体
rep_SelectProduct.SearchMode = GridLookUpSearchMode.AutoSearch;//设置为自动搜索模式，重要！！！
rep_SelectProduct.PopupFilterMode = DevExpress.XtraEditors.PopupFilterMode.Contains;//表格筛选列过滤模式
rep_SelectProduct.TextEditStyle = DevExpress.XtraEditors.Controls.TextEditStyles.Standard;//允许录入资料
rep_SelectProduct.View.OptionsView.ShowAutoFilterRow = true;//下拉表格显示过滤行
//按回车键处理包含关系的新值
rep_SelectProduct.ProcessNewValue += this.On_GridLookUpEdit_ProcessNewValue; //在输入框录入新值处理事件
//按回车键处理包含关系的新值
rep_SelectProduct.KeyDown += On_GridLookUpEdit_KeyDown;
//下拉表格的记录行点击事件
rep_SelectProduct.View.RowClick += On_GridLookUpEdit_RowClick;
rep_SelectProduct.CloseUp += On_GridLookUpEdit_CloseUp;
//绑定数据源
List<dt_Product> list = DataDictCache.Cache.ProductList.Copy();
rep_SelectProduct.DisplayMember = nameof(tb_SOs.ProductName);
rep_SelectProduct.ValueMember = nameof(tb_SOs.ProductName);
rep_SelectProduct.DataSource = list;
}2.3 On_GridLookUpEdit_ProcessNewValue
在单元格录入新值，自动添加到数据源
/// <summary>
/// 在单元格录入新值，自动添加到数据源
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void On_GridLookUpEdit_ProcessNewValue(object sender, ProcessNewValueEventArgs e)
{
var editor = sender as GridLookUpEdit;
if (e.DisplayValue.IsEmpty() || e.DisplayValue.ToStringEx() == editor.Properties.NullText)
{
return;
}
//如果没有绑定数据源，初始化空列表实例
if (editor.Properties.DataSource == null)
{
editor.Properties.DataSource = new List<dt_Product>();
}
//给数据源添加一条记录
var list = editor.Properties.DataSource as List<dt_Product>;
list.Add(new dt_Product { ProductName = e.DisplayValue.ToStringEx() });
e.Handled = true;
}2.4 On_GridLookUpEdit_KeyDown
GridLookUpEdit组件回车键事件，录入的数据不存在，自动添加到数据源
/// <summary>
/// GridLookUpEdit组件回车键事件，录入的数据不存在，自动添加到数据源
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void On_GridLookUpEdit_KeyDown(object sender, KeyEventArgs e)
{
if (e.KeyCode == Keys.Enter) //捕获回车键
{
var txt = (sender as GridLookUpEdit).Text;
var list = rep_SelectProduct.DataSource as List<dt_Product>;
if (!list.Any(a => a.ProductName.ToStringEx().ToLower() == txt.ToLower())) //数据源没有该值
{
list.Add(new dt_Product { ProductName = txt });//这里必须是对应DisplayMember字段
}
gvDetail.HideEditor();
gvDetail.SetFocusedRowCellValue(nameof(dt_Product.ProductName), txt);
e.Handled = true;
}
}2.5 On_GridLookUpEdit_RowClick
选择一条记录，触发表格的点击事件
/// <summary>
/// 选择一条记录，触发表格的点击事件
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void On_GridLookUpEdit_RowClick(object sender, RowClickEventArgs e)
{
GridView gv = (sender as GridView);
dt_Product product = gv.GetRow(e.RowHandle) as dt_Product; //下拉窗体当前选择行
res_SOs row = gvDetail.GetRow<res_SOs>();//明细表当前行
SetRowProductInfo(row, product);//赋值
gvDetail.HideEditor();
e.Handled = true;
}2.6 SetRowProductInfo
给销售订单明细记录设置产品资料
/// <summary>
/// 给销售订单明细记录设置产品资料
/// </summary>
/// <param name="row"></param>
/// <param name="product"></param>
void SetRowProductInfo(res_SOs row, dt_Product product)
{
row.ProductCode = product.ProductCode;
row.ProductName = product.ProductName;
row.ProductType = product.ProductType;
row.CategoryId = product.CategoryId;//品类
row.Price = product.SellPrice;//吨价
row.Spec = product.Spec;
row.Unit = product.UnitID;
row.Formula = product.Formula;
row.Length = product.Length;
row.UnitWeight = product.Weight;//米重
}2.7 Form.Load事件调用
private void frmSO_Load(object sender, EventArgs e)
{
this.InitGridLookUpEdit_SelectProduct();
}三、测试效果
自动筛选数据
选择一条记录
录入新品名
本教程《销售订单》界面，使用 CSFrameworkV6.1旗舰版 快速开发框架为客户定制的板材行业ERP系统。
以后会分享更多硬货给大家~ 感谢您的关注！
专注.NET技术、C/S架构开发框架软件
C/S框架网 - 开发框架文库
