在一些字典綁定中，往往為了方便展示詳細(xì)數(shù)據(jù)，需要把一些結(jié)構(gòu)樹展現(xiàn)在樹列表TreeList控件中或者下拉列表的樹形控件TreeListLookUpEdit控件中，為了快速的處理數(shù)據(jù)的綁定操作，比較每次使用涉及太多細(xì)節(jié)的操作，我們可以把相關(guān)的數(shù)據(jù)綁定操作，放在一些輔助類的擴(kuò)展函數(shù)中進(jìn)行處理，這樣可以更方便的，更簡潔的處理數(shù)據(jù)綁定操作，本文將介紹TreeList控件和TreeListLookUpEdit控件在擴(kuò)展函數(shù)中的處理操作。
PS：給大家推薦一個(gè)C#開發(fā)可以用到的界面組件——DevExpress WinForms，它能完美構(gòu)建流暢、美觀且易于使用的應(yīng)用程序，無論是Office風(fēng)格的界面，還是分析處理大批量的業(yè)務(wù)數(shù)據(jù)，它都能輕松勝任！
DevExpress技術(shù)交流群10：532598169 歡迎一起進(jìn)群討論
TreeList控件的綁定操作
TreeList本身就是一個(gè)樹形數(shù)據(jù)的展示控件，可以展示常規(guī)的二維表，也可以展示具有嵌套關(guān)系的二維表，數(shù)據(jù)源可以是多種方式的，支持Datable的數(shù)據(jù)源的嵌套展示。
單個(gè)列信息的樹形列表展示界面效果：
類似GridView的嵌套列表展示的TreeList界面效果：
這些界面都比較常見，也是我們經(jīng)常碰到的處理效果，但是TreeList的界面設(shè)置有很多特性，如果每次拷貝這些代碼，需要很多，也不便于維護(hù)，因此我們建立一些擴(kuò)展函數(shù)來處理界面元素的綁定，就非常必要。
本文介紹基于TreeList和TreeListLookUpEdit控件的綁定即可。兩個(gè)類型控件的數(shù)據(jù)源，都可以是DataTable類型，也可以是IList集合類型，如下所示是基于SQLSugar開發(fā)框架，返回的數(shù)據(jù)結(jié)構(gòu)是IList類型的。
所以一般樹形列表的綁定操作，提供一個(gè)方法來獲取數(shù)據(jù)并綁定即可。
/// <summary>
/// 綁定樹的數(shù)據(jù)源
/// </summary>
private async void BindTree()
{
var list = await BLLFactory<IDictTypeService>.Instance.GetAllAsync();
this.tree.DataSource = list?.Items;
this.tree.ExpandAll();
}
如果使用原生代碼初始化樹列表，那么代碼如下所示。
//使用原生代碼處理
//添加顯示列
this.tree.Columns.Add(new TreeListColumn{ FieldName= "Id", Caption= "ID"});//增加一個(gè)隱藏的字段，存儲(chǔ)需要的ID
this.tree.Columns.Add(new TreeListColumn{ FieldName= "Name", Caption= "字典類型名稱", Width=160, VisibleIndex =0});
//設(shè)置樹控件的層次關(guān)系及屬性
tree.KeyFieldName = "Id";
tree.ParentFieldName = "PID";
this.tree.OptionsBehavior.Editable = false;
this.tree.OptionsView.ShowColumns = false;
this.tree.OptionsView.ShowCheckBoxes = false;
this.tree.OptionsView.EnableAppearanceOddRow = true;
this.tree.OptionsView.EnableAppearanceEvenRow = true;
而實(shí)現(xiàn)查詢過濾的操作，還需要另外處理代碼，我們看看大概的代碼如下。
/// <summary>
/// 實(shí)現(xiàn)樹節(jié)點(diǎn)的過濾查詢
/// </summary>
private void InitSearchControl()
{
this.searchControl1.Client = this.tree;
this.tree.FilterNode += (object sender, FilterNodeEventArgs e) =>
{
if (tree.DataSource == null)
return;
string nodeText = e.Node.GetDisplayText("Name");//參數(shù)填寫FieldName
if (string.IsNullOrWhiteSpace(nodeText))
return;
bool isExist = nodeText.IndexOf(searchControl1.Text, StringComparison.OrdinalIgnoreCase) >= 0;
if (isExist)
{
var node = e.Node.ParentNode;
while (node != null)
{
if (!node.Visible)
{
node.Visible = true;
node = node.ParentNode;
}
else
break;
}
}
e.Node.Visible = isExist;
e.Handled = true;
};
}
這些是比較常見的操作，我們把它封裝為擴(kuò)展函數(shù)，然后根據(jù)特性傳入對(duì)應(yīng)參數(shù)實(shí)現(xiàn)即可。
最后簡單的三行代碼來簡單處理，可以達(dá)到同樣的效果就可以了。
//控件擴(kuò)展函數(shù)封裝處理
this.tree.CreateColumn("Name", "字典類型名稱", 160, true);
this.tree.InitTree("Id", "PID", "-1", false, false);
this.tree.InitSearchControl(this.searchControl1, "Name");
我們擴(kuò)展方法放在一個(gè)單獨(dú)的文件中，標(biāo)注為靜態(tài)類即可。
/// <summary>
/// TreeList控件的擴(kuò)展函數(shù)
/// </summary>
public static class TreeList_Extension
其中提供幾個(gè)對(duì)TreeList 常見的封裝處理方法就可以了。
對(duì)于一些不常見的屬性，我們保留它即可，如下界面代碼是對(duì)TreeList綁定展示多個(gè)列的處理操作。
/// <summary>
/// 初始化TreeList控件,展現(xiàn)嵌套的列表。
/// </summary>
private void InitControl()
{
this.tree.Columns.Clear();//控件擴(kuò)展函數(shù)封裝處理
this.tree.CreateColumn("Name", "機(jī)構(gòu)名稱", 160, true);
this.tree.CreateColumn("HandNo", "機(jī)構(gòu)編碼", 80, true);
this.tree.CreateColumn("Category", "機(jī)構(gòu)分類", 80, true);
this.tree.CreateColumn("Address", "機(jī)構(gòu)地址", 160, true);
this.tree.CreateColumn("InnerPhone", "內(nèi)線電話", 80, true);
this.tree.CreateColumn("OuterPhone", "外線電話", 80, true);
this.tree.CreateColumn("SortCode", "排序碼", 80, true);
this.tree.InitTree("Id", "PID", null, true, true);
this.tree.OptionsView.RowImagesShowMode = RowImagesShowMode.InCell;//緊湊型圖標(biāo)
this.tree.ExpandAll();
// 列過濾處理
this.tree.OptionsView.ShowAutoFilterRow = true;//顯示過濾行
this.tree.OptionsBehavior.EnableFiltering = true;//開啟過濾功能
//初始化樹節(jié)點(diǎn)選擇事件
this.tree.FocusedNodeChanged += delegate (object sender, FocusedNodeChangedEventArgs e)
{
this.FocusedNodeChanged();
};
//樹節(jié)點(diǎn)雙擊處理事件
this.tree.DoubleClick += (s, e) =>
{
if (this.tree.FocusedNode != null)
{
string ID = string.Concat(this.tree.FocusedNode.GetValue("Id"));
MessageDxUtil.ShowTips("Id=" + ID);
}
};
//編輯記錄失去焦點(diǎn)后校驗(yàn)處理
this.tree.ValidateNode += (s, e) =>
{
Console.WriteLine(this.tree.FocusedNode.GetValue("Name"));
};
}
實(shí)現(xiàn)類似GridView的嵌套列表展示的TreeList界面效果如下所示。
TreeListLookUpEdit控件綁定操作
在一些參考的列表中，我們往往需要展示更豐富一點(diǎn)的列表內(nèi)容，如下所示。
如果有嵌套列表的，展示嵌套列表的處理：
對(duì)于下拉的樹形列表，雖然這個(gè)控件比TreeList更復(fù)雜一些，它是下拉列表和TreeList的整合體，不過我們也可以用類似的擴(kuò)展函數(shù)方法，來簡單的實(shí)現(xiàn)數(shù)據(jù)的綁定展示。
如對(duì)于常規(guī)的數(shù)據(jù)綁定，我們大概的代碼如下所示。
//TreeListLookupEdit數(shù)據(jù)綁定
//this.txtProjectList3.Properties.TreeList.OptionsView.ShowCheckBoxes = true;
this.txtProjectList3.Properties.DataSource = list;
this.txtProjectList3.Properties.ValueMember = "Value";
this.txtProjectList3.Properties.DisplayMember = "Text";
this.txtProjectList3.Properties.TreeList.Columns.Clear();
for (int i = 0; i < columns.Count; i++)
{
this.txtProjectList3.Properties.TreeList.CreateColumn(columns[i].FieldName, columns[i].Caption,
columns[i].Width, true);
}
this.txtProjectList3.Properties.TreeList.InitTree(null, null, null, true, true);
this.txtProjectList3.Properties.ImmediatePopup = true;
this.txtProjectList3.Properties.TextEditStyle = TextEditStyles.Standard;
this.txtProjectList3.Properties.PopupWidthMode = DevExpress.XtraEditors.PopupWidthMode.ContentWidth;
this.txtProjectList3.Properties.PopupFormSize = new System.Drawing.Size(this.txtProjectList3.Width, 300);
this.txtProjectList3.Properties.TreeList.IndicatorWidth = 40;
this.txtProjectList3.Properties.TreeList.CustomDrawNodeIndicator += (s, ee) =>
{
if (ee.IsNodeIndicator)
{
var index = ee.Node.TreeList.GetVisibleIndexByNode(ee.Node);
ee.Info.DisplayText = (index + 1).ToString();
}
};
對(duì)于常規(guī)的列表綁定，我們可以用簡單的一個(gè)擴(kuò)展函數(shù)實(shí)現(xiàn)，如下所示。
//常規(guī)類別綁定
this.txtProjectList4.BindDictItems(list, "Text", "Value", true, columns.ToArray());
就可以實(shí)現(xiàn)常規(guī)的界面效果處理。
對(duì)于樹形列表，我們需要設(shè)置屬性的ID和PID，以及一些顯示的列屬性，那么也可以增加更多的參數(shù)來實(shí)現(xiàn)。
var dictTypeColumns = new List<LookUpColumnInfo>()
{
new LookUpColumnInfo("Id", "Id"),
new LookUpColumnInfo("Name", "字典類別名稱")
};
treeListLookUp.BindDictItems(result.Items, "Name", "Id", true, false, "Id", "PID", null, true, true, true, false, dictTypeColumns.ToArray());
因此嵌套列表就可以正常的展示出層次關(guān)系了。
因此我們把擴(kuò)展方法，放到靜態(tài)類里面就可以了，方法封裝如下所示：
/// <summary>
/// 綁定TreeListLookUpEdit控件的數(shù)據(jù)源(完整版）
/// </summary>
/// <param name="lookup">控件對(duì)象</param>
/// <param name="dataSource">數(shù)據(jù)源</param>
/// <param name="displayMember">顯示字段</param>
/// <param name="valueMember">值字段</param>
/// <param name="showRowIndicator">是否顯示序號(hào)</param>
/// <param name="showCheckbox">是否顯示復(fù)選框</param>
/// <param name="keyFieldName">設(shè)置父子遞歸關(guān)系字段-子字段，不指定則使用valueMember</param>
/// <param name="parentFieldName">設(shè)置父子遞歸關(guān)系字段-父字段，不指定則不嵌套展示</param>
/// <param name="rootValue">根節(jié)點(diǎn)的值</param>
/// <param name="editable">樹節(jié)點(diǎn)是否可以編輯</param>
/// <param name="showColumnHeader">是否顯示列頭</param>
/// <param name="oddEvenRowColor">是否奇偶行不同顏色</param>
/// <param name="allowDrop">是否運(yùn)行拖動(dòng)列</param>
/// <param name="lookUpColumnInfos">顯示的列</param>
/// <returns></returns>
public static object BindDictItems(this TreeListLookUpEdit lookup, object dataSource, string displayMember, string valueMember, bool showRowIndicator = true,
bool showCheckbox = false, string keyFieldName = null, string parentFieldName = null, string rootValue = null, bool editable = true,
bool showColumnHeader = false, bool oddEvenRowColor = true, bool allowDrop = false,
params LookUpColumnInfo[] lookUpColumnInfos)
{
lookup.Properties.DataSource = dataSource;
lookup.Properties.DisplayMember = displayMember;
lookup.Properties.ValueMember = valueMember;
lookup.Properties.TreeList.OptionsView.ShowCheckBoxes = showCheckbox;
lookup.Properties.TreeList.Columns.Clear();
for (int i = 0; i < lookUpColumnInfos.Length; i++)
{
lookup.Properties.TreeList.CreateColumn(lookUpColumnInfos[i].FieldName, lookUpColumnInfos[i].Caption,
lookUpColumnInfos[i].Width, true);
}
//初始化樹的樣式和特性
//keyFieldName = !string.IsNullOrWhiteSpace(keyFieldName) ? keyFieldName : valueMember;//如果不指定，采用valueMember
lookup.Properties.TreeList.InitTree(keyFieldName, parentFieldName, rootValue, editable, showColumnHeader, oddEvenRowColor, allowDrop);
lookup.Properties.PopupFormSize = new System.Drawing.Size(lookup.Width, 300);
lookup.Properties.ImmediatePopup = true;
lookup.Properties.TextEditStyle = TextEditStyles.Standard;
if (showRowIndicator)
{
lookup.Properties.TreeList.IndicatorWidth = 40;
//重寫序號(hào)顯示，默認(rèn)不顯示數(shù)值
lookup.Properties.TreeList.CustomDrawNodeIndicator += (s, ee) =>
{
if (ee.IsNodeIndicator)
{
var index = ee.Node.TreeList.GetVisibleIndexByNode(ee.Node);
ee.Info.DisplayText = (index + 1).ToString();
}
};
}
return dataSource;
}
通過擴(kuò)展方法的方式，可以簡化界面的處理代碼，同時(shí)利于我們?cè)陧?xiàng)目開發(fā)的時(shí)候，快速的實(shí)現(xiàn)相關(guān)的效果，而不需要過多的中斷查找相關(guān)的界面控件屬性。
本文轉(zhuǎn)載自：
標(biāo)簽：
本站文章除注明轉(zhuǎn)載外，均為本站原創(chuàng)或翻譯。歡迎任何形式的轉(zhuǎn)載，但請(qǐng)務(wù)必注明出處、不得修改原文相關(guān)鏈接，如果存在內(nèi)容上的異議請(qǐng)郵件反饋至chenjj@fc6vip.cn
文章轉(zhuǎn)載自：
金喜正規(guī)買球 
24次
相關(guān)產(chǎn)品
正式授權(quán)
最新文章 
金喜正規(guī)買球相關(guān)的文章 
微信
在線咨詢
渝公網(wǎng)安備
50010702500608號(hào)
客服熱線