【功能說明】
用途：使用於Client端，繼承自DataGridView元件，用以多列與多行方式顯示資料，並可進行編輯。
【元件屬性】
Name(名稱)(string)
元件名稱，用於識別該元件。
Columns(欄位明細)(collection)
設定要顯示的欄位明細。每個欄位有以下屬性：
Name(名稱)(string)：該列的名稱，用於識別該列。
DataProperyName(欄位名稱)(string)：設定該列要顯示的欄位名稱。
DefaultCellStyle(顯示格式設定)(enum)：此欄位專屬的格式，可設定顯示顏色、字體、對齊方式以及資料顯示的格式(如日期格式與數值格調等)。
HeaderText(抬頭)(string)：設定每個欄位的表頭標題。
Visible(顯示)(bool)：設定該欄位是否可以看見，為False代表隱藏。
ReadOnly(唯讀)(bool)：設定此欄位是否可以編輯，為False代表不能編輯。
Resizable(調整大小)(bool)：設定此欄位是否可以調整大小。
SortMode(排序模式)(enum) ：設定此欄位的排序模式，有NotSortable (沒有排序功能)，Automatic(自動)，Programmatic (程式控制) 。
Frozen(凍結)(bool)：設定此欄位是否有凍結在畫面上，如為True時，左邊的所有欄位(包含自己)將會自動凍結，只能捲定右邊的欄位。
Width(顯示寬度)(int32)：欄位的顯示寬度。
AutoSizeMode(自動寬度模式)(enum)：設定此欄位寬度的模式，請參考下文中的AutoSizeColumnMode屬性。
ToolTipText (提示訊息)(string)：當焦點停在本欄位所提示的頂
層訊息。
ContextMenuStrip(背景功能表)(MenuStrip)：此欄位可配合設定一個MemuScrip功能表。
ColumnType(欄位類別)(enum)：該列的欄位類別，ColumnType共有以下幾種，其中Info開頭為EEP的元件，其他為C＃內定的元件類別。
1． InfoDataGridViewCalendarColumn(日期列)：要顯示
為日期格式，可用下拉方式點出日曆以方便User選擇。其配合的欄位可以為日期類型，也可以為字串VARCHAR(8)類型，存放格式為YYYYMMDD。
2． InfoDataGridViewRefValColumn(關連選單列)：可
以配合使用InfoRefVal元件，在做資料編輯時，可透過下拉方式點出關聯Table內的相關資料，以方便User選擇。
3． InfoDataGridViewExpressionColumn(運算式列)：用
來以運算式的方式來顯示資料，例如，可以利用”Quantity*Price”這種方式來表示此欄位是由Quantity與Price欄位相乘的結果。
4． InfoDataGridViewComboBoxColumn(資料下拉
列)：與上述的關連選單列(RefVal)相似，配合InfoComboBox元件，在資料編輯時可以讓User下拉方式點出ComboBox的資料。不同的是，RefVal列是點出一個關聯資料的表單，此視窗是可以移動位置的，而ComboBox列則會固定是在該欄位下方顯示出ComboBox。
5． DataGridViewTextBoxColumn(資料列)：這是最常
用的欄位類型，如沒有特殊要求，一般都使用此類別。
6． DataGridViewLinkColumn(鏈接列)：可以使顯示的
內容顯示為鏈接狀態(HyperLink)，用此來連結其他的網頁或表單資料，連結時可配合CellClick事件。
7． DataGridViewImageColumn(圖示列)：可以用來顯
示圖型的欄位。
8． DataGridViewComboBoxColumn(下拉列)：此類型
的執行效果與InfoDataGridViewComboBoxColumn一致，因為InfoDataGirdViewComboBoxColumn是繼承自本類型加強而成的，多了可在下拉時顯示兩個欄位，並且傳回可以傳回名稱的欄位，而不是傳回邊號的欄位。
9． DataGridViewCheckBoxColumn(勾選列)：此類可以
顯示為勾選狀態，使用CheckBox元件來表示。
10． DataGridViewButtonColumn(按鈕列)：此類可
將Button按鈕來顯示在Grid中，用來讓User更易操作Grid的功能。
11． DataGridViewIndentityColumn(自動序號)：可以自動列出
DataGridView的Position次序，為一個Integer，可不必再使用欄位來顯示。
12． InfoDataTimeBoxColumn ( 日期列 ) ：此日期列與InfoDataTimeViewCanlendarColumn 的差別是，此欄位元類型在顯示時會有日期格式的下劃線提示。
RefValue(關聯的InfoRefVal)(string)：當ColumnType為RefValColumn和ComboBoxColumn時就可以使用本屬性，用來設定與其對應的InfoRefVal或InfoComboBox。
Expression(運算式)(string)：當ColumnType為ExpressionColumn時就可以使用本屬性，用來設定要顯示內容的運算式，可以直接用欄位名稱來設定。例如：Quantity*Price，用來顯示小計金額。
FlatStyle(外觀型態)(enum)：當ColumnType為ButtonColumn與CheckBoxColumn時所使用的屬性，可設定為Flat(平面)，Popup(自動開啟其他object)，Standard(立體形狀)，System(依Windows的預設形狀)。
Text(抬頭文字)(string)：當ColumnType為ButtonColumn或LinkColumn時所使用的屬性，可設定Button/LinkLabel的抬頭文字。如果為LinkColumn時須配合將UseColumnTextForLinkValue設為True才會有效，否則都會顯示欄位內容值。
TrueState(邏輯型態)(bool)： 當ColumnType為 CheckBoxColumn時，是否允許有三種狀態的CheckBox，為True時代表有三種狀態，須配合TrueValue(勾選值)與FalseValue(無勾選值)與IndeterminateValue(模糊值)等設定；為False時只須用到TrueValue與FalseValue等設定值。
DisplayStyle(顯示樣式)(enum) ：當ColumnType為 ComboBox或InfoComboBox時使用，可設定ComboBox，DroplDownButton，Nothing等樣式。另外由DisplayStyleForCurrentCell=True/False來控制是否僅目前Cell顯示此ComboBox。
DataSource(資料源)(DataSource)：當ColumnType為 ComboBox或InfoComboBox時使用，可選擇ComBoBox的資料來源，一般是對應到InfoBindnig。配合此屬性還要設定DisplayMember(顯示欄位名稱)與ValueMember(內容值欄位名稱)。
Items(資料內容)(string[])：當ColumnType為 ComboBox或InfoComboBox時使用，因不選擇使用資料表來源時，可在此直接設定ComboBox的項目內容。
ImageLayout(圖型排列)(enum) ：當ColumnType為 ImageColumn時使用，可設定為NotSet(無定義)，Normal(正常原圖大小)，Stretch(自動依比例放大)，Zoom(自動依Cell大小縮放，不按比率)。另有一個Image屬性可定義預設的圖樣，因為可能此欄位沒有圖型內容。
LinkColor(連結顏色)(Color) ：當ColumnType為 LinkColumn時使用，代表連結的文字顏色。另外ActvieLinkColor則代表Mouse移到此所顯示的回應顏色，VisitedLinkColor則代表已訪問過之後之鏈結文字的顏色(需配合TraceVisitedState=True才會有效)。
DataMember(資料成員)(string)
對應的資料表名稱，此可以不必設定，因為在EEP系統中皆統一以DataSource去對應到InfoBindingSource這個對象。
DataSource(資料源)(DataSource)
對應的資料集，在此直接對應到InfoBindingSource即可，讓InfoBindingSource與本元件產生互動行為。
DeleteHotKey(刪除熱鍵)(string)
用來設定刪除的熱鍵，系統刪除目前筆資料的方法是點在Row Header上，再按「Del」鍵即可刪除。
EnterEnable(Enter鍵致能)(bool)
控制Grid可以使用Enter鍵進入編輯Cell的狀態，並且可用Enter鍵進入下一個欄位。
SureDelete(確認刪除)(bool)
設定在刪除資料前是否提示確認，如果設為True，則刪除資料時會提示User是否確定刪除。
TotalActive(加總啟用)(bool)
是否要在Grid中顯示欄位小計的內容。此時會在Grid的下方多一個Row來顯示加總。
TotalBackColor(加總背景顏色)(color)
加總列的背景顏色。
TotalCaption(加總抬頭)(string)
加總的抬頭顯示，會顯示在Row的表頭上，所以不宜輸入太多的文字內容。
TotalCaptionFont(加總抬頭字型)(font)
TotalCaption的字型。
TotalColumns(加總欄位明細)(collection)
設定那些欄位要有加總功能，每個Colleciton定義如下：
ColumnName(名稱)(string)：要小計的欄位名稱。
ShowTotal(是否顯示加總值)(bool)：設定該加總值是否要顯示出來。
TotalAlignment(對齊方式)(enum)：加總值的對齊方式，有Left，Right，Center。
TotalMode(加總方式)(enum)：設定每個欄位的加總方式，有None(無)，Sum(加總)，Count(計次)，Max(最大值)，Min(最小值)，Average(平均)。
TotalFont(加總字型)(font)
加總數值的字型。
AllowUserToAddRows(允許新增)(bool)
設定Grid是否可以新增資料。
AllowUserToDeleteRows(允許刪除)(bool)
設定Grid是否可以刪除資料。
AllowUserToOrderColumns(允許移動欄位)(bool)
設定Grid是否可以用Mosue拖拉欄位表頭來達到更換欄位次序的目的。
AllowUserToResizeColumns(允許調整欄寬)(bool)
設定Grid是否可以用Mosue來調整欄位寬度。(用Mouse在欄位表頭間的中間線來調整)。
AllowUserToResizeRows(允許調整列高)(bool)
設定Grid是否可以用Mosue來調整任一列高度。(用Mouse在列表頭間的中間線來調整)。
DefaultCellStyle(顯示格式設定)(CellStyle)
所有欄位的預設格式，可設定顯示顏色、字型、對齊方式等等。
AlternatingRowsDefaultCellStyle(列間格格式設定)(CellStyle)
可以設定間格的資料列預設格式，與DefaultCellStyle一起搭配，控制奇數列與偶數列不同顏色與字型。
AutoSizeColumnsMode(自動欄位寬度)(enum)
可以設定自動處理欄位寬度大小，可設定AllCells(依所有所以欄位的內容決定大小，包含表頭)，AllCellsExceptHeader(依所有欄位的內容決定大小，表頭除外) ，DisplayedCellsExceptHeader(依畫面上所有欄位的內容決定大小，表頭除外)，DisplayedCells(依畫面上所有欄位的內容決定大小，包含表頭),Fill (根據所有欄位與Grid寬度情況自動決定)。
AutoSizeRowsMode(自動列高度)(enum)
可以設定自動處理列高度大小，可設定AllCells(依所有所以欄位的內容決定高度，包含表頭)，AllCellsExceptHeader(依所有欄位的內容決定高度，表頭除外) ，DisplayedCellsExceptHeader(依畫面上所有欄位的內容決定高度，表頭除外)，DisplayedCells(依畫面上所有欄位的內容決定高度，包含表頭),Fill (根據所有欄位與Grid高度情況自動決定)，AllHeader(依表頭的內容做為每Row的高度)。
BackGroundColor(背景顏色)(Color)
沒有資料區域之背景顏色。
BorderStyle(邊框型態)(enum)
Grid的邊框型態，可設定None(無框)，FixedSingle(單框)，Fiexed3D(立體框)。
CellBorderStyle(欄位格邊框型態)(enum)
Grid內每個Cell的邊框型態，可設定None(無框)，Custom(自定)，Raised(浮起)，RaisedHorizontal(橫浮起線)，RaiseVertical(直符起線)，Single(單框)，SingleHorizontal(橫單線)，SingleVertical(直單線)，SunKen (沉下)，SunKenHorizontal(橫沉下線)，SunVertical(直沉下線)。
Dock(對齊方式)(enum)
Grid的對齊方式，可設定None(無)，Top(靠上)，Bottom(靠下)，Right(靠右)，Left(靠左)，Fill(佔滿)。
EditMode(編輯啟動方式)(enum)
用來設定Grid的編輯啟動方式，可設定為EditOnEnter(以Enter鍵啟動)，EditOnF2(以F2鍵啟動)，EditOnKeystroke(任一個鍵)，EditOnKeystrokeOrF2(任一個鍵與F2)，EditProgrammatically(以程式控制)。
Enabled(致能)(bool)
是否可以致能。
MultiSelect(多筆複選)(bool)
是否可以多筆複選。
ReadOnly(唯讀)(bool)
是否為唯讀的情況，不能新增更改刪除。
Visible(顯示)(bool)
是否要顯示。
【事件】
請參閱 VS有關 DataGridView元件Event。
【功能函數】
請參閱 VS有關 DataGridView元件Method。
【 範例】
DataGridView 中取出被選取資料內容值
infoDataGridView.SelectedRows 就是當前選中的 Row 。
用 infoDataGridView . SelectedRows[index].Cells[index].Value 來 取 目前資料的 內容 值。
Detail 不是主鍵的欄位， 在 GridView 中 做到可以新增卻不能更改
可以在 Detail 的GridView 設定 CellBeginEdit 事件 ，如下 :
private voidinfoDataGridView1_CellBeginEdit( objectsender, DataGridViewCellCancelEventArgs e)
{
if (e.RowIndex != infoDataGridView1.NewRowIndex) // 更改而不是新增
{
if(e.ColumnIndex == 不希望修改的欄位在的列號 )
{
e.Cancel = true; // 拒絕修改
}
}
}
從 GridView 取值如下 :
String custid= (( DataGridViewRow) infoDataGridView1. CurrentRow ).Cells [" custidDataGridViewTextBoxColumn"]. Value.ToString ();
在某一個 DataGridViewTextBoxColumn 中改變顯示内容，可 在DataGridView 的 CellValueChanged 事件中，如下：
if (infoNavigator1.CurrentState == "Editing" ||infoNavigator1.CurrentState == "Inserting")
{
if ( e.ColumnIndex== 需要修改的 欄位的列 數 )
{
if( InfoDataGridView[ e.ColumnIndex,
e.RowIndex]. Value.ToString().Length < 4)
InfoDataGridView [ e.ColumnIndex, e.RowIndex].Value = "00" + InfoDataGridView[ e.ColumnIndex, e.RowIndex]. Value.ToString();
}
}
| Converted from CHM to HTML with chm2web Pro 2.85 (unicode) |