DevExpress控件-lookupedit的使用方法详解（图文）

最新推荐文章于 2025-10-31 14:48:07 发布

转载最新推荐文章于 2025-10-31 14:48:07 发布 · 1.1w 阅读

文章标签：

本文围绕LookupEdit控件展开，介绍了其绑定数据源、常用属性、获取选择值等操作。还阐述了枚举类型SearchMode的不同效果，以及判断是否选择下拉框、清空和设置nulltext值等内容。同时，针对使用中获取选择记录的问题给出解决办法，如利用相关方法获取数据，多键值情况可用gridlookupedit。

绑定数据源:

lookupedit.Properties.ValueMember = 实际要用的字段; //相当于editvalue
lookupedit.Properties.DisplayMember =要显示的字段; //相当于text
lookupedit.Properties.DataSource = 数据源;

常用属性

lookupedit.PopupWidth = 100; //下拉框宽度
lookupedit.NullText = "";//空时的值
lookupedit.DropDownRows = 10;//下拉框行数
lookupedit.TextEditStyle = TextEditStyles.Standard;//要使用户可以输入，这里须设为Standard
lookupedit.AllowNullInput = DevExpress.Utils.DefaultBoolean.True; //可用Ctrl + Delete清空选择內容

获取选择值

string id = this.lookUpEdit1.EditValue.ToString(); //是lookUpEdit.Properties.ValueMember的值
string name = this.lookUpEdit1.Text.Trim(); //是lookUpEdit.Properties.DisplayMember的值

允许输入自定义值

lookUpEdit1.Properties.TextEditStyle = DevExpress.XtraEditors.Controls.TextEditStyles.Standard;

动态添加列

this.lookUpEdit1.Properties.Columns.AddRange(new DevExpress.XtraEditors.Controls.LookUpColumnInfo[] {
new DevExpress.XtraEditors.Controls.LookUpColumnInfo("FieldName1", "Caption1"),
new DevExpress.XtraEditors.Controls.LookUpColumnInfo("FieldName2", "Caption2")});

实现用户自由输入内容，代码如下：

DataTable LookupTable = null;//LookupTable数据源
/// <summary>
/// 窗体加载
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void FrmTable_Load(object sender, EventArgs e)
{
//创建RepositoryItemLookUpEdit
RepositoryItemLookUpEdit cbxList = new RepositoryItemLookUpEdit();
cbxList.PopupWidth = 200; //下拉框宽度
cbxList.NullText = "";//空时的值
cbxList.DropDownRows = 30;//下拉框行数
cbxList.ImmediatePopup = true;//输入值是否马上弹出窗体
cbxList.ValidateOnEnterKey = true;//回车确认
cbxList.SearchMode = SearchMode.AutoFilter;//自动过滤掉不需要显示的数据，可以根据需要变化
cbxList.TextEditStyle = TextEditStyles.Standard;//要使用户可以输入，这里须设为Standard
cbxList.AllowNullInput = DevExpress.Utils.DefaultBoolean.True; //可用Ctrl + Delete清空选择內容
//添加显示列
cbxList.Columns.AddRange(new DevExpress.XtraEditors.Controls.LookUpColumnInfo[] {
new DevExpress.XtraEditors.Controls.LookUpColumnInfo("code", "代码"),
new DevExpress.XtraEditors.Controls.LookUpColumnInfo("name", "名称")});
cbxList.ValueMember = "name";
cbxList.DisplayMember = "name";
//指定该列控件
(gcl_dataList.MainView as GridView).Columns["name"].ColumnEdit = cbxList;
//获取数据源
sys_DataBase sys_DataBaseBLL = new sys_DataBase();
LookupTable = new DataTable();
LookupTable = sys_DataBaseBLL.GetColumnList2(30).Tables[0];
//绑定数据源
cbxList.DataSource = LookupTable;
//实现用户自由输入
cbxList.ProcessNewValue += LookUpEdit1_ProcessNewValue;
}
/// <summary>
/// 实现用户自由输入
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void LookUpEdit1_ProcessNewValue(object sender, DevExpress.XtraEditors.Controls.ProcessNewValueEventArgs e)
{
DataRow Row;
RepositoryItemLookUpEdit Edit = ((LookUpEdit)sender).Properties;
if (e.DisplayValue == null || Edit.NullText.Equals(e.DisplayValue) || string.Empty.Equals(e.DisplayValue))
return;
Row = LookupTable.NewRow();
Row["name"] = e.DisplayValue;
LookupTable.Rows.Add(Row);
e.Handled = true;
}

关于枚举类型SearchMode的定义：

配合lookUpEdit1.ImmediatePopup=True时使用

特点：在下拉窗体能显示匹配结果（蓝底白字），但在输入框内不显示，从数据列表中第一字符开始匹配。

SearchMode.OnlyInPopup效果如下：

SearchMode.AutoFilter效果如下：

特点：能在输入框显示匹配的数据，并过滤过不想要的记录。

SearchMode.AutoComplete效果如下：

特点：能在输入框显示匹配的数据，并且下拉窗体显示匹配的记录，AutoComplete模式仅匹配DisplayMember对应字段的值。

判断是否选择下拉框:

if(this.lookupedit.editvalue==null ||this.lookupedit.editvalue.tostring()=="nulltext")
{
//提示信息,说明未选择下拉框
}

清空nulltext值:　

lookupedit.properties.nulltext=null;

设置nulltext值:

lookupedit.properties.nulltext=“请您选择”;

默认不可编辑

lookUpEdit1.Properties.TextEditStyle = TextEditStyles.DisableTextEditor;<strong> </strong>

使用lookupedit1的值:

变量=this.lookupedit.editvalue.tostring()　　//是ookupedit.properties.valuemember的值
变量=this.lookupedit.text.trim()　　　　　　//是ookupedit.properties.displaymember 的值

特别值得注意的是，有时候我们要使用lookupedit来实现combox的一些效果，在实际的使用过程中在程序加载的时候会默认的选择第一项，它的设置是：

lookupedit.itemindex＝0； //选择第一项
lookupedit.itemindex＝-1； //无选项，此时显示的是nulltext值　其实这个地方只要editvalue==null，lookupedit就显示nulltext
lookupedit1.editvalue=value；//自动搜索datasouse，选择与之匹配的值，没有的情况下赋值null ,value的值必须与valuemember的数据类型一致。

在gridview中你选择一条记录，那么利用bindingsourse.current就可以获得你要选择的数据，如果是实体类就可以（object）进行强制转换，然后　进行一些其它的操作。

但是，lookupedit在你选择一条记录的时候，bindingsourse.current的值永远是第一条记录，要想获得你选择数据源的记录，必须利用lookupedit.getdatasoursebykeyvalue(keyvalue),（object）进行强制转这样就可以了。但是你要注意的就是keyvalue必须是你数据源中的主键，否则你获取的是相同键的第一个记录。如果遇到多键值决定一条记录怎么办呢？

这个问题dev express也有他相应的解决办法，就是用到gridlookupedit，它该是gridview和lookupedit的结合体吧，利用这个你就可以选择主键相同的记录了，利用gridlookupeditview.getdatasourcerowindex(gridlookupeditview.focusedrowhandle)就可以了。

实例绑定方法

//绑定lookUpEdit
private void BoundData()
{
string sql = "select daID,xm,sfzh from baseinfo";
DataSet ds = Archives.DataAccess.DataSql.Query(sql);
if (ds != null)
{
int rows = ds.Tables[0].Rows.Count;
lookUpEdit1.EditValue = "daID";
lookUpEdit1.Properties.ValueMember = "daID";
lookUpEdit1.Properties.DisplayMember = "xm";
lookUpEdit1.Properties.DataSource = ds.Tables[0];
//自适应宽度
//lookUpEdit1.Properties.BestFitMode = DevExpress.XtraEditors.Controls.BestFitMode.BestFitResizePopup;
//填充列
lookUpEdit1.Properties.PopulateColumns();
//设置列属性
//lookUpEdit1.Properties.Columns[0].Visible = false;
lookUpEdit1.Properties.Columns[1].Caption = "姓名";
lookUpEdit1.Properties.Columns[2].Caption = "身份证号";
lookUpEdit1.Properties.Columns[1].Width = 120;
lookUpEdit1.Properties.Columns[2].Width = 300;
//控制选择项的总宽度
lookUpEdit1.Properties.PopupWidth = 500;
//列格式设置
lookUpEdit1.Properties.Columns[0].FormatString = "000000";
//选择第一项
lookUpEdit1.ItemIndex = 0;
}
}