/*!
- * Ext JS Library 3.1.1
- * Copyright(c) 2006-2010 Ext JS, LLC
+ * Ext JS Library 3.2.0
+ * Copyright(c) 2006-2010 Ext JS, Inc.
* licensing@extjs.com
* http://www.extjs.com/license
*/
-/**\r
- * @class Ext.grid.GridPanel\r
- * @extends Ext.Panel\r
- * <p>This class represents the primary interface of a component based grid control to represent data\r
- * in a tabular format of rows and columns. The GridPanel is composed of the following:</p>\r
- * <div class="mdetail-params"><ul>\r
- * <li><b>{@link Ext.data.Store Store}</b> : The Model holding the data records (rows)\r
- * <div class="sub-desc"></div></li>\r
- * <li><b>{@link Ext.grid.ColumnModel Column model}</b> : Column makeup\r
- * <div class="sub-desc"></div></li>\r
- * <li><b>{@link Ext.grid.GridView View}</b> : Encapsulates the user interface \r
- * <div class="sub-desc"></div></li>\r
- * <li><b>{@link Ext.grid.AbstractSelectionModel selection model}</b> : Selection behavior \r
- * <div class="sub-desc"></div></li>\r
- * </ul></div>\r
- * <p>Example usage:</p>\r
- * <pre><code>\r
-var grid = new Ext.grid.GridPanel({\r
- {@link #store}: new {@link Ext.data.Store}({\r
- {@link Ext.data.Store#autoDestroy autoDestroy}: true,\r
- {@link Ext.data.Store#reader reader}: reader,\r
- {@link Ext.data.Store#data data}: xg.dummyData\r
- }),\r
- {@link #colModel}: new {@link Ext.grid.ColumnModel}({\r
- {@link Ext.grid.ColumnModel#defaults defaults}: {\r
- width: 120,\r
- sortable: true\r
- },\r
- {@link Ext.grid.ColumnModel#columns columns}: [\r
- {id: 'company', header: 'Company', width: 200, sortable: true, dataIndex: 'company'},\r
- {header: 'Price', renderer: Ext.util.Format.usMoney, dataIndex: 'price'},\r
- {header: 'Change', dataIndex: 'change'},\r
- {header: '% Change', dataIndex: 'pctChange'},\r
- // instead of specifying renderer: Ext.util.Format.dateRenderer('m/d/Y') use xtype\r
- {\r
- header: 'Last Updated', width: 135, dataIndex: 'lastChange',\r
- xtype: 'datecolumn', format: 'M d, Y'\r
- }\r
- ],\r
- }),\r
- {@link #viewConfig}: {\r
- {@link Ext.grid.GridView#forceFit forceFit}: true,\r
-\r
-// Return CSS class to apply to rows depending upon data values\r
- {@link Ext.grid.GridView#getRowClass getRowClass}: function(record, index) {\r
- var c = record.{@link Ext.data.Record#get get}('change');\r
- if (c < 0) {\r
- return 'price-fall';\r
- } else if (c > 0) {\r
- return 'price-rise';\r
- }\r
- }\r
- },\r
- {@link #sm}: new Ext.grid.RowSelectionModel({singleSelect:true}),\r
- width: 600,\r
- height: 300,\r
- frame: true,\r
- title: 'Framed with Row Selection and Horizontal Scrolling',\r
- iconCls: 'icon-grid'\r
-});\r
- * </code></pre>\r
- * <p><b><u>Notes:</u></b></p>\r
- * <div class="mdetail-params"><ul>\r
- * <li>Although this class inherits many configuration options from base classes, some of them\r
- * (such as autoScroll, autoWidth, layout, items, etc) are not used by this class, and will\r
- * have no effect.</li>\r
- * <li>A grid <b>requires</b> a width in which to scroll its columns, and a height in which to\r
- * scroll its rows. These dimensions can either be set explicitly through the\r
- * <tt>{@link Ext.BoxComponent#height height}</tt> and <tt>{@link Ext.BoxComponent#width width}</tt>\r
- * configuration options or implicitly set by using the grid as a child item of a\r
- * {@link Ext.Container Container} which will have a {@link Ext.Container#layout layout manager}\r
- * provide the sizing of its child items (for example the Container of the Grid may specify\r
- * <tt>{@link Ext.Container#layout layout}:'fit'</tt>).</li>\r
- * <li>To access the data in a Grid, it is necessary to use the data model encapsulated\r
- * by the {@link #store Store}. See the {@link #cellclick} event for more details.</li>\r
- * </ul></div>\r
- * @constructor\r
- * @param {Object} config The config object\r
- * @xtype grid\r
- */\r
-Ext.grid.GridPanel = Ext.extend(Ext.Panel, {\r
- /**\r
- * @cfg {String} autoExpandColumn\r
- * <p>The <tt>{@link Ext.grid.Column#id id}</tt> of a {@link Ext.grid.Column column} in\r
- * this grid that should expand to fill unused space. This value specified here can not\r
- * be <tt>0</tt>.</p>\r
- * <br><p><b>Note</b>: If the Grid's {@link Ext.grid.GridView view} is configured with\r
- * <tt>{@link Ext.grid.GridView#forceFit forceFit}=true</tt> the <tt>autoExpandColumn</tt>\r
- * is ignored. See {@link Ext.grid.Column}.<tt>{@link Ext.grid.Column#width width}</tt>\r
- * for additional details.</p>\r
- * <p>See <tt>{@link #autoExpandMax}</tt> and <tt>{@link #autoExpandMin}</tt> also.</p>\r
- */\r
- autoExpandColumn : false,\r
- /**\r
- * @cfg {Number} autoExpandMax The maximum width the <tt>{@link #autoExpandColumn}</tt>\r
- * can have (if enabled). Defaults to <tt>1000</tt>.\r
- */\r
- autoExpandMax : 1000,\r
- /**\r
- * @cfg {Number} autoExpandMin The minimum width the <tt>{@link #autoExpandColumn}</tt>\r
- * can have (if enabled). Defaults to <tt>50</tt>.\r
- */\r
- autoExpandMin : 50,\r
- /**\r
- * @cfg {Boolean} columnLines <tt>true</tt> to add css for column separation lines.\r
- * Default is <tt>false</tt>.\r
- */\r
- columnLines : false,\r
- /**\r
- * @cfg {Object} cm Shorthand for <tt>{@link #colModel}</tt>.\r
- */\r
- /**\r
- * @cfg {Object} colModel The {@link Ext.grid.ColumnModel} to use when rendering the grid (required).\r
- */\r
- /**\r
- * @cfg {Array} columns An array of {@link Ext.grid.Column columns} to auto create a\r
- * {@link Ext.grid.ColumnModel}. The ColumnModel may be explicitly created via the\r
- * <tt>{@link #colModel}</tt> configuration property.\r
- */\r
- /**\r
- * @cfg {String} ddGroup The DD group this GridPanel belongs to. Defaults to <tt>'GridDD'</tt> if not specified.\r
- */\r
- /**\r
- * @cfg {String} ddText\r
- * Configures the text in the drag proxy. Defaults to:\r
- * <pre><code>\r
- * ddText : '{0} selected row{1}'\r
- * </code></pre>\r
- * <tt>{0}</tt> is replaced with the number of selected rows.\r
- */\r
- ddText : '{0} selected row{1}',\r
- /**\r
- * @cfg {Boolean} deferRowRender <P>Defaults to <tt>true</tt> to enable deferred row rendering.</p>\r
- * <p>This allows the GridPanel to be initially rendered empty, with the expensive update of the row\r
- * structure deferred so that layouts with GridPanels appear more quickly.</p>\r
- */\r
- deferRowRender : true,\r
- /**\r
- * @cfg {Boolean} disableSelection <p><tt>true</tt> to disable selections in the grid. Defaults to <tt>false</tt>.</p>\r
- * <p>Ignored if a {@link #selModel SelectionModel} is specified.</p>\r
- */\r
- /**\r
- * @cfg {Boolean} enableColumnResize <tt>false</tt> to turn off column resizing for the whole grid. Defaults to <tt>true</tt>.\r
- */\r
- /**\r
- * @cfg {Boolean} enableColumnHide\r
- * Defaults to <tt>true</tt> to enable {@link Ext.grid.Column#hidden hiding of columns}\r
- * with the {@link #enableHdMenu header menu}.\r
- */\r
- enableColumnHide : true,\r
- /**\r
- * @cfg {Boolean} enableColumnMove Defaults to <tt>true</tt> to enable drag and drop reorder of columns. <tt>false</tt>\r
- * to turn off column reordering via drag drop.\r
- */\r
- enableColumnMove : true,\r
- /**\r
- * @cfg {Boolean} enableDragDrop <p>Enables dragging of the selected rows of the GridPanel. Defaults to <tt>false</tt>.</p>\r
- * <p>Setting this to <b><tt>true</tt></b> causes this GridPanel's {@link #getView GridView} to\r
- * create an instance of {@link Ext.grid.GridDragZone}. <b>Note</b>: this is available only <b>after</b>\r
- * the Grid has been rendered as the GridView's <tt>{@link Ext.grid.GridView#dragZone dragZone}</tt>\r
- * property.</p>\r
- * <p>A cooperating {@link Ext.dd.DropZone DropZone} must be created who's implementations of\r
- * {@link Ext.dd.DropZone#onNodeEnter onNodeEnter}, {@link Ext.dd.DropZone#onNodeOver onNodeOver},\r
- * {@link Ext.dd.DropZone#onNodeOut onNodeOut} and {@link Ext.dd.DropZone#onNodeDrop onNodeDrop} are able\r
- * to process the {@link Ext.grid.GridDragZone#getDragData data} which is provided.</p>\r
- */\r
- enableDragDrop : false,\r
- /**\r
- * @cfg {Boolean} enableHdMenu Defaults to <tt>true</tt> to enable the drop down button for menu in the headers.\r
- */\r
- enableHdMenu : true,\r
- /**\r
- * @cfg {Boolean} hideHeaders True to hide the grid's header. Defaults to <code>false</code>.\r
- */\r
- /**\r
- * @cfg {Object} loadMask An {@link Ext.LoadMask} config or true to mask the grid while\r
- * loading. Defaults to <code>false</code>.\r
- */\r
- loadMask : false,\r
- /**\r
- * @cfg {Number} maxHeight Sets the maximum height of the grid - ignored if <tt>autoHeight</tt> is not on.\r
- */\r
- /**\r
- * @cfg {Number} minColumnWidth The minimum width a column can be resized to. Defaults to <tt>25</tt>.\r
- */\r
- minColumnWidth : 25,\r
- /**\r
- * @cfg {Object} sm Shorthand for <tt>{@link #selModel}</tt>.\r
- */\r
- /**\r
- * @cfg {Object} selModel Any subclass of {@link Ext.grid.AbstractSelectionModel} that will provide\r
- * the selection model for the grid (defaults to {@link Ext.grid.RowSelectionModel} if not specified).\r
- */\r
- /**\r
- * @cfg {Ext.data.Store} store The {@link Ext.data.Store} the grid should use as its data source (required).\r
- */\r
- /**\r
- * @cfg {Boolean} stripeRows <tt>true</tt> to stripe the rows. Default is <tt>false</tt>.\r
- * <p>This causes the CSS class <tt><b>x-grid3-row-alt</b></tt> to be added to alternate rows of\r
- * the grid. A default CSS rule is provided which sets a background colour, but you can override this\r
- * with a rule which either overrides the <b>background-color</b> style using the '!important'\r
- * modifier, or which uses a CSS selector of higher specificity.</p>\r
- */\r
- stripeRows : false,\r
- /**\r
- * @cfg {Boolean} trackMouseOver True to highlight rows when the mouse is over. Default is <tt>true</tt>\r
- * for GridPanel, but <tt>false</tt> for EditorGridPanel.\r
- */\r
- trackMouseOver : true,\r
- /**\r
- * @cfg {Array} stateEvents\r
- * An array of events that, when fired, should trigger this component to save its state.\r
- * Defaults to:<pre><code>\r
- * stateEvents: ['columnmove', 'columnresize', 'sortchange', 'groupchange']\r
- * </code></pre>\r
- * <p>These can be any types of events supported by this component, including browser or\r
- * custom events (e.g., <tt>['click', 'customerchange']</tt>).</p>\r
- * <p>See {@link Ext.Component#stateful} for an explanation of saving and restoring\r
- * Component state.</p>\r
- */\r
- stateEvents : ['columnmove', 'columnresize', 'sortchange', 'groupchange'],\r
- /**\r
- * @cfg {Object} view The {@link Ext.grid.GridView} used by the grid. This can be set\r
- * before a call to {@link Ext.Component#render render()}.\r
- */\r
- view : null,\r
- \r
- /**\r
- * @cfg {Array} bubbleEvents\r
- * <p>An array of events that, when fired, should be bubbled to any parent container.\r
- * See {@link Ext.util.Observable#enableBubble}. \r
- * Defaults to <tt>[]</tt>.\r
- */\r
- bubbleEvents: [],\r
- \r
- /**\r
- * @cfg {Object} viewConfig A config object that will be applied to the grid's UI view. Any of\r
- * the config options available for {@link Ext.grid.GridView} can be specified here. This option\r
- * is ignored if <tt>{@link #view}</tt> is specified.\r
- */\r
-\r
- // private\r
- rendered : false,\r
- // private\r
- viewReady : false,\r
-\r
- // private\r
- initComponent : function(){\r
- Ext.grid.GridPanel.superclass.initComponent.call(this);\r
-\r
- if(this.columnLines){\r
- this.cls = (this.cls || '') + ' x-grid-with-col-lines';\r
- }\r
- // override any provided value since it isn't valid\r
- // and is causing too many bug reports ;)\r
- this.autoScroll = false;\r
- this.autoWidth = false;\r
-\r
- if(Ext.isArray(this.columns)){\r
- this.colModel = new Ext.grid.ColumnModel(this.columns);\r
- delete this.columns;\r
- }\r
-\r
- // check and correct shorthanded configs\r
- if(this.ds){\r
- this.store = this.ds;\r
- delete this.ds;\r
- }\r
- if(this.cm){\r
- this.colModel = this.cm;\r
- delete this.cm;\r
- }\r
- if(this.sm){\r
- this.selModel = this.sm;\r
- delete this.sm;\r
- }\r
- this.store = Ext.StoreMgr.lookup(this.store);\r
-\r
- this.addEvents(\r
- // raw events\r
- /**\r
- * @event click\r
- * The raw click event for the entire grid.\r
- * @param {Ext.EventObject} e\r
- */\r
- 'click',\r
- /**\r
- * @event dblclick\r
- * The raw dblclick event for the entire grid.\r
- * @param {Ext.EventObject} e\r
- */\r
- 'dblclick',\r
- /**\r
- * @event contextmenu\r
- * The raw contextmenu event for the entire grid.\r
- * @param {Ext.EventObject} e\r
- */\r
- 'contextmenu',\r
- /**\r
- * @event mousedown\r
- * The raw mousedown event for the entire grid.\r
- * @param {Ext.EventObject} e\r
- */\r
- 'mousedown',\r
- /**\r
- * @event mouseup\r
- * The raw mouseup event for the entire grid.\r
- * @param {Ext.EventObject} e\r
- */\r
- 'mouseup',\r
- /**\r
- * @event mouseover\r
- * The raw mouseover event for the entire grid.\r
- * @param {Ext.EventObject} e\r
- */\r
- 'mouseover',\r
- /**\r
- * @event mouseout\r
- * The raw mouseout event for the entire grid.\r
- * @param {Ext.EventObject} e\r
- */\r
- 'mouseout',\r
- /**\r
- * @event keypress\r
- * The raw keypress event for the entire grid.\r
- * @param {Ext.EventObject} e\r
- */\r
- 'keypress',\r
- /**\r
- * @event keydown\r
- * The raw keydown event for the entire grid.\r
- * @param {Ext.EventObject} e\r
- */\r
- 'keydown',\r
-\r
- // custom events\r
- /**\r
- * @event cellmousedown\r
- * Fires before a cell is clicked\r
- * @param {Grid} this\r
- * @param {Number} rowIndex\r
- * @param {Number} columnIndex\r
- * @param {Ext.EventObject} e\r
- */\r
- 'cellmousedown',\r
- /**\r
- * @event rowmousedown\r
- * Fires before a row is clicked\r
- * @param {Grid} this\r
- * @param {Number} rowIndex\r
- * @param {Ext.EventObject} e\r
- */\r
- 'rowmousedown',\r
- /**\r
- * @event headermousedown\r
- * Fires before a header is clicked\r
- * @param {Grid} this\r
- * @param {Number} columnIndex\r
- * @param {Ext.EventObject} e\r
- */\r
- 'headermousedown',\r
- \r
- /**\r
- * @event groupmousedown\r
- * Fires before a group header is clicked. <b>Only applies for grids with a {@link Ext.grid.GroupingView GroupingView}</b>.\r
- * @param {Grid} this\r
- * @param {String} groupField\r
- * @param {String} groupValue\r
- * @param {Ext.EventObject} e\r
- */\r
- 'groupmousedown',\r
- \r
- /**\r
- * @event rowbodymousedown\r
- * Fires before the row body is clicked. <b>Only applies for grids with {@link Ext.grid.GridView#enableRowBody enableRowBody} configured.</b>\r
- * @param {Grid} this\r
- * @param {Number} rowIndex\r
- * @param {Ext.EventObject} e\r
- */\r
- 'rowbodymousedown',\r
- \r
- /**\r
- * @event containermousedown\r
- * Fires before the container is clicked. The container consists of any part of the grid body that is not covered by a row.\r
- * @param {Grid} this\r
- * @param {Ext.EventObject} e\r
- */\r
- 'containermousedown',\r
-\r
- /**\r
- * @event cellclick\r
- * Fires when a cell is clicked.\r
- * The data for the cell is drawn from the {@link Ext.data.Record Record}\r
- * for this row. To access the data in the listener function use the\r
- * following technique:\r
- * <pre><code>\r
-function(grid, rowIndex, columnIndex, e) {\r
- var record = grid.getStore().getAt(rowIndex); // Get the Record\r
- var fieldName = grid.getColumnModel().getDataIndex(columnIndex); // Get field name\r
- var data = record.get(fieldName);\r
-}\r
-</code></pre>\r
- * @param {Grid} this\r
- * @param {Number} rowIndex\r
- * @param {Number} columnIndex\r
- * @param {Ext.EventObject} e\r
- */\r
- 'cellclick',\r
- /**\r
- * @event celldblclick\r
- * Fires when a cell is double clicked\r
- * @param {Grid} this\r
- * @param {Number} rowIndex\r
- * @param {Number} columnIndex\r
- * @param {Ext.EventObject} e\r
- */\r
- 'celldblclick',\r
- /**\r
- * @event rowclick\r
- * Fires when a row is clicked\r
- * @param {Grid} this\r
- * @param {Number} rowIndex\r
- * @param {Ext.EventObject} e\r
- */\r
- 'rowclick',\r
- /**\r
- * @event rowdblclick\r
- * Fires when a row is double clicked\r
- * @param {Grid} this\r
- * @param {Number} rowIndex\r
- * @param {Ext.EventObject} e\r
- */\r
- 'rowdblclick',\r
- /**\r
- * @event headerclick\r
- * Fires when a header is clicked\r
- * @param {Grid} this\r
- * @param {Number} columnIndex\r
- * @param {Ext.EventObject} e\r
- */\r
- 'headerclick',\r
- /**\r
- * @event headerdblclick\r
- * Fires when a header cell is double clicked\r
- * @param {Grid} this\r
- * @param {Number} columnIndex\r
- * @param {Ext.EventObject} e\r
- */\r
- 'headerdblclick',\r
- /**\r
- * @event groupclick\r
- * Fires when group header is clicked. <b>Only applies for grids with a {@link Ext.grid.GroupingView GroupingView}</b>.\r
- * @param {Grid} this\r
- * @param {String} groupField\r
- * @param {String} groupValue\r
- * @param {Ext.EventObject} e\r
- */\r
- 'groupclick',\r
- /**\r
- * @event groupdblclick\r
- * Fires when group header is double clicked. <b>Only applies for grids with a {@link Ext.grid.GroupingView GroupingView}</b>.\r
- * @param {Grid} this\r
- * @param {String} groupField\r
- * @param {String} groupValue\r
- * @param {Ext.EventObject} e\r
- */\r
- 'groupdblclick',\r
- /**\r
- * @event containerclick\r
- * Fires when the container is clicked. The container consists of any part of the grid body that is not covered by a row.\r
- * @param {Grid} this\r
- * @param {Ext.EventObject} e\r
- */\r
- 'containerclick',\r
- /**\r
- * @event containerdblclick\r
- * Fires when the container is double clicked. The container consists of any part of the grid body that is not covered by a row.\r
- * @param {Grid} this\r
- * @param {Ext.EventObject} e\r
- */\r
- 'containerdblclick',\r
- \r
- /**\r
- * @event rowbodyclick\r
- * Fires when the row body is clicked. <b>Only applies for grids with {@link Ext.grid.GridView#enableRowBody enableRowBody} configured.</b>\r
- * @param {Grid} this\r
- * @param {Number} rowIndex\r
- * @param {Ext.EventObject} e\r
- */\r
- 'rowbodyclick',\r
- /**\r
- * @event rowbodydblclick\r
- * Fires when the row body is double clicked. <b>Only applies for grids with {@link Ext.grid.GridView#enableRowBody enableRowBody} configured.</b>\r
- * @param {Grid} this\r
- * @param {Number} rowIndex\r
- * @param {Ext.EventObject} e\r
- */\r
- 'rowbodydblclick',\r
- \r
- /**\r
- * @event rowcontextmenu\r
- * Fires when a row is right clicked\r
- * @param {Grid} this\r
- * @param {Number} rowIndex\r
- * @param {Ext.EventObject} e\r
- */\r
- 'rowcontextmenu',\r
- /**\r
- * @event cellcontextmenu\r
- * Fires when a cell is right clicked\r
- * @param {Grid} this\r
- * @param {Number} rowIndex\r
- * @param {Number} cellIndex\r
- * @param {Ext.EventObject} e\r
- */\r
- 'cellcontextmenu',\r
- /**\r
- * @event headercontextmenu\r
- * Fires when a header is right clicked\r
- * @param {Grid} this\r
- * @param {Number} columnIndex\r
- * @param {Ext.EventObject} e\r
- */\r
- 'headercontextmenu',\r
- /**\r
- * @event groupcontextmenu\r
- * Fires when group header is right clicked. <b>Only applies for grids with a {@link Ext.grid.GroupingView GroupingView}</b>.\r
- * @param {Grid} this\r
- * @param {String} groupField\r
- * @param {String} groupValue\r
- * @param {Ext.EventObject} e\r
- */\r
- 'groupcontextmenu',\r
- /**\r
- * @event containercontextmenu\r
- * Fires when the container is right clicked. The container consists of any part of the grid body that is not covered by a row.\r
- * @param {Grid} this\r
- * @param {Ext.EventObject} e\r
- */\r
- 'containercontextmenu',\r
- /**\r
- * @event rowbodycontextmenu\r
- * Fires when the row body is right clicked. <b>Only applies for grids with {@link Ext.grid.GridView#enableRowBody enableRowBody} configured.</b>\r
- * @param {Grid} this\r
- * @param {Number} rowIndex\r
- * @param {Ext.EventObject} e\r
- */\r
- 'rowbodycontextmenu',\r
- /**\r
- * @event bodyscroll\r
- * Fires when the body element is scrolled\r
- * @param {Number} scrollLeft\r
- * @param {Number} scrollTop\r
- */\r
- 'bodyscroll',\r
- /**\r
- * @event columnresize\r
- * Fires when the user resizes a column\r
- * @param {Number} columnIndex\r
- * @param {Number} newSize\r
- */\r
- 'columnresize',\r
- /**\r
- * @event columnmove\r
- * Fires when the user moves a column\r
- * @param {Number} oldIndex\r
- * @param {Number} newIndex\r
- */\r
- 'columnmove',\r
- /**\r
- * @event sortchange\r
- * Fires when the grid's store sort changes\r
- * @param {Grid} this\r
- * @param {Object} sortInfo An object with the keys field and direction\r
- */\r
- 'sortchange',\r
- /**\r
- * @event groupchange\r
- * Fires when the grid's grouping changes (only applies for grids with a {@link Ext.grid.GroupingView GroupingView})\r
- * @param {Grid} this\r
- * @param {String} groupField A string with the grouping field, null if the store is not grouped.\r
- */\r
- 'groupchange',\r
- /**\r
- * @event reconfigure\r
- * Fires when the grid is reconfigured with a new store and/or column model.\r
- * @param {Grid} this\r
- * @param {Ext.data.Store} store The new store\r
- * @param {Ext.grid.ColumnModel} colModel The new column model\r
- */\r
- 'reconfigure',\r
- /**\r
- * @event viewready\r
- * Fires when the grid view is available (use this for selecting a default row). \r
- * @param {Grid} this\r
- */\r
- 'viewready'\r
- );\r
- },\r
-\r
- // private\r
- onRender : function(ct, position){\r
- Ext.grid.GridPanel.superclass.onRender.apply(this, arguments);\r
-\r
- var c = this.getGridEl();\r
-\r
- this.el.addClass('x-grid-panel');\r
-\r
- this.mon(c, {\r
- scope: this,\r
- mousedown: this.onMouseDown,\r
- click: this.onClick,\r
- dblclick: this.onDblClick,\r
- contextmenu: this.onContextMenu\r
- });\r
-\r
- this.relayEvents(c, ['mousedown','mouseup','mouseover','mouseout','keypress', 'keydown']);\r
-\r
- var view = this.getView();\r
- view.init(this);\r
- view.render();\r
- this.getSelectionModel().init(this);\r
- },\r
-\r
- // private\r
- initEvents : function(){\r
- Ext.grid.GridPanel.superclass.initEvents.call(this);\r
-\r
- if(this.loadMask){\r
- this.loadMask = new Ext.LoadMask(this.bwrap,\r
- Ext.apply({store:this.store}, this.loadMask));\r
- }\r
- },\r
-\r
- initStateEvents : function(){\r
- Ext.grid.GridPanel.superclass.initStateEvents.call(this);\r
- this.mon(this.colModel, 'hiddenchange', this.saveState, this, {delay: 100});\r
- },\r
-\r
- applyState : function(state){\r
- var cm = this.colModel,\r
- cs = state.columns,\r
- store = this.store,\r
- s,\r
- c,\r
- oldIndex;\r
- \r
- if(cs){\r
- for(var i = 0, len = cs.length; i < len; i++){\r
- s = cs[i];\r
- c = cm.getColumnById(s.id);\r
- if(c){\r
- c.hidden = s.hidden;\r
- c.width = s.width;\r
- oldIndex = cm.getIndexById(s.id);\r
- if(oldIndex != i){\r
- cm.moveColumn(oldIndex, i);\r
- }\r
- }\r
- }\r
- }\r
- if(store){\r
- s = state.sort;\r
- if(s){\r
- store[store.remoteSort ? 'setDefaultSort' : 'sort'](s.field, s.direction);\r
- }\r
- s = state.group;\r
- if(store.groupBy){\r
- if(s){\r
- store.groupBy(s);\r
- }else{\r
- store.clearGrouping();\r
- }\r
- }\r
-\r
- }\r
- var o = Ext.apply({}, state);\r
- delete o.columns;\r
- delete o.sort;\r
- Ext.grid.GridPanel.superclass.applyState.call(this, o);\r
- },\r
-\r
- getState : function(){\r
- var o = {columns: []},\r
- store = this.store,\r
- ss,\r
- gs;\r
- \r
- for(var i = 0, c; (c = this.colModel.config[i]); i++){\r
- o.columns[i] = {\r
- id: c.id,\r
- width: c.width\r
- };\r
- if(c.hidden){\r
- o.columns[i].hidden = true;\r
- }\r
- }\r
- if(store){\r
- ss = store.getSortState();\r
- if(ss){\r
- o.sort = ss;\r
- }\r
- if(store.getGroupState){\r
- gs = store.getGroupState();\r
- if(gs){\r
- o.group = gs;\r
- }\r
- }\r
- }\r
- return o;\r
- },\r
-\r
- // private\r
- afterRender : function(){\r
- Ext.grid.GridPanel.superclass.afterRender.call(this);\r
- var v = this.view;\r
- this.on('bodyresize', v.layout, v);\r
- v.layout();\r
- if(this.deferRowRender){\r
- v.afterRender.defer(10, this.view);\r
- }else{\r
- v.afterRender();\r
- }\r
- this.viewReady = true;\r
- },\r
-\r
- /**\r
- * <p>Reconfigures the grid to use a different Store and Column Model\r
- * and fires the 'reconfigure' event. The View will be bound to the new\r
- * objects and refreshed.</p>\r
- * <p>Be aware that upon reconfiguring a GridPanel, certain existing settings <i>may</i> become\r
- * invalidated. For example the configured {@link #autoExpandColumn} may no longer exist in the\r
- * new ColumnModel. Also, an existing {@link Ext.PagingToolbar PagingToolbar} will still be bound\r
- * to the old Store, and will need rebinding. Any {@link #plugins} might also need reconfiguring\r
- * with the new data.</p>\r
- * @param {Ext.data.Store} store The new {@link Ext.data.Store} object\r
- * @param {Ext.grid.ColumnModel} colModel The new {@link Ext.grid.ColumnModel} object\r
- */\r
- reconfigure : function(store, colModel){\r
- var rendered = this.rendered;\r
- if(rendered){\r
- if(this.loadMask){\r
- this.loadMask.destroy();\r
- this.loadMask = new Ext.LoadMask(this.bwrap,\r
- Ext.apply({}, {store:store}, this.initialConfig.loadMask));\r
- }\r
- }\r
- if(this.view){\r
- this.view.initData(store, colModel);\r
- }\r
- this.store = store;\r
- this.colModel = colModel;\r
- if(rendered){\r
- this.view.refresh(true);\r
- }\r
- this.fireEvent('reconfigure', this, store, colModel);\r
- },\r
-\r
- // private\r
- onDestroy : function(){\r
- if(this.rendered){\r
- Ext.destroy(this.view, this.loadMask);\r
- }else if(this.store && this.store.autoDestroy){\r
- this.store.destroy();\r
- }\r
- Ext.destroy(this.colModel, this.selModel);\r
- this.store = this.selModel = this.colModel = this.view = this.loadMask = null;\r
- Ext.grid.GridPanel.superclass.onDestroy.call(this);\r
- },\r
-\r
- // private\r
- processEvent : function(name, e){\r
- this.fireEvent(name, e);\r
- var t = e.getTarget(),\r
- v = this.view,\r
- header = v.findHeaderIndex(t);\r
- \r
- if(header !== false){\r
- this.fireEvent('header' + name, this, header, e);\r
- }else{\r
- var row = v.findRowIndex(t),\r
- cell,\r
- body;\r
- if(row !== false){\r
- this.fireEvent('row' + name, this, row, e);\r
- cell = v.findCellIndex(t);\r
- body = v.findRowBody(t);\r
- if(cell !== false){\r
- this.fireEvent('cell' + name, this, row, cell, e);\r
- }\r
- if(body){\r
- this.fireEvent('rowbody' + name, this, row, e);\r
- }\r
- }else{\r
- this.fireEvent('container' + name, this, e);\r
- }\r
- }\r
- this.view.processEvent(name, e);\r
- },\r
-\r
- // private\r
- onClick : function(e){\r
- this.processEvent('click', e);\r
- },\r
-\r
- // private\r
- onMouseDown : function(e){\r
- this.processEvent('mousedown', e);\r
- },\r
-\r
- // private\r
- onContextMenu : function(e, t){\r
- this.processEvent('contextmenu', e);\r
- },\r
-\r
- // private\r
- onDblClick : function(e){\r
- this.processEvent('dblclick', e);\r
- },\r
-\r
- // private\r
- walkCells : function(row, col, step, fn, scope){\r
- var cm = this.colModel, \r
- clen = cm.getColumnCount(),\r
- ds = this.store, \r
- rlen = ds.getCount(), \r
- first = true;\r
- if(step < 0){\r
- if(col < 0){\r
- row--;\r
- first = false;\r
- }\r
- while(row >= 0){\r
- if(!first){\r
- col = clen-1;\r
- }\r
- first = false;\r
- while(col >= 0){\r
- if(fn.call(scope || this, row, col, cm) === true){\r
- return [row, col];\r
- }\r
- col--;\r
- }\r
- row--;\r
- }\r
- } else {\r
- if(col >= clen){\r
- row++;\r
- first = false;\r
- }\r
- while(row < rlen){\r
- if(!first){\r
- col = 0;\r
- }\r
- first = false;\r
- while(col < clen){\r
- if(fn.call(scope || this, row, col, cm) === true){\r
- return [row, col];\r
- }\r
- col++;\r
- }\r
- row++;\r
- }\r
- }\r
- return null;\r
- },\r
-\r
- // private\r
- onResize : function(){\r
- Ext.grid.GridPanel.superclass.onResize.apply(this, arguments);\r
- if(this.viewReady){\r
- this.view.layout();\r
- }\r
- },\r
-\r
- /**\r
- * Returns the grid's underlying element.\r
- * @return {Element} The element\r
- */\r
- getGridEl : function(){\r
- return this.body;\r
- },\r
-\r
- // private for compatibility, overridden by editor grid\r
- stopEditing : Ext.emptyFn,\r
-\r
- /**\r
- * Returns the grid's selection model configured by the <code>{@link #selModel}</code>\r
- * configuration option. If no selection model was configured, this will create\r
- * and return a {@link Ext.grid.RowSelectionModel RowSelectionModel}.\r
- * @return {SelectionModel}\r
- */\r
- getSelectionModel : function(){\r
- if(!this.selModel){\r
- this.selModel = new Ext.grid.RowSelectionModel(\r
- this.disableSelection ? {selectRow: Ext.emptyFn} : null);\r
- }\r
- return this.selModel;\r
- },\r
-\r
- /**\r
- * Returns the grid's data store.\r
- * @return {Ext.data.Store} The store\r
- */\r
- getStore : function(){\r
- return this.store;\r
- },\r
-\r
- /**\r
- * Returns the grid's ColumnModel.\r
- * @return {Ext.grid.ColumnModel} The column model\r
- */\r
- getColumnModel : function(){\r
- return this.colModel;\r
- },\r
-\r
- /**\r
- * Returns the grid's GridView object.\r
- * @return {Ext.grid.GridView} The grid view\r
- */\r
- getView : function(){\r
- if(!this.view){\r
- this.view = new Ext.grid.GridView(this.viewConfig);\r
- }\r
- return this.view;\r
- },\r
- /**\r
- * Called to get grid's drag proxy text, by default returns this.ddText.\r
- * @return {String} The text\r
- */\r
- getDragDropText : function(){\r
- var count = this.selModel.getCount();\r
- return String.format(this.ddText, count, count == 1 ? '' : 's');\r
- }\r
-\r
- /** \r
- * @cfg {String/Number} activeItem \r
- * @hide \r
- */\r
- /** \r
- * @cfg {Boolean} autoDestroy \r
- * @hide \r
- */\r
- /** \r
- * @cfg {Object/String/Function} autoLoad \r
- * @hide \r
- */\r
- /** \r
- * @cfg {Boolean} autoWidth \r
- * @hide \r
- */\r
- /** \r
- * @cfg {Boolean/Number} bufferResize \r
- * @hide \r
- */\r
- /** \r
- * @cfg {String} defaultType \r
- * @hide \r
- */\r
- /** \r
- * @cfg {Object} defaults \r
- * @hide \r
- */\r
- /** \r
- * @cfg {Boolean} hideBorders \r
- * @hide \r
- */\r
- /** \r
- * @cfg {Mixed} items \r
- * @hide \r
- */\r
- /** \r
- * @cfg {String} layout \r
- * @hide \r
- */\r
- /** \r
- * @cfg {Object} layoutConfig \r
- * @hide \r
- */\r
- /** \r
- * @cfg {Boolean} monitorResize \r
- * @hide \r
- */\r
- /** \r
- * @property items \r
- * @hide \r
- */\r
- /** \r
- * @method add \r
- * @hide \r
- */\r
- /** \r
- * @method cascade \r
- * @hide \r
- */\r
- /** \r
- * @method doLayout \r
- * @hide \r
- */\r
- /** \r
- * @method find \r
- * @hide \r
- */\r
- /** \r
- * @method findBy \r
- * @hide \r
- */\r
- /** \r
- * @method findById \r
- * @hide \r
- */\r
- /** \r
- * @method findByType \r
- * @hide \r
- */\r
- /** \r
- * @method getComponent \r
- * @hide \r
- */\r
- /** \r
- * @method getLayout \r
- * @hide \r
- */\r
- /** \r
- * @method getUpdater \r
- * @hide \r
- */\r
- /** \r
- * @method insert \r
- * @hide \r
- */\r
- /** \r
- * @method load \r
- * @hide \r
- */\r
- /** \r
- * @method remove \r
- * @hide \r
- */\r
- /** \r
- * @event add \r
- * @hide \r
- */\r
- /** \r
- * @event afterlayout \r
- * @hide \r
- */\r
- /** \r
- * @event beforeadd \r
- * @hide \r
- */\r
- /** \r
- * @event beforeremove \r
- * @hide \r
- */\r
- /** \r
- * @event remove \r
- * @hide \r
- */\r
-\r
-\r
-\r
- /**\r
- * @cfg {String} allowDomMove @hide\r
- */\r
- /**\r
- * @cfg {String} autoEl @hide\r
- */\r
- /**\r
- * @cfg {String} applyTo @hide\r
- */\r
- /**\r
- * @cfg {String} autoScroll @hide\r
- */\r
- /**\r
- * @cfg {String} bodyBorder @hide\r
- */\r
- /**\r
- * @cfg {String} bodyStyle @hide\r
- */\r
- /**\r
- * @cfg {String} contentEl @hide\r
- */\r
- /**\r
- * @cfg {String} disabledClass @hide\r
- */\r
- /**\r
- * @cfg {String} elements @hide\r
- */\r
- /**\r
- * @cfg {String} html @hide\r
- */\r
- /**\r
- * @cfg {Boolean} preventBodyReset\r
- * @hide\r
- */\r
- /**\r
- * @property disabled\r
- * @hide\r
- */\r
- /**\r
- * @method applyToMarkup\r
- * @hide\r
- */\r
- /**\r
- * @method enable\r
- * @hide\r
- */\r
- /**\r
- * @method disable\r
- * @hide\r
- */\r
- /**\r
- * @method setDisabled\r
- * @hide\r
- */\r
-});\r
+/**
+ * @class Ext.grid.GridPanel
+ * @extends Ext.Panel
+ * <p>This class represents the primary interface of a component based grid control to represent data
+ * in a tabular format of rows and columns. The GridPanel is composed of the following:</p>
+ * <div class="mdetail-params"><ul>
+ * <li><b>{@link Ext.data.Store Store}</b> : The Model holding the data records (rows)
+ * <div class="sub-desc"></div></li>
+ * <li><b>{@link Ext.grid.ColumnModel Column model}</b> : Column makeup
+ * <div class="sub-desc"></div></li>
+ * <li><b>{@link Ext.grid.GridView View}</b> : Encapsulates the user interface
+ * <div class="sub-desc"></div></li>
+ * <li><b>{@link Ext.grid.AbstractSelectionModel selection model}</b> : Selection behavior
+ * <div class="sub-desc"></div></li>
+ * </ul></div>
+ * <p>Example usage:</p>
+ * <pre><code>
+var grid = new Ext.grid.GridPanel({
+ {@link #store}: new {@link Ext.data.Store}({
+ {@link Ext.data.Store#autoDestroy autoDestroy}: true,
+ {@link Ext.data.Store#reader reader}: reader,
+ {@link Ext.data.Store#data data}: xg.dummyData
+ }),
+ {@link #colModel}: new {@link Ext.grid.ColumnModel}({
+ {@link Ext.grid.ColumnModel#defaults defaults}: {
+ width: 120,
+ sortable: true
+ },
+ {@link Ext.grid.ColumnModel#columns columns}: [
+ {id: 'company', header: 'Company', width: 200, sortable: true, dataIndex: 'company'},
+ {header: 'Price', renderer: Ext.util.Format.usMoney, dataIndex: 'price'},
+ {header: 'Change', dataIndex: 'change'},
+ {header: '% Change', dataIndex: 'pctChange'},
+ // instead of specifying renderer: Ext.util.Format.dateRenderer('m/d/Y') use xtype
+ {
+ header: 'Last Updated', width: 135, dataIndex: 'lastChange',
+ xtype: 'datecolumn', format: 'M d, Y'
+ }
+ ],
+ }),
+ {@link #viewConfig}: {
+ {@link Ext.grid.GridView#forceFit forceFit}: true,
+
+// Return CSS class to apply to rows depending upon data values
+ {@link Ext.grid.GridView#getRowClass getRowClass}: function(record, index) {
+ var c = record.{@link Ext.data.Record#get get}('change');
+ if (c < 0) {
+ return 'price-fall';
+ } else if (c > 0) {
+ return 'price-rise';
+ }
+ }
+ },
+ {@link #sm}: new Ext.grid.RowSelectionModel({singleSelect:true}),
+ width: 600,
+ height: 300,
+ frame: true,
+ title: 'Framed with Row Selection and Horizontal Scrolling',
+ iconCls: 'icon-grid'
+});
+ * </code></pre>
+ * <p><b><u>Notes:</u></b></p>
+ * <div class="mdetail-params"><ul>
+ * <li>Although this class inherits many configuration options from base classes, some of them
+ * (such as autoScroll, autoWidth, layout, items, etc) are not used by this class, and will
+ * have no effect.</li>
+ * <li>A grid <b>requires</b> a width in which to scroll its columns, and a height in which to
+ * scroll its rows. These dimensions can either be set explicitly through the
+ * <tt>{@link Ext.BoxComponent#height height}</tt> and <tt>{@link Ext.BoxComponent#width width}</tt>
+ * configuration options or implicitly set by using the grid as a child item of a
+ * {@link Ext.Container Container} which will have a {@link Ext.Container#layout layout manager}
+ * provide the sizing of its child items (for example the Container of the Grid may specify
+ * <tt>{@link Ext.Container#layout layout}:'fit'</tt>).</li>
+ * <li>To access the data in a Grid, it is necessary to use the data model encapsulated
+ * by the {@link #store Store}. See the {@link #cellclick} event for more details.</li>
+ * </ul></div>
+ * @constructor
+ * @param {Object} config The config object
+ * @xtype grid
+ */
+Ext.grid.GridPanel = Ext.extend(Ext.Panel, {
+ /**
+ * @cfg {String} autoExpandColumn
+ * <p>The <tt>{@link Ext.grid.Column#id id}</tt> of a {@link Ext.grid.Column column} in
+ * this grid that should expand to fill unused space. This value specified here can not
+ * be <tt>0</tt>.</p>
+ * <br><p><b>Note</b>: If the Grid's {@link Ext.grid.GridView view} is configured with
+ * <tt>{@link Ext.grid.GridView#forceFit forceFit}=true</tt> the <tt>autoExpandColumn</tt>
+ * is ignored. See {@link Ext.grid.Column}.<tt>{@link Ext.grid.Column#width width}</tt>
+ * for additional details.</p>
+ * <p>See <tt>{@link #autoExpandMax}</tt> and <tt>{@link #autoExpandMin}</tt> also.</p>
+ */
+ autoExpandColumn : false,
+ /**
+ * @cfg {Number} autoExpandMax The maximum width the <tt>{@link #autoExpandColumn}</tt>
+ * can have (if enabled). Defaults to <tt>1000</tt>.
+ */
+ autoExpandMax : 1000,
+ /**
+ * @cfg {Number} autoExpandMin The minimum width the <tt>{@link #autoExpandColumn}</tt>
+ * can have (if enabled). Defaults to <tt>50</tt>.
+ */
+ autoExpandMin : 50,
+ /**
+ * @cfg {Boolean} columnLines <tt>true</tt> to add css for column separation lines.
+ * Default is <tt>false</tt>.
+ */
+ columnLines : false,
+ /**
+ * @cfg {Object} cm Shorthand for <tt>{@link #colModel}</tt>.
+ */
+ /**
+ * @cfg {Object} colModel The {@link Ext.grid.ColumnModel} to use when rendering the grid (required).
+ */
+ /**
+ * @cfg {Array} columns An array of {@link Ext.grid.Column columns} to auto create a
+ * {@link Ext.grid.ColumnModel}. The ColumnModel may be explicitly created via the
+ * <tt>{@link #colModel}</tt> configuration property.
+ */
+ /**
+ * @cfg {String} ddGroup The DD group this GridPanel belongs to. Defaults to <tt>'GridDD'</tt> if not specified.
+ */
+ /**
+ * @cfg {String} ddText
+ * Configures the text in the drag proxy. Defaults to:
+ * <pre><code>
+ * ddText : '{0} selected row{1}'
+ * </code></pre>
+ * <tt>{0}</tt> is replaced with the number of selected rows.
+ */
+ ddText : '{0} selected row{1}',
+ /**
+ * @cfg {Boolean} deferRowRender <P>Defaults to <tt>true</tt> to enable deferred row rendering.</p>
+ * <p>This allows the GridPanel to be initially rendered empty, with the expensive update of the row
+ * structure deferred so that layouts with GridPanels appear more quickly.</p>
+ */
+ deferRowRender : true,
+ /**
+ * @cfg {Boolean} disableSelection <p><tt>true</tt> to disable selections in the grid. Defaults to <tt>false</tt>.</p>
+ * <p>Ignored if a {@link #selModel SelectionModel} is specified.</p>
+ */
+ /**
+ * @cfg {Boolean} enableColumnResize <tt>false</tt> to turn off column resizing for the whole grid. Defaults to <tt>true</tt>.
+ */
+ /**
+ * @cfg {Boolean} enableColumnHide
+ * Defaults to <tt>true</tt> to enable {@link Ext.grid.Column#hidden hiding of columns}
+ * with the {@link #enableHdMenu header menu}.
+ */
+ enableColumnHide : true,
+ /**
+ * @cfg {Boolean} enableColumnMove Defaults to <tt>true</tt> to enable drag and drop reorder of columns. <tt>false</tt>
+ * to turn off column reordering via drag drop.
+ */
+ enableColumnMove : true,
+ /**
+ * @cfg {Boolean} enableDragDrop <p>Enables dragging of the selected rows of the GridPanel. Defaults to <tt>false</tt>.</p>
+ * <p>Setting this to <b><tt>true</tt></b> causes this GridPanel's {@link #getView GridView} to
+ * create an instance of {@link Ext.grid.GridDragZone}. <b>Note</b>: this is available only <b>after</b>
+ * the Grid has been rendered as the GridView's <tt>{@link Ext.grid.GridView#dragZone dragZone}</tt>
+ * property.</p>
+ * <p>A cooperating {@link Ext.dd.DropZone DropZone} must be created who's implementations of
+ * {@link Ext.dd.DropZone#onNodeEnter onNodeEnter}, {@link Ext.dd.DropZone#onNodeOver onNodeOver},
+ * {@link Ext.dd.DropZone#onNodeOut onNodeOut} and {@link Ext.dd.DropZone#onNodeDrop onNodeDrop} are able
+ * to process the {@link Ext.grid.GridDragZone#getDragData data} which is provided.</p>
+ */
+ enableDragDrop : false,
+ /**
+ * @cfg {Boolean} enableHdMenu Defaults to <tt>true</tt> to enable the drop down button for menu in the headers.
+ */
+ enableHdMenu : true,
+ /**
+ * @cfg {Boolean} hideHeaders True to hide the grid's header. Defaults to <code>false</code>.
+ */
+ /**
+ * @cfg {Object} loadMask An {@link Ext.LoadMask} config or true to mask the grid while
+ * loading. Defaults to <code>false</code>.
+ */
+ loadMask : false,
+ /**
+ * @cfg {Number} maxHeight Sets the maximum height of the grid - ignored if <tt>autoHeight</tt> is not on.
+ */
+ /**
+ * @cfg {Number} minColumnWidth The minimum width a column can be resized to. Defaults to <tt>25</tt>.
+ */
+ minColumnWidth : 25,
+ /**
+ * @cfg {Object} sm Shorthand for <tt>{@link #selModel}</tt>.
+ */
+ /**
+ * @cfg {Object} selModel Any subclass of {@link Ext.grid.AbstractSelectionModel} that will provide
+ * the selection model for the grid (defaults to {@link Ext.grid.RowSelectionModel} if not specified).
+ */
+ /**
+ * @cfg {Ext.data.Store} store The {@link Ext.data.Store} the grid should use as its data source (required).
+ */
+ /**
+ * @cfg {Boolean} stripeRows <tt>true</tt> to stripe the rows. Default is <tt>false</tt>.
+ * <p>This causes the CSS class <tt><b>x-grid3-row-alt</b></tt> to be added to alternate rows of
+ * the grid. A default CSS rule is provided which sets a background colour, but you can override this
+ * with a rule which either overrides the <b>background-color</b> style using the '!important'
+ * modifier, or which uses a CSS selector of higher specificity.</p>
+ */
+ stripeRows : false,
+ /**
+ * @cfg {Boolean} trackMouseOver True to highlight rows when the mouse is over. Default is <tt>true</tt>
+ * for GridPanel, but <tt>false</tt> for EditorGridPanel.
+ */
+ trackMouseOver : true,
+ /**
+ * @cfg {Array} stateEvents
+ * An array of events that, when fired, should trigger this component to save its state.
+ * Defaults to:<pre><code>
+ * stateEvents: ['columnmove', 'columnresize', 'sortchange', 'groupchange']
+ * </code></pre>
+ * <p>These can be any types of events supported by this component, including browser or
+ * custom events (e.g., <tt>['click', 'customerchange']</tt>).</p>
+ * <p>See {@link Ext.Component#stateful} for an explanation of saving and restoring
+ * Component state.</p>
+ */
+ stateEvents : ['columnmove', 'columnresize', 'sortchange', 'groupchange'],
+ /**
+ * @cfg {Object} view The {@link Ext.grid.GridView} used by the grid. This can be set
+ * before a call to {@link Ext.Component#render render()}.
+ */
+ view : null,
+
+ /**
+ * @cfg {Array} bubbleEvents
+ * <p>An array of events that, when fired, should be bubbled to any parent container.
+ * See {@link Ext.util.Observable#enableBubble}.
+ * Defaults to <tt>[]</tt>.
+ */
+ bubbleEvents: [],
+
+ /**
+ * @cfg {Object} viewConfig A config object that will be applied to the grid's UI view. Any of
+ * the config options available for {@link Ext.grid.GridView} can be specified here. This option
+ * is ignored if <tt>{@link #view}</tt> is specified.
+ */
+
+ // private
+ rendered : false,
+ // private
+ viewReady : false,
+
+ // private
+ initComponent : function(){
+ Ext.grid.GridPanel.superclass.initComponent.call(this);
+
+ if(this.columnLines){
+ this.cls = (this.cls || '') + ' x-grid-with-col-lines';
+ }
+ // override any provided value since it isn't valid
+ // and is causing too many bug reports ;)
+ this.autoScroll = false;
+ this.autoWidth = false;
+
+ if(Ext.isArray(this.columns)){
+ this.colModel = new Ext.grid.ColumnModel(this.columns);
+ delete this.columns;
+ }
+
+ // check and correct shorthanded configs
+ if(this.ds){
+ this.store = this.ds;
+ delete this.ds;
+ }
+ if(this.cm){
+ this.colModel = this.cm;
+ delete this.cm;
+ }
+ if(this.sm){
+ this.selModel = this.sm;
+ delete this.sm;
+ }
+ this.store = Ext.StoreMgr.lookup(this.store);
+
+ this.addEvents(
+ // raw events
+ /**
+ * @event click
+ * The raw click event for the entire grid.
+ * @param {Ext.EventObject} e
+ */
+ 'click',
+ /**
+ * @event dblclick
+ * The raw dblclick event for the entire grid.
+ * @param {Ext.EventObject} e
+ */
+ 'dblclick',
+ /**
+ * @event contextmenu
+ * The raw contextmenu event for the entire grid.
+ * @param {Ext.EventObject} e
+ */
+ 'contextmenu',
+ /**
+ * @event mousedown
+ * The raw mousedown event for the entire grid.
+ * @param {Ext.EventObject} e
+ */
+ 'mousedown',
+ /**
+ * @event mouseup
+ * The raw mouseup event for the entire grid.
+ * @param {Ext.EventObject} e
+ */
+ 'mouseup',
+ /**
+ * @event mouseover
+ * The raw mouseover event for the entire grid.
+ * @param {Ext.EventObject} e
+ */
+ 'mouseover',
+ /**
+ * @event mouseout
+ * The raw mouseout event for the entire grid.
+ * @param {Ext.EventObject} e
+ */
+ 'mouseout',
+ /**
+ * @event keypress
+ * The raw keypress event for the entire grid.
+ * @param {Ext.EventObject} e
+ */
+ 'keypress',
+ /**
+ * @event keydown
+ * The raw keydown event for the entire grid.
+ * @param {Ext.EventObject} e
+ */
+ 'keydown',
+
+ // custom events
+ /**
+ * @event cellmousedown
+ * Fires before a cell is clicked
+ * @param {Grid} this
+ * @param {Number} rowIndex
+ * @param {Number} columnIndex
+ * @param {Ext.EventObject} e
+ */
+ 'cellmousedown',
+ /**
+ * @event rowmousedown
+ * Fires before a row is clicked
+ * @param {Grid} this
+ * @param {Number} rowIndex
+ * @param {Ext.EventObject} e
+ */
+ 'rowmousedown',
+ /**
+ * @event headermousedown
+ * Fires before a header is clicked
+ * @param {Grid} this
+ * @param {Number} columnIndex
+ * @param {Ext.EventObject} e
+ */
+ 'headermousedown',
+
+ /**
+ * @event groupmousedown
+ * Fires before a group header is clicked. <b>Only applies for grids with a {@link Ext.grid.GroupingView GroupingView}</b>.
+ * @param {Grid} this
+ * @param {String} groupField
+ * @param {String} groupValue
+ * @param {Ext.EventObject} e
+ */
+ 'groupmousedown',
+
+ /**
+ * @event rowbodymousedown
+ * Fires before the row body is clicked. <b>Only applies for grids with {@link Ext.grid.GridView#enableRowBody enableRowBody} configured.</b>
+ * @param {Grid} this
+ * @param {Number} rowIndex
+ * @param {Ext.EventObject} e
+ */
+ 'rowbodymousedown',
+
+ /**
+ * @event containermousedown
+ * Fires before the container is clicked. The container consists of any part of the grid body that is not covered by a row.
+ * @param {Grid} this
+ * @param {Ext.EventObject} e
+ */
+ 'containermousedown',
+
+ /**
+ * @event cellclick
+ * Fires when a cell is clicked.
+ * The data for the cell is drawn from the {@link Ext.data.Record Record}
+ * for this row. To access the data in the listener function use the
+ * following technique:
+ * <pre><code>
+function(grid, rowIndex, columnIndex, e) {
+ var record = grid.getStore().getAt(rowIndex); // Get the Record
+ var fieldName = grid.getColumnModel().getDataIndex(columnIndex); // Get field name
+ var data = record.get(fieldName);
+}
+</code></pre>
+ * @param {Grid} this
+ * @param {Number} rowIndex
+ * @param {Number} columnIndex
+ * @param {Ext.EventObject} e
+ */
+ 'cellclick',
+ /**
+ * @event celldblclick
+ * Fires when a cell is double clicked
+ * @param {Grid} this
+ * @param {Number} rowIndex
+ * @param {Number} columnIndex
+ * @param {Ext.EventObject} e
+ */
+ 'celldblclick',
+ /**
+ * @event rowclick
+ * Fires when a row is clicked
+ * @param {Grid} this
+ * @param {Number} rowIndex
+ * @param {Ext.EventObject} e
+ */
+ 'rowclick',
+ /**
+ * @event rowdblclick
+ * Fires when a row is double clicked
+ * @param {Grid} this
+ * @param {Number} rowIndex
+ * @param {Ext.EventObject} e
+ */
+ 'rowdblclick',
+ /**
+ * @event headerclick
+ * Fires when a header is clicked
+ * @param {Grid} this
+ * @param {Number} columnIndex
+ * @param {Ext.EventObject} e
+ */
+ 'headerclick',
+ /**
+ * @event headerdblclick
+ * Fires when a header cell is double clicked
+ * @param {Grid} this
+ * @param {Number} columnIndex
+ * @param {Ext.EventObject} e
+ */
+ 'headerdblclick',
+ /**
+ * @event groupclick
+ * Fires when group header is clicked. <b>Only applies for grids with a {@link Ext.grid.GroupingView GroupingView}</b>.
+ * @param {Grid} this
+ * @param {String} groupField
+ * @param {String} groupValue
+ * @param {Ext.EventObject} e
+ */
+ 'groupclick',
+ /**
+ * @event groupdblclick
+ * Fires when group header is double clicked. <b>Only applies for grids with a {@link Ext.grid.GroupingView GroupingView}</b>.
+ * @param {Grid} this
+ * @param {String} groupField
+ * @param {String} groupValue
+ * @param {Ext.EventObject} e
+ */
+ 'groupdblclick',
+ /**
+ * @event containerclick
+ * Fires when the container is clicked. The container consists of any part of the grid body that is not covered by a row.
+ * @param {Grid} this
+ * @param {Ext.EventObject} e
+ */
+ 'containerclick',
+ /**
+ * @event containerdblclick
+ * Fires when the container is double clicked. The container consists of any part of the grid body that is not covered by a row.
+ * @param {Grid} this
+ * @param {Ext.EventObject} e
+ */
+ 'containerdblclick',
+
+ /**
+ * @event rowbodyclick
+ * Fires when the row body is clicked. <b>Only applies for grids with {@link Ext.grid.GridView#enableRowBody enableRowBody} configured.</b>
+ * @param {Grid} this
+ * @param {Number} rowIndex
+ * @param {Ext.EventObject} e
+ */
+ 'rowbodyclick',
+ /**
+ * @event rowbodydblclick
+ * Fires when the row body is double clicked. <b>Only applies for grids with {@link Ext.grid.GridView#enableRowBody enableRowBody} configured.</b>
+ * @param {Grid} this
+ * @param {Number} rowIndex
+ * @param {Ext.EventObject} e
+ */
+ 'rowbodydblclick',
+
+ /**
+ * @event rowcontextmenu
+ * Fires when a row is right clicked
+ * @param {Grid} this
+ * @param {Number} rowIndex
+ * @param {Ext.EventObject} e
+ */
+ 'rowcontextmenu',
+ /**
+ * @event cellcontextmenu
+ * Fires when a cell is right clicked
+ * @param {Grid} this
+ * @param {Number} rowIndex
+ * @param {Number} cellIndex
+ * @param {Ext.EventObject} e
+ */
+ 'cellcontextmenu',
+ /**
+ * @event headercontextmenu
+ * Fires when a header is right clicked
+ * @param {Grid} this
+ * @param {Number} columnIndex
+ * @param {Ext.EventObject} e
+ */
+ 'headercontextmenu',
+ /**
+ * @event groupcontextmenu
+ * Fires when group header is right clicked. <b>Only applies for grids with a {@link Ext.grid.GroupingView GroupingView}</b>.
+ * @param {Grid} this
+ * @param {String} groupField
+ * @param {String} groupValue
+ * @param {Ext.EventObject} e
+ */
+ 'groupcontextmenu',
+ /**
+ * @event containercontextmenu
+ * Fires when the container is right clicked. The container consists of any part of the grid body that is not covered by a row.
+ * @param {Grid} this
+ * @param {Ext.EventObject} e
+ */
+ 'containercontextmenu',
+ /**
+ * @event rowbodycontextmenu
+ * Fires when the row body is right clicked. <b>Only applies for grids with {@link Ext.grid.GridView#enableRowBody enableRowBody} configured.</b>
+ * @param {Grid} this
+ * @param {Number} rowIndex
+ * @param {Ext.EventObject} e
+ */
+ 'rowbodycontextmenu',
+ /**
+ * @event bodyscroll
+ * Fires when the body element is scrolled
+ * @param {Number} scrollLeft
+ * @param {Number} scrollTop
+ */
+ 'bodyscroll',
+ /**
+ * @event columnresize
+ * Fires when the user resizes a column
+ * @param {Number} columnIndex
+ * @param {Number} newSize
+ */
+ 'columnresize',
+ /**
+ * @event columnmove
+ * Fires when the user moves a column
+ * @param {Number} oldIndex
+ * @param {Number} newIndex
+ */
+ 'columnmove',
+ /**
+ * @event sortchange
+ * Fires when the grid's store sort changes
+ * @param {Grid} this
+ * @param {Object} sortInfo An object with the keys field and direction
+ */
+ 'sortchange',
+ /**
+ * @event groupchange
+ * Fires when the grid's grouping changes (only applies for grids with a {@link Ext.grid.GroupingView GroupingView})
+ * @param {Grid} this
+ * @param {String} groupField A string with the grouping field, null if the store is not grouped.
+ */
+ 'groupchange',
+ /**
+ * @event reconfigure
+ * Fires when the grid is reconfigured with a new store and/or column model.
+ * @param {Grid} this
+ * @param {Ext.data.Store} store The new store
+ * @param {Ext.grid.ColumnModel} colModel The new column model
+ */
+ 'reconfigure',
+ /**
+ * @event viewready
+ * Fires when the grid view is available (use this for selecting a default row).
+ * @param {Grid} this
+ */
+ 'viewready'
+ );
+ },
+
+ // private
+ onRender : function(ct, position){
+ Ext.grid.GridPanel.superclass.onRender.apply(this, arguments);
+
+ var c = this.getGridEl();
+
+ this.el.addClass('x-grid-panel');
+
+ this.mon(c, {
+ scope: this,
+ mousedown: this.onMouseDown,
+ click: this.onClick,
+ dblclick: this.onDblClick,
+ contextmenu: this.onContextMenu
+ });
+
+ this.relayEvents(c, ['mousedown','mouseup','mouseover','mouseout','keypress', 'keydown']);
+
+ var view = this.getView();
+ view.init(this);
+ view.render();
+ this.getSelectionModel().init(this);
+ },
+
+ // private
+ initEvents : function(){
+ Ext.grid.GridPanel.superclass.initEvents.call(this);
+
+ if(this.loadMask){
+ this.loadMask = new Ext.LoadMask(this.bwrap,
+ Ext.apply({store:this.store}, this.loadMask));
+ }
+ },
+
+ initStateEvents : function(){
+ Ext.grid.GridPanel.superclass.initStateEvents.call(this);
+ this.mon(this.colModel, 'hiddenchange', this.saveState, this, {delay: 100});
+ },
+
+ applyState : function(state){
+ var cm = this.colModel,
+ cs = state.columns,
+ store = this.store,
+ s,
+ c,
+ oldIndex;
+
+ if(cs){
+ for(var i = 0, len = cs.length; i < len; i++){
+ s = cs[i];
+ c = cm.getColumnById(s.id);
+ if(c){
+ c.hidden = s.hidden;
+ c.width = s.width;
+ oldIndex = cm.getIndexById(s.id);
+ if(oldIndex != i){
+ cm.moveColumn(oldIndex, i);
+ }
+ }
+ }
+ }
+ if(store){
+ s = state.sort;
+ if(s){
+ store[store.remoteSort ? 'setDefaultSort' : 'sort'](s.field, s.direction);
+ }
+ s = state.group;
+ if(store.groupBy){
+ if(s){
+ store.groupBy(s);
+ }else{
+ store.clearGrouping();
+ }
+ }
+
+ }
+ var o = Ext.apply({}, state);
+ delete o.columns;
+ delete o.sort;
+ Ext.grid.GridPanel.superclass.applyState.call(this, o);
+ },
+
+ getState : function(){
+ var o = {columns: []},
+ store = this.store,
+ ss,
+ gs;
+
+ for(var i = 0, c; (c = this.colModel.config[i]); i++){
+ o.columns[i] = {
+ id: c.id,
+ width: c.width
+ };
+ if(c.hidden){
+ o.columns[i].hidden = true;
+ }
+ }
+ if(store){
+ ss = store.getSortState();
+ if(ss){
+ o.sort = ss;
+ }
+ if(store.getGroupState){
+ gs = store.getGroupState();
+ if(gs){
+ o.group = gs;
+ }
+ }
+ }
+ return o;
+ },
+
+ // private
+ afterRender : function(){
+ Ext.grid.GridPanel.superclass.afterRender.call(this);
+ var v = this.view;
+ this.on('bodyresize', v.layout, v);
+ v.layout();
+ if(this.deferRowRender){
+ if (!this.deferRowRenderTask){
+ this.deferRowRenderTask = new Ext.util.DelayedTask(v.afterRender, this.view);
+ }
+ this.deferRowRenderTask.delay(10);
+ }else{
+ v.afterRender();
+ }
+ this.viewReady = true;
+ },
+
+ /**
+ * <p>Reconfigures the grid to use a different Store and Column Model
+ * and fires the 'reconfigure' event. The View will be bound to the new
+ * objects and refreshed.</p>
+ * <p>Be aware that upon reconfiguring a GridPanel, certain existing settings <i>may</i> become
+ * invalidated. For example the configured {@link #autoExpandColumn} may no longer exist in the
+ * new ColumnModel. Also, an existing {@link Ext.PagingToolbar PagingToolbar} will still be bound
+ * to the old Store, and will need rebinding. Any {@link #plugins} might also need reconfiguring
+ * with the new data.</p>
+ * @param {Ext.data.Store} store The new {@link Ext.data.Store} object
+ * @param {Ext.grid.ColumnModel} colModel The new {@link Ext.grid.ColumnModel} object
+ */
+ reconfigure : function(store, colModel){
+ var rendered = this.rendered;
+ if(rendered){
+ if(this.loadMask){
+ this.loadMask.destroy();
+ this.loadMask = new Ext.LoadMask(this.bwrap,
+ Ext.apply({}, {store:store}, this.initialConfig.loadMask));
+ }
+ }
+ if(this.view){
+ this.view.initData(store, colModel);
+ }
+ this.store = store;
+ this.colModel = colModel;
+ if(rendered){
+ this.view.refresh(true);
+ }
+ this.fireEvent('reconfigure', this, store, colModel);
+ },
+
+ // private
+ onDestroy : function(){
+ if (this.deferRowRenderTask && this.deferRowRenderTask.cancel){
+ this.deferRowRenderTask.cancel();
+ }
+ if(this.rendered){
+ Ext.destroy(this.view, this.loadMask);
+ }else if(this.store && this.store.autoDestroy){
+ this.store.destroy();
+ }
+ Ext.destroy(this.colModel, this.selModel);
+ this.store = this.selModel = this.colModel = this.view = this.loadMask = null;
+ Ext.grid.GridPanel.superclass.onDestroy.call(this);
+ },
+
+ // private
+ processEvent : function(name, e){
+ this.view.processEvent(name, e);
+ },
+
+ // private
+ onClick : function(e){
+ this.processEvent('click', e);
+ },
+
+ // private
+ onMouseDown : function(e){
+ this.processEvent('mousedown', e);
+ },
+
+ // private
+ onContextMenu : function(e, t){
+ this.processEvent('contextmenu', e);
+ },
+
+ // private
+ onDblClick : function(e){
+ this.processEvent('dblclick', e);
+ },
+
+ // private
+ walkCells : function(row, col, step, fn, scope){
+ var cm = this.colModel,
+ clen = cm.getColumnCount(),
+ ds = this.store,
+ rlen = ds.getCount(),
+ first = true;
+
+ if(step < 0){
+ if(col < 0){
+ row--;
+ first = false;
+ }
+ while(row >= 0){
+ if(!first){
+ col = clen-1;
+ }
+ first = false;
+ while(col >= 0){
+ if(fn.call(scope || this, row, col, cm) === true){
+ return [row, col];
+ }
+ col--;
+ }
+ row--;
+ }
+ } else {
+ if(col >= clen){
+ row++;
+ first = false;
+ }
+ while(row < rlen){
+ if(!first){
+ col = 0;
+ }
+ first = false;
+ while(col < clen){
+ if(fn.call(scope || this, row, col, cm) === true){
+ return [row, col];
+ }
+ col++;
+ }
+ row++;
+ }
+ }
+ return null;
+ },
+
+ /**
+ * Returns the grid's underlying element.
+ * @return {Element} The element
+ */
+ getGridEl : function(){
+ return this.body;
+ },
+
+ // private for compatibility, overridden by editor grid
+ stopEditing : Ext.emptyFn,
+
+ /**
+ * Returns the grid's selection model configured by the <code>{@link #selModel}</code>
+ * configuration option. If no selection model was configured, this will create
+ * and return a {@link Ext.grid.RowSelectionModel RowSelectionModel}.
+ * @return {SelectionModel}
+ */
+ getSelectionModel : function(){
+ if(!this.selModel){
+ this.selModel = new Ext.grid.RowSelectionModel(
+ this.disableSelection ? {selectRow: Ext.emptyFn} : null);
+ }
+ return this.selModel;
+ },
+
+ /**
+ * Returns the grid's data store.
+ * @return {Ext.data.Store} The store
+ */
+ getStore : function(){
+ return this.store;
+ },
+
+ /**
+ * Returns the grid's ColumnModel.
+ * @return {Ext.grid.ColumnModel} The column model
+ */
+ getColumnModel : function(){
+ return this.colModel;
+ },
+
+ /**
+ * Returns the grid's GridView object.
+ * @return {Ext.grid.GridView} The grid view
+ */
+ getView : function(){
+ if(!this.view){
+ this.view = new Ext.grid.GridView(this.viewConfig);
+ }
+ return this.view;
+ },
+ /**
+ * Called to get grid's drag proxy text, by default returns this.ddText.
+ * @return {String} The text
+ */
+ getDragDropText : function(){
+ var count = this.selModel.getCount();
+ return String.format(this.ddText, count, count == 1 ? '' : 's');
+ }
+
+ /**
+ * @cfg {String/Number} activeItem
+ * @hide
+ */
+ /**
+ * @cfg {Boolean} autoDestroy
+ * @hide
+ */
+ /**
+ * @cfg {Object/String/Function} autoLoad
+ * @hide
+ */
+ /**
+ * @cfg {Boolean} autoWidth
+ * @hide
+ */
+ /**
+ * @cfg {Boolean/Number} bufferResize
+ * @hide
+ */
+ /**
+ * @cfg {String} defaultType
+ * @hide
+ */
+ /**
+ * @cfg {Object} defaults
+ * @hide
+ */
+ /**
+ * @cfg {Boolean} hideBorders
+ * @hide
+ */
+ /**
+ * @cfg {Mixed} items
+ * @hide
+ */
+ /**
+ * @cfg {String} layout
+ * @hide
+ */
+ /**
+ * @cfg {Object} layoutConfig
+ * @hide
+ */
+ /**
+ * @cfg {Boolean} monitorResize
+ * @hide
+ */
+ /**
+ * @property items
+ * @hide
+ */
+ /**
+ * @method add
+ * @hide
+ */
+ /**
+ * @method cascade
+ * @hide
+ */
+ /**
+ * @method doLayout
+ * @hide
+ */
+ /**
+ * @method find
+ * @hide
+ */
+ /**
+ * @method findBy
+ * @hide
+ */
+ /**
+ * @method findById
+ * @hide
+ */
+ /**
+ * @method findByType
+ * @hide
+ */
+ /**
+ * @method getComponent
+ * @hide
+ */
+ /**
+ * @method getLayout
+ * @hide
+ */
+ /**
+ * @method getUpdater
+ * @hide
+ */
+ /**
+ * @method insert
+ * @hide
+ */
+ /**
+ * @method load
+ * @hide
+ */
+ /**
+ * @method remove
+ * @hide
+ */
+ /**
+ * @event add
+ * @hide
+ */
+ /**
+ * @event afterlayout
+ * @hide
+ */
+ /**
+ * @event beforeadd
+ * @hide
+ */
+ /**
+ * @event beforeremove
+ * @hide
+ */
+ /**
+ * @event remove
+ * @hide
+ */
+
+
+
+ /**
+ * @cfg {String} allowDomMove @hide
+ */
+ /**
+ * @cfg {String} autoEl @hide
+ */
+ /**
+ * @cfg {String} applyTo @hide
+ */
+ /**
+ * @cfg {String} autoScroll @hide
+ */
+ /**
+ * @cfg {String} bodyBorder @hide
+ */
+ /**
+ * @cfg {String} bodyStyle @hide
+ */
+ /**
+ * @cfg {String} contentEl @hide
+ */
+ /**
+ * @cfg {String} disabledClass @hide
+ */
+ /**
+ * @cfg {String} elements @hide
+ */
+ /**
+ * @cfg {String} html @hide
+ */
+ /**
+ * @cfg {Boolean} preventBodyReset
+ * @hide
+ */
+ /**
+ * @property disabled
+ * @hide
+ */
+ /**
+ * @method applyToMarkup
+ * @hide
+ */
+ /**
+ * @method enable
+ * @hide
+ */
+ /**
+ * @method disable
+ * @hide
+ */
+ /**
+ * @method setDisabled
+ * @hide
+ */
+});
Ext.reg('grid', Ext.grid.GridPanel);
\ No newline at end of file
git.ithinksw.org / extjs.git / blobdiff