Dev之GridControl詳解(圖文并茂).docx

GridControl詳解（一）原汁原味的表格展示Dev控件中的表格控件GridControl控件非常強大。不過，一些細枝末節(jié)的地方有時候用起來不好找挺討厭的。使用過程中，多半借助Demo和英文幫助文檔。網(wǎng)上具體的使用方法也多半零碎。偶遇一個簡單而且詳細的使用文檔。好記性不如爛筆頭！轉(zhuǎn)載過來，整理整理發(fā)出來做個記錄，總共有十個小節(jié)。做的非常精細，非常感謝原作者。插件所在位置使用時拖拽過來，如下所示即使拖拽過來原封不動的樣子：在程序中寫入構(gòu)建一個表格的代碼：csharp view plaincopyprint?1. private DataTable InitDt() 2. 3. DataTable dt = new DataTable(個人簡歷); 4. dt.Columns.Add(id,typeof(int); 5. dt.Columns.Add(name, typeof(string); 6. dt.Columns.Add(sex, typeof(int); 7. dt.Columns.Add(address, typeof(string); 8. dt.Columns.Add(aihao, typeof(string); 9. dt.Columns.Add(photo, typeof(string); 10. dt.Rows.Add(new object 1, 張三, 1, 東大街6號, 看書, ); 11. dt.Rows.Add(new object 1, 王五, 0, 西大街2號, 上網(wǎng),游戲, ); 12. dt.Rows.Add(new object 1, 李四, 1, 南大街3號, 上網(wǎng),逛街, ); 13. dt.Rows.Add(new object 1, 錢八, 0, 北大街5號, 上網(wǎng),逛街,看書,游戲, ); 14. dt.Rows.Add(new object 1, 趙九, 1, 中大街1號, 看書,逛街,游戲, ); 15. return dt; 16. 17. private DataTable InitDt() DataTable dt = new DataTable(個人簡歷); dt.Columns.Add(id,typeof(int); dt.Columns.Add(name, typeof(string); dt.Columns.Add(sex, typeof(int); dt.Columns.Add(address, typeof(string); dt.Columns.Add(aihao, typeof(string); dt.Columns.Add(photo, typeof(string); dt.Rows.Add(new object 1, 張三, 1, 東大街6號, 看書, ); dt.Rows.Add(new object 1, 王五, 0, 西大街2號, 上網(wǎng),游戲, ); dt.Rows.Add(new object 1, 李四, 1, 南大街3號, 上網(wǎng),逛街, ); dt.Rows.Add(new object 1, 錢八, 0, 北大街5號, 上網(wǎng),逛街,看書,游戲, ); dt.Rows.Add(new object 1, 趙九, 1, 中大街1號, 看書,逛街,游戲, ); return dt; 書寫gridControl1綁定數(shù)據(jù)方法：csharp view plaincopyprint?1. private void BindDataSource(DataTable dt) 2. 3. /綁定DataTable 4. gridControl1.DataSource = dt; 5. /綁定DataSet 6. /gridControl1.DataSource = ds; 7. /gridControl1.DataMember = 表名; 8. private void BindDataSource(DataTable dt) /綁定DataTable gridControl1.DataSource = dt; /綁定DataSet /gridControl1.DataSource = ds; /gridControl1.DataMember = 表名; 程序調(diào)用：BindDataSource(InitDt();呈現(xiàn)結(jié)果如下：GridControl詳解（二）表格的列名配置點擊Run Designer控件上的按鈕，彈出視圖設(shè)計窗口：列配置：我們配置完列名后，會發(fā)現(xiàn)設(shè)計視圖發(fā)生了變化：運行結(jié)果：GridControl詳解（三）列數(shù)據(jù)的格式設(shè)置 為了測試方便，我們加入新的3列，格式分別是數(shù)據(jù)，時間，字符串。代碼增加下列部分：csharp view plaincopyprint?1. /格式增加 2. dt.Columns.Add(數(shù)據(jù),typeof(decimal); 3. dt.Columns.Add(時間,typeof(DateTime); 4. dt.Columns.Add(自定義,typeof(string); 5. dt.Rows.Add(new object 1, 張三, 1,東大街6號,看書,-52.874,2011-8-5 17:52:55,# ); 6. dt.Rows.Add(new object 1, 王五, 0,西大街2號,上網(wǎng),游戲, -37.257,2011-8-5 17:52:55 ); 7. dt.Rows.Add(new object 1, 李四, 1,南大街3號,上網(wǎng),逛街, -54.254,2011-8-9 17:52:55 ); 8. dt.Rows.Add(new object 1, 錢八, 0,北大街5號,上網(wǎng),逛街,看書,游戲,-35.127,2011-8-9 17:52:55 ); 9. dt.Rows.Add(new object 1,趙九, 1,中大街1號,看書,逛街,游戲,-29.548,2011-8-9 20:52:55 ); /格式增加dt.Columns.Add(數(shù)據(jù),typeof(decimal);dt.Columns.Add(時間,typeof(DateTime);dt.Columns.Add(自定義,typeof(string);dt.Rows.Add(new object 1, 張三, 1,東大街6號,看書,-52.874,2011-8-5 17:52:55,# );dt.Rows.Add(new object 1, 王五, 0,西大街2號,上網(wǎng),游戲, -37.257,2011-8-5 17:52:55 );dt.Rows.Add(new object 1, 李四, 1,南大街3號,上網(wǎng),逛街, -54.254,2011-8-9 17:52:55 );dt.Rows.Add(new object 1, 錢八, 0,北大街5號,上網(wǎng),逛街,看書,游戲,-35.127,2011-8-9 17:52:55 );dt.Rows.Add(new object 1,趙九, 1,中大街1號,看書,逛街,游戲,-29.548,2011-8-9 20:52:55 );給gridControl1增加3列，對應(yīng)上述三列。數(shù)據(jù)：具體數(shù)據(jù)公式可以查看輸入控件的MASK設(shè)置器，里面有全部的格式公式：運行結(jié)果：時間：自定義：事件轉(zhuǎn)換：概念明確：1. gridControl1的每一列原始數(shù)據(jù)是Value，但是顯示數(shù)據(jù)是 DisplayText，默認DisplayText的值即是Value通過DisplayFormat轉(zhuǎn)換之后的值。2. gridControl下的事件一般是包含表格GridView切換，點擊，更改的事件，用的不多；每一個GridView下的事件包含行列處理，菜單顯示，分組排序等事件，我們常用。（所有在使用事件時，一定要明確是control事件還是view事件）GridView存在事件：自定義列顯示事件增加事件：csharp view plaincopyprint?1. private voidgridView1_CustomColumnDisplayText(objectsender, DevExpress.XtraGrid.Views.Base.CustomColumnDisplayTextEventArgse) 2. 3. if(e.Column.FieldName =sex) 4. 5. switch(e.Value.ToString().Trim() 6. 7. case1: 8. e.DisplayText = 男; 9. break; 10. case0: 11. e.DisplayText = 女; 12. break; 13. default: 14. e.DisplayText = ; 15. break; 16. 17. 18. private voidgridView1_CustomColumnDisplayText(objectsender, DevExpress.XtraGrid.Views.Base.CustomColumnDisplayTextEventArgse) if(e.Column.FieldName =sex) switch(e.Value.ToString().Trim() case1: e.DisplayText = 男; break; case0: e.DisplayText = 女; break; default: e.DisplayText = ; break; 顯示結(jié)果：GridControl詳解（四）分組排序匯總 分組：按時間分第一組：按性別分第二組：顯示結(jié)果：高級設(shè)置：將所有組展開代碼：gridView1.ExpandAllGroups();顯示結(jié)果：自定義組名，GridView級事件 增加事件：csharp view plaincopyprint?1. private void gridView1_CustomDrawGroupRow(object sender, DevExpress.XtraGrid.Views.Base.RowObjectCustomDrawEventArgs e) 2. 3. GridGroupRowInfo GridGroupRowInfo = e.Info as GridGroupRowInfo; 4. GridGroupRowInfo.GroupText = 第 + (e.RowHandle).ToString() + 行 + GridGroupRowInfo.EditValue.ToString(); 5. private void gridView1_CustomDrawGroupRow(object sender, DevExpress.XtraGrid.Views.Base.RowObjectCustomDrawEventArgs e) GridGroupRowInfo GridGroupRowInfo = e.Info as GridGroupRowInfo; GridGroupRowInfo.GroupText = 第 + (e.RowHandle).ToString() + 行 + GridGroupRowInfo.EditValue.ToString();顯示結(jié)果：注意：每一行都有一個RowHandle屬性，普通行的RowHandle為非負整數(shù)，從0開始；組行排序：排序設(shè)置顯示結(jié)果：匯總：匯總數(shù)據(jù)列設(shè)置注意：匯總結(jié)果是顯示在Footer面板中的，gridControl中的Footer面板默認是不顯示的，所以如果要匯總數(shù)據(jù)，那么必須先設(shè)置Footer面板顯示。顯示結(jié)果： 組計：代碼：csharp view plaincopyprint?1. gridView1.GroupSummary.Add(DevExpress.Data.SummaryItemType.Sum, 數(shù)據(jù), gridColumn7, 組計:0); gridView1.GroupSummary.Add(DevExpress.Data.SummaryItemType.Sum, 數(shù)據(jù), gridColumn7, 組計:0);結(jié)果顯示GridControl詳解（五）設(shè)置行備注和行號 備注顯示設(shè)置設(shè)置備注字段顯示結(jié)果：可以寫入按鍵事件F3，用以開關(guān)備注顯示csharp view plaincopyprint?1. private void Form4_KeyUp(object sender, KeyEventArgs e) 2. 3. if (e.KeyCode = Keys.F3) 4. 5. gridView1.OptionsView.ShowPreview = !gridView1.OptionsView.ShowPreview; 6. 7. private void Form4_KeyUp(object sender, KeyEventArgs e) if (e.KeyCode = Keys.F3) gridView1.OptionsView.ShowPreview = !gridView1.OptionsView.ShowPreview; 行號顯示要用到的事件：代碼：csharp view plaincopyprint?1. private void gridView1_CustomDrawRowIndicator(object sender, DevExpress.XtraGrid.Views.Grid.RowIndicatorCustomDrawEventArgs e) 2. 3. if (e.Info.IsRowIndicator) 4. 5. e.Info.DisplayText = Row + e.RowHandle.ToString(); 6. 7. 8. gridView1.IndicatorWidth = 70; private void gridView1_CustomDrawRowIndicator(object sender, DevExpress.XtraGrid.Views.Grid.RowIndicatorCustomDrawEventArgs e) if (e.Info.IsRowIndicator) e.Info.DisplayText = Row + e.RowHandle.ToString(); gridView1.IndicatorWidth = 70;顯示結(jié)果GridControl詳解（六）樣式設(shè)置 表格樣式：全局設(shè)置例子：例子：列樣式：只作用于當前的列通用樣式：外觀設(shè)定注意：樣式設(shè)定都是相同的，Appearance前綴。GridControl詳解（七）事件 csharp view plaincopyprint?1. private void gridView1_RowCellClick(object sender, DevExpress.XtraGrid.Views.Grid.RowCellClickEventArgs e) 2. 3. if (e.Button = MouseButtons.Left) 4. 5. /鼠標的那個按鈕按下 6. 7. if (e.Clicks = 2) 8. 9. /鼠標點擊次數(shù) 10. 11. if (e.Delta 0) 12. 13. /鼠標滾輪滾動方向 14. 15. if (e.X 0 & e.Y 0) 16. 17. /鼠標的坐標 18. 19. if (e.RowHandle 0) 20. 21. /點擊的行號 22. 23. if (e.CellValue != null) 24. 25. /點擊的單元格中的值 26. 27. if (e.Column != null) 28. 29. /點擊的單元格所屬列信息 30. 31. 32.33. private void gridView1_RowClick(object sender, DevExpress.XtraGrid.Views.Grid.RowClickEventArgs e) 34. 35. if (e.Button = MouseButtons.Left) 36. 37. /鼠標的那個按鈕按下 38. 39. if (e.Clicks = 2) 40. 41. /鼠標點擊次數(shù) 42. 43. if (e.Delta 0) 44. 45. /鼠標滾輪滾動方向 46. 47. if (e.X 0 & e.Y 0) 48. 49. /鼠標的坐標 50. 51. if (e.RowHandle 0) 52. 53. /點擊的行號 54. 55. private void gridView1_RowCellClick(object sender, DevExpress.XtraGrid.Views.Grid.RowCellClickEventArgs e) if (e.Button = MouseButtons.Left) /鼠標的那個按鈕按下 if (e.Clicks = 2) /鼠標點擊次數(shù) if (e.Delta 0) /鼠標滾輪滾動方向 if (e.X 0 & e.Y 0) /鼠標的坐標 if (e.RowHandle 0) /點擊的行號 if (e.CellValue != null) /點擊的單元格中的值 if (e.Column != null) /點擊的單元格所屬列信息 private void gridView1_RowClick(object sender, DevExpress.XtraGrid.Views.Grid.RowClickEventArgs e) if (e.Button = MouseButtons.Left) /鼠標的那個按鈕按下 if (e.Clicks = 2) /鼠標點擊次數(shù) if (e.Delta 0) /鼠標滾輪滾動方向 if (e.X 0 & e.Y 0) /鼠標的坐標 if (e.RowHandle 0) /點擊的行號 重新繪制列樣式事件：gridView1_CustomDrawCell代碼：csharp view plaincopyprint?1. private void gridView1_CustomDrawCell(object sender, DevExpress.XtraGrid.Views.Base.RowCellCustomDrawEventArgs e) 2. 3. if (e.Column.FieldName = 數(shù)據(jù)) 4. 5. GridCellInfo GridCellInfo = e.Cell as GridCellInfo; 6. if (GridCellInfo.IsDataCell & double.Parse(GridCellInfo.CellValue.ToString() -30 9. & double.Parse(GridCellInfo.CellValue.ToString() -50) 12. e.Appearance.BackColor = Color.Red; 13. 14. private void gridView1_CustomDrawCell(object sender, DevExpress.XtraGrid.Views.Base.RowCellCustomDrawEventArgs e) if (e.Column.FieldName = 數(shù)據(jù)) GridCellInfo GridCellInfo = e.Cell as GridCellInfo; if (GridCellInfo.IsDataCell & double.Parse(GridCellInfo.CellValue.ToString() -30 & double.Parse(GridCellInfo.CellValue.ToString() -50) e.Appearance.BackColor = Color.Red; 重新計算備注事件：gridView1_CalcPreviewText代碼：csharp view plaincopyprint?1. private void gridView1_CalcPreviewText(object sender, DevExpress.XtraGrid.Views.Grid.CalcPreviewTextEventArgs e) 2. 3. DataRow dr = gridView1.GetDataRow(e.RowHandle); 4. e.PreviewText = drname.ToString() + : + draihao.ToString(); 5. private void gridView1_CalcPreviewText(object sender, DevExpress.XtraGrid.Views.Grid.CalcPreviewTextEventArgs e) DataRow dr = gridView1.GetDataRow(e.RowHandle); e.PreviewText = drname.ToString() + : + draihao.ToString();注意：GridView中大多數(shù)事件我們都會并且必須用到e這個參數(shù)，我們可以從e這個參數(shù)中獲取很多信息，包括單元格、列、行、表格、GridControl的信息。我們要根據(jù)事件的意義來了解這個e是單元格級別的，或是行級別的，或是列級別的等，因為我們可以獲取e的層級以上的信息，層級以下的信息就不能獲取了。e中的屬性都是大同小異，其中最常用的是e.RowHandle這個屬性，它代表行號的意思，通過gridView1.GetDataRow(e.RowHandle)方法可以獲得這一行的數(shù)據(jù)行DataRow；并以此來做很多操作。上述我們也說過組行的RowHandle為負數(shù)，我們通過GetDataRow獲取數(shù)據(jù)行是錯誤的，這時我們通過gridView1.GetDataRowHandleByGroupRowHandle(e.RowHandle);方法來轉(zhuǎn)化，這時得到的數(shù)據(jù)行是該組的第一行數(shù)據(jù)。在此我們需特別注意。如果加入上述轉(zhuǎn)換，我們選擇數(shù)據(jù)時每組第一行數(shù)據(jù)就會重復(fù)，我們要做去重復(fù)處理。皮膚設(shè)置GridControl詳解（八）菜單 菜單控件拖入窗口中顯示如下設(shè)置popupMenu設(shè)置barManager設(shè)置controller增加菜單項彈出配置窗口一般菜單項設(shè)置對應(yīng)屬性如下：對應(yīng)事件：選擇菜單項設(shè)置事件同上，是否可見同上。子菜單項設(shè)置是否可見同上，很少去寫他的點擊事件，一般都寫的是他的子菜單中點擊事件。編輯菜單項設(shè)置菜單分組設(shè)置GridControl詳解（九）表格中的控件選擇完成控件后，可用+號點開ColumnEdit列，改控件的類型是RepositoryItem類型的，其相應(yīng)的屬性和相應(yīng)的控件屬性是類似的構(gòu)建數(shù)據(jù)如下:csharp view plaincopyprint?1. DataTable dt = new DataTable(); 2. dt.Columns.Add(名稱); 3. dt.Columns.Add(范圍); 4. dt.Columns.Add(小區(qū)總數(shù)); 5. dt.Columns.Add(類型); 6. dt.Columns.Add(子類型); 7. dt.Columns.Add(子片區(qū)數(shù)量); 8. dt.Columns.Add(責任人); 9. dt.Columns.Add(編號); 10. dt.Columns.Add(選擇); 11.12. dt.Rows.Add(new object 片區(qū)1, 范圍, 5, 線, 普通公路, 5, qiangfei, 1, 0 ); 13. dt.Rows.Add(new object 片區(qū)2, 范圍, 5, 線, 普通公路, 5, qiangfei, 2, 0 ); 14. dt.Rows.Add(new object 片區(qū)3, 范圍, 5, 線, 普通公路, 5, qiangfei, 3, 1 ); 15. dt.Rows.Add(new object 片區(qū)4, 范圍, 5, 線, 普通公路, 5, qiangfei, 4, 1 ); 16. dt.Rows.Add(new object 片區(qū)5, 范圍, 5, 線, 普通公路, 5, qiangfei, 5, 0 ); 17. dt.Rows.Add(new object 片區(qū)6, 范圍, 5, 線, 普通公路, 5, qiangfei, 6, 1 ); 18. dt.Rows.Add(new object 片區(qū)7, 范圍, 5, 線, 普通公路, 5, qiangfei, 7, 1 ); 19. dt.Rows.Add(new object 片區(qū)8, 范圍, 5, 線, 普通公路, 5, qiangfei, 8, 0 ); 20. dt.Rows.Add(new object 片區(qū)9, 范圍, 5, 線, 普通公路, 5, qiangfei, 9, 0 ); 21. dt.Rows.Add(new object 片區(qū)10, 范圍, 5, 線, 普通公路, 5, qiangfei, 10, 1 ); 22. dt.Rows.Add(new object 片區(qū)11, 范圍, 5, 線, 普通公路, 5, qiangfei, 11, 1 ); 23. dt.Rows.Add(new object 片區(qū)12, 范圍, 5, 線, 普通公路, 5, qiangfei, 12, 0 ); 24.25. gridControl1.DataSource = dt; DataTable dt = new DataTable(); dt.Columns.Add(名稱); dt.Columns.Add(范圍); dt.Columns.Add(小區(qū)總數(shù)); dt.Columns.Add(類型); dt.Columns.Add(子類型); dt.Columns.Add(子片區(qū)數(shù)量); dt.Columns.Add(責任人); dt.Columns.Add(編號); dt.Columns.Add(選擇); dt.Rows.Add(new object 片區(qū)1, 范圍, 5, 線, 普通公路, 5, qiangfei, 1, 0 ); dt.Rows.Add(new object 片區(qū)2, 范圍, 5, 線, 普通公路, 5, qiangfei, 2, 0 ); dt.Rows.Add(new object 片區(qū)3, 范圍, 5, 線, 普通公路, 5, qiangfei, 3, 1 ); dt.Rows.Add(new object 片區(qū)4, 范圍, 5, 線, 普通公路, 5, qiangfei, 4, 1 ); dt.Rows.Add(new object 片區(qū)5, 范圍, 5, 線, 普通公路, 5, qiangfei, 5, 0 ); dt.Rows.Add(new object 片區(qū)6, 范圍, 5, 線, 普通公路, 5, qiangfei, 6, 1 ); dt.Rows.Add(new object 片區(qū)7, 范圍, 5, 線, 普通公路, 5, qiangfei, 7, 1 ); dt.Rows.Add(new object 片區(qū)8, 范圍, 5, 線, 普通公路, 5, qiangfei, 8, 0 ); dt.Rows.Add(new object 片區(qū)9, 范圍, 5, 線, 普通公路, 5, qiangfei, 9, 0 ); dt.Rows.Add(new object 片區(qū)10, 范圍, 5, 線, 普通公路, 5, qiangfei, 10, 1 ); dt.Rows.Add(new object 片區(qū)11, 范圍, 5, 線, 普通公路, 5, qiangfei, 11, 1 ); dt.Rows.Add(new object 片區(qū)12, 范圍, 5, 線, 普通公路, 5, qiangfei, 12, 0 ); gridControl1.DataSource = dt;注意：我們表格中【選擇】一列的值是字符串型，那么表格中設(shè)置的類型也必須是字符串型。類型必須統(tǒng)一。 結(jié)果呈現(xiàn)：必要設(shè)置：【編輯】屬性我們?nèi)绻砑恿诉x擇框列，肯定要對選擇列可用進行點擊選中的操作，所以我們必須先打開表格的可編輯狀態(tài)。但是這樣每一列都可以編輯，所以要關(guān)閉其他列的可編輯狀態(tài)。這樣我們就可以操作選擇列，而其他列不可編輯。由此我們可以看出gridview上的Editable屬性控制大于列的AllowEdit屬性。進階：當我們點擊某一行的選擇列checkbox控件是，其綁定的值也會發(fā)生變化，聯(lián)動其datatable中的值也會發(fā)生變化，即選中時，datatable對應(yīng)的值會變成1；未選中時，其值為0。那么我們可以通過如下代碼獲取選中的所有信息;DataRow drs = dt.Select(選擇=1);GridControl詳解（十）BandedGridView 轉(zhuǎn)換結(jié)果：運行結(jié)果呈現(xiàn)：GridControl詳解（附）表格屬性一覽 Options OptionsBehavior 視圖的行為選項AllowIncrementalSearch 允許用戶通過輸入想得到的列值來定位行AllowPartialRedrawOnScrolling 允許視圖在垂直滾動中局部刷新AutoExpandAllGroups 自動展開視圖中的所有組AutoPopulateColumns 當視圖中沒有某些數(shù)據(jù)源中的字段時，在視圖中自動創(chuàng)建這些列AutoSelectAllInEditor 在一個單元格編輯中，是否允許通過Enter或F2來選擇該單元格的所有內(nèi)容AutoUpdateTotalSummary 當列值發(fā)生改變時，自動更新匯總摘要數(shù)據(jù)CacheValuesOnRowUpdating 緩沖將被存入數(shù)據(jù)源的數(shù)據(jù)(當一行數(shù)據(jù)要存入到數(shù)據(jù)源時，Grid可以將它的值存入到一個內(nèi)部的緩沖器中。這樣，萬一那行數(shù)據(jù)在存入時被數(shù)據(jù)源的檢查機制清空了，還可以恢復(fù))Editable 允許對單元格進行編輯EditorShowMode 設(shè)置鼠標激活單元格編輯器的模式FocusLeaveOnTab 如果在Grid中TAB鍵被禁止，是否在按下TAB鍵時將焦點移到下一個控件ImmediateUpdateRowPosition 因為排序、分組和過濾設(shè)置造成行的數(shù)據(jù)被修改時，是否立即更新一行的位置KeepFocusedRowOnUpdate 當后臺的數(shù)據(jù)記錄變化時，保持焦點行的焦點KeepGroupExpandedOnSorting 當數(shù)據(jù)進行排序時,保持行的擴展狀態(tài)SmartVertScrollBar 設(shè)置是否能滾動視圖到第一行和最后一行OptionsCustomization 訪問視圖的用戶化操作AllowChangeBandParent 允許用戶能夠移動帶子在父母中?AllowChangeColumnParent 允許用戶能夠在帶子中移動列AllowColumnMoving 允許用戶通過拖動列頭來移動列AllowColumnResizing 允許用戶修改列寬