Extjs4 GridPanel的主要設定參數詳細介紹_extjs

1、Ext.grid.GridPanel
主要設定項：
store：表格的資料集
columns：表格列模式的設定數組，可自動建立ColumnModel列模式
autoExpandColumn：自動充滿表格未用空間的列，參數為列id，id不能為0
stripeRows：表格是否隔行換色，預設為false
cm、colModel：表格的列模式，渲染表格時必須設定此配置項
sm、selModel：表格的選擇模式，預設為Ext.grid.RowSelectionModel
enableHdMenu：是否顯示表頭的上下文選單，預設為true
enableColumnHide：是否允許通過標題中的上下文選單隱藏列，預設為true
loadMask：是否在載入資料時顯示遮罩效果，預設為false
view：表格視圖，預設為Ext.grid.GridView
viewConfig：表格視圖的配置物件
autoExpandMax：自動擴充列的最大寬度，預設為1000
autoExpandMin：自動擴充列的最小寬度，預設為50
columnLines：是否顯示列分割線，預設為false
disableSelection ：是否禁止行選擇，預設為false
enableColumnMove：是否允許拖曳列，預設為true
enableColumnResize：是否允許改變列寬，預設為true
hideHeaders：是否隱藏表頭，預設為false
maxHeight：最大高度
minColumnWidth：最小列寬，預設為25
trackMouseOver：是否高亮顯示滑鼠所在的行，預設為true
主要方法：
getColumnModel()：取得列模式
getSelectionModel()：取得選擇模式
getStore()：取得資料集
getView()：取得視圖物件
reconfigure( Ext.data.Store store, Ext.grid.ColumnModel colModel )：使用新的資料集和列模式重新配置表格元件

2、Ext.grid.Column
主要設定項：
id：列id
header：表頭文字
dataIndex：設定列與資料集中資料記錄的對應關係，值為資料記錄中的欄位名稱。如果沒有設定該項目則使用列索引與資料記錄中欄位的索引進行對應
width：列寬
align：列資料的對齊方式
hidden：是否隱藏列，預設為false
fixed：是否固定列寬，預設為false
menuDisabled：是否停用列的上下文選單，預設為false
resizable：是否允許改變列寬，預設為true
sortable：是否允許排序，預設為true
renderer：設定列的自訂單元格渲染函數
傳入函數的參數有：
value：資料的原始值
metadata：元資料對象，用於設定單元格的樣式和屬性，該物件包含的屬性有：
css：套用到單元格TD元素上的樣式名稱
attr：一個HTML屬性定義字串，例如'style="color:blue"'
record：目前資料記錄物件
rowIndex：單元格的行索引
colIndex：單元格的列索引
store：資料集物件
xtype：列渲染器類型，預設為gridcolumn，其它可選值有booleancolumn、numbercolumn、datecolumn、 templatecolumn等
editable：是否可編輯，預設為true
editor：編輯器
groupName：
emptyGroupText：
>> >
3、Ext.grid.ColumnModel
主要配置項目： columns：字段數組
defaultSortable：是否進行預設排序，預設為false
defaultWidth：預設寬度
主要方法：
findColumnIndex( String col )：根據給定的dataIndex查找列索引
getColumnById( String id )：取得指定id對應的欄位
getColumnCount( Boolean visibleOnly )：取得總列數個編號>getColumnHeader( Number col )：取得列的表頭
getColumnId( Number index )：取得列id
getDataIndex( Number col )：取得列對應的資料欄位名稱
getIndexById( String id )：取得列對應的資料欄位名稱
getIndexById( String id )：取得列對應的資料欄位名稱
getIndexById( String id )：取得欄位索引
getTotalWidth( Boolean includeHidden )
isCellEditable( Number colIndex, Number rowIndex )
isFixed()
isHidden( Number colnterdex ) setDataIndex( Number col, String dataIndex )
setEditable( Number col, Boolean editable )
setEditor( Number col, Object editor , Boolean hidden )
setRenderer( Number col, Function fn )


4、Ext.grid.AbstractSelectionModel

主要方法：
lock()：l 主要方法：
lock()：l

主要方法：
lock()：l

主要方法： lock()：l
主要方法：
lock()：l

主要方法：
lock()：
unlock()：解鎖選擇區域
isLocked()：目前選擇區域是否被鎖定
5、Ext.grid.CellSelectionModel

主要方法：
clearSelections( Boolean preventNotify )：清除選擇區域
getSelectedCell()：取得目前選取的儲存格，傳回一數組，其格式：[rowIndex, colIndex]
hasSelection()：目前是否有選取區域
select( Number rowIndex, Number colIndex, [Boolean preventViewNotify], [Boolean preventFocus], [Ext.data.Record r] )：選擇指定單元格6、Ext.grid. 🎜> 主要配置項： singleSelect：是否單選模式，預設為false，即可以選擇多個資料主要方法： clearSelections( [Boolean fast] )：清除所有選取區域deselectRange( Number startRow, Number endRow )：取消範圍內的行選擇deselectRow( Number row, [Boolean preventViewNotify] )：取消指定行的選擇狀態each( Function fn, [Object scope] )：遍歷所有選擇行，並呼叫指定函數。目前被選行將傳入此函數中
getCount()：得到選取的總行數
getSelected()：得到第一個被選記錄
getSelections()：得到所有被選記錄的陣列
hasNext()：判斷目前被選行之後是否還有記錄可以選擇
hasPrevious()：判斷目前被選行之前是否還有記錄可以選擇
hasSelection()：是否已選擇了資料
isIdSelected( String id )：判斷指定id的記錄是否被選擇
isSelected( Number/Record index )：判斷指定記錄或記錄索引的資料是否被選擇
selectAll()：選擇所有行
selectFirstRow()：選擇第一行
selectLastRow( [Boolean keepExisting] )：選擇最後行
keepExisting：是否保持現有的選擇
selectNext( [Boolean keepExisting] )：選擇目前選擇行的下一行
selectPrevious( [Boolean keepExisting] )：選擇目前選擇行的上一行
selectRange( Number startRow, Number endRow, [Boolean keepExisting] )：選取範圍內的所有行
ArlectRecords( , [Boolean keepExisting] )：選擇一組指定記錄
selectRow( Number row, [Boolean keepExisting], [Boolean preventViewNotify] )：選擇一行
row：行索引
selectRows( Array lean keepExisting] )：選擇多行
rows：行索引數組

7、Ext.grid.CheckboxSelectionModel
主要配置：
singleSelect：是否單選模式，預設為false，即可以選擇多個資料
checkOnly：是否只能透過點擊checkbox列進行選擇，預設為false
sortable：是否允許checkbox列排序，預設為false
width：checkbox列的寬度，預設為20

8、Ext.grid.RowNumberer
主要設定項：
header：行號列表頭顯示的內容
width：列寬，預設為23

9、Ext.grid.GridView
主要配置項目：
enableRowBody：是否包含行體
sortAscText：表格標題選單中升序的文字描述
sortDescText：表格標題選單中降序的文字描述
columnsText：表格標題選單中列對應的文字描述
autoFill：是否自動擴充列以充滿整個表格，預設為false
forceFit：是否強制調整表格列寬以適用表格的整體寬度，防止出現水平捲軸，預設為false
主要方法：
focusCell( Number row, Number col )：將焦點移到指定單元格
focusRow( Number row )：將焦點移動指定行
getCell( Number row, Number col )：取得指定單元格對應的td元素
getHeaderCell( Number index )：取得指定表頭對應的td元素
getRow( Number index )：取得指定行對應的tr元素
getRowClass( Record record, Number index, Object rowParams, Store store )：得到附加到表格行上的樣式名稱
record：目前行的資料記錄對象
index：目前行的索引
rowParams：渲染時傳入到行模板中的配置對象，透過它可以為行體自訂樣式，該物件只在enableRowBody為true時才生效，可能的屬性如下：
body：渲染到行體中的HTML程式碼片段
bodyStyle：套用到行體tr元素style屬性的字串
cols：套用到行體td元素colspan屬性的值，預設為總列數
store：表格資料集
refresh( [Boolean headersToo] )：刷新表格元件
scrollToTop()：捲動表格到頂端

實戰1：
讓gridpanel的捲軸自動捲動到最後一筆記錄(動態插入資料)：
grid.getView().focusRow(vehiclePassInfoGrid.getStore().getCount()-1);

2:清除gridpanel中有行被選取的狀態：
grid.getSelectionModel().clearSelections();