(Extjs)對於GridPanel的各種操作

標籤：

剛才做了個有點特殊的需求，在某視窗關閉時，要把Gridpanel中的選擇行清空，因為如果不清空，直接雙擊，就不能即時更新出來我想要的內容。

答案是：Grid.getSelectionModel().clearSelections();

 

順便，把Gridpanel的多種操作總結一下，它的協助文檔不給力啊。

 

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： 
groupable：


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 )：取得列索引 
getTotalWidth( Boolean includeHidden ) 
isCellEditable( Number colIndex, Number rowIndex ) 
isFixed() 
isHidden( Number colIndex ) 
setColumnHeader( Number col, String header ) 
setColumnWidth( Number col, Number width, Boolean suppressEvent ) 
setDataIndex( Number col, String dataIndex ) 
setEditable( Number col, Boolean editable ) 
setEditor( Number col, Object editor ) 
setHidden( Number colIndex, Boolean hidden ) 
setRenderer( Number col, Function fn )


4、Ext.grid.AbstractSelectionModel 
主要方法： 
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.RowSelectionModel 
主要配置項： 
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] )：選擇範圍內的所有行 
selectRecords( Array records, [Boolean keepExisting] )：選擇一組指定記錄 
selectRow( Number row, [Boolean keepExisting], [Boolean preventViewNotify] )：選擇一行 
row：行索引 
selectRows( Array rows, [Boolean 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(); 

(Extjs)對於GridPanel的各種操作