Bienvenue sur PostGIS.fr

Bienvenue sur PostGIS.fr , le site de la communauté des utilisateurs francophones de PostGIS.

PostGIS ajoute le support d'objets géographique à la base de données PostgreSQL. En effet, PostGIS "spatialise" le serverur PostgreSQL, ce qui permet de l'utiliser comme une base de données SIG.

Maintenu à jour, en fonction de nos disponibilités et des diverses sorties des outils que nous testons, nous vous proposons l'ensemble de nos travaux publiés en langue française.

source: trunk/workshop-routing-foss4g/web/ext/pkgs/pkg-grid-foundation-debug.js @ 77

Revision 76, 246.0 KB checked in by djay, 13 years ago (diff)

Ajout du répertoire web

  • Property svn:executable set to *
Line 
1/*!
2 * Ext JS Library 3.4.0
3 * Copyright(c) 2006-2011 Sencha Inc.
4 * licensing@sencha.com
5 * http://www.sencha.com/license
6 */
7/**
8 * @class Ext.grid.GridPanel
9 * @extends Ext.Panel
10 * <p>This class represents the primary interface of a component based grid control to represent data
11 * in a tabular format of rows and columns. The GridPanel is composed of the following:</p>
12 * <div class="mdetail-params"><ul>
13 * <li><b>{@link Ext.data.Store Store}</b> : The Model holding the data records (rows)
14 * <div class="sub-desc"></div></li>
15 * <li><b>{@link Ext.grid.ColumnModel Column model}</b> : Column makeup
16 * <div class="sub-desc"></div></li>
17 * <li><b>{@link Ext.grid.GridView View}</b> : Encapsulates the user interface
18 * <div class="sub-desc"></div></li>
19 * <li><b>{@link Ext.grid.AbstractSelectionModel selection model}</b> : Selection behavior
20 * <div class="sub-desc"></div></li>
21 * </ul></div>
22 * <p>Example usage:</p>
23 * <pre><code>
24var grid = new Ext.grid.GridPanel({
25    {@link #store}: new {@link Ext.data.Store}({
26        {@link Ext.data.Store#autoDestroy autoDestroy}: true,
27        {@link Ext.data.Store#reader reader}: reader,
28        {@link Ext.data.Store#data data}: xg.dummyData
29    }),
30    {@link #colModel}: new {@link Ext.grid.ColumnModel}({
31        {@link Ext.grid.ColumnModel#defaults defaults}: {
32            width: 120,
33            sortable: true
34        },
35        {@link Ext.grid.ColumnModel#columns columns}: [
36            {id: 'company', header: 'Company', width: 200, sortable: true, dataIndex: 'company'},
37            {header: 'Price', renderer: Ext.util.Format.usMoney, dataIndex: 'price'},
38            {header: 'Change', dataIndex: 'change'},
39            {header: '% Change', dataIndex: 'pctChange'},
40            // instead of specifying renderer: Ext.util.Format.dateRenderer('m/d/Y') use xtype
41            {
42                header: 'Last Updated', width: 135, dataIndex: 'lastChange',
43                xtype: 'datecolumn', format: 'M d, Y'
44            }
45        ]
46    }),
47    {@link #viewConfig}: {
48        {@link Ext.grid.GridView#forceFit forceFit}: true,
49
50//      Return CSS class to apply to rows depending upon data values
51        {@link Ext.grid.GridView#getRowClass getRowClass}: function(record, index) {
52            var c = record.{@link Ext.data.Record#get get}('change');
53            if (c < 0) {
54                return 'price-fall';
55            } else if (c > 0) {
56                return 'price-rise';
57            }
58        }
59    },
60    {@link #sm}: new Ext.grid.RowSelectionModel({singleSelect:true}),
61    width: 600,
62    height: 300,
63    frame: true,
64    title: 'Framed with Row Selection and Horizontal Scrolling',
65    iconCls: 'icon-grid'
66});
67 * </code></pre>
68 * <p><b><u>Notes:</u></b></p>
69 * <div class="mdetail-params"><ul>
70 * <li>Although this class inherits many configuration options from base classes, some of them
71 * (such as autoScroll, autoWidth, layout, items, etc) are not used by this class, and will
72 * have no effect.</li>
73 * <li>A grid <b>requires</b> a width in which to scroll its columns, and a height in which to
74 * scroll its rows. These dimensions can either be set explicitly through the
75 * <tt>{@link Ext.BoxComponent#height height}</tt> and <tt>{@link Ext.BoxComponent#width width}</tt>
76 * configuration options or implicitly set by using the grid as a child item of a
77 * {@link Ext.Container Container} which will have a {@link Ext.Container#layout layout manager}
78 * provide the sizing of its child items (for example the Container of the Grid may specify
79 * <tt>{@link Ext.Container#layout layout}:'fit'</tt>).</li>
80 * <li>To access the data in a Grid, it is necessary to use the data model encapsulated
81 * by the {@link #store Store}. See the {@link #cellclick} event for more details.</li>
82 * </ul></div>
83 * @constructor
84 * @param {Object} config The config object
85 * @xtype grid
86 */
87Ext.grid.GridPanel = Ext.extend(Ext.Panel, {
88    /**
89     * @cfg {String} autoExpandColumn
90     * <p>The <tt>{@link Ext.grid.Column#id id}</tt> of a {@link Ext.grid.Column column} in
91     * this grid that should expand to fill unused space. This value specified here can not
92     * be <tt>0</tt>.</p>
93     * <br><p><b>Note</b>: If the Grid's {@link Ext.grid.GridView view} is configured with
94     * <tt>{@link Ext.grid.GridView#forceFit forceFit}=true</tt> the <tt>autoExpandColumn</tt>
95     * is ignored. See {@link Ext.grid.Column}.<tt>{@link Ext.grid.Column#width width}</tt>
96     * for additional details.</p>
97     * <p>See <tt>{@link #autoExpandMax}</tt> and <tt>{@link #autoExpandMin}</tt> also.</p>
98     */
99    autoExpandColumn : false,
100   
101    /**
102     * @cfg {Number} autoExpandMax The maximum width the <tt>{@link #autoExpandColumn}</tt>
103     * can have (if enabled). Defaults to <tt>1000</tt>.
104     */
105    autoExpandMax : 1000,
106   
107    /**
108     * @cfg {Number} autoExpandMin The minimum width the <tt>{@link #autoExpandColumn}</tt>
109     * can have (if enabled). Defaults to <tt>50</tt>.
110     */
111    autoExpandMin : 50,
112   
113    /**
114     * @cfg {Boolean} columnLines <tt>true</tt> to add css for column separation lines.
115     * Default is <tt>false</tt>.
116     */
117    columnLines : false,
118   
119    /**
120     * @cfg {Object} cm Shorthand for <tt>{@link #colModel}</tt>.
121     */
122    /**
123     * @cfg {Object} colModel The {@link Ext.grid.ColumnModel} to use when rendering the grid (required).
124     */
125    /**
126     * @cfg {Array} columns An array of {@link Ext.grid.Column columns} to auto create a
127     * {@link Ext.grid.ColumnModel}.  The ColumnModel may be explicitly created via the
128     * <tt>{@link #colModel}</tt> configuration property.
129     */
130    /**
131     * @cfg {String} ddGroup The DD group this GridPanel belongs to. Defaults to <tt>'GridDD'</tt> if not specified.
132     */
133    /**
134     * @cfg {String} ddText
135     * Configures the text in the drag proxy.  Defaults to:
136     * <pre><code>
137     * ddText : '{0} selected row{1}'
138     * </code></pre>
139     * <tt>{0}</tt> is replaced with the number of selected rows.
140     */
141    ddText : '{0} selected row{1}',
142   
143    /**
144     * @cfg {Boolean} deferRowRender <P>Defaults to <tt>true</tt> to enable deferred row rendering.</p>
145     * <p>This allows the GridPanel to be initially rendered empty, with the expensive update of the row
146     * structure deferred so that layouts with GridPanels appear more quickly.</p>
147     */
148    deferRowRender : true,
149   
150    /**
151     * @cfg {Boolean} disableSelection <p><tt>true</tt> to disable selections in the grid. Defaults to <tt>false</tt>.</p>
152     * <p>Ignored if a {@link #selModel SelectionModel} is specified.</p>
153     */
154    /**
155     * @cfg {Boolean} enableColumnResize <tt>false</tt> to turn off column resizing for the whole grid. Defaults to <tt>true</tt>.
156     */
157    /**
158     * @cfg {Boolean} enableColumnHide
159     * Defaults to <tt>true</tt> to enable {@link Ext.grid.Column#hidden hiding of columns}
160     * with the {@link #enableHdMenu header menu}.
161     */
162    enableColumnHide : true,
163   
164    /**
165     * @cfg {Boolean} enableColumnMove Defaults to <tt>true</tt> to enable drag and drop reorder of columns. <tt>false</tt>
166     * to turn off column reordering via drag drop.
167     */
168    enableColumnMove : true,
169   
170    /**
171     * @cfg {Boolean} enableDragDrop <p>Enables dragging of the selected rows of the GridPanel. Defaults to <tt>false</tt>.</p>
172     * <p>Setting this to <b><tt>true</tt></b> causes this GridPanel's {@link #getView GridView} to
173     * create an instance of {@link Ext.grid.GridDragZone}. <b>Note</b>: this is available only <b>after</b>
174     * the Grid has been rendered as the GridView's <tt>{@link Ext.grid.GridView#dragZone dragZone}</tt>
175     * property.</p>
176     * <p>A cooperating {@link Ext.dd.DropZone DropZone} must be created who's implementations of
177     * {@link Ext.dd.DropZone#onNodeEnter onNodeEnter}, {@link Ext.dd.DropZone#onNodeOver onNodeOver},
178     * {@link Ext.dd.DropZone#onNodeOut onNodeOut} and {@link Ext.dd.DropZone#onNodeDrop onNodeDrop} are able
179     * to process the {@link Ext.grid.GridDragZone#getDragData data} which is provided.</p>
180     */
181    enableDragDrop : false,
182   
183    /**
184     * @cfg {Boolean} enableHdMenu Defaults to <tt>true</tt> to enable the drop down button for menu in the headers.
185     */
186    enableHdMenu : true,
187   
188    /**
189     * @cfg {Boolean} hideHeaders True to hide the grid's header. Defaults to <code>false</code>.
190     */
191    /**
192     * @cfg {Object} loadMask An {@link Ext.LoadMask} config or true to mask the grid while
193     * loading. Defaults to <code>false</code>.
194     */
195    loadMask : false,
196   
197    /**
198     * @cfg {Number} maxHeight Sets the maximum height of the grid - ignored if <tt>autoHeight</tt> is not on.
199     */
200    /**
201     * @cfg {Number} minColumnWidth The minimum width a column can be resized to. Defaults to <tt>25</tt>.
202     */
203    minColumnWidth : 25,
204   
205    /**
206     * @cfg {Object} sm Shorthand for <tt>{@link #selModel}</tt>.
207     */
208    /**
209     * @cfg {Object} selModel Any subclass of {@link Ext.grid.AbstractSelectionModel} that will provide
210     * the selection model for the grid (defaults to {@link Ext.grid.RowSelectionModel} if not specified).
211     */
212    /**
213     * @cfg {Ext.data.Store} store The {@link Ext.data.Store} the grid should use as its data source (required).
214     */
215    /**
216     * @cfg {Boolean} stripeRows <tt>true</tt> to stripe the rows. Default is <tt>false</tt>.
217     * <p>This causes the CSS class <tt><b>x-grid3-row-alt</b></tt> to be added to alternate rows of
218     * the grid. A default CSS rule is provided which sets a background colour, but you can override this
219     * with a rule which either overrides the <b>background-color</b> style using the '!important'
220     * modifier, or which uses a CSS selector of higher specificity.</p>
221     */
222    stripeRows : false,
223   
224    /**
225     * @cfg {Boolean} trackMouseOver True to highlight rows when the mouse is over. Default is <tt>true</tt>
226     * for GridPanel, but <tt>false</tt> for EditorGridPanel.
227     */
228    trackMouseOver : true,
229   
230    /**
231     * @cfg {Array} stateEvents
232     * An array of events that, when fired, should trigger this component to save its state.
233     * Defaults to:<pre><code>
234     * stateEvents: ['columnmove', 'columnresize', 'sortchange', 'groupchange']
235     * </code></pre>
236     * <p>These can be any types of events supported by this component, including browser or
237     * custom events (e.g., <tt>['click', 'customerchange']</tt>).</p>
238     * <p>See {@link Ext.Component#stateful} for an explanation of saving and restoring
239     * Component state.</p>
240     */
241    stateEvents : ['columnmove', 'columnresize', 'sortchange', 'groupchange'],
242   
243    /**
244     * @cfg {Object} view The {@link Ext.grid.GridView} used by the grid. This can be set
245     * before a call to {@link Ext.Component#render render()}.
246     */
247    view : null,
248
249    /**
250     * @cfg {Array} bubbleEvents
251     * <p>An array of events that, when fired, should be bubbled to any parent container.
252     * See {@link Ext.util.Observable#enableBubble}.
253     * Defaults to <tt>[]</tt>.
254     */
255    bubbleEvents: [],
256
257    /**
258     * @cfg {Object} viewConfig A config object that will be applied to the grid's UI view.  Any of
259     * the config options available for {@link Ext.grid.GridView} can be specified here. This option
260     * is ignored if <tt>{@link #view}</tt> is specified.
261     */
262
263    // private
264    rendered : false,
265   
266    // private
267    viewReady : false,
268
269    // private
270    initComponent : function() {
271        Ext.grid.GridPanel.superclass.initComponent.call(this);
272
273        if (this.columnLines) {
274            this.cls = (this.cls || '') + ' x-grid-with-col-lines';
275        }
276        // override any provided value since it isn't valid
277        // and is causing too many bug reports ;)
278        this.autoScroll = false;
279        this.autoWidth = false;
280
281        if(Ext.isArray(this.columns)){
282            this.colModel = new Ext.grid.ColumnModel(this.columns);
283            delete this.columns;
284        }
285
286        // check and correct shorthanded configs
287        if(this.ds){
288            this.store = this.ds;
289            delete this.ds;
290        }
291        if(this.cm){
292            this.colModel = this.cm;
293            delete this.cm;
294        }
295        if(this.sm){
296            this.selModel = this.sm;
297            delete this.sm;
298        }
299        this.store = Ext.StoreMgr.lookup(this.store);
300
301        this.addEvents(
302            // raw events
303            /**
304             * @event click
305             * The raw click event for the entire grid.
306             * @param {Ext.EventObject} e
307             */
308            'click',
309            /**
310             * @event dblclick
311             * The raw dblclick event for the entire grid.
312             * @param {Ext.EventObject} e
313             */
314            'dblclick',
315            /**
316             * @event contextmenu
317             * The raw contextmenu event for the entire grid.
318             * @param {Ext.EventObject} e
319             */
320            'contextmenu',
321            /**
322             * @event mousedown
323             * The raw mousedown event for the entire grid.
324             * @param {Ext.EventObject} e
325             */
326            'mousedown',
327            /**
328             * @event mouseup
329             * The raw mouseup event for the entire grid.
330             * @param {Ext.EventObject} e
331             */
332            'mouseup',
333            /**
334             * @event mouseover
335             * The raw mouseover event for the entire grid.
336             * @param {Ext.EventObject} e
337             */
338            'mouseover',
339            /**
340             * @event mouseout
341             * The raw mouseout event for the entire grid.
342             * @param {Ext.EventObject} e
343             */
344            'mouseout',
345            /**
346             * @event keypress
347             * The raw keypress event for the entire grid.
348             * @param {Ext.EventObject} e
349             */
350            'keypress',
351            /**
352             * @event keydown
353             * The raw keydown event for the entire grid.
354             * @param {Ext.EventObject} e
355             */
356            'keydown',
357
358            // custom events
359            /**
360             * @event cellmousedown
361             * Fires before a cell is clicked
362             * @param {Grid} this
363             * @param {Number} rowIndex
364             * @param {Number} columnIndex
365             * @param {Ext.EventObject} e
366             */
367            'cellmousedown',
368            /**
369             * @event rowmousedown
370             * Fires before a row is clicked
371             * @param {Grid} this
372             * @param {Number} rowIndex
373             * @param {Ext.EventObject} e
374             */
375            'rowmousedown',
376            /**
377             * @event headermousedown
378             * Fires before a header is clicked
379             * @param {Grid} this
380             * @param {Number} columnIndex
381             * @param {Ext.EventObject} e
382             */
383            'headermousedown',
384
385            /**
386             * @event groupmousedown
387             * Fires before a group header is clicked. <b>Only applies for grids with a {@link Ext.grid.GroupingView GroupingView}</b>.
388             * @param {Grid} this
389             * @param {String} groupField
390             * @param {String} groupValue
391             * @param {Ext.EventObject} e
392             */
393            'groupmousedown',
394
395            /**
396             * @event rowbodymousedown
397             * Fires before the row body is clicked. <b>Only applies for grids with {@link Ext.grid.GridView#enableRowBody enableRowBody} configured.</b>
398             * @param {Grid} this
399             * @param {Number} rowIndex
400             * @param {Ext.EventObject} e
401             */
402            'rowbodymousedown',
403
404            /**
405             * @event containermousedown
406             * Fires before the container is clicked. The container consists of any part of the grid body that is not covered by a row.
407             * @param {Grid} this
408             * @param {Ext.EventObject} e
409             */
410            'containermousedown',
411
412            /**
413             * @event cellclick
414             * Fires when a cell is clicked.
415             * The data for the cell is drawn from the {@link Ext.data.Record Record}
416             * for this row. To access the data in the listener function use the
417             * following technique:
418             * <pre><code>
419function(grid, rowIndex, columnIndex, e) {
420    var record = grid.getStore().getAt(rowIndex);  // Get the Record
421    var fieldName = grid.getColumnModel().getDataIndex(columnIndex); // Get field name
422    var data = record.get(fieldName);
423}
424</code></pre>
425             * @param {Grid} this
426             * @param {Number} rowIndex
427             * @param {Number} columnIndex
428             * @param {Ext.EventObject} e
429             */
430            'cellclick',
431            /**
432             * @event celldblclick
433             * Fires when a cell is double clicked
434             * @param {Grid} this
435             * @param {Number} rowIndex
436             * @param {Number} columnIndex
437             * @param {Ext.EventObject} e
438             */
439            'celldblclick',
440            /**
441             * @event rowclick
442             * Fires when a row is clicked
443             * @param {Grid} this
444             * @param {Number} rowIndex
445             * @param {Ext.EventObject} e
446             */
447            'rowclick',
448            /**
449             * @event rowdblclick
450             * Fires when a row is double clicked
451             * @param {Grid} this
452             * @param {Number} rowIndex
453             * @param {Ext.EventObject} e
454             */
455            'rowdblclick',
456            /**
457             * @event headerclick
458             * Fires when a header is clicked
459             * @param {Grid} this
460             * @param {Number} columnIndex
461             * @param {Ext.EventObject} e
462             */
463            'headerclick',
464            /**
465             * @event headerdblclick
466             * Fires when a header cell is double clicked
467             * @param {Grid} this
468             * @param {Number} columnIndex
469             * @param {Ext.EventObject} e
470             */
471            'headerdblclick',
472            /**
473             * @event groupclick
474             * Fires when group header is clicked. <b>Only applies for grids with a {@link Ext.grid.GroupingView GroupingView}</b>.
475             * @param {Grid} this
476             * @param {String} groupField
477             * @param {String} groupValue
478             * @param {Ext.EventObject} e
479             */
480            'groupclick',
481            /**
482             * @event groupdblclick
483             * Fires when group header is double clicked. <b>Only applies for grids with a {@link Ext.grid.GroupingView GroupingView}</b>.
484             * @param {Grid} this
485             * @param {String} groupField
486             * @param {String} groupValue
487             * @param {Ext.EventObject} e
488             */
489            'groupdblclick',
490            /**
491             * @event containerclick
492             * Fires when the container is clicked. The container consists of any part of the grid body that is not covered by a row.
493             * @param {Grid} this
494             * @param {Ext.EventObject} e
495             */
496            'containerclick',
497            /**
498             * @event containerdblclick
499             * Fires when the container is double clicked. The container consists of any part of the grid body that is not covered by a row.
500             * @param {Grid} this
501             * @param {Ext.EventObject} e
502             */
503            'containerdblclick',
504
505            /**
506             * @event rowbodyclick
507             * Fires when the row body is clicked. <b>Only applies for grids with {@link Ext.grid.GridView#enableRowBody enableRowBody} configured.</b>
508             * @param {Grid} this
509             * @param {Number} rowIndex
510             * @param {Ext.EventObject} e
511             */
512            'rowbodyclick',
513            /**
514             * @event rowbodydblclick
515             * Fires when the row body is double clicked. <b>Only applies for grids with {@link Ext.grid.GridView#enableRowBody enableRowBody} configured.</b>
516             * @param {Grid} this
517             * @param {Number} rowIndex
518             * @param {Ext.EventObject} e
519             */
520            'rowbodydblclick',
521
522            /**
523             * @event rowcontextmenu
524             * Fires when a row is right clicked
525             * @param {Grid} this
526             * @param {Number} rowIndex
527             * @param {Ext.EventObject} e
528             */
529            'rowcontextmenu',
530            /**
531             * @event cellcontextmenu
532             * Fires when a cell is right clicked
533             * @param {Grid} this
534             * @param {Number} rowIndex
535             * @param {Number} cellIndex
536             * @param {Ext.EventObject} e
537             */
538            'cellcontextmenu',
539            /**
540             * @event headercontextmenu
541             * Fires when a header is right clicked
542             * @param {Grid} this
543             * @param {Number} columnIndex
544             * @param {Ext.EventObject} e
545             */
546            'headercontextmenu',
547            /**
548             * @event groupcontextmenu
549             * Fires when group header is right clicked. <b>Only applies for grids with a {@link Ext.grid.GroupingView GroupingView}</b>.
550             * @param {Grid} this
551             * @param {String} groupField
552             * @param {String} groupValue
553             * @param {Ext.EventObject} e
554             */
555            'groupcontextmenu',
556            /**
557             * @event containercontextmenu
558             * Fires when the container is right clicked. The container consists of any part of the grid body that is not covered by a row.
559             * @param {Grid} this
560             * @param {Ext.EventObject} e
561             */
562            'containercontextmenu',
563            /**
564             * @event rowbodycontextmenu
565             * Fires when the row body is right clicked. <b>Only applies for grids with {@link Ext.grid.GridView#enableRowBody enableRowBody} configured.</b>
566             * @param {Grid} this
567             * @param {Number} rowIndex
568             * @param {Ext.EventObject} e
569             */
570            'rowbodycontextmenu',
571            /**
572             * @event bodyscroll
573             * Fires when the body element is scrolled
574             * @param {Number} scrollLeft
575             * @param {Number} scrollTop
576             */
577            'bodyscroll',
578            /**
579             * @event columnresize
580             * Fires when the user resizes a column
581             * @param {Number} columnIndex
582             * @param {Number} newSize
583             */
584            'columnresize',
585            /**
586             * @event columnmove
587             * Fires when the user moves a column
588             * @param {Number} oldIndex
589             * @param {Number} newIndex
590             */
591            'columnmove',
592            /**
593             * @event sortchange
594             * Fires when the grid's store sort changes
595             * @param {Grid} this
596             * @param {Object} sortInfo An object with the keys field and direction
597             */
598            'sortchange',
599            /**
600             * @event groupchange
601             * Fires when the grid's grouping changes (only applies for grids with a {@link Ext.grid.GroupingView GroupingView})
602             * @param {Grid} this
603             * @param {String} groupField A string with the grouping field, null if the store is not grouped.
604             */
605            'groupchange',
606            /**
607             * @event reconfigure
608             * Fires when the grid is reconfigured with a new store and/or column model.
609             * @param {Grid} this
610             * @param {Ext.data.Store} store The new store
611             * @param {Ext.grid.ColumnModel} colModel The new column model
612             */
613            'reconfigure',
614            /**
615             * @event viewready
616             * Fires when the grid view is available (use this for selecting a default row).
617             * @param {Grid} this
618             */
619            'viewready'
620        );
621    },
622
623    // private
624    onRender : function(ct, position){
625        Ext.grid.GridPanel.superclass.onRender.apply(this, arguments);
626
627        var c = this.getGridEl();
628
629        this.el.addClass('x-grid-panel');
630
631        this.mon(c, {
632            scope: this,
633            mousedown: this.onMouseDown,
634            click: this.onClick,
635            dblclick: this.onDblClick,
636            contextmenu: this.onContextMenu
637        });
638
639        this.relayEvents(c, ['mousedown','mouseup','mouseover','mouseout','keypress', 'keydown']);
640
641        var view = this.getView();
642        view.init(this);
643        view.render();
644        this.getSelectionModel().init(this);
645    },
646
647    // private
648    initEvents : function(){
649        Ext.grid.GridPanel.superclass.initEvents.call(this);
650
651        if(this.loadMask){
652            this.loadMask = new Ext.LoadMask(this.bwrap,
653                    Ext.apply({store:this.store}, this.loadMask));
654        }
655    },
656
657    initStateEvents : function(){
658        Ext.grid.GridPanel.superclass.initStateEvents.call(this);
659        this.mon(this.colModel, 'hiddenchange', this.saveState, this, {delay: 100});
660    },
661
662    applyState : function(state){
663        var cm = this.colModel,
664            cs = state.columns,
665            store = this.store,
666            s,
667            c,
668            colIndex;
669
670        if(cs){
671            for(var i = 0, len = cs.length; i < len; i++){
672                s = cs[i];
673                c = cm.getColumnById(s.id);
674                if(c){
675                    colIndex = cm.getIndexById(s.id);
676                    cm.setState(colIndex, {
677                        hidden: s.hidden,
678                        width: s.width,
679                        sortable: s.sortable
680                    });
681                    if(colIndex != i){
682                        cm.moveColumn(colIndex, i);
683                    }
684                }
685            }
686        }
687        if(store){
688            s = state.sort;
689            if(s){
690                store[store.remoteSort ? 'setDefaultSort' : 'sort'](s.field, s.direction);
691            }
692            s = state.group;
693            if(store.groupBy){
694                if(s){
695                    store.groupBy(s);
696                }else{
697                    store.clearGrouping();
698                }
699            }
700
701        }
702        var o = Ext.apply({}, state);
703        delete o.columns;
704        delete o.sort;
705        Ext.grid.GridPanel.superclass.applyState.call(this, o);
706    },
707
708    getState : function(){
709        var o = {columns: []},
710            store = this.store,
711            ss,
712            gs;
713
714        for(var i = 0, c; (c = this.colModel.config[i]); i++){
715            o.columns[i] = {
716                id: c.id,
717                width: c.width
718            };
719            if(c.hidden){
720                o.columns[i].hidden = true;
721            }
722            if(c.sortable){
723                o.columns[i].sortable = true;
724            }
725        }
726        if(store){
727            ss = store.getSortState();
728            if(ss){
729                o.sort = ss;
730            }
731            if(store.getGroupState){
732                gs = store.getGroupState();
733                if(gs){
734                    o.group = gs;
735                }
736            }
737        }
738        return o;
739    },
740
741    // private
742    afterRender : function(){
743        Ext.grid.GridPanel.superclass.afterRender.call(this);
744        var v = this.view;
745        this.on('bodyresize', v.layout, v);
746        v.layout(true);
747        if(this.deferRowRender){
748            if (!this.deferRowRenderTask){
749                this.deferRowRenderTask = new Ext.util.DelayedTask(v.afterRender, this.view);
750            }
751            this.deferRowRenderTask.delay(10);
752        }else{
753            v.afterRender();
754        }
755        this.viewReady = true;
756    },
757
758    /**
759     * <p>Reconfigures the grid to use a different Store and Column Model
760     * and fires the 'reconfigure' event. The View will be bound to the new
761     * objects and refreshed.</p>
762     * <p>Be aware that upon reconfiguring a GridPanel, certain existing settings <i>may</i> become
763     * invalidated. For example the configured {@link #autoExpandColumn} may no longer exist in the
764     * new ColumnModel. Also, an existing {@link Ext.PagingToolbar PagingToolbar} will still be bound
765     * to the old Store, and will need rebinding. Any {@link #plugins} might also need reconfiguring
766     * with the new data.</p>
767     * @param {Ext.data.Store} store The new {@link Ext.data.Store} object
768     * @param {Ext.grid.ColumnModel} colModel The new {@link Ext.grid.ColumnModel} object
769     */
770    reconfigure : function(store, colModel){
771        var rendered = this.rendered;
772        if(rendered){
773            if(this.loadMask){
774                this.loadMask.destroy();
775                this.loadMask = new Ext.LoadMask(this.bwrap,
776                        Ext.apply({}, {store:store}, this.initialConfig.loadMask));
777            }
778        }
779        if(this.view){
780            this.view.initData(store, colModel);
781        }
782        this.store = store;
783        this.colModel = colModel;
784        if(rendered){
785            this.view.refresh(true);
786        }
787        this.fireEvent('reconfigure', this, store, colModel);
788    },
789
790    // private
791    onDestroy : function(){
792        if (this.deferRowRenderTask && this.deferRowRenderTask.cancel){
793            this.deferRowRenderTask.cancel();
794        }
795        if(this.rendered){
796            Ext.destroy(this.view, this.loadMask);
797        }else if(this.store && this.store.autoDestroy){
798            this.store.destroy();
799        }
800        Ext.destroy(this.colModel, this.selModel);
801        this.store = this.selModel = this.colModel = this.view = this.loadMask = null;
802        Ext.grid.GridPanel.superclass.onDestroy.call(this);
803    },
804
805    // private
806    processEvent : function(name, e){
807        this.view.processEvent(name, e);
808    },
809
810    // private
811    onClick : function(e){
812        this.processEvent('click', e);
813    },
814
815    // private
816    onMouseDown : function(e){
817        this.processEvent('mousedown', e);
818    },
819
820    // private
821    onContextMenu : function(e, t){
822        this.processEvent('contextmenu', e);
823    },
824
825    // private
826    onDblClick : function(e){
827        this.processEvent('dblclick', e);
828    },
829
830    // private
831    walkCells : function(row, col, step, fn, scope){
832        var cm    = this.colModel,
833            clen  = cm.getColumnCount(),
834            ds    = this.store,
835            rlen  = ds.getCount(),
836            first = true;
837
838        if(step < 0){
839            if(col < 0){
840                row--;
841                first = false;
842            }
843            while(row >= 0){
844                if(!first){
845                    col = clen-1;
846                }
847                first = false;
848                while(col >= 0){
849                    if(fn.call(scope || this, row, col, cm) === true){
850                        return [row, col];
851                    }
852                    col--;
853                }
854                row--;
855            }
856        } else {
857            if(col >= clen){
858                row++;
859                first = false;
860            }
861            while(row < rlen){
862                if(!first){
863                    col = 0;
864                }
865                first = false;
866                while(col < clen){
867                    if(fn.call(scope || this, row, col, cm) === true){
868                        return [row, col];
869                    }
870                    col++;
871                }
872                row++;
873            }
874        }
875        return null;
876    },
877
878    /**
879     * Returns the grid's underlying element.
880     * @return {Element} The element
881     */
882    getGridEl : function(){
883        return this.body;
884    },
885
886    // private for compatibility, overridden by editor grid
887    stopEditing : Ext.emptyFn,
888
889    /**
890     * Returns the grid's selection model configured by the <code>{@link #selModel}</code>
891     * configuration option. If no selection model was configured, this will create
892     * and return a {@link Ext.grid.RowSelectionModel RowSelectionModel}.
893     * @return {SelectionModel}
894     */
895    getSelectionModel : function(){
896        if(!this.selModel){
897            this.selModel = new Ext.grid.RowSelectionModel(
898                    this.disableSelection ? {selectRow: Ext.emptyFn} : null);
899        }
900        return this.selModel;
901    },
902
903    /**
904     * Returns the grid's data store.
905     * @return {Ext.data.Store} The store
906     */
907    getStore : function(){
908        return this.store;
909    },
910
911    /**
912     * Returns the grid's ColumnModel.
913     * @return {Ext.grid.ColumnModel} The column model
914     */
915    getColumnModel : function(){
916        return this.colModel;
917    },
918
919    /**
920     * Returns the grid's GridView object.
921     * @return {Ext.grid.GridView} The grid view
922     */
923    getView : function() {
924        if (!this.view) {
925            this.view = new Ext.grid.GridView(this.viewConfig);
926        }
927       
928        return this.view;
929    },
930    /**
931     * Called to get grid's drag proxy text, by default returns this.ddText.
932     * @return {String} The text
933     */
934    getDragDropText : function(){
935        var count = this.selModel.getCount();
936        return String.format(this.ddText, count, count == 1 ? '' : 's');
937    }
938
939    /**
940     * @cfg {String/Number} activeItem
941     * @hide
942     */
943    /**
944     * @cfg {Boolean} autoDestroy
945     * @hide
946     */
947    /**
948     * @cfg {Object/String/Function} autoLoad
949     * @hide
950     */
951    /**
952     * @cfg {Boolean} autoWidth
953     * @hide
954     */
955    /**
956     * @cfg {Boolean/Number} bufferResize
957     * @hide
958     */
959    /**
960     * @cfg {String} defaultType
961     * @hide
962     */
963    /**
964     * @cfg {Object} defaults
965     * @hide
966     */
967    /**
968     * @cfg {Boolean} hideBorders
969     * @hide
970     */
971    /**
972     * @cfg {Mixed} items
973     * @hide
974     */
975    /**
976     * @cfg {String} layout
977     * @hide
978     */
979    /**
980     * @cfg {Object} layoutConfig
981     * @hide
982     */
983    /**
984     * @cfg {Boolean} monitorResize
985     * @hide
986     */
987    /**
988     * @property items
989     * @hide
990     */
991    /**
992     * @method add
993     * @hide
994     */
995    /**
996     * @method cascade
997     * @hide
998     */
999    /**
1000     * @method doLayout
1001     * @hide
1002     */
1003    /**
1004     * @method find
1005     * @hide
1006     */
1007    /**
1008     * @method findBy
1009     * @hide
1010     */
1011    /**
1012     * @method findById
1013     * @hide
1014     */
1015    /**
1016     * @method findByType
1017     * @hide
1018     */
1019    /**
1020     * @method getComponent
1021     * @hide
1022     */
1023    /**
1024     * @method getLayout
1025     * @hide
1026     */
1027    /**
1028     * @method getUpdater
1029     * @hide
1030     */
1031    /**
1032     * @method insert
1033     * @hide
1034     */
1035    /**
1036     * @method load
1037     * @hide
1038     */
1039    /**
1040     * @method remove
1041     * @hide
1042     */
1043    /**
1044     * @event add
1045     * @hide
1046     */
1047    /**
1048     * @event afterlayout
1049     * @hide
1050     */
1051    /**
1052     * @event beforeadd
1053     * @hide
1054     */
1055    /**
1056     * @event beforeremove
1057     * @hide
1058     */
1059    /**
1060     * @event remove
1061     * @hide
1062     */
1063
1064
1065
1066    /**
1067     * @cfg {String} allowDomMove  @hide
1068     */
1069    /**
1070     * @cfg {String} autoEl @hide
1071     */
1072    /**
1073     * @cfg {String} applyTo  @hide
1074     */
1075    /**
1076     * @cfg {String} autoScroll  @hide
1077     */
1078    /**
1079     * @cfg {String} bodyBorder  @hide
1080     */
1081    /**
1082     * @cfg {String} bodyStyle  @hide
1083     */
1084    /**
1085     * @cfg {String} contentEl  @hide
1086     */
1087    /**
1088     * @cfg {String} disabledClass  @hide
1089     */
1090    /**
1091     * @cfg {String} elements  @hide
1092     */
1093    /**
1094     * @cfg {String} html  @hide
1095     */
1096    /**
1097     * @cfg {Boolean} preventBodyReset
1098     * @hide
1099     */
1100    /**
1101     * @property disabled
1102     * @hide
1103     */
1104    /**
1105     * @method applyToMarkup
1106     * @hide
1107     */
1108    /**
1109     * @method enable
1110     * @hide
1111     */
1112    /**
1113     * @method disable
1114     * @hide
1115     */
1116    /**
1117     * @method setDisabled
1118     * @hide
1119     */
1120});
1121Ext.reg('grid', Ext.grid.GridPanel);/**
1122 * @class Ext.grid.PivotGrid
1123 * @extends Ext.grid.GridPanel
1124 * <p>The PivotGrid component enables rapid summarization of large data sets. It provides a way to reduce a large set of
1125 * data down into a format where trends and insights become more apparent. A classic example is in sales data; a company
1126 * will often have a record of all sales it makes for a given period - this will often encompass thousands of rows of
1127 * data. The PivotGrid allows you to see how well each salesperson performed, which cities generate the most revenue,
1128 * how products perform between cities and so on.</p>
1129 * <p>A PivotGrid is composed of two axes (left and top), one {@link #measure} and one {@link #aggregator aggregation}
1130 * function. Each axis can contain one or more {@link #dimension}, which are ordered into a hierarchy. Dimensions on the
1131 * left axis can also specify a width. Each dimension in each axis can specify its sort ordering, defaulting to "ASC",
1132 * and must specify one of the fields in the {@link Ext.data.Record Record} used by the PivotGrid's
1133 * {@link Ext.data.Store Store}.</p>
1134<pre><code>
1135// This is the record representing a single sale
1136var SaleRecord = Ext.data.Record.create([
1137    {name: 'person',   type: 'string'},
1138    {name: 'product',  type: 'string'},
1139    {name: 'city',     type: 'string'},
1140    {name: 'state',    type: 'string'},
1141    {name: 'year',     type: 'int'},
1142    {name: 'value',    type: 'int'}
1143]);
1144
1145// A simple store that loads SaleRecord data from a url
1146var myStore = new Ext.data.Store({
1147    url: 'data.json',
1148    autoLoad: true,
1149    reader: new Ext.data.JsonReader({
1150        root: 'rows',
1151        idProperty: 'id'
1152    }, SaleRecord)
1153});
1154
1155// Create the PivotGrid itself, referencing the store
1156var pivot = new Ext.grid.PivotGrid({
1157    store     : myStore,
1158    aggregator: 'sum',
1159    measure   : 'value',
1160
1161    leftAxis: [
1162        {
1163            width: 60,
1164            dataIndex: 'product'
1165        },
1166        {
1167            width: 120,
1168            dataIndex: 'person',
1169            direction: 'DESC'
1170        }
1171    ],
1172
1173    topAxis: [
1174        {
1175            dataIndex: 'year'
1176        }
1177    ]
1178});
1179</code></pre>
1180 * <p>The specified {@link #measure} is the field from SaleRecord that is extracted from each combination
1181 * of product and person (on the left axis) and year on the top axis. There may be several SaleRecords in the
1182 * data set that share this combination, so an array of measure fields is produced. This array is then
1183 * aggregated using the {@link #aggregator} function.</p>
1184 * <p>The default aggregator function is sum, which simply adds up all of the extracted measure values. Other
1185 * built-in aggregator functions are count, avg, min and max. In addition, you can specify your own function.
1186 * In this example we show the code used to sum the measures, but you can return any value you like. See
1187 * {@link #aggregator} for more details.</p>
1188<pre><code>
1189new Ext.grid.PivotGrid({
1190    aggregator: function(records, measure) {
1191        var length = records.length,
1192            total  = 0,
1193            i;
1194
1195        for (i = 0; i < length; i++) {
1196            total += records[i].get(measure);
1197        }
1198
1199        return total;
1200    },
1201   
1202    renderer: function(value) {
1203        return Math.round(value);
1204    },
1205   
1206    //your normal config here
1207});
1208</code></pre>
1209 * <p><u>Renderers</u></p>
1210 * <p>PivotGrid optionally accepts a {@link #renderer} function which can modify the data in each cell before it
1211 * is rendered. The renderer is passed the value that would usually be placed in the cell and is expected to return
1212 * the new value. For example let's imagine we had height data expressed as a decimal - here's how we might use a
1213 * renderer to display the data in feet and inches notation:</p>
1214<pre><code>
1215new Ext.grid.PivotGrid({
1216    //in each case the value is a decimal number of feet
1217    renderer  : function(value) {
1218        var feet   = Math.floor(value),
1219            inches = Math.round((value - feet) * 12);
1220
1221        return String.format("{0}' {1}\"", feet, inches);
1222    },
1223    //normal config here
1224});
1225</code></pre>
1226 * <p><u>Reconfiguring</u></p>
1227 * <p>All aspects PivotGrid's configuration can be updated at runtime. It is easy to change the {@link #setMeasure measure},
1228 * {@link #setAggregator aggregation function}, {@link #setLeftAxis left} and {@link #setTopAxis top} axes and refresh the grid.</p>
1229 * <p>In this case we reconfigure the PivotGrid to have city and year as the top axis dimensions, rendering the average sale
1230 * value into the cells:</p>
1231<pre><code>
1232//the left axis can also be changed
1233pivot.topAxis.setDimensions([
1234    {dataIndex: 'city', direction: 'DESC'},
1235    {dataIndex: 'year', direction: 'ASC'}
1236]);
1237
1238pivot.setMeasure('value');
1239pivot.setAggregator('avg');
1240
1241pivot.view.refresh(true);
1242</code></pre>
1243 * <p>See the {@link Ext.grid.PivotAxis PivotAxis} documentation for further detail on reconfiguring axes.</p>
1244 */
1245Ext.grid.PivotGrid = Ext.extend(Ext.grid.GridPanel, {
1246   
1247    /**
1248     * @cfg {String|Function} aggregator The aggregation function to use to combine the measures extracted
1249     * for each dimension combination. Can be any of the built-in aggregators (sum, count, avg, min, max).
1250     * Can also be a function which accepts two arguments (an array of Records to aggregate, and the measure
1251     * to aggregate them on) and should return a String.
1252     */
1253    aggregator: 'sum',
1254   
1255    /**
1256     * @cfg {Function} renderer Optional renderer to pass values through before they are rendered to the dom. This
1257     * gives an opportunity to modify cell contents after the value has been computed.
1258     */
1259    renderer: undefined,
1260   
1261    /**
1262     * @cfg {String} measure The field to extract from each Record when pivoting around the two axes. See the class
1263     * introduction docs for usage
1264     */
1265   
1266    /**
1267     * @cfg {Array|Ext.grid.PivotAxis} leftAxis Either and array of {@link #dimension} to use on the left axis, or
1268     * a {@link Ext.grid.PivotAxis} instance. If an array is passed, it is turned into a PivotAxis internally.
1269     */
1270   
1271    /**
1272     * @cfg {Array|Ext.grid.PivotAxis} topAxis Either and array of {@link #dimension} to use on the top axis, or
1273     * a {@link Ext.grid.PivotAxis} instance. If an array is passed, it is turned into a PivotAxis internally.
1274     */
1275   
1276    //inherit docs
1277    initComponent: function() {
1278        Ext.grid.PivotGrid.superclass.initComponent.apply(this, arguments);
1279       
1280        this.initAxes();
1281       
1282        //no resizing of columns is allowed yet in PivotGrid
1283        this.enableColumnResize = false;
1284       
1285        this.viewConfig = Ext.apply(this.viewConfig || {}, {
1286            forceFit: true
1287        });
1288       
1289        //TODO: dummy col model that is never used - GridView is too tightly integrated with ColumnModel
1290        //in 3.x to remove this altogether.
1291        this.colModel = new Ext.grid.ColumnModel({});
1292    },
1293   
1294    /**
1295     * Returns the function currently used to aggregate the records in each Pivot cell
1296     * @return {Function} The current aggregator function
1297     */
1298    getAggregator: function() {
1299        if (typeof this.aggregator == 'string') {
1300            return Ext.grid.PivotAggregatorMgr.types[this.aggregator];
1301        } else {
1302            return this.aggregator;
1303        }
1304    },
1305   
1306    /**
1307     * Sets the function to use when aggregating data for each cell.
1308     * @param {String|Function} aggregator The new aggregator function or named function string
1309     */
1310    setAggregator: function(aggregator) {
1311        this.aggregator = aggregator;
1312    },
1313   
1314    /**
1315     * Sets the field name to use as the Measure in this Pivot Grid
1316     * @param {String} measure The field to make the measure
1317     */
1318    setMeasure: function(measure) {
1319        this.measure = measure;
1320    },
1321   
1322    /**
1323     * Sets the left axis of this pivot grid. Optionally refreshes the grid afterwards.
1324     * @param {Ext.grid.PivotAxis} axis The pivot axis
1325     * @param {Boolean} refresh True to immediately refresh the grid and its axes (defaults to false)
1326     */
1327    setLeftAxis: function(axis, refresh) {
1328        /**
1329         * The configured {@link Ext.grid.PivotAxis} used as the left Axis for this Pivot Grid
1330         * @property leftAxis
1331         * @type Ext.grid.PivotAxis
1332         */
1333        this.leftAxis = axis;
1334       
1335        if (refresh) {
1336            this.view.refresh();
1337        }
1338    },
1339   
1340    /**
1341     * Sets the top axis of this pivot grid. Optionally refreshes the grid afterwards.
1342     * @param {Ext.grid.PivotAxis} axis The pivot axis
1343     * @param {Boolean} refresh True to immediately refresh the grid and its axes (defaults to false)
1344     */
1345    setTopAxis: function(axis, refresh) {
1346        /**
1347         * The configured {@link Ext.grid.PivotAxis} used as the top Axis for this Pivot Grid
1348         * @property topAxis
1349         * @type Ext.grid.PivotAxis
1350         */
1351        this.topAxis = axis;
1352       
1353        if (refresh) {
1354            this.view.refresh();
1355        }
1356    },
1357   
1358    /**
1359     * @private
1360     * Creates the top and left axes. Should usually only need to be called once from initComponent
1361     */
1362    initAxes: function() {
1363        var PivotAxis = Ext.grid.PivotAxis;
1364       
1365        if (!(this.leftAxis instanceof PivotAxis)) {
1366            this.setLeftAxis(new PivotAxis({
1367                orientation: 'vertical',
1368                dimensions : this.leftAxis || [],
1369                store      : this.store
1370            }));
1371        };
1372       
1373        if (!(this.topAxis instanceof PivotAxis)) {
1374            this.setTopAxis(new PivotAxis({
1375                orientation: 'horizontal',
1376                dimensions : this.topAxis || [],
1377                store      : this.store
1378            }));
1379        };
1380    },
1381   
1382    /**
1383     * @private
1384     * @return {Array} 2-dimensional array of cell data
1385     */
1386    extractData: function() {
1387        var records  = this.store.data.items,
1388            recCount = records.length,
1389            cells    = [],
1390            record, i, j, k;
1391       
1392        if (recCount == 0) {
1393            return [];
1394        }
1395       
1396        var leftTuples = this.leftAxis.getTuples(),
1397            leftCount  = leftTuples.length,
1398            topTuples  = this.topAxis.getTuples(),
1399            topCount   = topTuples.length,
1400            aggregator = this.getAggregator();
1401       
1402        for (i = 0; i < recCount; i++) {
1403            record = records[i];
1404           
1405            for (j = 0; j < leftCount; j++) {
1406                cells[j] = cells[j] || [];
1407               
1408                if (leftTuples[j].matcher(record) === true) {
1409                    for (k = 0; k < topCount; k++) {
1410                        cells[j][k] = cells[j][k] || [];
1411                       
1412                        if (topTuples[k].matcher(record)) {
1413                            cells[j][k].push(record);
1414                        }
1415                    }
1416                }
1417            }
1418        }
1419       
1420        var rowCount = cells.length,
1421            colCount, row;
1422       
1423        for (i = 0; i < rowCount; i++) {
1424            row = cells[i];
1425            colCount = row.length;
1426           
1427            for (j = 0; j < colCount; j++) {
1428                cells[i][j] = aggregator(cells[i][j], this.measure);
1429            }
1430        }
1431       
1432        return cells;
1433    },
1434   
1435    /**
1436     * Returns the grid's GridView object.
1437     * @return {Ext.grid.PivotGridView} The grid view
1438     */
1439    getView: function() {
1440        if (!this.view) {
1441            this.view = new Ext.grid.PivotGridView(this.viewConfig);
1442        }
1443       
1444        return this.view;
1445    }
1446});
1447
1448Ext.reg('pivotgrid', Ext.grid.PivotGrid);
1449
1450
1451Ext.grid.PivotAggregatorMgr = new Ext.AbstractManager();
1452
1453Ext.grid.PivotAggregatorMgr.registerType('sum', function(records, measure) {
1454    var length = records.length,
1455        total  = 0,
1456        i;
1457   
1458    for (i = 0; i < length; i++) {
1459        total += records[i].get(measure);
1460    }
1461   
1462    return total;
1463});
1464
1465Ext.grid.PivotAggregatorMgr.registerType('avg', function(records, measure) {
1466    var length = records.length,
1467        total  = 0,
1468        i;
1469   
1470    for (i = 0; i < length; i++) {
1471        total += records[i].get(measure);
1472    }
1473   
1474    return (total / length) || 'n/a';
1475});
1476
1477Ext.grid.PivotAggregatorMgr.registerType('min', function(records, measure) {
1478    var data   = [],
1479        length = records.length,
1480        i;
1481   
1482    for (i = 0; i < length; i++) {
1483        data.push(records[i].get(measure));
1484    }
1485   
1486    return Math.min.apply(this, data) || 'n/a';
1487});
1488
1489Ext.grid.PivotAggregatorMgr.registerType('max', function(records, measure) {
1490    var data   = [],
1491        length = records.length,
1492        i;
1493   
1494    for (i = 0; i < length; i++) {
1495        data.push(records[i].get(measure));
1496    }
1497   
1498    return Math.max.apply(this, data) || 'n/a';
1499});
1500
1501Ext.grid.PivotAggregatorMgr.registerType('count', function(records, measure) {
1502    return records.length;
1503});/**
1504 * @class Ext.grid.GridView
1505 * @extends Ext.util.Observable
1506 * <p>This class encapsulates the user interface of an {@link Ext.grid.GridPanel}.
1507 * Methods of this class may be used to access user interface elements to enable
1508 * special display effects. Do not change the DOM structure of the user interface.</p>
1509 * <p>This class does not provide ways to manipulate the underlying data. The data
1510 * model of a Grid is held in an {@link Ext.data.Store}.</p>
1511 * @constructor
1512 * @param {Object} config
1513 */
1514Ext.grid.GridView = Ext.extend(Ext.util.Observable, {
1515    /**
1516     * Override this function to apply custom CSS classes to rows during rendering.  You can also supply custom
1517     * parameters to the row template for the current row to customize how it is rendered using the <b>rowParams</b>
1518     * parameter.  This function should return the CSS class name (or empty string '' for none) that will be added
1519     * to the row's wrapping div.  To apply multiple class names, simply return them space-delimited within the string
1520     * (e.g., 'my-class another-class'). Example usage:
1521    <pre><code>
1522viewConfig: {
1523    forceFit: true,
1524    showPreview: true, // custom property
1525    enableRowBody: true, // required to create a second, full-width row to show expanded Record data
1526    getRowClass: function(record, rowIndex, rp, ds){ // rp = rowParams
1527        if(this.showPreview){
1528            rp.body = '&lt;p>'+record.data.excerpt+'&lt;/p>';
1529            return 'x-grid3-row-expanded';
1530        }
1531        return 'x-grid3-row-collapsed';
1532    }
1533},
1534    </code></pre>
1535     * @param {Record} record The {@link Ext.data.Record} corresponding to the current row.
1536     * @param {Number} index The row index.
1537     * @param {Object} rowParams A config object that is passed to the row template during rendering that allows
1538     * customization of various aspects of a grid row.
1539     * <p>If {@link #enableRowBody} is configured <b><tt></tt>true</b>, then the following properties may be set
1540     * by this function, and will be used to render a full-width expansion row below each grid row:</p>
1541     * <ul>
1542     * <li><code>body</code> : String <div class="sub-desc">An HTML fragment to be used as the expansion row's body content (defaults to '').</div></li>
1543     * <li><code>bodyStyle</code> : String <div class="sub-desc">A CSS style specification that will be applied to the expansion row's &lt;tr> element. (defaults to '').</div></li>
1544     * </ul>
1545     * The following property will be passed in, and may be appended to:
1546     * <ul>
1547     * <li><code>tstyle</code> : String <div class="sub-desc">A CSS style specification that willl be applied to the &lt;table> element which encapsulates
1548     * both the standard grid row, and any expansion row.</div></li>
1549     * </ul>
1550     * @param {Store} store The {@link Ext.data.Store} this grid is bound to
1551     * @method getRowClass
1552     * @return {String} a CSS class name to add to the row.
1553     */
1554
1555    /**
1556     * @cfg {Boolean} enableRowBody True to add a second TR element per row that can be used to provide a row body
1557     * that spans beneath the data row.  Use the {@link #getRowClass} method's rowParams config to customize the row body.
1558     */
1559
1560    /**
1561     * @cfg {String} emptyText Default text (html tags are accepted) to display in the grid body when no rows
1562     * are available (defaults to ''). This value will be used to update the <tt>{@link #mainBody}</tt>:
1563    <pre><code>
1564    this.mainBody.update('&lt;div class="x-grid-empty">' + this.emptyText + '&lt;/div>');
1565    </code></pre>
1566     */
1567
1568    /**
1569     * @cfg {Boolean} headersDisabled True to disable the grid column headers (defaults to <tt>false</tt>).
1570     * Use the {@link Ext.grid.ColumnModel ColumnModel} <tt>{@link Ext.grid.ColumnModel#menuDisabled menuDisabled}</tt>
1571     * config to disable the <i>menu</i> for individual columns.  While this config is true the
1572     * following will be disabled:<div class="mdetail-params"><ul>
1573     * <li>clicking on header to sort</li>
1574     * <li>the trigger to reveal the menu.</li>
1575     * </ul></div>
1576     */
1577
1578    /**
1579     * <p>A customized implementation of a {@link Ext.dd.DragZone DragZone} which provides default implementations
1580     * of the template methods of DragZone to enable dragging of the selected rows of a GridPanel.
1581     * See {@link Ext.grid.GridDragZone} for details.</p>
1582     * <p>This will <b>only</b> be present:<div class="mdetail-params"><ul>
1583     * <li><i>if</i> the owning GridPanel was configured with {@link Ext.grid.GridPanel#enableDragDrop enableDragDrop}: <tt>true</tt>.</li>
1584     * <li><i>after</i> the owning GridPanel has been rendered.</li>
1585     * </ul></div>
1586     * @property dragZone
1587     * @type {Ext.grid.GridDragZone}
1588     */
1589
1590    /**
1591     * @cfg {Boolean} deferEmptyText True to defer <tt>{@link #emptyText}</tt> being applied until the store's
1592     * first load (defaults to <tt>true</tt>).
1593     */
1594    deferEmptyText : true,
1595
1596    /**
1597     * @cfg {Number} scrollOffset The amount of space to reserve for the vertical scrollbar
1598     * (defaults to <tt>undefined</tt>). If an explicit value isn't specified, this will be automatically
1599     * calculated.
1600     */
1601    scrollOffset : undefined,
1602
1603    /**
1604     * @cfg {Boolean} autoFill
1605     * Defaults to <tt>false</tt>.  Specify <tt>true</tt> to have the column widths re-proportioned
1606     * when the grid is <b>initially rendered</b>.  The
1607     * {@link Ext.grid.Column#width initially configured width}</tt> of each column will be adjusted
1608     * to fit the grid width and prevent horizontal scrolling. If columns are later resized (manually
1609     * or programmatically), the other columns in the grid will <b>not</b> be resized to fit the grid width.
1610     * See <tt>{@link #forceFit}</tt> also.
1611     */
1612    autoFill : false,
1613
1614    /**
1615     * @cfg {Boolean} forceFit
1616     * <p>Defaults to <tt>false</tt>.  Specify <tt>true</tt> to have the column widths re-proportioned
1617     * at <b>all times</b>.</p>
1618     * <p>The {@link Ext.grid.Column#width initially configured width}</tt> of each
1619     * column will be adjusted to fit the grid width and prevent horizontal scrolling. If columns are
1620     * later resized (manually or programmatically), the other columns in the grid <b>will</b> be resized
1621     * to fit the grid width.</p>
1622     * <p>Columns which are configured with <code>fixed: true</code> are omitted from being resized.</p>
1623     * <p>See <tt>{@link #autoFill}</tt>.</p>
1624     */
1625    forceFit : false,
1626
1627    /**
1628     * @cfg {Array} sortClasses The CSS classes applied to a header when it is sorted. (defaults to <tt>['sort-asc', 'sort-desc']</tt>)
1629     */
1630    sortClasses : ['sort-asc', 'sort-desc'],
1631
1632    /**
1633     * @cfg {String} sortAscText The text displayed in the 'Sort Ascending' menu item (defaults to <tt>'Sort Ascending'</tt>)
1634     */
1635    sortAscText : 'Sort Ascending',
1636
1637    /**
1638     * @cfg {String} sortDescText The text displayed in the 'Sort Descending' menu item (defaults to <tt>'Sort Descending'</tt>)
1639     */
1640    sortDescText : 'Sort Descending',
1641
1642    /**
1643     * @cfg {String} columnsText The text displayed in the 'Columns' menu item (defaults to <tt>'Columns'</tt>)
1644     */
1645    columnsText : 'Columns',
1646
1647    /**
1648     * @cfg {String} selectedRowClass The CSS class applied to a selected row (defaults to <tt>'x-grid3-row-selected'</tt>). An
1649     * example overriding the default styling:
1650    <pre><code>
1651    .x-grid3-row-selected {background-color: yellow;}
1652    </code></pre>
1653     * Note that this only controls the row, and will not do anything for the text inside it.  To style inner
1654     * facets (like text) use something like:
1655    <pre><code>
1656    .x-grid3-row-selected .x-grid3-cell-inner {
1657        color: #FFCC00;
1658    }
1659    </code></pre>
1660     * @type String
1661     */
1662    selectedRowClass : 'x-grid3-row-selected',
1663
1664    // private
1665    borderWidth : 2,
1666    tdClass : 'x-grid3-cell',
1667    hdCls : 'x-grid3-hd',
1668   
1669   
1670    /**
1671     * @cfg {Boolean} markDirty True to show the dirty cell indicator when a cell has been modified. Defaults to <tt>true</tt>.
1672     */
1673    markDirty : true,
1674
1675    /**
1676     * @cfg {Number} cellSelectorDepth The number of levels to search for cells in event delegation (defaults to <tt>4</tt>)
1677     */
1678    cellSelectorDepth : 4,
1679   
1680    /**
1681     * @cfg {Number} rowSelectorDepth The number of levels to search for rows in event delegation (defaults to <tt>10</tt>)
1682     */
1683    rowSelectorDepth : 10,
1684
1685    /**
1686     * @cfg {Number} rowBodySelectorDepth The number of levels to search for row bodies in event delegation (defaults to <tt>10</tt>)
1687     */
1688    rowBodySelectorDepth : 10,
1689
1690    /**
1691     * @cfg {String} cellSelector The selector used to find cells internally (defaults to <tt>'td.x-grid3-cell'</tt>)
1692     */
1693    cellSelector : 'td.x-grid3-cell',
1694   
1695    /**
1696     * @cfg {String} rowSelector The selector used to find rows internally (defaults to <tt>'div.x-grid3-row'</tt>)
1697     */
1698    rowSelector : 'div.x-grid3-row',
1699
1700    /**
1701     * @cfg {String} rowBodySelector The selector used to find row bodies internally (defaults to <tt>'div.x-grid3-row'</tt>)
1702     */
1703    rowBodySelector : 'div.x-grid3-row-body',
1704
1705    // private
1706    firstRowCls: 'x-grid3-row-first',
1707    lastRowCls: 'x-grid3-row-last',
1708    rowClsRe: /(?:^|\s+)x-grid3-row-(first|last|alt)(?:\s+|$)/g,
1709   
1710    /**
1711     * @cfg {String} headerMenuOpenCls The CSS class to add to the header cell when its menu is visible. Defaults to 'x-grid3-hd-menu-open'
1712     */
1713    headerMenuOpenCls: 'x-grid3-hd-menu-open',
1714   
1715    /**
1716     * @cfg {String} rowOverCls The CSS class added to each row when it is hovered over. Defaults to 'x-grid3-row-over'
1717     */
1718    rowOverCls: 'x-grid3-row-over',
1719
1720    constructor : function(config) {
1721        Ext.apply(this, config);
1722       
1723        // These events are only used internally by the grid components
1724        this.addEvents(
1725            /**
1726             * @event beforerowremoved
1727             * Internal UI Event. Fired before a row is removed.
1728             * @param {Ext.grid.GridView} view
1729             * @param {Number} rowIndex The index of the row to be removed.
1730             * @param {Ext.data.Record} record The Record to be removed
1731             */
1732            'beforerowremoved',
1733           
1734            /**
1735             * @event beforerowsinserted
1736             * Internal UI Event. Fired before rows are inserted.
1737             * @param {Ext.grid.GridView} view
1738             * @param {Number} firstRow The index of the first row to be inserted.
1739             * @param {Number} lastRow The index of the last row to be inserted.
1740             */
1741            'beforerowsinserted',
1742           
1743            /**
1744             * @event beforerefresh
1745             * Internal UI Event. Fired before the view is refreshed.
1746             * @param {Ext.grid.GridView} view
1747             */
1748            'beforerefresh',
1749           
1750            /**
1751             * @event rowremoved
1752             * Internal UI Event. Fired after a row is removed.
1753             * @param {Ext.grid.GridView} view
1754             * @param {Number} rowIndex The index of the row that was removed.
1755             * @param {Ext.data.Record} record The Record that was removed
1756             */
1757            'rowremoved',
1758           
1759            /**
1760             * @event rowsinserted
1761             * Internal UI Event. Fired after rows are inserted.
1762             * @param {Ext.grid.GridView} view
1763             * @param {Number} firstRow The index of the first inserted.
1764             * @param {Number} lastRow The index of the last row inserted.
1765             */
1766            'rowsinserted',
1767           
1768            /**
1769             * @event rowupdated
1770             * Internal UI Event. Fired after a row has been updated.
1771             * @param {Ext.grid.GridView} view
1772             * @param {Number} firstRow The index of the row updated.
1773             * @param {Ext.data.record} record The Record backing the row updated.
1774             */
1775            'rowupdated',
1776           
1777            /**
1778             * @event refresh
1779             * Internal UI Event. Fired after the GridView's body has been refreshed.
1780             * @param {Ext.grid.GridView} view
1781             */
1782            'refresh'
1783        );
1784       
1785        Ext.grid.GridView.superclass.constructor.call(this);
1786    },
1787
1788    /* -------------------------------- UI Specific ----------------------------- */
1789   
1790    /**
1791     * The master template to use when rendering the GridView. Has a default template
1792     * @property Ext.Template
1793     * @type masterTpl
1794     */
1795    masterTpl: new Ext.Template(
1796        '<div class="x-grid3" hidefocus="true">',
1797            '<div class="x-grid3-viewport">',
1798                '<div class="x-grid3-header">',
1799                    '<div class="x-grid3-header-inner">',
1800                        '<div class="x-grid3-header-offset" style="{ostyle}">{header}</div>',
1801                    '</div>',
1802                    '<div class="x-clear"></div>',
1803                '</div>',
1804                '<div class="x-grid3-scroller">',
1805                    '<div class="x-grid3-body" style="{bstyle}">{body}</div>',
1806                    '<a href="#" class="x-grid3-focus" tabIndex="-1"></a>',
1807                '</div>',
1808            '</div>',
1809            '<div class="x-grid3-resize-marker">&#160;</div>',
1810            '<div class="x-grid3-resize-proxy">&#160;</div>',
1811        '</div>'
1812    ),
1813   
1814    /**
1815     * The template to use when rendering headers. Has a default template
1816     * @property headerTpl
1817     * @type Ext.Template
1818     */
1819    headerTpl: new Ext.Template(
1820        '<table border="0" cellspacing="0" cellpadding="0" style="{tstyle}">',
1821            '<thead>',
1822                '<tr class="x-grid3-hd-row">{cells}</tr>',
1823            '</thead>',
1824        '</table>'
1825    ),
1826   
1827    /**
1828     * The template to use when rendering the body. Has a default template
1829     * @property bodyTpl
1830     * @type Ext.Template
1831     */
1832    bodyTpl: new Ext.Template('{rows}'),
1833   
1834    /**
1835     * The template to use to render each cell. Has a default template
1836     * @property cellTpl
1837     * @type Ext.Template
1838     */
1839    cellTpl: new Ext.Template(
1840        '<td class="x-grid3-col x-grid3-cell x-grid3-td-{id} {css}" style="{style}" tabIndex="0" {cellAttr}>',
1841            '<div class="x-grid3-cell-inner x-grid3-col-{id}" unselectable="on" {attr}>{value}</div>',
1842        '</td>'
1843    ),
1844   
1845    /**
1846     * @private
1847     * Provides default templates if they are not given for this particular instance. Most of the templates are defined on
1848     * the prototype, the ones defined inside this function are done so because they are based on Grid or GridView configuration
1849     */
1850    initTemplates : function() {
1851        var templates = this.templates || {},
1852            template, name,
1853           
1854            headerCellTpl = new Ext.Template(
1855                '<td class="x-grid3-hd x-grid3-cell x-grid3-td-{id} {css}" style="{style}">',
1856                    '<div {tooltip} {attr} class="x-grid3-hd-inner x-grid3-hd-{id}" unselectable="on" style="{istyle}">', 
1857                        this.grid.enableHdMenu ? '<a class="x-grid3-hd-btn" href="#"></a>' : '',
1858                        '{value}',
1859                        '<img alt="" class="x-grid3-sort-icon" src="', Ext.BLANK_IMAGE_URL, '" />',
1860                    '</div>',
1861                '</td>'
1862            ),
1863       
1864            rowBodyText = [
1865                '<tr class="x-grid3-row-body-tr" style="{bodyStyle}">',
1866                    '<td colspan="{cols}" class="x-grid3-body-cell" tabIndex="0" hidefocus="on">',
1867                        '<div class="x-grid3-row-body">{body}</div>',
1868                    '</td>',
1869                '</tr>'
1870            ].join(""),
1871       
1872            innerText = [
1873                '<table class="x-grid3-row-table" border="0" cellspacing="0" cellpadding="0" style="{tstyle}">',
1874                     '<tbody>',
1875                        '<tr>{cells}</tr>',
1876                        this.enableRowBody ? rowBodyText : '',
1877                     '</tbody>',
1878                '</table>'
1879            ].join("");
1880       
1881        Ext.applyIf(templates, {
1882            hcell   : headerCellTpl,
1883            cell    : this.cellTpl,
1884            body    : this.bodyTpl,
1885            header  : this.headerTpl,
1886            master  : this.masterTpl,
1887            row     : new Ext.Template('<div class="x-grid3-row {alt}" style="{tstyle}">' + innerText + '</div>'),
1888            rowInner: new Ext.Template(innerText)
1889        });
1890
1891        for (name in templates) {
1892            template = templates[name];
1893           
1894            if (template && Ext.isFunction(template.compile) && !template.compiled) {
1895                template.disableFormats = true;
1896                template.compile();
1897            }
1898        }
1899
1900        this.templates = templates;
1901        this.colRe = new RegExp('x-grid3-td-([^\\s]+)', '');
1902    },
1903
1904    /**
1905     * @private
1906     * Each GridView has its own private flyweight, accessed through this method
1907     */
1908    fly : function(el) {
1909        if (!this._flyweight) {
1910            this._flyweight = new Ext.Element.Flyweight(document.body);
1911        }
1912        this._flyweight.dom = el;
1913        return this._flyweight;
1914    },
1915
1916    // private
1917    getEditorParent : function() {
1918        return this.scroller.dom;
1919    },
1920
1921    /**
1922     * @private
1923     * Finds and stores references to important elements
1924     */
1925    initElements : function() {
1926        var Element  = Ext.Element,
1927            el       = Ext.get(this.grid.getGridEl().dom.firstChild),
1928            mainWrap = new Element(el.child('div.x-grid3-viewport')),
1929            mainHd   = new Element(mainWrap.child('div.x-grid3-header')),
1930            scroller = new Element(mainWrap.child('div.x-grid3-scroller'));
1931       
1932        if (this.grid.hideHeaders) {
1933            mainHd.setDisplayed(false);
1934        }
1935       
1936        if (this.forceFit) {
1937            scroller.setStyle('overflow-x', 'hidden');
1938        }
1939       
1940        /**
1941         * <i>Read-only</i>. The GridView's body Element which encapsulates all rows in the Grid.
1942         * This {@link Ext.Element Element} is only available after the GridPanel has been rendered.
1943         * @type Ext.Element
1944         * @property mainBody
1945         */
1946       
1947        Ext.apply(this, {
1948            el      : el,
1949            mainWrap: mainWrap,
1950            scroller: scroller,
1951            mainHd  : mainHd,
1952            innerHd : mainHd.child('div.x-grid3-header-inner').dom,
1953            mainBody: new Element(Element.fly(scroller).child('div.x-grid3-body')),
1954            focusEl : new Element(Element.fly(scroller).child('a')),
1955           
1956            resizeMarker: new Element(el.child('div.x-grid3-resize-marker')),
1957            resizeProxy : new Element(el.child('div.x-grid3-resize-proxy'))
1958        });
1959       
1960        this.focusEl.swallowEvent('click', true);
1961    },
1962
1963    // private
1964    getRows : function() {
1965        return this.hasRows() ? this.mainBody.dom.childNodes : [];
1966    },
1967
1968    // finder methods, used with delegation
1969
1970    // private
1971    findCell : function(el) {
1972        if (!el) {
1973            return false;
1974        }
1975        return this.fly(el).findParent(this.cellSelector, this.cellSelectorDepth);
1976    },
1977
1978    /**
1979     * <p>Return the index of the grid column which contains the passed HTMLElement.</p>
1980     * See also {@link #findRowIndex}
1981     * @param {HTMLElement} el The target element
1982     * @return {Number} The column index, or <b>false</b> if the target element is not within a row of this GridView.
1983     */
1984    findCellIndex : function(el, requiredCls) {
1985        var cell = this.findCell(el),
1986            hasCls;
1987       
1988        if (cell) {
1989            hasCls = this.fly(cell).hasClass(requiredCls);
1990            if (!requiredCls || hasCls) {
1991                return this.getCellIndex(cell);
1992            }
1993        }
1994        return false;
1995    },
1996
1997    // private
1998    getCellIndex : function(el) {
1999        if (el) {
2000            var match = el.className.match(this.colRe);
2001           
2002            if (match && match[1]) {
2003                return this.cm.getIndexById(match[1]);
2004            }
2005        }
2006        return false;
2007    },
2008
2009    // private
2010    findHeaderCell : function(el) {
2011        var cell = this.findCell(el);
2012        return cell && this.fly(cell).hasClass(this.hdCls) ? cell : null;
2013    },
2014
2015    // private
2016    findHeaderIndex : function(el){
2017        return this.findCellIndex(el, this.hdCls);
2018    },
2019
2020    /**
2021     * Return the HtmlElement representing the grid row which contains the passed element.
2022     * @param {HTMLElement} el The target HTMLElement
2023     * @return {HTMLElement} The row element, or null if the target element is not within a row of this GridView.
2024     */
2025    findRow : function(el) {
2026        if (!el) {
2027            return false;
2028        }
2029        return this.fly(el).findParent(this.rowSelector, this.rowSelectorDepth);
2030    },
2031
2032    /**
2033     * Return the index of the grid row which contains the passed HTMLElement.
2034     * See also {@link #findCellIndex}
2035     * @param {HTMLElement} el The target HTMLElement
2036     * @return {Number} The row index, or <b>false</b> if the target element is not within a row of this GridView.
2037     */
2038    findRowIndex : function(el) {
2039        var row = this.findRow(el);
2040        return row ? row.rowIndex : false;
2041    },
2042
2043    /**
2044     * Return the HtmlElement representing the grid row body which contains the passed element.
2045     * @param {HTMLElement} el The target HTMLElement
2046     * @return {HTMLElement} The row body element, or null if the target element is not within a row body of this GridView.
2047     */
2048    findRowBody : function(el) {
2049        if (!el) {
2050            return false;
2051        }
2052       
2053        return this.fly(el).findParent(this.rowBodySelector, this.rowBodySelectorDepth);
2054    },
2055
2056    // getter methods for fetching elements dynamically in the grid
2057
2058    /**
2059     * Return the <tt>&lt;div></tt> HtmlElement which represents a Grid row for the specified index.
2060     * @param {Number} index The row index
2061     * @return {HtmlElement} The div element.
2062     */
2063    getRow : function(row) {
2064        return this.getRows()[row];
2065    },
2066
2067    /**
2068     * Returns the grid's <tt>&lt;td></tt> HtmlElement at the specified coordinates.
2069     * @param {Number} row The row index in which to find the cell.
2070     * @param {Number} col The column index of the cell.
2071     * @return {HtmlElement} The td at the specified coordinates.
2072     */
2073    getCell : function(row, col) {
2074        return Ext.fly(this.getRow(row)).query(this.cellSelector)[col]; 
2075    },
2076
2077    /**
2078     * Return the <tt>&lt;td></tt> HtmlElement which represents the Grid's header cell for the specified column index.
2079     * @param {Number} index The column index
2080     * @return {HtmlElement} The td element.
2081     */
2082    getHeaderCell : function(index) {
2083        return this.mainHd.dom.getElementsByTagName('td')[index];
2084    },
2085
2086    // manipulating elements
2087
2088    // private - use getRowClass to apply custom row classes
2089    addRowClass : function(rowId, cls) {
2090        var row = this.getRow(rowId);
2091        if (row) {
2092            this.fly(row).addClass(cls);
2093        }
2094    },
2095
2096    // private
2097    removeRowClass : function(row, cls) {
2098        var r = this.getRow(row);
2099        if(r){
2100            this.fly(r).removeClass(cls);
2101        }
2102    },
2103
2104    // private
2105    removeRow : function(row) {
2106        Ext.removeNode(this.getRow(row));
2107        this.syncFocusEl(row);
2108    },
2109
2110    // private
2111    removeRows : function(firstRow, lastRow) {
2112        var bd = this.mainBody.dom,
2113            rowIndex;
2114           
2115        for (rowIndex = firstRow; rowIndex <= lastRow; rowIndex++){
2116            Ext.removeNode(bd.childNodes[firstRow]);
2117        }
2118       
2119        this.syncFocusEl(firstRow);
2120    },
2121
2122    /* ----------------------------------- Scrolling functions -------------------------------------------*/
2123   
2124    // private
2125    getScrollState : function() {
2126        var sb = this.scroller.dom;
2127       
2128        return {
2129            left: sb.scrollLeft, 
2130            top : sb.scrollTop
2131        };
2132    },
2133
2134    // private
2135    restoreScroll : function(state) {
2136        var sb = this.scroller.dom;
2137        sb.scrollLeft = state.left;
2138        sb.scrollTop  = state.top;
2139    },
2140
2141    /**
2142     * Scrolls the grid to the top
2143     */
2144    scrollToTop : function() {
2145        var dom = this.scroller.dom;
2146       
2147        dom.scrollTop  = 0;
2148        dom.scrollLeft = 0;
2149    },
2150
2151    // private
2152    syncScroll : function() {
2153        this.syncHeaderScroll();
2154        var mb = this.scroller.dom;
2155        this.grid.fireEvent('bodyscroll', mb.scrollLeft, mb.scrollTop);
2156    },
2157
2158    // private
2159    syncHeaderScroll : function() {
2160        var innerHd    = this.innerHd,
2161            scrollLeft = this.scroller.dom.scrollLeft;
2162       
2163        innerHd.scrollLeft = scrollLeft;
2164        innerHd.scrollLeft = scrollLeft; // second time for IE (1/2 time first fails, other browsers ignore)
2165    },
2166   
2167    /**
2168     * @private
2169     * Ensures the given column has the given icon class
2170     */
2171    updateSortIcon : function(col, dir) {
2172        var sortClasses = this.sortClasses,
2173            sortClass   = sortClasses[dir == "DESC" ? 1 : 0],
2174            headers     = this.mainHd.select('td').removeClass(sortClasses);
2175       
2176        headers.item(col).addClass(sortClass);
2177    },
2178
2179    /**
2180     * @private
2181     * Updates the size of every column and cell in the grid
2182     */
2183    updateAllColumnWidths : function() {
2184        var totalWidth = this.getTotalWidth(),
2185            colCount   = this.cm.getColumnCount(),
2186            rows       = this.getRows(),
2187            rowCount   = rows.length,
2188            widths     = [],
2189            row, rowFirstChild, trow, i, j;
2190       
2191        for (i = 0; i < colCount; i++) {
2192            widths[i] = this.getColumnWidth(i);
2193            this.getHeaderCell(i).style.width = widths[i];
2194        }
2195       
2196        this.updateHeaderWidth();
2197       
2198        for (i = 0; i < rowCount; i++) {
2199            row = rows[i];
2200            row.style.width = totalWidth;
2201            rowFirstChild = row.firstChild;
2202           
2203            if (rowFirstChild) {
2204                rowFirstChild.style.width = totalWidth;
2205                trow = rowFirstChild.rows[0];
2206               
2207                for (j = 0; j < colCount; j++) {
2208                    trow.childNodes[j].style.width = widths[j];
2209                }
2210            }
2211        }
2212       
2213        this.onAllColumnWidthsUpdated(widths, totalWidth);
2214    },
2215
2216    /**
2217     * @private
2218     * Called after a column's width has been updated, this resizes all of the cells for that column in each row
2219     * @param {Number} column The column index
2220     */
2221    updateColumnWidth : function(column, width) {
2222        var columnWidth = this.getColumnWidth(column),
2223            totalWidth  = this.getTotalWidth(),
2224            headerCell  = this.getHeaderCell(column),
2225            nodes       = this.getRows(),
2226            nodeCount   = nodes.length,
2227            row, i, firstChild;
2228       
2229        this.updateHeaderWidth();
2230        headerCell.style.width = columnWidth;
2231       
2232        for (i = 0; i < nodeCount; i++) {
2233            row = nodes[i];
2234            firstChild = row.firstChild;
2235           
2236            row.style.width = totalWidth;
2237            if (firstChild) {
2238                firstChild.style.width = totalWidth;
2239                firstChild.rows[0].childNodes[column].style.width = columnWidth;
2240            }
2241        }
2242       
2243        this.onColumnWidthUpdated(column, columnWidth, totalWidth);
2244    },
2245   
2246    /**
2247     * @private
2248     * Sets the hidden status of a given column.
2249     * @param {Number} col The column index
2250     * @param {Boolean} hidden True to make the column hidden
2251     */
2252    updateColumnHidden : function(col, hidden) {
2253        var totalWidth = this.getTotalWidth(),
2254            display    = hidden ? 'none' : '',
2255            headerCell = this.getHeaderCell(col),
2256            nodes      = this.getRows(),
2257            nodeCount  = nodes.length,
2258            row, rowFirstChild, i;
2259       
2260        this.updateHeaderWidth();
2261        headerCell.style.display = display;
2262       
2263        for (i = 0; i < nodeCount; i++) {
2264            row = nodes[i];
2265            row.style.width = totalWidth;
2266            rowFirstChild = row.firstChild;
2267           
2268            if (rowFirstChild) {
2269                rowFirstChild.style.width = totalWidth;
2270                rowFirstChild.rows[0].childNodes[col].style.display = display;
2271            }
2272        }
2273       
2274        this.onColumnHiddenUpdated(col, hidden, totalWidth);
2275        delete this.lastViewWidth; //recalc
2276        this.layout();
2277    },
2278
2279    /**
2280     * @private
2281     * Renders all of the rows to a string buffer and returns the string. This is called internally
2282     * by renderRows and performs the actual string building for the rows - it does not inject HTML into the DOM.
2283     * @param {Array} columns The column data acquired from getColumnData.
2284     * @param {Array} records The array of records to render
2285     * @param {Ext.data.Store} store The store to render the rows from
2286     * @param {Number} startRow The index of the first row being rendered. Sometimes we only render a subset of
2287     * the rows so this is used to maintain logic for striping etc
2288     * @param {Number} colCount The total number of columns in the column model
2289     * @param {Boolean} stripe True to stripe the rows
2290     * @return {String} A string containing the HTML for the rendered rows
2291     */
2292    doRender : function(columns, records, store, startRow, colCount, stripe) {
2293        var templates = this.templates,
2294            cellTemplate = templates.cell,
2295            rowTemplate = templates.row,
2296            last = colCount - 1,
2297            tstyle = 'width:' + this.getTotalWidth() + ';',
2298            // buffers
2299            rowBuffer = [],
2300            colBuffer = [],
2301            rowParams = {tstyle: tstyle},
2302            meta = {},
2303            len  = records.length,
2304            alt,
2305            column,
2306            record, i, j, rowIndex;
2307
2308        //build up each row's HTML
2309        for (j = 0; j < len; j++) {
2310            record    = records[j];
2311            colBuffer = [];
2312
2313            rowIndex = j + startRow;
2314
2315            //build up each column's HTML
2316            for (i = 0; i < colCount; i++) {
2317                column = columns[i];
2318               
2319                meta.id    = column.id;
2320                meta.css   = i === 0 ? 'x-grid3-cell-first ' : (i == last ? 'x-grid3-cell-last ' : '');
2321                meta.attr  = meta.cellAttr = '';
2322                meta.style = column.style;
2323                meta.value = column.renderer.call(column.scope, record.data[column.name], meta, record, rowIndex, i, store);
2324
2325                if (Ext.isEmpty(meta.value)) {
2326                    meta.value = '&#160;';
2327                }
2328
2329                if (this.markDirty && record.dirty && typeof record.modified[column.name] != 'undefined') {
2330                    meta.css += ' x-grid3-dirty-cell';
2331                }
2332
2333                colBuffer[colBuffer.length] = cellTemplate.apply(meta);
2334            }
2335
2336            alt = [];
2337            //set up row striping and row dirtiness CSS classes
2338            if (stripe && ((rowIndex + 1) % 2 === 0)) {
2339                alt[0] = 'x-grid3-row-alt';
2340            }
2341
2342            if (record.dirty) {
2343                alt[1] = ' x-grid3-dirty-row';
2344            }
2345
2346            rowParams.cols = colCount;
2347
2348            if (this.getRowClass) {
2349                alt[2] = this.getRowClass(record, rowIndex, rowParams, store);
2350            }
2351
2352            rowParams.alt   = alt.join(' ');
2353            rowParams.cells = colBuffer.join('');
2354
2355            rowBuffer[rowBuffer.length] = rowTemplate.apply(rowParams);
2356        }
2357
2358        return rowBuffer.join('');
2359    },
2360
2361    /**
2362     * @private
2363     * Adds CSS classes and rowIndex to each row
2364     * @param {Number} startRow The row to start from (defaults to 0)
2365     */
2366    processRows : function(startRow, skipStripe) {
2367        if (!this.ds || this.ds.getCount() < 1) {
2368            return;
2369        }
2370
2371        var rows   = this.getRows(),
2372            length = rows.length,
2373            row, i;
2374
2375        skipStripe = skipStripe || !this.grid.stripeRows;
2376        startRow   = startRow   || 0;
2377
2378        for (i = 0; i < length; i++) {
2379            row = rows[i];
2380            if (row) {
2381                row.rowIndex = i;
2382                if (!skipStripe) {
2383                    row.className = row.className.replace(this.rowClsRe, ' ');
2384                    if ((i + 1) % 2 === 0){
2385                        row.className += ' x-grid3-row-alt';
2386                    }
2387                }
2388            }
2389        }
2390
2391        // add first/last-row classes
2392        if (startRow === 0) {
2393            Ext.fly(rows[0]).addClass(this.firstRowCls);
2394        }
2395
2396        Ext.fly(rows[length - 1]).addClass(this.lastRowCls);
2397    },
2398   
2399    /**
2400     * @private
2401     */
2402    afterRender : function() {
2403        if (!this.ds || !this.cm) {
2404            return;
2405        }
2406       
2407        this.mainBody.dom.innerHTML = this.renderBody() || '&#160;';
2408        this.processRows(0, true);
2409
2410        if (this.deferEmptyText !== true) {
2411            this.applyEmptyText();
2412        }
2413       
2414        this.grid.fireEvent('viewready', this.grid);
2415    },
2416   
2417    /**
2418     * @private
2419     * This is always intended to be called after renderUI. Sets up listeners on the UI elements
2420     * and sets up options like column menus, moving and resizing.
2421     */
2422    afterRenderUI: function() {
2423        var grid = this.grid;
2424       
2425        this.initElements();
2426
2427        // get mousedowns early
2428        Ext.fly(this.innerHd).on('click', this.handleHdDown, this);
2429
2430        this.mainHd.on({
2431            scope    : this,
2432            mouseover: this.handleHdOver,
2433            mouseout : this.handleHdOut,
2434            mousemove: this.handleHdMove
2435        });
2436
2437        this.scroller.on('scroll', this.syncScroll,  this);
2438       
2439        if (grid.enableColumnResize !== false) {
2440            this.splitZone = new Ext.grid.GridView.SplitDragZone(grid, this.mainHd.dom);
2441        }
2442
2443        if (grid.enableColumnMove) {
2444            this.columnDrag = new Ext.grid.GridView.ColumnDragZone(grid, this.innerHd);
2445            this.columnDrop = new Ext.grid.HeaderDropZone(grid, this.mainHd.dom);
2446        }
2447
2448        if (grid.enableHdMenu !== false) {
2449            this.hmenu = new Ext.menu.Menu({id: grid.id + '-hctx'});
2450            this.hmenu.add(
2451                {itemId:'asc',  text: this.sortAscText,  cls: 'xg-hmenu-sort-asc'},
2452                {itemId:'desc', text: this.sortDescText, cls: 'xg-hmenu-sort-desc'}
2453            );
2454
2455            if (grid.enableColumnHide !== false) {
2456                this.colMenu = new Ext.menu.Menu({id:grid.id + '-hcols-menu'});
2457                this.colMenu.on({
2458                    scope     : this,
2459                    beforeshow: this.beforeColMenuShow,
2460                    itemclick : this.handleHdMenuClick
2461                });
2462                this.hmenu.add('-', {
2463                    itemId:'columns',
2464                    hideOnClick: false,
2465                    text: this.columnsText,
2466                    menu: this.colMenu,
2467                    iconCls: 'x-cols-icon'
2468                });
2469            }
2470
2471            this.hmenu.on('itemclick', this.handleHdMenuClick, this);
2472        }
2473
2474        if (grid.trackMouseOver) {
2475            this.mainBody.on({
2476                scope    : this,
2477                mouseover: this.onRowOver,
2478                mouseout : this.onRowOut
2479            });
2480        }
2481
2482        if (grid.enableDragDrop || grid.enableDrag) {
2483            this.dragZone = new Ext.grid.GridDragZone(grid, {
2484                ddGroup : grid.ddGroup || 'GridDD'
2485            });
2486        }
2487
2488        this.updateHeaderSortState();
2489    },
2490
2491    /**
2492     * @private
2493     * Renders each of the UI elements in turn. This is called internally, once, by this.render. It does not
2494     * render rows from the store, just the surrounding UI elements.
2495     */
2496    renderUI : function() {
2497        var templates = this.templates;
2498
2499        return templates.master.apply({
2500            body  : templates.body.apply({rows:'&#160;'}),
2501            header: this.renderHeaders(),
2502            ostyle: 'width:' + this.getOffsetWidth() + ';',
2503            bstyle: 'width:' + this.getTotalWidth()  + ';'
2504        });
2505    },
2506
2507    // private
2508    processEvent : function(name, e) {
2509        var target = e.getTarget(),
2510            grid   = this.grid,
2511            header = this.findHeaderIndex(target),
2512            row, cell, col, body;
2513
2514        grid.fireEvent(name, e);
2515
2516        if (header !== false) {
2517            grid.fireEvent('header' + name, grid, header, e);
2518        } else {
2519            row = this.findRowIndex(target);
2520
2521//          Grid's value-added events must bubble correctly to allow cancelling via returning false: cell->column->row
2522//          We must allow a return of false at any of these levels to cancel the event processing.
2523//          Particularly allowing rowmousedown to be cancellable by prior handlers which need to prevent selection.
2524            if (row !== false) {
2525                cell = this.findCellIndex(target);
2526                if (cell !== false) {
2527                    col = grid.colModel.getColumnAt(cell);
2528                    if (grid.fireEvent('cell' + name, grid, row, cell, e) !== false) {
2529                        if (!col || (col.processEvent && (col.processEvent(name, e, grid, row, cell) !== false))) {
2530                            grid.fireEvent('row' + name, grid, row, e);
2531                        }
2532                    }
2533                } else {
2534                    if (grid.fireEvent('row' + name, grid, row, e) !== false) {
2535                        (body = this.findRowBody(target)) && grid.fireEvent('rowbody' + name, grid, row, e);
2536                    }
2537                }
2538            } else {
2539                grid.fireEvent('container' + name, grid, e);
2540            }
2541        }
2542    },
2543
2544    /**
2545     * @private
2546     * Sizes the grid's header and body elements
2547     */
2548    layout : function(initial) {
2549        if (!this.mainBody) {
2550            return; // not rendered
2551        }
2552
2553        var grid       = this.grid,
2554            gridEl     = grid.getGridEl(),
2555            gridSize   = gridEl.getSize(true),
2556            gridWidth  = gridSize.width,
2557            gridHeight = gridSize.height,
2558            scroller   = this.scroller,
2559            scrollStyle, headerHeight, scrollHeight;
2560       
2561        if (gridWidth < 20 || gridHeight < 20) {
2562            return;
2563        }
2564       
2565        if (grid.autoHeight) {
2566            scrollStyle = scroller.dom.style;
2567            scrollStyle.overflow = 'visible';
2568           
2569            if (Ext.isWebKit) {
2570                scrollStyle.position = 'static';
2571            }
2572        } else {
2573            this.el.setSize(gridWidth, gridHeight);
2574           
2575            headerHeight = this.mainHd.getHeight();
2576            scrollHeight = gridHeight - headerHeight;
2577           
2578            scroller.setSize(gridWidth, scrollHeight);
2579           
2580            if (this.innerHd) {
2581                this.innerHd.style.width = (gridWidth) + "px";
2582            }
2583        }
2584       
2585        if (this.forceFit || (initial === true && this.autoFill)) {
2586            if (this.lastViewWidth != gridWidth) {
2587                this.fitColumns(false, false);
2588                this.lastViewWidth = gridWidth;
2589            }
2590        } else {
2591            this.autoExpand();
2592            this.syncHeaderScroll();
2593        }
2594       
2595        this.onLayout(gridWidth, scrollHeight);
2596    },
2597
2598    // template functions for subclasses and plugins
2599    // these functions include precalculated values
2600    onLayout : function(vw, vh) {
2601        // do nothing
2602    },
2603
2604    onColumnWidthUpdated : function(col, w, tw) {
2605        //template method
2606    },
2607
2608    onAllColumnWidthsUpdated : function(ws, tw) {
2609        //template method
2610    },
2611
2612    onColumnHiddenUpdated : function(col, hidden, tw) {
2613        // template method
2614    },
2615
2616    updateColumnText : function(col, text) {
2617        // template method
2618    },
2619
2620    afterMove : function(colIndex) {
2621        // template method
2622    },
2623
2624    /* ----------------------------------- Core Specific -------------------------------------------*/
2625    // private
2626    init : function(grid) {
2627        this.grid = grid;
2628
2629        this.initTemplates();
2630        this.initData(grid.store, grid.colModel);
2631        this.initUI(grid);
2632    },
2633
2634    // private
2635    getColumnId : function(index){
2636        return this.cm.getColumnId(index);
2637    },
2638
2639    // private
2640    getOffsetWidth : function() {
2641        return (this.cm.getTotalWidth() + this.getScrollOffset()) + 'px';
2642    },
2643
2644    // private
2645    getScrollOffset: function() {
2646        return Ext.num(this.scrollOffset, Ext.getScrollBarWidth());
2647    },
2648
2649    /**
2650     * @private
2651     * Renders the header row using the 'header' template. Does not inject the HTML into the DOM, just
2652     * returns a string.
2653     * @return {String} Rendered header row
2654     */
2655    renderHeaders : function() {
2656        var colModel   = this.cm,
2657            templates  = this.templates,
2658            headerTpl  = templates.hcell,
2659            properties = {},
2660            colCount   = colModel.getColumnCount(),
2661            last       = colCount - 1,
2662            cells      = [],
2663            i, cssCls;
2664       
2665        for (i = 0; i < colCount; i++) {
2666            if (i == 0) {
2667                cssCls = 'x-grid3-cell-first ';
2668            } else {
2669                cssCls = i == last ? 'x-grid3-cell-last ' : '';
2670            }
2671           
2672            properties = {
2673                id     : colModel.getColumnId(i),
2674                value  : colModel.getColumnHeader(i) || '',
2675                style  : this.getColumnStyle(i, true),
2676                css    : cssCls,
2677                tooltip: this.getColumnTooltip(i)
2678            };
2679           
2680            if (colModel.config[i].align == 'right') {
2681                properties.istyle = 'padding-right: 16px;';
2682            } else {
2683                delete properties.istyle;
2684            }
2685           
2686            cells[i] = headerTpl.apply(properties);
2687        }
2688       
2689        return templates.header.apply({
2690            cells : cells.join(""),
2691            tstyle: String.format("width: {0};", this.getTotalWidth())
2692        });
2693    },
2694
2695    /**
2696     * @private
2697     */
2698    getColumnTooltip : function(i) {
2699        var tooltip = this.cm.getColumnTooltip(i);
2700        if (tooltip) {
2701            if (Ext.QuickTips.isEnabled()) {
2702                return 'ext:qtip="' + tooltip + '"';
2703            } else {
2704                return 'title="' + tooltip + '"';
2705            }
2706        }
2707       
2708        return '';
2709    },
2710
2711    // private
2712    beforeUpdate : function() {
2713        this.grid.stopEditing(true);
2714    },
2715
2716    /**
2717     * @private
2718     * Re-renders the headers and ensures they are sized correctly
2719     */
2720    updateHeaders : function() {
2721        this.innerHd.firstChild.innerHTML = this.renderHeaders();
2722       
2723        this.updateHeaderWidth(false);
2724    },
2725   
2726    /**
2727     * @private
2728     * Ensures that the header is sized to the total width available to it
2729     * @param {Boolean} updateMain True to update the mainBody's width also (defaults to true)
2730     */
2731    updateHeaderWidth: function(updateMain) {
2732        var innerHdChild = this.innerHd.firstChild,
2733            totalWidth   = this.getTotalWidth();
2734       
2735        innerHdChild.style.width = this.getOffsetWidth();
2736        innerHdChild.firstChild.style.width = totalWidth;
2737       
2738        if (updateMain !== false) {
2739            this.mainBody.dom.style.width = totalWidth;
2740        }
2741    },
2742
2743    /**
2744     * Focuses the specified row.
2745     * @param {Number} row The row index
2746     */
2747    focusRow : function(row) {
2748        this.focusCell(row, 0, false);
2749    },
2750
2751    /**
2752     * Focuses the specified cell.
2753     * @param {Number} row The row index
2754     * @param {Number} col The column index
2755     */
2756    focusCell : function(row, col, hscroll) {
2757        this.syncFocusEl(this.ensureVisible(row, col, hscroll));
2758       
2759        var focusEl = this.focusEl;
2760       
2761        if (Ext.isGecko) {
2762            focusEl.focus();
2763        } else {
2764            focusEl.focus.defer(1, focusEl);
2765        }
2766    },
2767
2768    /**
2769     * @private
2770     * Finds the Elements corresponding to the given row and column indexes
2771     */
2772    resolveCell : function(row, col, hscroll) {
2773        if (!Ext.isNumber(row)) {
2774            row = row.rowIndex;
2775        }
2776       
2777        if (!this.ds) {
2778            return null;
2779        }
2780       
2781        if (row < 0 || row >= this.ds.getCount()) {
2782            return null;
2783        }
2784        col = (col !== undefined ? col : 0);
2785
2786        var rowEl    = this.getRow(row),
2787            colModel = this.cm,
2788            colCount = colModel.getColumnCount(),
2789            cellEl;
2790           
2791        if (!(hscroll === false && col === 0)) {
2792            while (col < colCount && colModel.isHidden(col)) {
2793                col++;
2794            }
2795           
2796            cellEl = this.getCell(row, col);
2797        }
2798
2799        return {row: rowEl, cell: cellEl};
2800    },
2801
2802    /**
2803     * @private
2804     * Returns the XY co-ordinates of a given row/cell resolution (see {@link #resolveCell})
2805     * @return {Array} X and Y coords
2806     */
2807    getResolvedXY : function(resolved) {
2808        if (!resolved) {
2809            return null;
2810        }
2811       
2812        var cell = resolved.cell,
2813            row  = resolved.row;
2814       
2815        if (cell) {
2816            return Ext.fly(cell).getXY();
2817        } else {
2818            return [this.el.getX(), Ext.fly(row).getY()];
2819        }
2820    },
2821
2822    /**
2823     * @private
2824     * Moves the focus element to the x and y co-ordinates of the given row and column
2825     */
2826    syncFocusEl : function(row, col, hscroll) {
2827        var xy = row;
2828       
2829        if (!Ext.isArray(xy)) {
2830            row = Math.min(row, Math.max(0, this.getRows().length-1));
2831           
2832            if (isNaN(row)) {
2833                return;
2834            }
2835           
2836            xy = this.getResolvedXY(this.resolveCell(row, col, hscroll));
2837        }
2838       
2839        this.focusEl.setXY(xy || this.scroller.getXY());
2840    },
2841
2842    /**
2843     * @private
2844     */
2845    ensureVisible : function(row, col, hscroll) {
2846        var resolved = this.resolveCell(row, col, hscroll);
2847       
2848        if (!resolved || !resolved.row) {
2849            return null;
2850        }
2851
2852        var rowEl  = resolved.row,
2853            cellEl = resolved.cell,
2854            c = this.scroller.dom,
2855            p = rowEl,
2856            ctop = 0,
2857            stop = this.el.dom;
2858
2859        while (p && p != stop) {
2860            ctop += p.offsetTop;
2861            p = p.offsetParent;
2862        }
2863
2864        ctop -= this.mainHd.dom.offsetHeight;
2865        stop = parseInt(c.scrollTop, 10);
2866
2867        var cbot = ctop + rowEl.offsetHeight,
2868            ch = c.clientHeight,
2869            sbot = stop + ch;
2870
2871
2872        if (ctop < stop) {
2873          c.scrollTop = ctop;
2874        } else if(cbot > sbot) {
2875            c.scrollTop = cbot-ch;
2876        }
2877
2878        if (hscroll !== false) {
2879            var cleft  = parseInt(cellEl.offsetLeft, 10),
2880                cright = cleft + cellEl.offsetWidth,
2881                sleft  = parseInt(c.scrollLeft, 10),
2882                sright = sleft + c.clientWidth;
2883               
2884            if (cleft < sleft) {
2885                c.scrollLeft = cleft;
2886            } else if(cright > sright) {
2887                c.scrollLeft = cright-c.clientWidth;
2888            }
2889        }
2890       
2891        return this.getResolvedXY(resolved);
2892    },
2893
2894    // private
2895    insertRows : function(dm, firstRow, lastRow, isUpdate) {
2896        var last = dm.getCount() - 1;
2897        if( !isUpdate && firstRow === 0 && lastRow >= last) {
2898            this.fireEvent('beforerowsinserted', this, firstRow, lastRow);
2899                this.refresh();
2900            this.fireEvent('rowsinserted', this, firstRow, lastRow);
2901        } else {
2902            if (!isUpdate) {
2903                this.fireEvent('beforerowsinserted', this, firstRow, lastRow);
2904            }
2905            var html = this.renderRows(firstRow, lastRow),
2906                before = this.getRow(firstRow);
2907            if (before) {
2908                if(firstRow === 0){
2909                    Ext.fly(this.getRow(0)).removeClass(this.firstRowCls);
2910                }
2911                Ext.DomHelper.insertHtml('beforeBegin', before, html);
2912            } else {
2913                var r = this.getRow(last - 1);
2914                if(r){
2915                    Ext.fly(r).removeClass(this.lastRowCls);
2916                }
2917                Ext.DomHelper.insertHtml('beforeEnd', this.mainBody.dom, html);
2918            }
2919            if (!isUpdate) {
2920                this.processRows(firstRow);
2921                this.fireEvent('rowsinserted', this, firstRow, lastRow);
2922            } else if (firstRow === 0 || firstRow >= last) {
2923                //ensure first/last row is kept after an update.
2924                Ext.fly(this.getRow(firstRow)).addClass(firstRow === 0 ? this.firstRowCls : this.lastRowCls);
2925            }
2926        }
2927        this.syncFocusEl(firstRow);
2928    },
2929
2930    /**
2931     * @private
2932     * DEPRECATED - this doesn't appear to be called anywhere in the library, remove in 4.0.
2933     */
2934    deleteRows : function(dm, firstRow, lastRow) {
2935        if (dm.getRowCount() < 1) {
2936            this.refresh();
2937        } else {
2938            this.fireEvent('beforerowsdeleted', this, firstRow, lastRow);
2939
2940            this.removeRows(firstRow, lastRow);
2941
2942            this.processRows(firstRow);
2943            this.fireEvent('rowsdeleted', this, firstRow, lastRow);
2944        }
2945    },
2946
2947    /**
2948     * @private
2949     * Builds a CSS string for the given column index
2950     * @param {Number} colIndex The column index
2951     * @param {Boolean} isHeader True if getting the style for the column's header
2952     * @return {String} The CSS string
2953     */
2954    getColumnStyle : function(colIndex, isHeader) {
2955        var colModel  = this.cm,
2956            colConfig = colModel.config,
2957            style     = isHeader ? '' : colConfig[colIndex].css || '',
2958            align     = colConfig[colIndex].align;
2959       
2960        style += String.format("width: {0};", this.getColumnWidth(colIndex));
2961       
2962        if (colModel.isHidden(colIndex)) {
2963            style += 'display: none; ';
2964        }
2965       
2966        if (align) {
2967            style += String.format("text-align: {0};", align);
2968        }
2969       
2970        return style;
2971    },
2972
2973    /**
2974     * @private
2975     * Returns the width of a given column minus its border width
2976     * @return {Number} The column index
2977     * @return {String|Number} The width in pixels
2978     */
2979    getColumnWidth : function(column) {
2980        var columnWidth = this.cm.getColumnWidth(column),
2981            borderWidth = this.borderWidth;
2982       
2983        if (Ext.isNumber(columnWidth)) {
2984            if (Ext.isBorderBox || (Ext.isWebKit && !Ext.isSafari2)) {
2985                return columnWidth + "px";
2986            } else {
2987                return Math.max(columnWidth - borderWidth, 0) + "px";
2988            }
2989        } else {
2990            return columnWidth;
2991        }
2992    },
2993
2994    /**
2995     * @private
2996     * Returns the total width of all visible columns
2997     * @return {String}
2998     */
2999    getTotalWidth : function() {
3000        return this.cm.getTotalWidth() + 'px';
3001    },
3002
3003    /**
3004     * @private
3005     * Resizes each column to fit the available grid width.
3006     * TODO: The second argument isn't even used, remove it in 4.0
3007     * @param {Boolean} preventRefresh True to prevent resizing of each row to the new column sizes (defaults to false)
3008     * @param {null} onlyExpand NOT USED, will be removed in 4.0
3009     * @param {Number} omitColumn The index of a column to leave at its current width. Defaults to undefined
3010     * @return {Boolean} True if the operation succeeded, false if not or undefined if the grid view is not yet initialized
3011     */
3012    fitColumns : function(preventRefresh, onlyExpand, omitColumn) {
3013        var grid          = this.grid,
3014            colModel      = this.cm,
3015            totalColWidth = colModel.getTotalWidth(false),
3016            gridWidth     = this.getGridInnerWidth(),
3017            extraWidth    = gridWidth - totalColWidth,
3018            columns       = [],
3019            extraCol      = 0,
3020            width         = 0,
3021            colWidth, fraction, i;
3022       
3023        // not initialized, so don't screw up the default widths
3024        if (gridWidth < 20 || extraWidth === 0) {
3025            return false;
3026        }
3027       
3028        var visibleColCount = colModel.getColumnCount(true),
3029            totalColCount   = colModel.getColumnCount(false),
3030            adjCount        = visibleColCount - (Ext.isNumber(omitColumn) ? 1 : 0);
3031       
3032        if (adjCount === 0) {
3033            adjCount = 1;
3034            omitColumn = undefined;
3035        }
3036       
3037        //FIXME: the algorithm used here is odd and potentially confusing. Includes this for loop and the while after it.
3038        for (i = 0; i < totalColCount; i++) {
3039            if (!colModel.isFixed(i) && i !== omitColumn) {
3040                colWidth = colModel.getColumnWidth(i);
3041                columns.push(i, colWidth);
3042               
3043                if (!colModel.isHidden(i)) {
3044                    extraCol = i;
3045                    width += colWidth;
3046                }
3047            }
3048        }
3049       
3050        fraction = (gridWidth - colModel.getTotalWidth()) / width;
3051       
3052        while (columns.length) {
3053            colWidth = columns.pop();
3054            i        = columns.pop();
3055           
3056            colModel.setColumnWidth(i, Math.max(grid.minColumnWidth, Math.floor(colWidth + colWidth * fraction)), true);
3057        }
3058       
3059        //this has been changed above so remeasure now
3060        totalColWidth = colModel.getTotalWidth(false);
3061       
3062        if (totalColWidth > gridWidth) {
3063            var adjustCol = (adjCount == visibleColCount) ? extraCol : omitColumn,
3064                newWidth  = Math.max(1, colModel.getColumnWidth(adjustCol) - (totalColWidth - gridWidth));
3065           
3066            colModel.setColumnWidth(adjustCol, newWidth, true);
3067        }
3068       
3069        if (preventRefresh !== true) {
3070            this.updateAllColumnWidths();
3071        }
3072       
3073        return true;
3074    },
3075
3076    /**
3077     * @private
3078     * Resizes the configured autoExpandColumn to take the available width after the other columns have
3079     * been accounted for
3080     * @param {Boolean} preventUpdate True to prevent the resizing of all rows (defaults to false)
3081     */
3082    autoExpand : function(preventUpdate) {
3083        var grid             = this.grid,
3084            colModel         = this.cm,
3085            gridWidth        = this.getGridInnerWidth(),
3086            totalColumnWidth = colModel.getTotalWidth(false),
3087            autoExpandColumn = grid.autoExpandColumn;
3088       
3089        if (!this.userResized && autoExpandColumn) {
3090            if (gridWidth != totalColumnWidth) {
3091                //if we are not already using all available width, resize the autoExpandColumn
3092                var colIndex     = colModel.getIndexById(autoExpandColumn),
3093                    currentWidth = colModel.getColumnWidth(colIndex),
3094                    desiredWidth = gridWidth - totalColumnWidth + currentWidth,
3095                    newWidth     = Math.min(Math.max(desiredWidth, grid.autoExpandMin), grid.autoExpandMax);
3096               
3097                if (currentWidth != newWidth) {
3098                    colModel.setColumnWidth(colIndex, newWidth, true);
3099                   
3100                    if (preventUpdate !== true) {
3101                        this.updateColumnWidth(colIndex, newWidth);
3102                    }
3103                }
3104            }
3105        }
3106    },
3107   
3108    /**
3109     * Returns the total internal width available to the grid, taking the scrollbar into account
3110     * @return {Number} The total width
3111     */
3112    getGridInnerWidth: function() {
3113        return this.grid.getGridEl().getWidth(true) - this.getScrollOffset();
3114    },
3115
3116    /**
3117     * @private
3118     * Returns an array of column configurations - one for each column
3119     * @return {Array} Array of column config objects. This includes the column name, renderer, id style and renderer
3120     */
3121    getColumnData : function() {
3122        var columns  = [],
3123            colModel = this.cm,
3124            colCount = colModel.getColumnCount(),
3125            fields   = this.ds.fields,
3126            i, name;
3127       
3128        for (i = 0; i < colCount; i++) {
3129            name = colModel.getDataIndex(i);
3130           
3131            columns[i] = {
3132                name    : Ext.isDefined(name) ? name : (fields.get(i) ? fields.get(i).name : undefined),
3133                renderer: colModel.getRenderer(i),
3134                scope   : colModel.getRendererScope(i),
3135                id      : colModel.getColumnId(i),
3136                style   : this.getColumnStyle(i)
3137            };
3138        }
3139       
3140        return columns;
3141    },
3142
3143    /**
3144     * @private
3145     * Renders rows between start and end indexes
3146     * @param {Number} startRow Index of the first row to render
3147     * @param {Number} endRow Index of the last row to render
3148     */
3149    renderRows : function(startRow, endRow) {
3150        var grid     = this.grid,
3151            store    = grid.store,
3152            stripe   = grid.stripeRows,
3153            colModel = grid.colModel,
3154            colCount = colModel.getColumnCount(),
3155            rowCount = store.getCount(),
3156            records;
3157       
3158        if (rowCount < 1) {
3159            return '';
3160        }
3161       
3162        startRow = startRow || 0;
3163        endRow   = Ext.isDefined(endRow) ? endRow : rowCount - 1;
3164        records  = store.getRange(startRow, endRow);
3165       
3166        return this.doRender(this.getColumnData(), records, store, startRow, colCount, stripe);
3167    },
3168
3169    // private
3170    renderBody : function(){
3171        var markup = this.renderRows() || '&#160;';
3172        return this.templates.body.apply({rows: markup});
3173    },
3174
3175    /**
3176     * @private
3177     * Refreshes a row by re-rendering it. Fires the rowupdated event when done
3178     */
3179    refreshRow: function(record) {
3180        var store     = this.ds,
3181            colCount  = this.cm.getColumnCount(),
3182            columns   = this.getColumnData(),
3183            last      = colCount - 1,
3184            cls       = ['x-grid3-row'],
3185            rowParams = {
3186                tstyle: String.format("width: {0};", this.getTotalWidth())
3187            },
3188            colBuffer = [],
3189            cellTpl   = this.templates.cell,
3190            rowIndex, row, column, meta, css, i;
3191       
3192        if (Ext.isNumber(record)) {
3193            rowIndex = record;
3194            record   = store.getAt(rowIndex);
3195        } else {
3196            rowIndex = store.indexOf(record);
3197        }
3198       
3199        //the record could not be found
3200        if (!record || rowIndex < 0) {
3201            return;
3202        }
3203       
3204        //builds each column in this row
3205        for (i = 0; i < colCount; i++) {
3206            column = columns[i];
3207           
3208            if (i == 0) {
3209                css = 'x-grid3-cell-first';
3210            } else {
3211                css = (i == last) ? 'x-grid3-cell-last ' : '';
3212            }
3213           
3214            meta = {
3215                id      : column.id,
3216                style   : column.style,
3217                css     : css,
3218                attr    : "",
3219                cellAttr: ""
3220            };
3221            // Need to set this after, because we pass meta to the renderer
3222            meta.value = column.renderer.call(column.scope, record.data[column.name], meta, record, rowIndex, i, store);
3223           
3224            if (Ext.isEmpty(meta.value)) {
3225                meta.value = '&#160;';
3226            }
3227           
3228            if (this.markDirty && record.dirty && typeof record.modified[column.name] != 'undefined') {
3229                meta.css += ' x-grid3-dirty-cell';
3230            }
3231           
3232            colBuffer[i] = cellTpl.apply(meta);
3233        }
3234       
3235        row = this.getRow(rowIndex);
3236        row.className = '';
3237       
3238        if (this.grid.stripeRows && ((rowIndex + 1) % 2 === 0)) {
3239            cls.push('x-grid3-row-alt');
3240        }
3241       
3242        if (this.getRowClass) {
3243            rowParams.cols = colCount;
3244            cls.push(this.getRowClass(record, rowIndex, rowParams, store));
3245        }
3246       
3247        this.fly(row).addClass(cls).setStyle(rowParams.tstyle);
3248        rowParams.cells = colBuffer.join("");
3249        row.innerHTML = this.templates.rowInner.apply(rowParams);
3250       
3251        this.fireEvent('rowupdated', this, rowIndex, record);
3252    },
3253
3254    /**
3255     * Refreshs the grid UI
3256     * @param {Boolean} headersToo (optional) True to also refresh the headers
3257     */
3258    refresh : function(headersToo) {
3259        this.fireEvent('beforerefresh', this);
3260        this.grid.stopEditing(true);
3261
3262        var result = this.renderBody();
3263        this.mainBody.update(result).setWidth(this.getTotalWidth());
3264        if (headersToo === true) {
3265            this.updateHeaders();
3266            this.updateHeaderSortState();
3267        }
3268        this.processRows(0, true);
3269        this.layout();
3270        this.applyEmptyText();
3271        this.fireEvent('refresh', this);
3272    },
3273
3274    /**
3275     * @private
3276     * Displays the configured emptyText if there are currently no rows to display
3277     */
3278    applyEmptyText : function() {
3279        if (this.emptyText && !this.hasRows()) {
3280            this.mainBody.update('<div class="x-grid-empty">' + this.emptyText + '</div>');
3281        }
3282    },
3283
3284    /**
3285     * @private
3286     * Adds sorting classes to the column headers based on the bound store's sortInfo. Fires the 'sortchange' event
3287     * if the sorting has changed since this function was last run.
3288     */
3289    updateHeaderSortState : function() {
3290        var state = this.ds.getSortState();
3291        if (!state) {
3292            return;
3293        }
3294
3295        if (!this.sortState || (this.sortState.field != state.field || this.sortState.direction != state.direction)) {
3296            this.grid.fireEvent('sortchange', this.grid, state);
3297        }
3298
3299        this.sortState = state;
3300
3301        var sortColumn = this.cm.findColumnIndex(state.field);
3302        if (sortColumn != -1) {
3303            var sortDir = state.direction;
3304            this.updateSortIcon(sortColumn, sortDir);
3305        }
3306    },
3307
3308    /**
3309     * @private
3310     * Removes any sorting indicator classes from the column headers
3311     */
3312    clearHeaderSortState : function() {
3313        if (!this.sortState) {
3314            return;
3315        }
3316        this.grid.fireEvent('sortchange', this.grid, null);
3317        this.mainHd.select('td').removeClass(this.sortClasses);
3318        delete this.sortState;
3319    },
3320
3321    /**
3322     * @private
3323     * Destroys all objects associated with the GridView
3324     */
3325    destroy : function() {
3326        var me              = this,
3327            grid            = me.grid,
3328            gridEl          = grid.getGridEl(),
3329            dragZone        = me.dragZone,
3330            splitZone       = me.splitZone,
3331            columnDrag      = me.columnDrag,
3332            columnDrop      = me.columnDrop,
3333            scrollToTopTask = me.scrollToTopTask,
3334            columnDragData,
3335            columnDragProxy;
3336       
3337        if (scrollToTopTask && scrollToTopTask.cancel) {
3338            scrollToTopTask.cancel();
3339        }
3340       
3341        Ext.destroyMembers(me, 'colMenu', 'hmenu');
3342
3343        me.initData(null, null);
3344        me.purgeListeners();
3345       
3346        Ext.fly(me.innerHd).un("click", me.handleHdDown, me);
3347
3348        if (grid.enableColumnMove) {
3349            columnDragData = columnDrag.dragData;
3350            columnDragProxy = columnDrag.proxy;
3351            Ext.destroy(
3352                columnDrag.el,
3353                columnDragProxy.ghost,
3354                columnDragProxy.el,
3355                columnDrop.el,
3356                columnDrop.proxyTop,
3357                columnDrop.proxyBottom,
3358                columnDragData.ddel,
3359                columnDragData.header
3360            );
3361           
3362            if (columnDragProxy.anim) {
3363                Ext.destroy(columnDragProxy.anim);
3364            }
3365           
3366            delete columnDragProxy.ghost;
3367            delete columnDragData.ddel;
3368            delete columnDragData.header;
3369            columnDrag.destroy();
3370           
3371            delete Ext.dd.DDM.locationCache[columnDrag.id];
3372            delete columnDrag._domRef;
3373
3374            delete columnDrop.proxyTop;
3375            delete columnDrop.proxyBottom;
3376            columnDrop.destroy();
3377            delete Ext.dd.DDM.locationCache["gridHeader" + gridEl.id];
3378            delete columnDrop._domRef;
3379            delete Ext.dd.DDM.ids[columnDrop.ddGroup];
3380        }
3381
3382        if (splitZone) { // enableColumnResize
3383            splitZone.destroy();
3384            delete splitZone._domRef;
3385            delete Ext.dd.DDM.ids["gridSplitters" + gridEl.id];
3386        }
3387
3388        Ext.fly(me.innerHd).removeAllListeners();
3389        Ext.removeNode(me.innerHd);
3390        delete me.innerHd;
3391
3392        Ext.destroy(
3393            me.el,
3394            me.mainWrap,
3395            me.mainHd,
3396            me.scroller,
3397            me.mainBody,
3398            me.focusEl,
3399            me.resizeMarker,
3400            me.resizeProxy,
3401            me.activeHdBtn,
3402            me._flyweight,
3403            dragZone,
3404            splitZone
3405        );
3406
3407        delete grid.container;
3408
3409        if (dragZone) {
3410            dragZone.destroy();
3411        }
3412
3413        Ext.dd.DDM.currentTarget = null;
3414        delete Ext.dd.DDM.locationCache[gridEl.id];
3415
3416        Ext.EventManager.removeResizeListener(me.onWindowResize, me);
3417    },
3418
3419    // private
3420    onDenyColumnHide : function() {
3421
3422    },
3423
3424    // private
3425    render : function() {
3426        if (this.autoFill) {
3427            var ct = this.grid.ownerCt;
3428           
3429            if (ct && ct.getLayout()) {
3430                ct.on('afterlayout', function() {
3431                    this.fitColumns(true, true);
3432                    this.updateHeaders();
3433                    this.updateHeaderSortState();
3434                }, this, {single: true});
3435            }
3436        } else if (this.forceFit) {
3437            this.fitColumns(true, false);
3438        } else if (this.grid.autoExpandColumn) {
3439            this.autoExpand(true);
3440        }
3441       
3442        this.grid.getGridEl().dom.innerHTML = this.renderUI();
3443       
3444        this.afterRenderUI();
3445    },
3446
3447    /* --------------------------------- Model Events and Handlers --------------------------------*/
3448   
3449    /**
3450     * @private
3451     * Binds a new Store and ColumnModel to this GridView. Removes any listeners from the old objects (if present)
3452     * and adds listeners to the new ones
3453     * @param {Ext.data.Store} newStore The new Store instance
3454     * @param {Ext.grid.ColumnModel} newColModel The new ColumnModel instance
3455     */
3456    initData : function(newStore, newColModel) {
3457        var me = this;
3458       
3459        if (me.ds) {
3460            var oldStore = me.ds;
3461           
3462            oldStore.un('add', me.onAdd, me);
3463            oldStore.un('load', me.onLoad, me);
3464            oldStore.un('clear', me.onClear, me);
3465            oldStore.un('remove', me.onRemove, me);
3466            oldStore.un('update', me.onUpdate, me);
3467            oldStore.un('datachanged', me.onDataChange, me);
3468           
3469            if (oldStore !== newStore && oldStore.autoDestroy) {
3470                oldStore.destroy();
3471            }
3472        }
3473       
3474        if (newStore) {
3475            newStore.on({
3476                scope      : me,
3477                load       : me.onLoad,
3478                add        : me.onAdd,
3479                remove     : me.onRemove,
3480                update     : me.onUpdate,
3481                clear      : me.onClear,
3482                datachanged: me.onDataChange
3483            });
3484        }
3485       
3486        if (me.cm) {
3487            var oldColModel = me.cm;
3488           
3489            oldColModel.un('configchange', me.onColConfigChange, me);
3490            oldColModel.un('widthchange',  me.onColWidthChange, me);
3491            oldColModel.un('headerchange', me.onHeaderChange, me);
3492            oldColModel.un('hiddenchange', me.onHiddenChange, me);
3493            oldColModel.un('columnmoved',  me.onColumnMove, me);
3494        }
3495       
3496        if (newColModel) {
3497            delete me.lastViewWidth;
3498           
3499            newColModel.on({
3500                scope       : me,
3501                configchange: me.onColConfigChange,
3502                widthchange : me.onColWidthChange,
3503                headerchange: me.onHeaderChange,
3504                hiddenchange: me.onHiddenChange,
3505                columnmoved : me.onColumnMove
3506            });
3507        }
3508       
3509        me.ds = newStore;
3510        me.cm = newColModel;
3511    },
3512
3513    // private
3514    onDataChange : function(){
3515        this.refresh(true);
3516        this.updateHeaderSortState();
3517        this.syncFocusEl(0);
3518    },
3519
3520    // private
3521    onClear : function() {
3522        this.refresh();
3523        this.syncFocusEl(0);
3524    },
3525
3526    // private
3527    onUpdate : function(store, record) {
3528        this.refreshRow(record);
3529    },
3530
3531    // private
3532    onAdd : function(store, records, index) {
3533        this.insertRows(store, index, index + (records.length-1));
3534    },
3535
3536    // private
3537    onRemove : function(store, record, index, isUpdate) {
3538        if (isUpdate !== true) {
3539            this.fireEvent('beforerowremoved', this, index, record);
3540        }
3541       
3542        this.removeRow(index);
3543       
3544        if (isUpdate !== true) {
3545            this.processRows(index);
3546            this.applyEmptyText();
3547            this.fireEvent('rowremoved', this, index, record);
3548        }
3549    },
3550
3551    /**
3552     * @private
3553     * Called when a store is loaded, scrolls to the top row
3554     */
3555    onLoad : function() {
3556        if (Ext.isGecko) {
3557            if (!this.scrollToTopTask) {
3558                this.scrollToTopTask = new Ext.util.DelayedTask(this.scrollToTop, this);
3559            }
3560            this.scrollToTopTask.delay(1);
3561        } else {
3562            this.scrollToTop();
3563        }
3564    },
3565
3566    // private
3567    onColWidthChange : function(cm, col, width) {
3568        this.updateColumnWidth(col, width);
3569    },
3570
3571    // private
3572    onHeaderChange : function(cm, col, text) {
3573        this.updateHeaders();
3574    },
3575
3576    // private
3577    onHiddenChange : function(cm, col, hidden) {
3578        this.updateColumnHidden(col, hidden);
3579    },
3580
3581    // private
3582    onColumnMove : function(cm, oldIndex, newIndex) {
3583        this.indexMap = null;
3584        this.refresh(true);
3585        this.restoreScroll(this.getScrollState());
3586       
3587        this.afterMove(newIndex);
3588        this.grid.fireEvent('columnmove', oldIndex, newIndex);
3589    },
3590
3591    // private
3592    onColConfigChange : function() {
3593        delete this.lastViewWidth;
3594        this.indexMap = null;
3595        this.refresh(true);
3596    },
3597
3598    /* -------------------- UI Events and Handlers ------------------------------ */
3599    // private
3600    initUI : function(grid) {
3601        grid.on('headerclick', this.onHeaderClick, this);
3602    },
3603
3604    // private
3605    initEvents : Ext.emptyFn,
3606
3607    // private
3608    onHeaderClick : function(g, index) {
3609        if (this.headersDisabled || !this.cm.isSortable(index)) {
3610            return;
3611        }
3612        g.stopEditing(true);
3613        g.store.sort(this.cm.getDataIndex(index));
3614    },
3615
3616    /**
3617     * @private
3618     * Adds the hover class to a row when hovered over
3619     */
3620    onRowOver : function(e, target) {
3621        var row = this.findRowIndex(target);
3622       
3623        if (row !== false) {
3624            this.addRowClass(row, this.rowOverCls);
3625        }
3626    },
3627
3628    /**
3629     * @private
3630     * Removes the hover class from a row on mouseout
3631     */
3632    onRowOut : function(e, target) {
3633        var row = this.findRowIndex(target);
3634       
3635        if (row !== false && !e.within(this.getRow(row), true)) {
3636            this.removeRowClass(row, this.rowOverCls);
3637        }
3638    },
3639
3640    // private
3641    onRowSelect : function(row) {
3642        this.addRowClass(row, this.selectedRowClass);
3643    },
3644
3645    // private
3646    onRowDeselect : function(row) {
3647        this.removeRowClass(row, this.selectedRowClass);
3648    },
3649
3650    // private
3651    onCellSelect : function(row, col) {
3652        var cell = this.getCell(row, col);
3653        if (cell) {
3654            this.fly(cell).addClass('x-grid3-cell-selected');
3655        }
3656    },
3657
3658    // private
3659    onCellDeselect : function(row, col) {
3660        var cell = this.getCell(row, col);
3661        if (cell) {
3662            this.fly(cell).removeClass('x-grid3-cell-selected');
3663        }
3664    },
3665
3666    // private
3667    handleWheel : function(e) {
3668        e.stopPropagation();
3669    },
3670
3671    /**
3672     * @private
3673     * Called by the SplitDragZone when a drag has been completed. Resizes the columns
3674     */
3675    onColumnSplitterMoved : function(cellIndex, width) {
3676        this.userResized = true;
3677        this.grid.colModel.setColumnWidth(cellIndex, width, true);
3678
3679        if (this.forceFit) {
3680            this.fitColumns(true, false, cellIndex);
3681            this.updateAllColumnWidths();
3682        } else {
3683            this.updateColumnWidth(cellIndex, width);
3684            this.syncHeaderScroll();
3685        }
3686
3687        this.grid.fireEvent('columnresize', cellIndex, width);
3688    },
3689
3690    /**
3691     * @private
3692     * Click handler for the shared column dropdown menu, called on beforeshow. Builds the menu
3693     * which displays the list of columns for the user to show or hide.
3694     */
3695    beforeColMenuShow : function() {
3696        var colModel = this.cm,
3697            colCount = colModel.getColumnCount(),
3698            colMenu  = this.colMenu,
3699            i;
3700
3701        colMenu.removeAll();
3702
3703        for (i = 0; i < colCount; i++) {
3704            if (colModel.config[i].hideable !== false) {
3705                colMenu.add(new Ext.menu.CheckItem({
3706                    text       : colModel.getColumnHeader(i),
3707                    itemId     : 'col-' + colModel.getColumnId(i),
3708                    checked    : !colModel.isHidden(i),
3709                    disabled   : colModel.config[i].hideable === false,
3710                    hideOnClick: false
3711                }));
3712            }
3713        }
3714    },
3715   
3716    /**
3717     * @private
3718     * Attached as the 'itemclick' handler to the header menu and the column show/hide submenu (if available).
3719     * Performs sorting if the sorter buttons were clicked, otherwise hides/shows the column that was clicked.
3720     */
3721    handleHdMenuClick : function(item) {
3722        var store     = this.ds,
3723            dataIndex = this.cm.getDataIndex(this.hdCtxIndex);
3724
3725        switch (item.getItemId()) {
3726            case 'asc':
3727                store.sort(dataIndex, 'ASC');
3728                break;
3729            case 'desc':
3730                store.sort(dataIndex, 'DESC');
3731                break;
3732            default:
3733                this.handleHdMenuClickDefault(item);
3734        }
3735        return true;
3736    },
3737   
3738    /**
3739     * Called by handleHdMenuClick if any button except a sort ASC/DESC button was clicked. The default implementation provides
3740     * the column hide/show functionality based on the check state of the menu item. A different implementation can be provided
3741     * if needed.
3742     * @param {Ext.menu.BaseItem} item The menu item that was clicked
3743     */
3744    handleHdMenuClickDefault: function(item) {
3745        var colModel = this.cm,
3746            itemId   = item.getItemId(),
3747            index    = colModel.getIndexById(itemId.substr(4));
3748
3749        if (index != -1) {
3750            if (item.checked && colModel.getColumnsBy(this.isHideableColumn, this).length <= 1) {
3751                this.onDenyColumnHide();
3752                return;
3753            }
3754            colModel.setHidden(index, item.checked);
3755        }
3756    },
3757
3758    /**
3759     * @private
3760     * Called when a header cell is clicked - shows the menu if the click happened over a trigger button
3761     */
3762    handleHdDown : function(e, target) {
3763        if (Ext.fly(target).hasClass('x-grid3-hd-btn')) {
3764            e.stopEvent();
3765           
3766            var colModel  = this.cm,
3767                header    = this.findHeaderCell(target),
3768                index     = this.getCellIndex(header),
3769                sortable  = colModel.isSortable(index),
3770                menu      = this.hmenu,
3771                menuItems = menu.items,
3772                menuCls   = this.headerMenuOpenCls;
3773           
3774            this.hdCtxIndex = index;
3775           
3776            Ext.fly(header).addClass(menuCls);
3777            menuItems.get('asc').setDisabled(!sortable);
3778            menuItems.get('desc').setDisabled(!sortable);
3779           
3780            menu.on('hide', function() {
3781                Ext.fly(header).removeClass(menuCls);
3782            }, this, {single:true});
3783           
3784            menu.show(target, 'tl-bl?');
3785        }
3786    },
3787
3788    /**
3789     * @private
3790     * Attached to the headers' mousemove event. This figures out the CSS cursor to use based on where the mouse is currently
3791     * pointed. If the mouse is currently hovered over the extreme left or extreme right of any header cell and the cell next
3792     * to it is resizable it is given the resize cursor, otherwise the cursor is set to an empty string.
3793     */
3794    handleHdMove : function(e) {
3795        var header = this.findHeaderCell(this.activeHdRef);
3796       
3797        if (header && !this.headersDisabled) {
3798            var handleWidth  = this.splitHandleWidth || 5,
3799                activeRegion = this.activeHdRegion,
3800                headerStyle  = header.style,
3801                colModel     = this.cm,
3802                cursor       = '',
3803                pageX        = e.getPageX();
3804               
3805            if (this.grid.enableColumnResize !== false) {
3806                var activeHeaderIndex = this.activeHdIndex,
3807                    previousVisible   = this.getPreviousVisible(activeHeaderIndex),
3808                    currentResizable  = colModel.isResizable(activeHeaderIndex),
3809                    previousResizable = previousVisible && colModel.isResizable(previousVisible),
3810                    inLeftResizer     = pageX - activeRegion.left <= handleWidth,
3811                    inRightResizer    = activeRegion.right - pageX <= (!this.activeHdBtn ? handleWidth : 2);
3812               
3813                if (inLeftResizer && previousResizable) {
3814                    cursor = Ext.isAir ? 'move' : Ext.isWebKit ? 'e-resize' : 'col-resize'; // col-resize not always supported
3815                } else if (inRightResizer && currentResizable) {
3816                    cursor = Ext.isAir ? 'move' : Ext.isWebKit ? 'w-resize' : 'col-resize';
3817                }
3818            }
3819           
3820            headerStyle.cursor = cursor;
3821        }
3822    },
3823   
3824    /**
3825     * @private
3826     * Returns the index of the nearest currently visible header to the left of the given index.
3827     * @param {Number} index The header index
3828     * @return {Number/undefined} The index of the nearest visible header
3829     */
3830    getPreviousVisible: function(index) {
3831        while (index > 0) {
3832            if (!this.cm.isHidden(index - 1)) {
3833                return index;
3834            }
3835            index--;
3836        }
3837        return undefined;
3838    },
3839
3840    /**
3841     * @private
3842     * Tied to the header element's mouseover event - adds the over class to the header cell if the menu is not disabled
3843     * for that cell
3844     */
3845    handleHdOver : function(e, target) {
3846        var header = this.findHeaderCell(target);
3847       
3848        if (header && !this.headersDisabled) {
3849            var fly = this.fly(header);
3850           
3851            this.activeHdRef = target;
3852            this.activeHdIndex = this.getCellIndex(header);
3853            this.activeHdRegion = fly.getRegion();
3854           
3855            if (!this.isMenuDisabled(this.activeHdIndex, fly)) {
3856                fly.addClass('x-grid3-hd-over');
3857                this.activeHdBtn = fly.child('.x-grid3-hd-btn');
3858               
3859                if (this.activeHdBtn) {
3860                    this.activeHdBtn.dom.style.height = (header.firstChild.offsetHeight - 1) + 'px';
3861                }
3862            }
3863        }
3864    },
3865
3866    /**
3867     * @private
3868     * Tied to the header element's mouseout event. Removes the hover class from the header cell
3869     */
3870    handleHdOut : function(e, target) {
3871        var header = this.findHeaderCell(target);
3872       
3873        if (header && (!Ext.isIE || !e.within(header, true))) {
3874            this.activeHdRef = null;
3875            this.fly(header).removeClass('x-grid3-hd-over');
3876            header.style.cursor = '';
3877        }
3878    },
3879   
3880    /**
3881     * @private
3882     * Used by {@link #handleHdOver} to determine whether or not to show the header menu class on cell hover
3883     * @param {Number} cellIndex The header cell index
3884     * @param {Ext.Element} el The cell element currently being hovered over
3885     */
3886    isMenuDisabled: function(cellIndex, el) {
3887        return this.cm.isMenuDisabled(cellIndex);
3888    },
3889
3890    /**
3891     * @private
3892     * Returns true if there are any rows rendered into the GridView
3893     * @return {Boolean} True if any rows have been rendered
3894     */
3895    hasRows : function() {
3896        var fc = this.mainBody.dom.firstChild;
3897        return fc && fc.nodeType == 1 && fc.className != 'x-grid-empty';
3898    },
3899   
3900    /**
3901     * @private
3902     */
3903    isHideableColumn : function(c) {
3904        return !c.hidden;
3905    },
3906
3907    /**
3908     * @private
3909     * DEPRECATED - will be removed in Ext JS 5.0
3910     */
3911    bind : function(d, c) {
3912        this.initData(d, c);
3913    }
3914});
3915
3916
3917// private
3918// This is a support class used internally by the Grid components
3919Ext.grid.GridView.SplitDragZone = Ext.extend(Ext.dd.DDProxy, {
3920
3921    constructor: function(grid, hd){
3922        this.grid = grid;
3923        this.view = grid.getView();
3924        this.marker = this.view.resizeMarker;
3925        this.proxy = this.view.resizeProxy;
3926        Ext.grid.GridView.SplitDragZone.superclass.constructor.call(this, hd,
3927            'gridSplitters' + this.grid.getGridEl().id, {
3928            dragElId : Ext.id(this.proxy.dom), resizeFrame:false
3929        });
3930        this.scroll = false;
3931        this.hw = this.view.splitHandleWidth || 5;
3932    },
3933
3934    b4StartDrag : function(x, y){
3935        this.dragHeadersDisabled = this.view.headersDisabled;
3936        this.view.headersDisabled = true;
3937        var h = this.view.mainWrap.getHeight();
3938        this.marker.setHeight(h);
3939        this.marker.show();
3940        this.marker.alignTo(this.view.getHeaderCell(this.cellIndex), 'tl-tl', [-2, 0]);
3941        this.proxy.setHeight(h);
3942        var w = this.cm.getColumnWidth(this.cellIndex),
3943            minw = Math.max(w-this.grid.minColumnWidth, 0);
3944        this.resetConstraints();
3945        this.setXConstraint(minw, 1000);
3946        this.setYConstraint(0, 0);
3947        this.minX = x - minw;
3948        this.maxX = x + 1000;
3949        this.startPos = x;
3950        Ext.dd.DDProxy.prototype.b4StartDrag.call(this, x, y);
3951    },
3952
3953    allowHeaderDrag : function(e){
3954        return true;
3955    },
3956
3957    handleMouseDown : function(e){
3958        var t = this.view.findHeaderCell(e.getTarget());
3959        if(t && this.allowHeaderDrag(e)){
3960            var xy = this.view.fly(t).getXY(), 
3961                x = xy[0],
3962                exy = e.getXY(), 
3963                ex = exy[0],
3964                w = t.offsetWidth, 
3965                adjust = false;
3966               
3967            if((ex - x) <= this.hw){
3968                adjust = -1;
3969            }else if((x+w) - ex <= this.hw){
3970                adjust = 0;
3971            }
3972            if(adjust !== false){
3973                this.cm = this.grid.colModel;
3974                var ci = this.view.getCellIndex(t);
3975                if(adjust == -1){
3976                  if (ci + adjust < 0) {
3977                    return;
3978                  }
3979                    while(this.cm.isHidden(ci+adjust)){
3980                        --adjust;
3981                        if(ci+adjust < 0){
3982                            return;
3983                        }
3984                    }
3985                }
3986                this.cellIndex = ci+adjust;
3987                this.split = t.dom;
3988                if(this.cm.isResizable(this.cellIndex) && !this.cm.isFixed(this.cellIndex)){
3989                    Ext.grid.GridView.SplitDragZone.superclass.handleMouseDown.apply(this, arguments);
3990                }
3991            }else if(this.view.columnDrag){
3992                this.view.columnDrag.callHandleMouseDown(e);
3993            }
3994        }
3995    },
3996
3997    endDrag : function(e){
3998        this.marker.hide();
3999        var v = this.view,
4000            endX = Math.max(this.minX, e.getPageX()),
4001            diff = endX - this.startPos,
4002            disabled = this.dragHeadersDisabled;
4003           
4004        v.onColumnSplitterMoved(this.cellIndex, this.cm.getColumnWidth(this.cellIndex)+diff);
4005        setTimeout(function(){
4006            v.headersDisabled = disabled;
4007        }, 50);
4008    },
4009
4010    autoOffset : function(){
4011        this.setDelta(0,0);
4012    }
4013});
4014/**
4015 * @class Ext.grid.PivotGridView
4016 * @extends Ext.grid.GridView
4017 * Specialised GridView for rendering Pivot Grid components. Config can be passed to the PivotGridView via the PivotGrid constructor's
4018 * viewConfig option:
4019<pre><code>
4020new Ext.grid.PivotGrid({
4021    viewConfig: {
4022        title: 'My Pivot Grid',
4023        getCellCls: function(value) {
4024            return value > 10 'red' : 'green';
4025        }
4026    }
4027});
4028</code></pre>
4029 * <p>Currently {@link #title} and {@link #getCellCls} are the only configuration options accepted by PivotGridView. All other
4030 * interaction is performed via the {@link Ext.grid.PivotGrid PivotGrid} class.</p>
4031 */
4032Ext.grid.PivotGridView = Ext.extend(Ext.grid.GridView, {
4033   
4034    /**
4035     * The CSS class added to all group header cells. Defaults to 'grid-hd-group-cell'
4036     * @property colHeaderCellCls
4037     * @type String
4038     */
4039    colHeaderCellCls: 'grid-hd-group-cell',
4040   
4041    /**
4042     * @cfg {String} title Optional title to be placed in the top left corner of the PivotGrid. Defaults to an empty string.
4043     */
4044    title: '',
4045   
4046    /**
4047     * @cfg {Function} getCellCls Optional function which should return a CSS class name for each cell value. This is useful when
4048     * color coding cells based on their value. Defaults to undefined.
4049     */
4050   
4051    /**
4052     * Returns the headers to be rendered at the top of the grid. Should be a 2-dimensional array, where each item specifies the number
4053     * of columns it groups (column in this case refers to normal grid columns). In the example below we have 5 city groups, which are
4054     * each part of a continent supergroup. The colspan for each city group refers to the number of normal grid columns that group spans,
4055     * so in this case the grid would be expected to have a total of 12 columns:
4056<pre><code>
4057[
4058    {
4059        items: [
4060            {header: 'England',   colspan: 5},
4061            {header: 'USA',       colspan: 3}
4062        ]
4063    },
4064    {
4065        items: [
4066            {header: 'London',    colspan: 2},
4067            {header: 'Cambridge', colspan: 3},
4068            {header: 'Palo Alto', colspan: 3}
4069        ]
4070    }
4071]
4072</code></pre>
4073     * In the example above we have cities nested under countries. The nesting could be deeper if desired - e.g. Continent -> Country ->
4074     * State -> City, or any other structure. The only constaint is that the same depth must be used throughout the structure.
4075     * @return {Array} A tree structure containing the headers to be rendered. Must include the colspan property at each level, which should
4076     * be the sum of all child nodes beneath this node.
4077     */
4078    getColumnHeaders: function() {
4079        return this.grid.topAxis.buildHeaders();;
4080    },
4081   
4082    /**
4083     * Returns the headers to be rendered on the left of the grid. Should be a 2-dimensional array, where each item specifies the number
4084     * of rows it groups. In the example below we have 5 city groups, which are each part of a continent supergroup. The rowspan for each
4085     * city group refers to the number of normal grid columns that group spans, so in this case the grid would be expected to have a
4086     * total of 12 rows:
4087<pre><code>
4088[
4089    {
4090        width: 90,
4091        items: [
4092            {header: 'England',   rowspan: 5},
4093            {header: 'USA',       rowspan: 3}
4094        ]
4095    },
4096    {
4097        width: 50,
4098        items: [
4099            {header: 'London',    rowspan: 2},
4100            {header: 'Cambridge', rowspan: 3},
4101            {header: 'Palo Alto', rowspan: 3}
4102        ]
4103    }
4104]
4105</code></pre>
4106     * In the example above we have cities nested under countries. The nesting could be deeper if desired - e.g. Continent -> Country ->
4107     * State -> City, or any other structure. The only constaint is that the same depth must be used throughout the structure.
4108     * @return {Array} A tree structure containing the headers to be rendered. Must include the colspan property at each level, which should
4109     * be the sum of all child nodes beneath this node.
4110     * Each group may specify the width it should be rendered with.
4111     * @return {Array} The row groups
4112     */
4113    getRowHeaders: function() {
4114        return this.grid.leftAxis.buildHeaders();
4115    },
4116   
4117    /**
4118     * @private
4119     * Renders rows between start and end indexes
4120     * @param {Number} startRow Index of the first row to render
4121     * @param {Number} endRow Index of the last row to render
4122     */
4123    renderRows : function(startRow, endRow) {
4124        var grid          = this.grid,
4125            rows          = grid.extractData(),
4126            rowCount      = rows.length,
4127            templates     = this.templates,
4128            renderer      = grid.renderer,
4129            hasRenderer   = typeof renderer == 'function',
4130            getCellCls    = this.getCellCls,
4131            hasGetCellCls = typeof getCellCls == 'function',
4132            cellTemplate  = templates.cell,
4133            rowTemplate   = templates.row,
4134            rowBuffer     = [],
4135            meta          = {},
4136            tstyle        = 'width:' + this.getGridInnerWidth() + 'px;',
4137            colBuffer, colCount, column, i, row;
4138       
4139        startRow = startRow || 0;
4140        endRow   = Ext.isDefined(endRow) ? endRow : rowCount - 1;
4141       
4142        for (i = 0; i < rowCount; i++) {
4143            row = rows[i];
4144            colCount  = row.length;
4145            colBuffer = [];
4146           
4147            //build up each column's HTML
4148            for (var j = 0; j < colCount; j++) {
4149               
4150                meta.id    = i + '-' + j;
4151                meta.css   = j === 0 ? 'x-grid3-cell-first ' : (j == (colCount - 1) ? 'x-grid3-cell-last ' : '');
4152                meta.attr  = meta.cellAttr = '';
4153                meta.value = row[j];
4154
4155                if (Ext.isEmpty(meta.value)) {
4156                    meta.value = '&#160;';
4157                }
4158               
4159                if (hasRenderer) {
4160                    meta.value = renderer(meta.value);
4161                }
4162               
4163                if (hasGetCellCls) {
4164                    meta.css += getCellCls(meta.value) + ' ';
4165                }
4166
4167                colBuffer[colBuffer.length] = cellTemplate.apply(meta);
4168            }
4169           
4170            rowBuffer[rowBuffer.length] = rowTemplate.apply({
4171                tstyle: tstyle,
4172                cols  : colCount,
4173                cells : colBuffer.join(""),
4174                alt   : ''
4175            });
4176        }
4177       
4178        return rowBuffer.join("");
4179    },
4180   
4181    /**
4182     * The master template to use when rendering the GridView. Has a default template
4183     * @property Ext.Template
4184     * @type masterTpl
4185     */
4186    masterTpl: new Ext.Template(
4187        '<div class="x-grid3 x-pivotgrid" hidefocus="true">',
4188            '<div class="x-grid3-viewport">',
4189                '<div class="x-grid3-header">',
4190                    '<div class="x-grid3-header-title"><span>{title}</span></div>',
4191                    '<div class="x-grid3-header-inner">',
4192                        '<div class="x-grid3-header-offset" style="{ostyle}"></div>',
4193                    '</div>',
4194                    '<div class="x-clear"></div>',
4195                '</div>',
4196                '<div class="x-grid3-scroller">',
4197                    '<div class="x-grid3-row-headers"></div>',
4198                    '<div class="x-grid3-body" style="{bstyle}">{body}</div>',
4199                    '<a href="#" class="x-grid3-focus" tabIndex="-1"></a>',
4200                '</div>',
4201            '</div>',
4202            '<div class="x-grid3-resize-marker">&#160;</div>',
4203            '<div class="x-grid3-resize-proxy">&#160;</div>',
4204        '</div>'
4205    ),
4206   
4207    /**
4208     * @private
4209     * Adds a gcell template to the internal templates object. This is used to render the headers in a multi-level column header.
4210     */
4211    initTemplates: function() {
4212        Ext.grid.PivotGridView.superclass.initTemplates.apply(this, arguments);
4213       
4214        var templates = this.templates || {};
4215        if (!templates.gcell) {
4216            templates.gcell = new Ext.XTemplate(
4217                '<td class="x-grid3-hd x-grid3-gcell x-grid3-td-{id} ux-grid-hd-group-row-{row} ' + this.colHeaderCellCls + '" style="{style}">',
4218                    '<div {tooltip} class="x-grid3-hd-inner x-grid3-hd-{id}" unselectable="on" style="{istyle}">', 
4219                        this.grid.enableHdMenu ? '<a class="x-grid3-hd-btn" href="#"></a>' : '', '{value}',
4220                    '</div>',
4221                '</td>'
4222            );
4223        }
4224       
4225        this.templates = templates;
4226        this.hrowRe = new RegExp("ux-grid-hd-group-row-(\\d+)", "");
4227    },
4228   
4229    /**
4230     * @private
4231     * Sets up the reference to the row headers element
4232     */
4233    initElements: function() {
4234        Ext.grid.PivotGridView.superclass.initElements.apply(this, arguments);
4235       
4236        /**
4237         * @property rowHeadersEl
4238         * @type Ext.Element
4239         * The element containing all row headers
4240         */
4241        this.rowHeadersEl = new Ext.Element(this.scroller.child('div.x-grid3-row-headers'));
4242       
4243        /**
4244         * @property headerTitleEl
4245         * @type Ext.Element
4246         * The element that contains the optional title (top left section of the pivot grid)
4247         */
4248        this.headerTitleEl = new Ext.Element(this.mainHd.child('div.x-grid3-header-title'));
4249    },
4250   
4251    /**
4252     * @private
4253     * Takes row headers into account when calculating total available width
4254     */
4255    getGridInnerWidth: function() {
4256        var previousWidth = Ext.grid.PivotGridView.superclass.getGridInnerWidth.apply(this, arguments);
4257       
4258        return previousWidth - this.getTotalRowHeaderWidth();
4259    },
4260   
4261    /**
4262     * Returns the total width of all row headers as specified by {@link #getRowHeaders}
4263     * @return {Number} The total width
4264     */
4265    getTotalRowHeaderWidth: function() {
4266        var headers = this.getRowHeaders(),
4267            length  = headers.length,
4268            total   = 0,
4269            i;
4270       
4271        for (i = 0; i< length; i++) {
4272            total += headers[i].width;
4273        }
4274       
4275        return total;
4276    },
4277   
4278    /**
4279     * @private
4280     * Returns the total height of all column headers
4281     * @return {Number} The total height
4282     */
4283    getTotalColumnHeaderHeight: function() {
4284        return this.getColumnHeaders().length * 21;
4285    },
4286   
4287    /**
4288     * Inherit docs
4289     * @private
4290     * @param {HTMLElement} el
4291     */
4292    getCellIndex : function(el) {
4293        if (el) {
4294            var match = el.className.match(this.colRe),
4295                data;
4296 
4297            if (match && (data = match[1])) {
4298                return parseInt(data.split('-')[1], 10);
4299            }
4300        }
4301        return false;
4302    },
4303   
4304   
4305    /**
4306     * @private
4307     * Slight specialisation of the GridView renderUI - just adds the row headers
4308     */
4309    renderUI : function() {
4310        var templates  = this.templates,
4311            innerWidth = this.getGridInnerWidth();
4312           
4313        return templates.master.apply({
4314            body  : templates.body.apply({rows:'&#160;'}),
4315            ostyle: 'width:' + innerWidth + 'px',
4316            bstyle: 'width:' + innerWidth + 'px'
4317        });
4318    },
4319   
4320    /**
4321     * @private
4322     * Make sure that the headers and rows are all sized correctly during layout
4323     */
4324    onLayout: function(width, height) {
4325        Ext.grid.PivotGridView.superclass.onLayout.apply(this, arguments);
4326       
4327        var width = this.getGridInnerWidth();
4328       
4329        this.resizeColumnHeaders(width);
4330        this.resizeAllRows(width);
4331    },
4332   
4333    /**
4334     * Refreshs the grid UI
4335     * @param {Boolean} headersToo (optional) True to also refresh the headers
4336     */
4337    refresh : function(headersToo) {
4338        this.fireEvent('beforerefresh', this);
4339        this.grid.stopEditing(true);
4340       
4341        var result = this.renderBody();
4342        this.mainBody.update(result).setWidth(this.getGridInnerWidth());
4343        if (headersToo === true) {
4344            this.updateHeaders();
4345            this.updateHeaderSortState();
4346        }
4347        this.processRows(0, true);
4348        this.layout();
4349        this.applyEmptyText();
4350        this.fireEvent('refresh', this);
4351    },
4352   
4353    /**
4354     * @private
4355     * Bypasses GridView's renderHeaders as they are taken care of separately by the PivotAxis instances
4356     */
4357    renderHeaders: Ext.emptyFn,
4358   
4359    /**
4360     * @private
4361     * Taken care of by PivotAxis
4362     */
4363    fitColumns: Ext.emptyFn,
4364   
4365    /**
4366     * @private
4367     * Called on layout, ensures that the width of each column header is correct. Omitting this can lead to faulty
4368     * layouts when nested in a container.
4369     * @param {Number} width The new width
4370     */
4371    resizeColumnHeaders: function(width) {
4372        var topAxis = this.grid.topAxis;
4373       
4374        if (topAxis.rendered) {
4375            topAxis.el.setWidth(width);
4376        }
4377    },
4378   
4379    /**
4380     * @private
4381     * Sets the row header div to the correct width. Should be called after rendering and reconfiguration of headers
4382     */
4383    resizeRowHeaders: function() {
4384        var rowHeaderWidth = this.getTotalRowHeaderWidth(),
4385            marginStyle    = String.format("margin-left: {0}px;", rowHeaderWidth);
4386       
4387        this.rowHeadersEl.setWidth(rowHeaderWidth);
4388        this.mainBody.applyStyles(marginStyle);
4389        Ext.fly(this.innerHd).applyStyles(marginStyle);
4390       
4391        this.headerTitleEl.setWidth(rowHeaderWidth);
4392        this.headerTitleEl.setHeight(this.getTotalColumnHeaderHeight());
4393    },
4394   
4395    /**
4396     * @private
4397     * Resizes all rendered rows to the given width. Usually called by onLayout
4398     * @param {Number} width The new width
4399     */
4400    resizeAllRows: function(width) {
4401        var rows   = this.getRows(),
4402            length = rows.length,
4403            i;
4404       
4405        for (i = 0; i < length; i++) {
4406            Ext.fly(rows[i]).setWidth(width);
4407            Ext.fly(rows[i]).child('table').setWidth(width);
4408        }
4409    },
4410   
4411    /**
4412     * @private
4413     * Updates the Row Headers, deferring the updating of Column Headers to GridView
4414     */
4415    updateHeaders: function() {
4416        this.renderGroupRowHeaders();
4417        this.renderGroupColumnHeaders();
4418    },
4419   
4420    /**
4421     * @private
4422     * Renders all row header groups at all levels based on the structure fetched from {@link #getGroupRowHeaders}
4423     */
4424    renderGroupRowHeaders: function() {
4425        var leftAxis = this.grid.leftAxis;
4426       
4427        this.resizeRowHeaders();
4428        leftAxis.rendered = false;
4429        leftAxis.render(this.rowHeadersEl);
4430       
4431        this.setTitle(this.title);
4432    },
4433   
4434    /**
4435     * Sets the title text in the top left segment of the PivotGridView
4436     * @param {String} title The title
4437     */
4438    setTitle: function(title) {
4439        this.headerTitleEl.child('span').dom.innerHTML = title;
4440    },
4441   
4442    /**
4443     * @private
4444     * Renders all column header groups at all levels based on the structure fetched from {@link #getColumnHeaders}
4445     */
4446    renderGroupColumnHeaders: function() {
4447        var topAxis = this.grid.topAxis;
4448       
4449        topAxis.rendered = false;
4450        topAxis.render(this.innerHd.firstChild);
4451    },
4452   
4453    /**
4454     * @private
4455     * Overridden to test whether the user is hovering over a group cell, in which case we don't show the menu
4456     */
4457    isMenuDisabled: function(cellIndex, el) {
4458        return true;
4459    }
4460});/**
4461 * @class Ext.grid.PivotAxis
4462 * @extends Ext.Component
4463 * <p>PivotAxis is a class that supports a {@link Ext.grid.PivotGrid}. Each PivotGrid contains two PivotAxis instances - the left
4464 * axis and the top axis. Each PivotAxis defines an ordered set of dimensions, each of which should correspond to a field in a
4465 * Store's Record (see {@link Ext.grid.PivotGrid} documentation for further explanation).</p>
4466 * <p>Developers should have little interaction with the PivotAxis instances directly as most of their management is performed by
4467 * the PivotGrid. An exception is the dynamic reconfiguration of axes at run time - to achieve this we use PivotAxis's
4468 * {@link #setDimensions} function and refresh the grid:</p>
4469<pre><code>
4470var pivotGrid = new Ext.grid.PivotGrid({
4471    //some PivotGrid config here
4472});
4473
4474//change the left axis dimensions
4475pivotGrid.leftAxis.setDimensions([
4476    {
4477        dataIndex: 'person',
4478        direction: 'DESC',
4479        width    : 100
4480    },
4481    {
4482        dataIndex: 'product',
4483        direction: 'ASC',
4484        width    : 80
4485    }
4486]);
4487
4488pivotGrid.view.refresh(true);
4489</code></pre>
4490 * This clears the previous dimensions on the axis and redraws the grid with the new dimensions.
4491 */
4492Ext.grid.PivotAxis = Ext.extend(Ext.Component, {
4493    /**
4494     * @cfg {String} orientation One of 'vertical' or 'horizontal'. Defaults to horizontal
4495     */
4496    orientation: 'horizontal',
4497   
4498    /**
4499     * @cfg {Number} defaultHeaderWidth The width to render each row header that does not have a width specified via
4500     {@link #getRowGroupHeaders}. Defaults to 80.
4501     */
4502    defaultHeaderWidth: 80,
4503   
4504    /**
4505     * @private
4506     * @cfg {Number} paddingWidth The amount of padding used by each cell.
4507     * TODO: From 4.x onwards this can be removed as it won't be needed. For now it is used to account for the differences between
4508     * the content box and border box measurement models
4509     */
4510    paddingWidth: 7,
4511   
4512    /**
4513     * Updates the dimensions used by this axis
4514     * @param {Array} dimensions The new dimensions
4515     */
4516    setDimensions: function(dimensions) {
4517        this.dimensions = dimensions;
4518    },
4519   
4520    /**
4521     * @private
4522     * Builds the html table that contains the dimensions for this axis. This branches internally between vertical
4523     * and horizontal orientations because the table structure is slightly different in each case
4524     */
4525    onRender: function(ct, position) {
4526        var rows = this.orientation == 'horizontal'
4527                 ? this.renderHorizontalRows()
4528                 : this.renderVerticalRows();
4529       
4530        this.el = Ext.DomHelper.overwrite(ct.dom, {tag: 'table', cn: rows}, true);
4531    },
4532   
4533    /**
4534     * @private
4535     * Specialised renderer for horizontal oriented axes
4536     * @return {Object} The HTML Domspec for a horizontal oriented axis
4537     */
4538    renderHorizontalRows: function() {
4539        var headers  = this.buildHeaders(),
4540            rowCount = headers.length,
4541            rows     = [],
4542            cells, cols, colCount, i, j;
4543       
4544        for (i = 0; i < rowCount; i++) {
4545            cells = [];
4546            cols  = headers[i].items;
4547            colCount = cols.length;
4548
4549            for (j = 0; j < colCount; j++) {
4550                cells.push({
4551                    tag: 'td',
4552                    html: cols[j].header,
4553                    colspan: cols[j].span
4554                });
4555            }
4556
4557            rows[i] = {
4558                tag: 'tr',
4559                cn: cells
4560            };
4561        }
4562       
4563        return rows;
4564    },
4565   
4566    /**
4567     * @private
4568     * Specialised renderer for vertical oriented axes
4569     * @return {Object} The HTML Domspec for a vertical oriented axis
4570     */
4571    renderVerticalRows: function() {
4572        var headers  = this.buildHeaders(),
4573            colCount = headers.length,
4574            rowCells = [],
4575            rows     = [],
4576            rowCount, col, row, colWidth, i, j;
4577       
4578        for (i = 0; i < colCount; i++) {
4579            col = headers[i];
4580            colWidth = col.width || 80;
4581            rowCount = col.items.length;
4582           
4583            for (j = 0; j < rowCount; j++) {
4584                row = col.items[j];
4585               
4586                rowCells[row.start] = rowCells[row.start] || [];
4587                rowCells[row.start].push({
4588                    tag    : 'td',
4589                    html   : row.header,
4590                    rowspan: row.span,
4591                    width  : Ext.isBorderBox ? colWidth : colWidth - this.paddingWidth
4592                });
4593            }
4594        }
4595       
4596        rowCount = rowCells.length;
4597        for (i = 0; i < rowCount; i++) {
4598            rows[i] = {
4599                tag: 'tr',
4600                cn : rowCells[i]
4601            };
4602        }
4603       
4604        return rows;
4605    },
4606   
4607    /**
4608     * @private
4609     * Returns the set of all unique tuples based on the bound store and dimension definitions.
4610     * Internally we construct a new, temporary store to make use of the multi-sort capabilities of Store. In
4611     * 4.x this functionality should have been moved to MixedCollection so this step should not be needed.
4612     * @return {Array} All unique tuples
4613     */
4614    getTuples: function() {
4615        var newStore = new Ext.data.Store({});
4616       
4617        newStore.data = this.store.data.clone();
4618        newStore.fields = this.store.fields;
4619       
4620        var sorters    = [],
4621            dimensions = this.dimensions,
4622            length     = dimensions.length,
4623            i;
4624       
4625        for (i = 0; i < length; i++) {
4626            sorters.push({
4627                field    : dimensions[i].dataIndex,
4628                direction: dimensions[i].direction || 'ASC'
4629            });
4630        }
4631       
4632        newStore.sort(sorters);
4633       
4634        var records = newStore.data.items,
4635            hashes  = [],
4636            tuples  = [],
4637            recData, hash, info, data, key;
4638       
4639        length = records.length;
4640       
4641        for (i = 0; i < length; i++) {
4642            info = this.getRecordInfo(records[i]);
4643            data = info.data;
4644            hash = "";
4645           
4646            for (key in data) {
4647                hash += data[key] + '---';
4648            }
4649           
4650            if (hashes.indexOf(hash) == -1) {
4651                hashes.push(hash);
4652                tuples.push(info);
4653            }
4654        }
4655       
4656        newStore.destroy();
4657       
4658        return tuples;
4659    },
4660   
4661    /**
4662     * @private
4663     */
4664    getRecordInfo: function(record) {
4665        var dimensions = this.dimensions,
4666            length  = dimensions.length,
4667            data    = {},
4668            dimension, dataIndex, i;
4669       
4670        //get an object containing just the data we are interested in based on the configured dimensions
4671        for (i = 0; i < length; i++) {
4672            dimension = dimensions[i];
4673            dataIndex = dimension.dataIndex;
4674           
4675            data[dataIndex] = record.get(dataIndex);
4676        }
4677       
4678        //creates a specialised matcher function for a given tuple. The returned function will return
4679        //true if the record passed to it matches the dataIndex values of each dimension in this axis
4680        var createMatcherFunction = function(data) {
4681            return function(record) {
4682                for (var dataIndex in data) {
4683                    if (record.get(dataIndex) != data[dataIndex]) {
4684                        return false;
4685                    }
4686                }
4687               
4688                return true;
4689            };
4690        };
4691       
4692        return {
4693            data: data,
4694            matcher: createMatcherFunction(data)
4695        };
4696    },
4697   
4698    /**
4699     * @private
4700     * Uses the calculated set of tuples to build an array of headers that can be rendered into a table using rowspan or
4701     * colspan. Basically this takes the set of tuples and spans any cells that run into one another, so if we had dimensions
4702     * of Person and Product and several tuples containing different Products for the same Person, those Products would be
4703     * spanned.
4704     * @return {Array} The headers
4705     */
4706    buildHeaders: function() {
4707        var tuples     = this.getTuples(),
4708            rowCount   = tuples.length,
4709            dimensions = this.dimensions,
4710            dimension,
4711            colCount   = dimensions.length,
4712            headers    = [],
4713            tuple, rows, currentHeader, previousHeader, span, start, isLast, changed, i, j;
4714       
4715        for (i = 0; i < colCount; i++) {
4716            dimension = dimensions[i];
4717            rows  = [];
4718            span  = 0;
4719            start = 0;
4720           
4721            for (j = 0; j < rowCount; j++) {
4722                tuple  = tuples[j];
4723                isLast = j == (rowCount - 1);
4724                currentHeader = tuple.data[dimension.dataIndex];
4725               
4726                /*
4727                 * 'changed' indicates that we need to create a new cell. This should be true whenever the cell
4728                 * above (previousHeader) is different from this cell, or when the cell on the previous dimension
4729                 * changed (e.g. if the current dimension is Product and the previous was Person, we need to start
4730                 * a new cell if Product is the same but Person changed, so we check the previous dimension and tuple)
4731                 */
4732                changed = previousHeader != undefined && previousHeader != currentHeader;
4733                if (i > 0 && j > 0) {
4734                    changed = changed || tuple.data[dimensions[i-1].dataIndex] != tuples[j-1].data[dimensions[i-1].dataIndex];
4735                }
4736               
4737                if (changed) {                   
4738                    rows.push({
4739                        header: previousHeader,
4740                        span  : span,
4741                        start : start
4742                    });
4743                   
4744                    start += span;
4745                    span = 0;
4746                }
4747               
4748                if (isLast) {
4749                    rows.push({
4750                        header: currentHeader,
4751                        span  : span + 1,
4752                        start : start
4753                    });
4754                   
4755                    start += span;
4756                    span = 0;
4757                }
4758               
4759                previousHeader = currentHeader;
4760                span++;
4761            }
4762           
4763            headers.push({
4764                items: rows,
4765                width: dimension.width || this.defaultHeaderWidth
4766            });
4767           
4768            previousHeader = undefined;
4769        }
4770       
4771        return headers;
4772    }
4773});
4774// private
4775// This is a support class used internally by the Grid components
4776Ext.grid.HeaderDragZone = Ext.extend(Ext.dd.DragZone, {
4777    maxDragWidth: 120,
4778   
4779    constructor : function(grid, hd, hd2){
4780        this.grid = grid;
4781        this.view = grid.getView();
4782        this.ddGroup = "gridHeader" + this.grid.getGridEl().id;
4783        Ext.grid.HeaderDragZone.superclass.constructor.call(this, hd);
4784        if(hd2){
4785            this.setHandleElId(Ext.id(hd));
4786            this.setOuterHandleElId(Ext.id(hd2));
4787        }
4788        this.scroll = false;
4789    },
4790   
4791    getDragData : function(e){
4792        var t = Ext.lib.Event.getTarget(e),
4793            h = this.view.findHeaderCell(t);
4794        if(h){
4795            return {ddel: h.firstChild, header:h};
4796        }
4797        return false;
4798    },
4799
4800    onInitDrag : function(e){
4801        // keep the value here so we can restore it;
4802        this.dragHeadersDisabled = this.view.headersDisabled;
4803        this.view.headersDisabled = true;
4804        var clone = this.dragData.ddel.cloneNode(true);
4805        clone.id = Ext.id();
4806        clone.style.width = Math.min(this.dragData.header.offsetWidth,this.maxDragWidth) + "px";
4807        this.proxy.update(clone);
4808        return true;
4809    },
4810
4811    afterValidDrop : function(){
4812        this.completeDrop();
4813    },
4814
4815    afterInvalidDrop : function(){
4816        this.completeDrop();
4817    },
4818   
4819    completeDrop: function(){
4820        var v = this.view,
4821            disabled = this.dragHeadersDisabled;
4822        setTimeout(function(){
4823            v.headersDisabled = disabled;
4824        }, 50);
4825    }
4826});
4827
4828// private
4829// This is a support class used internally by the Grid components
4830Ext.grid.HeaderDropZone = Ext.extend(Ext.dd.DropZone, {
4831    proxyOffsets : [-4, -9],
4832    fly: Ext.Element.fly,
4833   
4834    constructor : function(grid, hd, hd2){
4835        this.grid = grid;
4836        this.view = grid.getView();
4837        // split the proxies so they don't interfere with mouse events
4838        this.proxyTop = Ext.DomHelper.append(document.body, {
4839            cls:"col-move-top", html:"&#160;"
4840        }, true);
4841        this.proxyBottom = Ext.DomHelper.append(document.body, {
4842            cls:"col-move-bottom", html:"&#160;"
4843        }, true);
4844        this.proxyTop.hide = this.proxyBottom.hide = function(){
4845            this.setLeftTop(-100,-100);
4846            this.setStyle("visibility", "hidden");
4847        };
4848        this.ddGroup = "gridHeader" + this.grid.getGridEl().id;
4849        // temporarily disabled
4850        //Ext.dd.ScrollManager.register(this.view.scroller.dom);
4851        Ext.grid.HeaderDropZone.superclass.constructor.call(this, grid.getGridEl().dom);
4852    },
4853
4854    getTargetFromEvent : function(e){
4855        var t = Ext.lib.Event.getTarget(e),
4856            cindex = this.view.findCellIndex(t);
4857        if(cindex !== false){
4858            return this.view.getHeaderCell(cindex);
4859        }
4860    },
4861
4862    nextVisible : function(h){
4863        var v = this.view, cm = this.grid.colModel;
4864        h = h.nextSibling;
4865        while(h){
4866            if(!cm.isHidden(v.getCellIndex(h))){
4867                return h;
4868            }
4869            h = h.nextSibling;
4870        }
4871        return null;
4872    },
4873
4874    prevVisible : function(h){
4875        var v = this.view, cm = this.grid.colModel;
4876        h = h.prevSibling;
4877        while(h){
4878            if(!cm.isHidden(v.getCellIndex(h))){
4879                return h;
4880            }
4881            h = h.prevSibling;
4882        }
4883        return null;
4884    },
4885
4886    positionIndicator : function(h, n, e){
4887        var x = Ext.lib.Event.getPageX(e),
4888            r = Ext.lib.Dom.getRegion(n.firstChild),
4889            px, 
4890            pt, 
4891            py = r.top + this.proxyOffsets[1];
4892        if((r.right - x) <= (r.right-r.left)/2){
4893            px = r.right+this.view.borderWidth;
4894            pt = "after";
4895        }else{
4896            px = r.left;
4897            pt = "before";
4898        }
4899
4900        if(this.grid.colModel.isFixed(this.view.getCellIndex(n))){
4901            return false;
4902        }
4903
4904        px +=  this.proxyOffsets[0];
4905        this.proxyTop.setLeftTop(px, py);
4906        this.proxyTop.show();
4907        if(!this.bottomOffset){
4908            this.bottomOffset = this.view.mainHd.getHeight();
4909        }
4910        this.proxyBottom.setLeftTop(px, py+this.proxyTop.dom.offsetHeight+this.bottomOffset);
4911        this.proxyBottom.show();
4912        return pt;
4913    },
4914
4915    onNodeEnter : function(n, dd, e, data){
4916        if(data.header != n){
4917            this.positionIndicator(data.header, n, e);
4918        }
4919    },
4920
4921    onNodeOver : function(n, dd, e, data){
4922        var result = false;
4923        if(data.header != n){
4924            result = this.positionIndicator(data.header, n, e);
4925        }
4926        if(!result){
4927            this.proxyTop.hide();
4928            this.proxyBottom.hide();
4929        }
4930        return result ? this.dropAllowed : this.dropNotAllowed;
4931    },
4932
4933    onNodeOut : function(n, dd, e, data){
4934        this.proxyTop.hide();
4935        this.proxyBottom.hide();
4936    },
4937
4938    onNodeDrop : function(n, dd, e, data){
4939        var h = data.header;
4940        if(h != n){
4941            var cm = this.grid.colModel,
4942                x = Ext.lib.Event.getPageX(e),
4943                r = Ext.lib.Dom.getRegion(n.firstChild),
4944                pt = (r.right - x) <= ((r.right-r.left)/2) ? "after" : "before",
4945                oldIndex = this.view.getCellIndex(h),
4946                newIndex = this.view.getCellIndex(n);
4947            if(pt == "after"){
4948                newIndex++;
4949            }
4950            if(oldIndex < newIndex){
4951                newIndex--;
4952            }
4953            cm.moveColumn(oldIndex, newIndex);
4954            return true;
4955        }
4956        return false;
4957    }
4958});
4959
4960Ext.grid.GridView.ColumnDragZone = Ext.extend(Ext.grid.HeaderDragZone, {
4961   
4962    constructor : function(grid, hd){
4963        Ext.grid.GridView.ColumnDragZone.superclass.constructor.call(this, grid, hd, null);
4964        this.proxy.el.addClass('x-grid3-col-dd');
4965    },
4966   
4967    handleMouseDown : function(e){
4968    },
4969
4970    callHandleMouseDown : function(e){
4971        Ext.grid.GridView.ColumnDragZone.superclass.handleMouseDown.call(this, e);
4972    }
4973});// private
4974// This is a support class used internally by the Grid components
4975Ext.grid.SplitDragZone = Ext.extend(Ext.dd.DDProxy, {
4976    fly: Ext.Element.fly,
4977   
4978    constructor : function(grid, hd, hd2){
4979        this.grid = grid;
4980        this.view = grid.getView();
4981        this.proxy = this.view.resizeProxy;
4982        Ext.grid.SplitDragZone.superclass.constructor.call(this, hd,
4983            "gridSplitters" + this.grid.getGridEl().id, {
4984            dragElId : Ext.id(this.proxy.dom), resizeFrame:false
4985        });
4986        this.setHandleElId(Ext.id(hd));
4987        this.setOuterHandleElId(Ext.id(hd2));
4988        this.scroll = false;
4989    },
4990
4991    b4StartDrag : function(x, y){
4992        this.view.headersDisabled = true;
4993        this.proxy.setHeight(this.view.mainWrap.getHeight());
4994        var w = this.cm.getColumnWidth(this.cellIndex);
4995        var minw = Math.max(w-this.grid.minColumnWidth, 0);
4996        this.resetConstraints();
4997        this.setXConstraint(minw, 1000);
4998        this.setYConstraint(0, 0);
4999        this.minX = x - minw;
5000        this.maxX = x + 1000;
5001        this.startPos = x;
5002        Ext.dd.DDProxy.prototype.b4StartDrag.call(this, x, y);
5003    },
5004
5005
5006    handleMouseDown : function(e){
5007        var ev = Ext.EventObject.setEvent(e);
5008        var t = this.fly(ev.getTarget());
5009        if(t.hasClass("x-grid-split")){
5010            this.cellIndex = this.view.getCellIndex(t.dom);
5011            this.split = t.dom;
5012            this.cm = this.grid.colModel;
5013            if(this.cm.isResizable(this.cellIndex) && !this.cm.isFixed(this.cellIndex)){
5014                Ext.grid.SplitDragZone.superclass.handleMouseDown.apply(this, arguments);
5015            }
5016        }
5017    },
5018
5019    endDrag : function(e){
5020        this.view.headersDisabled = false;
5021        var endX = Math.max(this.minX, Ext.lib.Event.getPageX(e));
5022        var diff = endX - this.startPos;
5023        this.view.onColumnSplitterMoved(this.cellIndex, this.cm.getColumnWidth(this.cellIndex)+diff);
5024    },
5025
5026    autoOffset : function(){
5027        this.setDelta(0,0);
5028    }
5029});/**
5030 * @class Ext.grid.GridDragZone
5031 * @extends Ext.dd.DragZone
5032 * <p>A customized implementation of a {@link Ext.dd.DragZone DragZone} which provides default implementations of two of the
5033 * template methods of DragZone to enable dragging of the selected rows of a GridPanel.</p>
5034 * <p>A cooperating {@link Ext.dd.DropZone DropZone} must be created who's template method implementations of
5035 * {@link Ext.dd.DropZone#onNodeEnter onNodeEnter}, {@link Ext.dd.DropZone#onNodeOver onNodeOver},
5036 * {@link Ext.dd.DropZone#onNodeOut onNodeOut} and {@link Ext.dd.DropZone#onNodeDrop onNodeDrop}</p> are able
5037 * to process the {@link #getDragData data} which is provided.
5038 */
5039Ext.grid.GridDragZone = function(grid, config){
5040    this.view = grid.getView();
5041    Ext.grid.GridDragZone.superclass.constructor.call(this, this.view.mainBody.dom, config);
5042    this.scroll = false;
5043    this.grid = grid;
5044    this.ddel = document.createElement('div');
5045    this.ddel.className = 'x-grid-dd-wrap';
5046};
5047
5048Ext.extend(Ext.grid.GridDragZone, Ext.dd.DragZone, {
5049    ddGroup : "GridDD",
5050
5051    /**
5052     * <p>The provided implementation of the getDragData method which collects the data to be dragged from the GridPanel on mousedown.</p>
5053     * <p>This data is available for processing in the {@link Ext.dd.DropZone#onNodeEnter onNodeEnter}, {@link Ext.dd.DropZone#onNodeOver onNodeOver},
5054     * {@link Ext.dd.DropZone#onNodeOut onNodeOut} and {@link Ext.dd.DropZone#onNodeDrop onNodeDrop} methods of a cooperating {@link Ext.dd.DropZone DropZone}.</p>
5055     * <p>The data object contains the following properties:<ul>
5056     * <li><b>grid</b> : Ext.Grid.GridPanel<div class="sub-desc">The GridPanel from which the data is being dragged.</div></li>
5057     * <li><b>ddel</b> : htmlElement<div class="sub-desc">An htmlElement which provides the "picture" of the data being dragged.</div></li>
5058     * <li><b>rowIndex</b> : Number<div class="sub-desc">The index of the row which receieved the mousedown gesture which triggered the drag.</div></li>
5059     * <li><b>selections</b> : Array<div class="sub-desc">An Array of the selected Records which are being dragged from the GridPanel.</div></li>
5060     * </ul></p>
5061     */
5062    getDragData : function(e){
5063        var t = Ext.lib.Event.getTarget(e);
5064        var rowIndex = this.view.findRowIndex(t);
5065        if(rowIndex !== false){
5066            var sm = this.grid.selModel;
5067            if(!sm.isSelected(rowIndex) || e.hasModifier()){
5068                sm.handleMouseDown(this.grid, rowIndex, e);
5069            }
5070            return {grid: this.grid, ddel: this.ddel, rowIndex: rowIndex, selections:sm.getSelections()};
5071        }
5072        return false;
5073    },
5074
5075    /**
5076     * <p>The provided implementation of the onInitDrag method. Sets the <tt>innerHTML</tt> of the drag proxy which provides the "picture"
5077     * of the data being dragged.</p>
5078     * <p>The <tt>innerHTML</tt> data is found by calling the owning GridPanel's {@link Ext.grid.GridPanel#getDragDropText getDragDropText}.</p>
5079     */
5080    onInitDrag : function(e){
5081        var data = this.dragData;
5082        this.ddel.innerHTML = this.grid.getDragDropText();
5083        this.proxy.update(this.ddel);
5084        // fire start drag?
5085    },
5086
5087    /**
5088     * An empty immplementation. Implement this to provide behaviour after a repair of an invalid drop. An implementation might highlight
5089     * the selected rows to show that they have not been dragged.
5090     */
5091    afterRepair : function(){
5092        this.dragging = false;
5093    },
5094
5095    /**
5096     * <p>An empty implementation. Implement this to provide coordinates for the drag proxy to slide back to after an invalid drop.</p>
5097     * <p>Called before a repair of an invalid drop to get the XY to animate to.</p>
5098     * @param {EventObject} e The mouse up event
5099     * @return {Array} The xy location (e.g. [100, 200])
5100     */
5101    getRepairXY : function(e, data){
5102        return false;
5103    },
5104
5105    onEndDrag : function(data, e){
5106        // fire end drag?
5107    },
5108
5109    onValidDrop : function(dd, e, id){
5110        // fire drag drop?
5111        this.hideProxy();
5112    },
5113
5114    beforeInvalidDrop : function(e, id){
5115
5116    }
5117});
5118/**
5119 * @class Ext.grid.ColumnModel
5120 * @extends Ext.util.Observable
5121 * <p>After the data has been read into the client side cache (<b>{@link Ext.data.Store Store}</b>),
5122 * the ColumnModel is used to configure how and what parts of that data will be displayed in the
5123 * vertical slices (columns) of the grid. The Ext.grid.ColumnModel Class is the default implementation
5124 * of a ColumnModel used by implentations of {@link Ext.grid.GridPanel GridPanel}.</p>
5125 * <p>Data is mapped into the store's records and then indexed into the ColumnModel using the
5126 * <tt>{@link Ext.grid.Column#dataIndex dataIndex}</tt>:</p>
5127 * <pre><code>
5128{data source} == mapping ==> {data store} == <b><tt>{@link Ext.grid.Column#dataIndex dataIndex}</tt></b> ==> {ColumnModel}
5129 * </code></pre>
5130 * <p>Each {@link Ext.grid.Column Column} in the grid's ColumnModel is configured with a
5131 * <tt>{@link Ext.grid.Column#dataIndex dataIndex}</tt> to specify how the data within
5132 * each record in the store is indexed into the ColumnModel.</p>
5133 * <p>There are two ways to initialize the ColumnModel class:</p>
5134 * <p><u>Initialization Method 1: an Array</u></p>
5135<pre><code>
5136 var colModel = new Ext.grid.ColumnModel([
5137    { header: "Ticker", width: 60, sortable: true},
5138    { header: "Company Name", width: 150, sortable: true, id: 'company'},
5139    { header: "Market Cap.", width: 100, sortable: true},
5140    { header: "$ Sales", width: 100, sortable: true, renderer: money},
5141    { header: "Employees", width: 100, sortable: true, resizable: false}
5142 ]);
5143 </code></pre>
5144 * <p>The ColumnModel may be initialized with an Array of {@link Ext.grid.Column} column configuration
5145 * objects to define the initial layout / display of the columns in the Grid. The order of each
5146 * {@link Ext.grid.Column} column configuration object within the specified Array defines the initial
5147 * order of the column display.  A Column's display may be initially hidden using the
5148 * <tt>{@link Ext.grid.Column#hidden hidden}</tt></b> config property (and then shown using the column
5149 * header menu).  Fields that are not included in the ColumnModel will not be displayable at all.</p>
5150 * <p>How each column in the grid correlates (maps) to the {@link Ext.data.Record} field in the
5151 * {@link Ext.data.Store Store} the column draws its data from is configured through the
5152 * <b><tt>{@link Ext.grid.Column#dataIndex dataIndex}</tt></b>.  If the
5153 * <b><tt>{@link Ext.grid.Column#dataIndex dataIndex}</tt></b> is not explicitly defined (as shown in the
5154 * example above) it will use the column configuration's index in the Array as the index.</p>
5155 * <p>See <b><tt>{@link Ext.grid.Column}</tt></b> for additional configuration options for each column.</p>
5156 * <p><u>Initialization Method 2: an Object</u></p>
5157 * <p>In order to use configuration options from <tt>Ext.grid.ColumnModel</tt>, an Object may be used to
5158 * initialize the ColumnModel.  The column configuration Array will be specified in the <tt><b>{@link #columns}</b></tt>
5159 * config property. The <tt><b>{@link #defaults}</b></tt> config property can be used to apply defaults
5160 * for all columns, e.g.:</p><pre><code>
5161 var colModel = new Ext.grid.ColumnModel({
5162    columns: [
5163        { header: "Ticker", width: 60, menuDisabled: false},
5164        { header: "Company Name", width: 150, id: 'company'},
5165        { header: "Market Cap."},
5166        { header: "$ Sales", renderer: money},
5167        { header: "Employees", resizable: false}
5168    ],
5169    defaults: {
5170        sortable: true,
5171        menuDisabled: true,
5172        width: 100
5173    },
5174    listeners: {
5175        {@link #hiddenchange}: function(cm, colIndex, hidden) {
5176            saveConfig(colIndex, hidden);
5177        }
5178    }
5179});
5180 </code></pre>
5181 * <p>In both examples above, the ability to apply a CSS class to all cells in a column (including the
5182 * header) is demonstrated through the use of the <b><tt>{@link Ext.grid.Column#id id}</tt></b> config
5183 * option. This column could be styled by including the following css:</p><pre><code>
5184 //add this css *after* the core css is loaded
5185.x-grid3-td-company {
5186    color: red; // entire column will have red font
5187}
5188// modify the header row only, adding an icon to the column header
5189.x-grid3-hd-company {
5190    background: transparent
5191        url(../../resources/images/icons/silk/building.png)
5192        no-repeat 3px 3px ! important;
5193        padding-left:20px;
5194}
5195 </code></pre>
5196 * Note that the "Company Name" column could be specified as the
5197 * <b><tt>{@link Ext.grid.GridPanel}.{@link Ext.grid.GridPanel#autoExpandColumn autoExpandColumn}</tt></b>.
5198 * @constructor
5199 * @param {Mixed} config Specify either an Array of {@link Ext.grid.Column} configuration objects or specify
5200 * a configuration Object (see introductory section discussion utilizing Initialization Method 2 above).
5201 */
5202Ext.grid.ColumnModel = Ext.extend(Ext.util.Observable, {
5203    /**
5204     * @cfg {Number} defaultWidth (optional) The width of columns which have no <tt>{@link #width}</tt>
5205     * specified (defaults to <tt>100</tt>).  This property shall preferably be configured through the
5206     * <tt><b>{@link #defaults}</b></tt> config property.
5207     */
5208    defaultWidth: 100,
5209
5210    /**
5211     * @cfg {Boolean} defaultSortable (optional) Default sortable of columns which have no
5212     * sortable specified (defaults to <tt>false</tt>).  This property shall preferably be configured
5213     * through the <tt><b>{@link #defaults}</b></tt> config property.
5214     */
5215    defaultSortable: false,
5216
5217    /**
5218     * @cfg {Array} columns An Array of object literals.  The config options defined by
5219     * <b>{@link Ext.grid.Column}</b> are the options which may appear in the object literal for each
5220     * individual column definition.
5221     */
5222
5223    /**
5224     * @cfg {Object} defaults Object literal which will be used to apply {@link Ext.grid.Column}
5225     * configuration options to all <tt><b>{@link #columns}</b></tt>.  Configuration options specified with
5226     * individual {@link Ext.grid.Column column} configs will supersede these <tt><b>{@link #defaults}</b></tt>.
5227     */
5228
5229    constructor : function(config) {
5230        /**
5231             * An Array of {@link Ext.grid.Column Column definition} objects representing the configuration
5232             * of this ColumnModel.  See {@link Ext.grid.Column} for the configuration properties that may
5233             * be specified.
5234             * @property config
5235             * @type Array
5236             */
5237            if (config.columns) {
5238                Ext.apply(this, config);
5239                this.setConfig(config.columns, true);
5240            } else {
5241                this.setConfig(config, true);
5242            }
5243           
5244            this.addEvents(
5245                /**
5246                 * @event widthchange
5247                 * Fires when the width of a column is programmaticially changed using
5248                 * <code>{@link #setColumnWidth}</code>.
5249                 * Note internal resizing suppresses the event from firing. See also
5250                 * {@link Ext.grid.GridPanel}.<code>{@link #columnresize}</code>.
5251                 * @param {ColumnModel} this
5252                 * @param {Number} columnIndex The column index
5253                 * @param {Number} newWidth The new width
5254                 */
5255                "widthchange",
5256               
5257                /**
5258                 * @event headerchange
5259                 * Fires when the text of a header changes.
5260                 * @param {ColumnModel} this
5261                 * @param {Number} columnIndex The column index
5262                 * @param {String} newText The new header text
5263                 */
5264                "headerchange",
5265               
5266                /**
5267                 * @event hiddenchange
5268                 * Fires when a column is hidden or "unhidden".
5269                 * @param {ColumnModel} this
5270                 * @param {Number} columnIndex The column index
5271                 * @param {Boolean} hidden true if hidden, false otherwise
5272                 */
5273                "hiddenchange",
5274               
5275                /**
5276                 * @event columnmoved
5277                 * Fires when a column is moved.
5278                 * @param {ColumnModel} this
5279                 * @param {Number} oldIndex
5280                 * @param {Number} newIndex
5281                 */
5282                "columnmoved",
5283               
5284                /**
5285                 * @event configchange
5286                 * Fires when the configuration is changed
5287                 * @param {ColumnModel} this
5288                 */
5289                "configchange"
5290            );
5291           
5292            Ext.grid.ColumnModel.superclass.constructor.call(this);
5293    },
5294
5295    /**
5296     * Returns the id of the column at the specified index.
5297     * @param {Number} index The column index
5298     * @return {String} the id
5299     */
5300    getColumnId : function(index) {
5301        return this.config[index].id;
5302    },
5303
5304    getColumnAt : function(index) {
5305        return this.config[index];
5306    },
5307
5308    /**
5309     * <p>Reconfigures this column model according to the passed Array of column definition objects.
5310     * For a description of the individual properties of a column definition object, see the
5311     * <a href="#Ext.grid.ColumnModel-configs">Config Options</a>.</p>
5312     * <p>Causes the {@link #configchange} event to be fired. A {@link Ext.grid.GridPanel GridPanel}
5313     * using this ColumnModel will listen for this event and refresh its UI automatically.</p>
5314     * @param {Array} config Array of Column definition objects.
5315     * @param {Boolean} initial Specify <tt>true</tt> to bypass cleanup which deletes the <tt>totalWidth</tt>
5316     * and destroys existing editors.
5317     */
5318    setConfig : function(config, initial) {
5319        var i, c, len;
5320       
5321        if (!initial) { // cleanup
5322            delete this.totalWidth;
5323           
5324            for (i = 0, len = this.config.length; i < len; i++) {
5325                c = this.config[i];
5326               
5327                if (c.setEditor) {
5328                    //check here, in case we have a special column like a CheckboxSelectionModel
5329                    c.setEditor(null);
5330                }
5331            }
5332        }
5333
5334        // backward compatibility
5335        this.defaults = Ext.apply({
5336            width: this.defaultWidth,
5337            sortable: this.defaultSortable
5338        }, this.defaults);
5339
5340        this.config = config;
5341        this.lookup = {};
5342
5343        for (i = 0, len = config.length; i < len; i++) {
5344            c = Ext.applyIf(config[i], this.defaults);
5345           
5346            // if no id, create one using column's ordinal position
5347            if (Ext.isEmpty(c.id)) {
5348                c.id = i;
5349            }
5350           
5351            if (!c.isColumn) {
5352                var Cls = Ext.grid.Column.types[c.xtype || 'gridcolumn'];
5353                c = new Cls(c);
5354                config[i] = c;
5355            }
5356           
5357            this.lookup[c.id] = c;
5358        }
5359       
5360        if (!initial) {
5361            this.fireEvent('configchange', this);
5362        }
5363    },
5364
5365    /**
5366     * Returns the column for a specified id.
5367     * @param {String} id The column id
5368     * @return {Object} the column
5369     */
5370    getColumnById : function(id) {
5371        return this.lookup[id];
5372    },
5373
5374    /**
5375     * Returns the index for a specified column id.
5376     * @param {String} id The column id
5377     * @return {Number} the index, or -1 if not found
5378     */
5379    getIndexById : function(id) {
5380        for (var i = 0, len = this.config.length; i < len; i++) {
5381            if (this.config[i].id == id) {
5382                return i;
5383            }
5384        }
5385        return -1;
5386    },
5387
5388    /**
5389     * Moves a column from one position to another.
5390     * @param {Number} oldIndex The index of the column to move.
5391     * @param {Number} newIndex The position at which to reinsert the coolumn.
5392     */
5393    moveColumn : function(oldIndex, newIndex) {
5394        var config = this.config,
5395            c      = config[oldIndex];
5396           
5397        config.splice(oldIndex, 1);
5398        config.splice(newIndex, 0, c);
5399        this.dataMap = null;
5400        this.fireEvent("columnmoved", this, oldIndex, newIndex);
5401    },
5402
5403    /**
5404     * Returns the number of columns.
5405     * @param {Boolean} visibleOnly Optional. Pass as true to only include visible columns.
5406     * @return {Number}
5407     */
5408    getColumnCount : function(visibleOnly) {
5409        var length = this.config.length,
5410            c = 0,
5411            i;
5412       
5413        if (visibleOnly === true) {
5414            for (i = 0; i < length; i++) {
5415                if (!this.isHidden(i)) {
5416                    c++;
5417                }
5418            }
5419           
5420            return c;
5421        }
5422       
5423        return length;
5424    },
5425
5426    /**
5427     * Returns the column configs that return true by the passed function that is called
5428     * with (columnConfig, index)
5429<pre><code>
5430// returns an array of column config objects for all hidden columns
5431var columns = grid.getColumnModel().getColumnsBy(function(c){
5432  return c.hidden;
5433});
5434</code></pre>
5435     * @param {Function} fn A function which, when passed a {@link Ext.grid.Column Column} object, must
5436     * return <code>true</code> if the column is to be included in the returned Array.
5437     * @param {Object} scope (optional) The scope (<code>this</code> reference) in which the function
5438     * is executed. Defaults to this ColumnModel.
5439     * @return {Array} result
5440     */
5441    getColumnsBy : function(fn, scope) {
5442        var config = this.config,
5443            length = config.length,
5444            result = [],
5445            i, c;
5446           
5447        for (i = 0; i < length; i++){
5448            c = config[i];
5449           
5450            if (fn.call(scope || this, c, i) === true) {
5451                result[result.length] = c;
5452            }
5453        }
5454       
5455        return result;
5456    },
5457
5458    /**
5459     * Returns true if the specified column is sortable.
5460     * @param {Number} col The column index
5461     * @return {Boolean}
5462     */
5463    isSortable : function(col) {
5464        return !!this.config[col].sortable;
5465    },
5466
5467    /**
5468     * Returns true if the specified column menu is disabled.
5469     * @param {Number} col The column index
5470     * @return {Boolean}
5471     */
5472    isMenuDisabled : function(col) {
5473        return !!this.config[col].menuDisabled;
5474    },
5475
5476    /**
5477     * Returns the rendering (formatting) function defined for the column.
5478     * @param {Number} col The column index.
5479     * @return {Function} The function used to render the cell. See {@link #setRenderer}.
5480     */
5481    getRenderer : function(col) {
5482        return this.config[col].renderer || Ext.grid.ColumnModel.defaultRenderer;
5483    },
5484
5485    getRendererScope : function(col) {
5486        return this.config[col].scope;
5487    },
5488
5489    /**
5490     * Sets the rendering (formatting) function for a column.  See {@link Ext.util.Format} for some
5491     * default formatting functions.
5492     * @param {Number} col The column index
5493     * @param {Function} fn The function to use to process the cell's raw data
5494     * to return HTML markup for the grid view. The render function is called with
5495     * the following parameters:<ul>
5496     * <li><b>value</b> : Object<p class="sub-desc">The data value for the cell.</p></li>
5497     * <li><b>metadata</b> : Object<p class="sub-desc">An object in which you may set the following attributes:<ul>
5498     * <li><b>css</b> : String<p class="sub-desc">A CSS class name to add to the cell's TD element.</p></li>
5499     * <li><b>attr</b> : String<p class="sub-desc">An HTML attribute definition string to apply to the data container element <i>within</i> the table cell
5500     * (e.g. 'style="color:red;"').</p></li></ul></p></li>
5501     * <li><b>record</b> : Ext.data.record<p class="sub-desc">The {@link Ext.data.Record} from which the data was extracted.</p></li>
5502     * <li><b>rowIndex</b> : Number<p class="sub-desc">Row index</p></li>
5503     * <li><b>colIndex</b> : Number<p class="sub-desc">Column index</p></li>
5504     * <li><b>store</b> : Ext.data.Store<p class="sub-desc">The {@link Ext.data.Store} object from which the Record was extracted.</p></li></ul>
5505     */
5506    setRenderer : function(col, fn) {
5507        this.config[col].renderer = fn;
5508    },
5509
5510    /**
5511     * Returns the width for the specified column.
5512     * @param {Number} col The column index
5513     * @return {Number}
5514     */
5515    getColumnWidth : function(col) {
5516        var width = this.config[col].width;
5517        if(typeof width != 'number'){
5518            width = this.defaultWidth;
5519        }
5520        return width;
5521    },
5522
5523    /**
5524     * Sets the width for a column.
5525     * @param {Number} col The column index
5526     * @param {Number} width The new width
5527     * @param {Boolean} suppressEvent True to suppress firing the <code>{@link #widthchange}</code>
5528     * event. Defaults to false.
5529     */
5530    setColumnWidth : function(col, width, suppressEvent) {
5531        this.config[col].width = width;
5532        this.totalWidth = null;
5533       
5534        if (!suppressEvent) {
5535             this.fireEvent("widthchange", this, col, width);
5536        }
5537    },
5538
5539    /**
5540     * Returns the total width of all columns.
5541     * @param {Boolean} includeHidden True to include hidden column widths
5542     * @return {Number}
5543     */
5544    getTotalWidth : function(includeHidden) {
5545        if (!this.totalWidth) {
5546            this.totalWidth = 0;
5547            for (var i = 0, len = this.config.length; i < len; i++) {
5548                if (includeHidden || !this.isHidden(i)) {
5549                    this.totalWidth += this.getColumnWidth(i);
5550                }
5551            }
5552        }
5553        return this.totalWidth;
5554    },
5555
5556    /**
5557     * Returns the header for the specified column.
5558     * @param {Number} col The column index
5559     * @return {String}
5560     */
5561    getColumnHeader : function(col) {
5562        return this.config[col].header;
5563    },
5564
5565    /**
5566     * Sets the header for a column.
5567     * @param {Number} col The column index
5568     * @param {String} header The new header
5569     */
5570    setColumnHeader : function(col, header) {
5571        this.config[col].header = header;
5572        this.fireEvent("headerchange", this, col, header);
5573    },
5574
5575    /**
5576     * Returns the tooltip for the specified column.
5577     * @param {Number} col The column index
5578     * @return {String}
5579     */
5580    getColumnTooltip : function(col) {
5581            return this.config[col].tooltip;
5582    },
5583    /**
5584     * Sets the tooltip for a column.
5585     * @param {Number} col The column index
5586     * @param {String} tooltip The new tooltip
5587     */
5588    setColumnTooltip : function(col, tooltip) {
5589            this.config[col].tooltip = tooltip;
5590    },
5591
5592    /**
5593     * Returns the dataIndex for the specified column.
5594<pre><code>
5595// Get field name for the column
5596var fieldName = grid.getColumnModel().getDataIndex(columnIndex);
5597</code></pre>
5598     * @param {Number} col The column index
5599     * @return {String} The column's dataIndex
5600     */
5601    getDataIndex : function(col) {
5602        return this.config[col].dataIndex;
5603    },
5604
5605    /**
5606     * Sets the dataIndex for a column.
5607     * @param {Number} col The column index
5608     * @param {String} dataIndex The new dataIndex
5609     */
5610    setDataIndex : function(col, dataIndex) {
5611        this.config[col].dataIndex = dataIndex;
5612    },
5613
5614    /**
5615     * Finds the index of the first matching column for the given dataIndex.
5616     * @param {String} col The dataIndex to find
5617     * @return {Number} The column index, or -1 if no match was found
5618     */
5619    findColumnIndex : function(dataIndex) {
5620        var c = this.config;
5621        for(var i = 0, len = c.length; i < len; i++){
5622            if(c[i].dataIndex == dataIndex){
5623                return i;
5624            }
5625        }
5626        return -1;
5627    },
5628
5629    /**
5630     * Returns true if the cell is editable.
5631<pre><code>
5632var store = new Ext.data.Store({...});
5633var colModel = new Ext.grid.ColumnModel({
5634  columns: [...],
5635  isCellEditable: function(col, row) {
5636    var record = store.getAt(row);
5637    if (record.get('readonly')) { // replace with your condition
5638      return false;
5639    }
5640    return Ext.grid.ColumnModel.prototype.isCellEditable.call(this, col, row);
5641  }
5642});
5643var grid = new Ext.grid.GridPanel({
5644  store: store,
5645  colModel: colModel,
5646  ...
5647});
5648</code></pre>
5649     * @param {Number} colIndex The column index
5650     * @param {Number} rowIndex The row index
5651     * @return {Boolean}
5652     */
5653    isCellEditable : function(colIndex, rowIndex) {
5654        var c = this.config[colIndex],
5655            ed = c.editable;
5656
5657        //force boolean
5658        return !!(ed || (!Ext.isDefined(ed) && c.editor));
5659    },
5660
5661    /**
5662     * Returns the editor defined for the cell/column.
5663     * @param {Number} colIndex The column index
5664     * @param {Number} rowIndex The row index
5665     * @return {Ext.Editor} The {@link Ext.Editor Editor} that was created to wrap
5666     * the {@link Ext.form.Field Field} used to edit the cell.
5667     */
5668    getCellEditor : function(colIndex, rowIndex) {
5669        return this.config[colIndex].getCellEditor(rowIndex);
5670    },
5671
5672    /**
5673     * Sets if a column is editable.
5674     * @param {Number} col The column index
5675     * @param {Boolean} editable True if the column is editable
5676     */
5677    setEditable : function(col, editable) {
5678        this.config[col].editable = editable;
5679    },
5680
5681    /**
5682     * Returns <tt>true</tt> if the column is <code>{@link Ext.grid.Column#hidden hidden}</code>,
5683     * <tt>false</tt> otherwise.
5684     * @param {Number} colIndex The column index
5685     * @return {Boolean}
5686     */
5687    isHidden : function(colIndex) {
5688        return !!this.config[colIndex].hidden; // ensure returns boolean
5689    },
5690
5691    /**
5692     * Returns <tt>true</tt> if the column is <code>{@link Ext.grid.Column#fixed fixed}</code>,
5693     * <tt>false</tt> otherwise.
5694     * @param {Number} colIndex The column index
5695     * @return {Boolean}
5696     */
5697    isFixed : function(colIndex) {
5698        return !!this.config[colIndex].fixed;
5699    },
5700
5701    /**
5702     * Returns true if the column can be resized
5703     * @return {Boolean}
5704     */
5705    isResizable : function(colIndex) {
5706        return colIndex >= 0 && this.config[colIndex].resizable !== false && this.config[colIndex].fixed !== true;
5707    },
5708   
5709    /**
5710     * Sets if a column is hidden.
5711<pre><code>
5712myGrid.getColumnModel().setHidden(0, true); // hide column 0 (0 = the first column).
5713</code></pre>
5714     * @param {Number} colIndex The column index
5715     * @param {Boolean} hidden True if the column is hidden
5716     */
5717    setHidden : function(colIndex, hidden) {
5718        var c = this.config[colIndex];
5719        if(c.hidden !== hidden){
5720            c.hidden = hidden;
5721            this.totalWidth = null;
5722            this.fireEvent("hiddenchange", this, colIndex, hidden);
5723        }
5724    },
5725
5726    /**
5727     * Sets the editor for a column and destroys the prior editor.
5728     * @param {Number} col The column index
5729     * @param {Object} editor The editor object
5730     */
5731    setEditor : function(col, editor) {
5732        this.config[col].setEditor(editor);
5733    },
5734
5735    /**
5736     * Destroys this column model by purging any event listeners. Destroys and dereferences all Columns.
5737     */
5738    destroy : function() {
5739        var length = this.config.length,
5740            i = 0;
5741
5742        for (; i < length; i++){
5743            this.config[i].destroy(); // Column's destroy encapsulates all cleanup.
5744        }
5745        delete this.config;
5746        delete this.lookup;
5747        this.purgeListeners();
5748    },
5749
5750    /**
5751     * @private
5752     * Setup any saved state for the column, ensures that defaults are applied.
5753     */
5754    setState : function(col, state) {
5755        state = Ext.applyIf(state, this.defaults);
5756        Ext.apply(this.config[col], state);
5757    }
5758});
5759
5760// private
5761Ext.grid.ColumnModel.defaultRenderer = function(value) {
5762    if (typeof value == "string" && value.length < 1) {
5763        return "&#160;";
5764    }
5765    return value;
5766};/**
5767 * @class Ext.grid.AbstractSelectionModel
5768 * @extends Ext.util.Observable
5769 * Abstract base class for grid SelectionModels.  It provides the interface that should be
5770 * implemented by descendant classes.  This class should not be directly instantiated.
5771 * @constructor
5772 */
5773Ext.grid.AbstractSelectionModel = Ext.extend(Ext.util.Observable,  {
5774    /**
5775     * The GridPanel for which this SelectionModel is handling selection. Read-only.
5776     * @type Object
5777     * @property grid
5778     */
5779
5780    constructor : function(){
5781        this.locked = false;
5782        Ext.grid.AbstractSelectionModel.superclass.constructor.call(this);
5783    },
5784
5785    /** @ignore Called by the grid automatically. Do not call directly. */
5786    init : function(grid){
5787        this.grid = grid;
5788        if(this.lockOnInit){
5789            delete this.lockOnInit;
5790            this.locked = false;
5791            this.lock();
5792        }
5793        this.initEvents();
5794    },
5795
5796    /**
5797     * Locks the selections.
5798     */
5799    lock : function(){
5800        if(!this.locked){
5801            this.locked = true;
5802            // If the grid has been set, then the view is already initialized.
5803            var g = this.grid;
5804            if(g){
5805                g.getView().on({
5806                    scope: this,
5807                    beforerefresh: this.sortUnLock,
5808                    refresh: this.sortLock
5809                });
5810            }else{
5811                this.lockOnInit = true;
5812            }
5813        }
5814    },
5815
5816    // set the lock states before and after a view refresh
5817    sortLock : function() {
5818        this.locked = true;
5819    },
5820
5821    // set the lock states before and after a view refresh
5822    sortUnLock : function() {
5823        this.locked = false;
5824    },
5825
5826    /**
5827     * Unlocks the selections.
5828     */
5829    unlock : function(){
5830        if(this.locked){
5831            this.locked = false;
5832            var g = this.grid,
5833                gv;
5834               
5835            // If the grid has been set, then the view is already initialized.
5836            if(g){
5837                gv = g.getView();
5838                gv.un('beforerefresh', this.sortUnLock, this);
5839                gv.un('refresh', this.sortLock, this);   
5840            }else{
5841                delete this.lockOnInit;
5842            }
5843        }
5844    },
5845
5846    /**
5847     * Returns true if the selections are locked.
5848     * @return {Boolean}
5849     */
5850    isLocked : function(){
5851        return this.locked;
5852    },
5853
5854    destroy: function(){
5855        this.unlock();
5856        this.purgeListeners();
5857    }
5858});/**
5859 * @class Ext.grid.RowSelectionModel
5860 * @extends Ext.grid.AbstractSelectionModel
5861 * The default SelectionModel used by {@link Ext.grid.GridPanel}.
5862 * It supports multiple selections and keyboard selection/navigation. The objects stored
5863 * as selections and returned by {@link #getSelected}, and {@link #getSelections} are
5864 * the {@link Ext.data.Record Record}s which provide the data for the selected rows.
5865 * @constructor
5866 * @param {Object} config
5867 */
5868Ext.grid.RowSelectionModel = Ext.extend(Ext.grid.AbstractSelectionModel,  {
5869    /**
5870     * @cfg {Boolean} singleSelect
5871     * <tt>true</tt> to allow selection of only one row at a time (defaults to <tt>false</tt>
5872     * allowing multiple selections)
5873     */
5874    singleSelect : false,
5875   
5876    constructor : function(config){
5877        Ext.apply(this, config);
5878        this.selections = new Ext.util.MixedCollection(false, function(o){
5879            return o.id;
5880        });
5881
5882        this.last = false;
5883        this.lastActive = false;
5884
5885        this.addEvents(
5886                /**
5887                 * @event selectionchange
5888                 * Fires when the selection changes
5889                 * @param {SelectionModel} this
5890                 */
5891                'selectionchange',
5892                /**
5893                 * @event beforerowselect
5894                 * Fires before a row is selected, return false to cancel the selection.
5895                 * @param {SelectionModel} this
5896                 * @param {Number} rowIndex The index to be selected
5897                 * @param {Boolean} keepExisting False if other selections will be cleared
5898                 * @param {Record} record The record to be selected
5899                 */
5900                'beforerowselect',
5901                /**
5902                 * @event rowselect
5903                 * Fires when a row is selected.
5904                 * @param {SelectionModel} this
5905                 * @param {Number} rowIndex The selected index
5906                 * @param {Ext.data.Record} r The selected record
5907                 */
5908                'rowselect',
5909                /**
5910                 * @event rowdeselect
5911                 * Fires when a row is deselected.  To prevent deselection
5912                 * {@link Ext.grid.AbstractSelectionModel#lock lock the selections}.
5913                 * @param {SelectionModel} this
5914                 * @param {Number} rowIndex
5915                 * @param {Record} record
5916                 */
5917                'rowdeselect'
5918        );
5919        Ext.grid.RowSelectionModel.superclass.constructor.call(this);
5920    },
5921
5922    /**
5923     * @cfg {Boolean} moveEditorOnEnter
5924     * <tt>false</tt> to turn off moving the editor to the next row down when the enter key is pressed
5925     * or the next row up when shift + enter keys are pressed.
5926     */
5927    // private
5928    initEvents : function(){
5929
5930        if(!this.grid.enableDragDrop && !this.grid.enableDrag){
5931            this.grid.on('rowmousedown', this.handleMouseDown, this);
5932        }
5933
5934        this.rowNav = new Ext.KeyNav(this.grid.getGridEl(), {
5935            up: this.onKeyPress, 
5936            down: this.onKeyPress,
5937            scope: this
5938        });
5939
5940        this.grid.getView().on({
5941            scope: this,
5942            refresh: this.onRefresh,
5943            rowupdated: this.onRowUpdated,
5944            rowremoved: this.onRemove
5945        });
5946    },
5947   
5948    onKeyPress : function(e, name){
5949        var up = name == 'up',
5950            method = up ? 'selectPrevious' : 'selectNext',
5951            add = up ? -1 : 1,
5952            last;
5953        if(!e.shiftKey || this.singleSelect){
5954            this[method](false);
5955        }else if(this.last !== false && this.lastActive !== false){
5956            last = this.last;
5957            this.selectRange(this.last,  this.lastActive + add);
5958            this.grid.getView().focusRow(this.lastActive);
5959            if(last !== false){
5960                this.last = last;
5961            }
5962        }else{
5963           this.selectFirstRow();
5964        }
5965    },
5966
5967    // private
5968    onRefresh : function(){
5969        var ds = this.grid.store,
5970            s = this.getSelections(),
5971            i = 0,
5972            len = s.length, 
5973            index, r;
5974           
5975        this.silent = true;
5976        this.clearSelections(true);
5977        for(; i < len; i++){
5978            r = s[i];
5979            if((index = ds.indexOfId(r.id)) != -1){
5980                this.selectRow(index, true);
5981            }
5982        }
5983        if(s.length != this.selections.getCount()){
5984            this.fireEvent('selectionchange', this);
5985        }
5986        this.silent = false;
5987    },
5988
5989    // private
5990    onRemove : function(v, index, r){
5991        if(this.selections.remove(r) !== false){
5992            this.fireEvent('selectionchange', this);
5993        }
5994    },
5995
5996    // private
5997    onRowUpdated : function(v, index, r){
5998        if(this.isSelected(r)){
5999            v.onRowSelect(index);
6000        }
6001    },
6002
6003    /**
6004     * Select records.
6005     * @param {Array} records The records to select
6006     * @param {Boolean} keepExisting (optional) <tt>true</tt> to keep existing selections
6007     */
6008    selectRecords : function(records, keepExisting){
6009        if(!keepExisting){
6010            this.clearSelections();
6011        }
6012        var ds = this.grid.store,
6013            i = 0,
6014            len = records.length;
6015        for(; i < len; i++){
6016            this.selectRow(ds.indexOf(records[i]), true);
6017        }
6018    },
6019
6020    /**
6021     * Gets the number of selected rows.
6022     * @return {Number}
6023     */
6024    getCount : function(){
6025        return this.selections.length;
6026    },
6027
6028    /**
6029     * Selects the first row in the grid.
6030     */
6031    selectFirstRow : function(){
6032        this.selectRow(0);
6033    },
6034
6035    /**
6036     * Select the last row.
6037     * @param {Boolean} keepExisting (optional) <tt>true</tt> to keep existing selections
6038     */
6039    selectLastRow : function(keepExisting){
6040        this.selectRow(this.grid.store.getCount() - 1, keepExisting);
6041    },
6042
6043    /**
6044     * Selects the row immediately following the last selected row.
6045     * @param {Boolean} keepExisting (optional) <tt>true</tt> to keep existing selections
6046     * @return {Boolean} <tt>true</tt> if there is a next row, else <tt>false</tt>
6047     */
6048    selectNext : function(keepExisting){
6049        if(this.hasNext()){
6050            this.selectRow(this.last+1, keepExisting);
6051            this.grid.getView().focusRow(this.last);
6052            return true;
6053        }
6054        return false;
6055    },
6056
6057    /**
6058     * Selects the row that precedes the last selected row.
6059     * @param {Boolean} keepExisting (optional) <tt>true</tt> to keep existing selections
6060     * @return {Boolean} <tt>true</tt> if there is a previous row, else <tt>false</tt>
6061     */
6062    selectPrevious : function(keepExisting){
6063        if(this.hasPrevious()){
6064            this.selectRow(this.last-1, keepExisting);
6065            this.grid.getView().focusRow(this.last);
6066            return true;
6067        }
6068        return false;
6069    },
6070
6071    /**
6072     * Returns true if there is a next record to select
6073     * @return {Boolean}
6074     */
6075    hasNext : function(){
6076        return this.last !== false && (this.last+1) < this.grid.store.getCount();
6077    },
6078
6079    /**
6080     * Returns true if there is a previous record to select
6081     * @return {Boolean}
6082     */
6083    hasPrevious : function(){
6084        return !!this.last;
6085    },
6086
6087
6088    /**
6089     * Returns the selected records
6090     * @return {Array} Array of selected records
6091     */
6092    getSelections : function(){
6093        return [].concat(this.selections.items);
6094    },
6095
6096    /**
6097     * Returns the first selected record.
6098     * @return {Record}
6099     */
6100    getSelected : function(){
6101        return this.selections.itemAt(0);
6102    },
6103
6104    /**
6105     * Calls the passed function with each selection. If the function returns
6106     * <tt>false</tt>, iteration is stopped and this function returns
6107     * <tt>false</tt>. Otherwise it returns <tt>true</tt>.
6108     * @param {Function} fn The function to call upon each iteration. It is passed the selected {@link Ext.data.Record Record}.
6109     * @param {Object} scope (optional) The scope (<code>this</code> reference) in which the function is executed. Defaults to this RowSelectionModel.
6110     * @return {Boolean} true if all selections were iterated
6111     */
6112    each : function(fn, scope){
6113        var s = this.getSelections(),
6114            i = 0,
6115            len = s.length;
6116           
6117        for(; i < len; i++){
6118            if(fn.call(scope || this, s[i], i) === false){
6119                return false;
6120            }
6121        }
6122        return true;
6123    },
6124
6125    /**
6126     * Clears all selections if the selection model
6127     * {@link Ext.grid.AbstractSelectionModel#isLocked is not locked}.
6128     * @param {Boolean} fast (optional) <tt>true</tt> to bypass the
6129     * conditional checks and events described in {@link #deselectRow}.
6130     */
6131    clearSelections : function(fast){
6132        if(this.isLocked()){
6133            return;
6134        }
6135        if(fast !== true){
6136            var ds = this.grid.store,
6137                s = this.selections;
6138            s.each(function(r){
6139                this.deselectRow(ds.indexOfId(r.id));
6140            }, this);
6141            s.clear();
6142        }else{
6143            this.selections.clear();
6144        }
6145        this.last = false;
6146    },
6147
6148
6149    /**
6150     * Selects all rows if the selection model
6151     * {@link Ext.grid.AbstractSelectionModel#isLocked is not locked}.
6152     */
6153    selectAll : function(){
6154        if(this.isLocked()){
6155            return;
6156        }
6157        this.selections.clear();
6158        for(var i = 0, len = this.grid.store.getCount(); i < len; i++){
6159            this.selectRow(i, true);
6160        }
6161    },
6162
6163    /**
6164     * Returns <tt>true</tt> if there is a selection.
6165     * @return {Boolean}
6166     */
6167    hasSelection : function(){
6168        return this.selections.length > 0;
6169    },
6170
6171    /**
6172     * Returns <tt>true</tt> if the specified row is selected.
6173     * @param {Number/Record} index The record or index of the record to check
6174     * @return {Boolean}
6175     */
6176    isSelected : function(index){
6177        var r = Ext.isNumber(index) ? this.grid.store.getAt(index) : index;
6178        return (r && this.selections.key(r.id) ? true : false);
6179    },
6180
6181    /**
6182     * Returns <tt>true</tt> if the specified record id is selected.
6183     * @param {String} id The id of record to check
6184     * @return {Boolean}
6185     */
6186    isIdSelected : function(id){
6187        return (this.selections.key(id) ? true : false);
6188    },
6189
6190    // private
6191    handleMouseDown : function(g, rowIndex, e){
6192        if(e.button !== 0 || this.isLocked()){
6193            return;
6194        }
6195        var view = this.grid.getView();
6196        if(e.shiftKey && !this.singleSelect && this.last !== false){
6197            var last = this.last;
6198            this.selectRange(last, rowIndex, e.ctrlKey);
6199            this.last = last; // reset the last
6200            view.focusRow(rowIndex);
6201        }else{
6202            var isSelected = this.isSelected(rowIndex);
6203            if(e.ctrlKey && isSelected){
6204                this.deselectRow(rowIndex);
6205            }else if(!isSelected || this.getCount() > 1){
6206                this.selectRow(rowIndex, e.ctrlKey || e.shiftKey);
6207                view.focusRow(rowIndex);
6208            }
6209        }
6210    },
6211
6212    /**
6213     * Selects multiple rows.
6214     * @param {Array} rows Array of the indexes of the row to select
6215     * @param {Boolean} keepExisting (optional) <tt>true</tt> to keep
6216     * existing selections (defaults to <tt>false</tt>)
6217     */
6218    selectRows : function(rows, keepExisting){
6219        if(!keepExisting){
6220            this.clearSelections();
6221        }
6222        for(var i = 0, len = rows.length; i < len; i++){
6223            this.selectRow(rows[i], true);
6224        }
6225    },
6226
6227    /**
6228     * Selects a range of rows if the selection model
6229     * {@link Ext.grid.AbstractSelectionModel#isLocked is not locked}.
6230     * All rows in between startRow and endRow are also selected.
6231     * @param {Number} startRow The index of the first row in the range
6232     * @param {Number} endRow The index of the last row in the range
6233     * @param {Boolean} keepExisting (optional) True to retain existing selections
6234     */
6235    selectRange : function(startRow, endRow, keepExisting){
6236        var i;
6237        if(this.isLocked()){
6238            return;
6239        }
6240        if(!keepExisting){
6241            this.clearSelections();
6242        }
6243        if(startRow <= endRow){
6244            for(i = startRow; i <= endRow; i++){
6245                this.selectRow(i, true);
6246            }
6247        }else{
6248            for(i = startRow; i >= endRow; i--){
6249                this.selectRow(i, true);
6250            }
6251        }
6252    },
6253
6254    /**
6255     * Deselects a range of rows if the selection model
6256     * {@link Ext.grid.AbstractSelectionModel#isLocked is not locked}. 
6257     * All rows in between startRow and endRow are also deselected.
6258     * @param {Number} startRow The index of the first row in the range
6259     * @param {Number} endRow The index of the last row in the range
6260     */
6261    deselectRange : function(startRow, endRow, preventViewNotify){
6262        if(this.isLocked()){
6263            return;
6264        }
6265        for(var i = startRow; i <= endRow; i++){
6266            this.deselectRow(i, preventViewNotify);
6267        }
6268    },
6269
6270    /**
6271     * Selects a row.  Before selecting a row, checks if the selection model
6272     * {@link Ext.grid.AbstractSelectionModel#isLocked is locked} and fires the
6273     * {@link #beforerowselect} event.  If these checks are satisfied the row
6274     * will be selected and followed up by  firing the {@link #rowselect} and
6275     * {@link #selectionchange} events.
6276     * @param {Number} row The index of the row to select
6277     * @param {Boolean} keepExisting (optional) <tt>true</tt> to keep existing selections
6278     * @param {Boolean} preventViewNotify (optional) Specify <tt>true</tt> to
6279     * prevent notifying the view (disables updating the selected appearance)
6280     */
6281    selectRow : function(index, keepExisting, preventViewNotify){
6282        if(this.isLocked() || (index < 0 || index >= this.grid.store.getCount()) || (keepExisting && this.isSelected(index))){
6283            return;
6284        }
6285        var r = this.grid.store.getAt(index);
6286        if(r && this.fireEvent('beforerowselect', this, index, keepExisting, r) !== false){
6287            if(!keepExisting || this.singleSelect){
6288                this.clearSelections();
6289            }
6290            this.selections.add(r);
6291            this.last = this.lastActive = index;
6292            if(!preventViewNotify){
6293                this.grid.getView().onRowSelect(index);
6294            }
6295            if(!this.silent){
6296                this.fireEvent('rowselect', this, index, r);
6297                this.fireEvent('selectionchange', this);
6298            }
6299        }
6300    },
6301
6302    /**
6303     * Deselects a row.  Before deselecting a row, checks if the selection model
6304     * {@link Ext.grid.AbstractSelectionModel#isLocked is locked}.
6305     * If this check is satisfied the row will be deselected and followed up by
6306     * firing the {@link #rowdeselect} and {@link #selectionchange} events.
6307     * @param {Number} row The index of the row to deselect
6308     * @param {Boolean} preventViewNotify (optional) Specify <tt>true</tt> to
6309     * prevent notifying the view (disables updating the selected appearance)
6310     */
6311    deselectRow : function(index, preventViewNotify){
6312        if(this.isLocked()){
6313            return;
6314        }
6315        if(this.last == index){
6316            this.last = false;
6317        }
6318        if(this.lastActive == index){
6319            this.lastActive = false;
6320        }
6321        var r = this.grid.store.getAt(index);
6322        if(r){
6323            this.selections.remove(r);
6324            if(!preventViewNotify){
6325                this.grid.getView().onRowDeselect(index);
6326            }
6327            this.fireEvent('rowdeselect', this, index, r);
6328            this.fireEvent('selectionchange', this);
6329        }
6330    },
6331
6332    // private
6333    acceptsNav : function(row, col, cm){
6334        return !cm.isHidden(col) && cm.isCellEditable(col, row);
6335    },
6336
6337    // private
6338    onEditorKey : function(field, e){
6339        var k = e.getKey(), 
6340            newCell, 
6341            g = this.grid, 
6342            last = g.lastEdit,
6343            ed = g.activeEditor,
6344            shift = e.shiftKey,
6345            ae, last, r, c;
6346           
6347        if(k == e.TAB){
6348            e.stopEvent();
6349            ed.completeEdit();
6350            if(shift){
6351                newCell = g.walkCells(ed.row, ed.col-1, -1, this.acceptsNav, this);
6352            }else{
6353                newCell = g.walkCells(ed.row, ed.col+1, 1, this.acceptsNav, this);
6354            }
6355        }else if(k == e.ENTER){
6356            if(this.moveEditorOnEnter !== false){
6357                if(shift){
6358                    newCell = g.walkCells(last.row - 1, last.col, -1, this.acceptsNav, this);
6359                }else{
6360                    newCell = g.walkCells(last.row + 1, last.col, 1, this.acceptsNav, this);
6361                }
6362            }
6363        }
6364        if(newCell){
6365            r = newCell[0];
6366            c = newCell[1];
6367
6368            this.onEditorSelect(r, last.row);
6369
6370            if(g.isEditor && g.editing){ // *** handle tabbing while editorgrid is in edit mode
6371                ae = g.activeEditor;
6372                if(ae && ae.field.triggerBlur){
6373                    // *** if activeEditor is a TriggerField, explicitly call its triggerBlur() method
6374                    ae.field.triggerBlur();
6375                }
6376            }
6377            g.startEditing(r, c);
6378        }
6379    },
6380   
6381    onEditorSelect: function(row, lastRow){
6382        if(lastRow != row){
6383            this.selectRow(row); // *** highlight newly-selected cell and update selection
6384        }
6385    },
6386   
6387    destroy : function(){
6388        Ext.destroy(this.rowNav);
6389        this.rowNav = null;
6390        Ext.grid.RowSelectionModel.superclass.destroy.call(this);
6391    }
6392});
6393/**
6394 * @class Ext.grid.Column
6395 * <p>This class encapsulates column configuration data to be used in the initialization of a
6396 * {@link Ext.grid.ColumnModel ColumnModel}.</p>
6397 * <p>While subclasses are provided to render data in different ways, this class renders a passed
6398 * data field unchanged and is usually used for textual columns.</p>
6399 */
6400Ext.grid.Column = Ext.extend(Ext.util.Observable, {
6401    /**
6402     * @cfg {Boolean} editable Optional. Defaults to <tt>true</tt>, enabling the configured
6403     * <tt>{@link #editor}</tt>.  Set to <tt>false</tt> to initially disable editing on this column.
6404     * The initial configuration may be dynamically altered using
6405     * {@link Ext.grid.ColumnModel}.{@link Ext.grid.ColumnModel#setEditable setEditable()}.
6406     */
6407    /**
6408     * @cfg {String} id Optional. A name which identifies this column (defaults to the column's initial
6409     * ordinal position.) The <tt>id</tt> is used to create a CSS <b>class</b> name which is applied to all
6410     * table cells (including headers) in that column (in this context the <tt>id</tt> does not need to be
6411     * unique). The class name takes the form of <pre>x-grid3-td-<b>id</b></pre>
6412     * Header cells will also receive this class name, but will also have the class <pre>x-grid3-hd</pre>
6413     * So, to target header cells, use CSS selectors such as:<pre>.x-grid3-hd-row .x-grid3-td-<b>id</b></pre>
6414     * The {@link Ext.grid.GridPanel#autoExpandColumn} grid config option references the column via this
6415     * unique identifier.
6416     */
6417    /**
6418     * @cfg {String} header Optional. The header text to be used as innerHTML
6419     * (html tags are accepted) to display in the Grid view.  <b>Note</b>: to
6420     * have a clickable header with no text displayed use <tt>'&amp;#160;'</tt>.
6421     */
6422    /**
6423     * @cfg {Boolean} groupable Optional. If the grid is being rendered by an {@link Ext.grid.GroupingView}, this option
6424     * may be used to disable the header menu item to group by the column selected. Defaults to <tt>true</tt>,
6425     * which enables the header menu group option.  Set to <tt>false</tt> to disable (but still show) the
6426     * group option in the header menu for the column. See also <code>{@link #groupName}</code>.
6427     */
6428    /**
6429     * @cfg {String} groupName Optional. If the grid is being rendered by an {@link Ext.grid.GroupingView}, this option
6430     * may be used to specify the text with which to prefix the group field value in the group header line.
6431     * See also {@link #groupRenderer} and
6432     * {@link Ext.grid.GroupingView}.{@link Ext.grid.GroupingView#showGroupName showGroupName}.
6433     */
6434    /**
6435     * @cfg {Function} groupRenderer <p>Optional. If the grid is being rendered by an {@link Ext.grid.GroupingView}, this option
6436     * may be used to specify the function used to format the grouping field value for display in the group
6437     * {@link #groupName header}.  If a <tt><b>groupRenderer</b></tt> is not specified, the configured
6438     * <tt><b>{@link #renderer}</b></tt> will be called; if a <tt><b>{@link #renderer}</b></tt> is also not specified
6439     * the new value of the group field will be used.</p>
6440     * <p>The called function (either the <tt><b>groupRenderer</b></tt> or <tt><b>{@link #renderer}</b></tt>) will be
6441     * passed the following parameters:
6442     * <div class="mdetail-params"><ul>
6443     * <li><b>v</b> : Object<p class="sub-desc">The new value of the group field.</p></li>
6444     * <li><b>unused</b> : undefined<p class="sub-desc">Unused parameter.</p></li>
6445     * <li><b>r</b> : Ext.data.Record<p class="sub-desc">The Record providing the data
6446     * for the row which caused group change.</p></li>
6447     * <li><b>rowIndex</b> : Number<p class="sub-desc">The row index of the Record which caused group change.</p></li>
6448     * <li><b>colIndex</b> : Number<p class="sub-desc">The column index of the group field.</p></li>
6449     * <li><b>ds</b> : Ext.data.Store<p class="sub-desc">The Store which is providing the data Model.</p></li>
6450     * </ul></div></p>
6451     * <p>The function should return a string value.</p>
6452     */
6453    /**
6454     * @cfg {String} emptyGroupText Optional. If the grid is being rendered by an {@link Ext.grid.GroupingView}, this option
6455     * may be used to specify the text to display when there is an empty group value. Defaults to the
6456     * {@link Ext.grid.GroupingView}.{@link Ext.grid.GroupingView#emptyGroupText emptyGroupText}.
6457     */
6458    /**
6459     * @cfg {String} dataIndex <p><b>Required</b>. The name of the field in the
6460     * grid's {@link Ext.data.Store}'s {@link Ext.data.Record} definition from
6461     * which to draw the column's value.</p>
6462     */
6463    /**
6464     * @cfg {Number} width
6465     * Optional. The initial width in pixels of the column.
6466     * The width of each column can also be affected if any of the following are configured:
6467     * <div class="mdetail-params"><ul>
6468     * <li>{@link Ext.grid.GridPanel}.<tt>{@link Ext.grid.GridPanel#autoExpandColumn autoExpandColumn}</tt></li>
6469     * <li>{@link Ext.grid.GridView}.<tt>{@link Ext.grid.GridView#forceFit forceFit}</tt>
6470     * <div class="sub-desc">
6471     * <p>By specifying <tt>forceFit:true</tt>, {@link #fixed non-fixed width} columns will be
6472     * re-proportioned (based on the relative initial widths) to fill the width of the grid so
6473     * that no horizontal scrollbar is shown.</p>
6474     * </div></li>
6475     * <li>{@link Ext.grid.GridView}.<tt>{@link Ext.grid.GridView#autoFill autoFill}</tt></li>
6476     * <li>{@link Ext.grid.GridPanel}.<tt>{@link Ext.grid.GridPanel#minColumnWidth minColumnWidth}</tt></li>
6477     * <br><p><b>Note</b>: when the width of each column is determined, a space on the right side
6478     * is reserved for the vertical scrollbar.  The
6479     * {@link Ext.grid.GridView}.<tt>{@link Ext.grid.GridView#scrollOffset scrollOffset}</tt>
6480     * can be modified to reduce or eliminate the reserved offset.</p>
6481     */
6482    /**
6483     * @cfg {Boolean} sortable Optional. <tt>true</tt> if sorting is to be allowed on this column.
6484     * Defaults to the value of the <code>{@link Ext.grid.ColumnModel#defaultSortable}</code> property.
6485     * Whether local/remote sorting is used is specified in <code>{@link Ext.data.Store#remoteSort}</code>.
6486     */
6487    /**
6488     * @cfg {Boolean} fixed Optional. <tt>true</tt> if the column width cannot be changed.  Defaults to <tt>false</tt>.
6489     */
6490    /**
6491     * @cfg {Boolean} resizable Optional. <tt>false</tt> to disable column resizing. Defaults to <tt>true</tt>.
6492     */
6493    /**
6494     * @cfg {Boolean} menuDisabled Optional. <tt>true</tt> to disable the column menu. Defaults to <tt>false</tt>.
6495     */
6496    /**
6497     * @cfg {Boolean} hidden
6498     * Optional. <tt>true</tt> to initially hide this column. Defaults to <tt>false</tt>.
6499     * A hidden column {@link Ext.grid.GridPanel#enableColumnHide may be shown via the header row menu}.
6500     * If a column is never to be shown, simply do not include this column in the Column Model at all.
6501     */
6502    /**
6503     * @cfg {String} tooltip Optional. A text string to use as the column header's tooltip.  If Quicktips
6504     * are enabled, this value will be used as the text of the quick tip, otherwise it will be set as the
6505     * header's HTML title attribute. Defaults to ''.
6506     */
6507    /**
6508     * @cfg {Mixed} renderer
6509     * <p>For an alternative to specifying a renderer see <code>{@link #xtype}</code></p>
6510     * <p>Optional. A renderer is an 'interceptor' method which can be used transform data (value,
6511     * appearance, etc.) before it is rendered). This may be specified in either of three ways:
6512     * <div class="mdetail-params"><ul>
6513     * <li>A renderer function used to return HTML markup for a cell given the cell's data value.</li>
6514     * <li>A string which references a property name of the {@link Ext.util.Format} class which
6515     * provides a renderer function.</li>
6516     * <li>An object specifying both the renderer function, and its execution scope (<tt><b>this</b></tt>
6517     * reference) e.g.:<pre style="margin-left:1.2em"><code>
6518{
6519    fn: this.gridRenderer,
6520    scope: this
6521}
6522</code></pre></li></ul></div>
6523     * If not specified, the default renderer uses the raw data value.</p>
6524     * <p>For information about the renderer function (passed parameters, etc.), see
6525     * {@link Ext.grid.ColumnModel#setRenderer}. An example of specifying renderer function inline:</p><pre><code>
6526var companyColumn = {
6527   header: 'Company Name',
6528   dataIndex: 'company',
6529   renderer: function(value, metaData, record, rowIndex, colIndex, store) {
6530      // provide the logic depending on business rules
6531      // name of your own choosing to manipulate the cell depending upon
6532      // the data in the underlying Record object.
6533      if (value == 'whatever') {
6534          //metaData.css : String : A CSS class name to add to the TD element of the cell.
6535          //metaData.attr : String : An html attribute definition string to apply to
6536          //                         the data container element within the table
6537          //                         cell (e.g. 'style="color:red;"').
6538          metaData.css = 'name-of-css-class-you-will-define';
6539      }
6540      return value;
6541   }
6542}
6543     * </code></pre>
6544     * See also {@link #scope}.
6545     */
6546    /**
6547     * @cfg {String} xtype Optional. A String which references a predefined {@link Ext.grid.Column} subclass
6548     * type which is preconfigured with an appropriate <code>{@link #renderer}</code> to be easily
6549     * configured into a ColumnModel. The predefined {@link Ext.grid.Column} subclass types are:
6550     * <div class="mdetail-params"><ul>
6551     * <li><b><tt>gridcolumn</tt></b> : {@link Ext.grid.Column} (<b>Default</b>)<p class="sub-desc"></p></li>
6552     * <li><b><tt>booleancolumn</tt></b> : {@link Ext.grid.BooleanColumn}<p class="sub-desc"></p></li>
6553     * <li><b><tt>numbercolumn</tt></b> : {@link Ext.grid.NumberColumn}<p class="sub-desc"></p></li>
6554     * <li><b><tt>datecolumn</tt></b> : {@link Ext.grid.DateColumn}<p class="sub-desc"></p></li>
6555     * <li><b><tt>templatecolumn</tt></b> : {@link Ext.grid.TemplateColumn}<p class="sub-desc"></p></li>
6556     * </ul></div>
6557     * <p>Configuration properties for the specified <code>xtype</code> may be specified with
6558     * the Column configuration properties, for example:</p>
6559     * <pre><code>
6560var grid = new Ext.grid.GridPanel({
6561    ...
6562    columns: [{
6563        header: 'Last Updated',
6564        dataIndex: 'lastChange',
6565        width: 85,
6566        sortable: true,
6567        //renderer: Ext.util.Format.dateRenderer('m/d/Y'),
6568        xtype: 'datecolumn', // use xtype instead of renderer
6569        format: 'M/d/Y' // configuration property for {@link Ext.grid.DateColumn}
6570    }, {
6571        ...
6572    }]
6573});
6574     * </code></pre>
6575     */
6576    /**
6577     * @cfg {Object} scope Optional. The scope (<tt><b>this</b></tt> reference) in which to execute the
6578     * renderer.  Defaults to the Column configuration object.
6579     */
6580    /**
6581     * @cfg {String} align Optional. Set the CSS text-align property of the column.  Defaults to undefined.
6582     */
6583    /**
6584     * @cfg {String} css Optional. An inline style definition string which is applied to all table cells in the column
6585     * (excluding headers). Defaults to undefined.
6586     */
6587    /**
6588     * @cfg {Boolean} hideable Optional. Specify as <tt>false</tt> to prevent the user from hiding this column
6589     * (defaults to true).  To disallow column hiding globally for all columns in the grid, use
6590     * {@link Ext.grid.GridPanel#enableColumnHide} instead.
6591     */
6592    /**
6593     * @cfg {Ext.form.Field} editor Optional. The {@link Ext.form.Field} to use when editing values in this column
6594     * if editing is supported by the grid. See <tt>{@link #editable}</tt> also.
6595     */
6596
6597    /**
6598     * @private
6599     * @cfg {Boolean} isColumn
6600     * Used by ColumnModel setConfig method to avoid reprocessing a Column
6601     * if <code>isColumn</code> is not set ColumnModel will recreate a new Ext.grid.Column
6602     * Defaults to true.
6603     */
6604    isColumn : true,
6605
6606    constructor : function(config){
6607        Ext.apply(this, config);
6608
6609        if(Ext.isString(this.renderer)){
6610            this.renderer = Ext.util.Format[this.renderer];
6611        }else if(Ext.isObject(this.renderer)){
6612            this.scope = this.renderer.scope;
6613            this.renderer = this.renderer.fn;
6614        }
6615        if(!this.scope){
6616            this.scope = this;
6617        }
6618
6619        var ed = this.editor;
6620        delete this.editor;
6621        this.setEditor(ed);
6622        this.addEvents(
6623            /**
6624             * @event click
6625             * Fires when this Column is clicked.
6626             * @param {Column} this
6627             * @param {Grid} The owning GridPanel
6628             * @param {Number} rowIndex
6629             * @param {Ext.EventObject} e
6630             */
6631            'click',
6632            /**
6633             * @event contextmenu
6634             * Fires when this Column is right clicked.
6635             * @param {Column} this
6636             * @param {Grid} The owning GridPanel
6637             * @param {Number} rowIndex
6638             * @param {Ext.EventObject} e
6639             */
6640            'contextmenu',
6641            /**
6642             * @event dblclick
6643             * Fires when this Column is double clicked.
6644             * @param {Column} this
6645             * @param {Grid} The owning GridPanel
6646             * @param {Number} rowIndex
6647             * @param {Ext.EventObject} e
6648             */
6649            'dblclick',
6650            /**
6651             * @event mousedown
6652             * Fires when this Column receives a mousedown event.
6653             * @param {Column} this
6654             * @param {Grid} The owning GridPanel
6655             * @param {Number} rowIndex
6656             * @param {Ext.EventObject} e
6657             */
6658            'mousedown'
6659        );
6660        Ext.grid.Column.superclass.constructor.call(this);
6661    },
6662
6663    /**
6664     * @private
6665     * Process and refire events routed from the GridView's processEvent method.
6666     * Returns the event handler's status to allow cancelling of GridView's bubbling process.
6667     */
6668    processEvent : function(name, e, grid, rowIndex, colIndex){
6669        return this.fireEvent(name, this, grid, rowIndex, e);
6670    },
6671
6672    /**
6673     * @private
6674     * Clean up. Remove any Editor. Remove any listeners.
6675     */
6676    destroy: function() {
6677        if(this.setEditor){
6678            this.setEditor(null);
6679        }
6680        this.purgeListeners();
6681    },
6682
6683    /**
6684     * Optional. A function which returns displayable data when passed the following parameters:
6685     * <div class="mdetail-params"><ul>
6686     * <li><b>value</b> : Object<p class="sub-desc">The data value for the cell.</p></li>
6687     * <li><b>metadata</b> : Object<p class="sub-desc">An object in which you may set the following attributes:<ul>
6688     * <li><b>css</b> : String<p class="sub-desc">A CSS class name to add to the cell's TD element.</p></li>
6689     * <li><b>attr</b> : String<p class="sub-desc">An HTML attribute definition string to apply to the data container
6690     * element <i>within</i> the table cell (e.g. 'style="color:red;"').</p></li></ul></p></li>
6691     * <li><b>record</b> : Ext.data.record<p class="sub-desc">The {@link Ext.data.Record} from which the data was
6692     * extracted.</p></li>
6693     * <li><b>rowIndex</b> : Number<p class="sub-desc">Row index</p></li>
6694     * <li><b>colIndex</b> : Number<p class="sub-desc">Column index</p></li>
6695     * <li><b>store</b> : Ext.data.Store<p class="sub-desc">The {@link Ext.data.Store} object from which the Record
6696     * was extracted.</p></li>
6697     * </ul></div>
6698     * @property renderer
6699     * @type Function
6700     */
6701    renderer : function(value){
6702        return value;
6703    },
6704
6705    // private
6706    getEditor: function(rowIndex){
6707        return this.editable !== false ? this.editor : null;
6708    },
6709
6710    /**
6711     * Sets a new editor for this column.
6712     * @param {Ext.Editor/Ext.form.Field} editor The editor to set
6713     */
6714    setEditor : function(editor){
6715        var ed = this.editor;
6716        if(ed){
6717            if(ed.gridEditor){
6718                ed.gridEditor.destroy();
6719                delete ed.gridEditor;
6720            }else{
6721                ed.destroy();
6722            }
6723        }
6724        this.editor = null;
6725        if(editor){
6726            //not an instance, create it
6727            if(!editor.isXType){
6728                editor = Ext.create(editor, 'textfield');
6729            }
6730            this.editor = editor;
6731        }
6732    },
6733
6734    /**
6735     * Returns the {@link Ext.Editor editor} defined for this column that was created to wrap the {@link Ext.form.Field Field}
6736     * used to edit the cell.
6737     * @param {Number} rowIndex The row index
6738     * @return {Ext.Editor}
6739     */
6740    getCellEditor: function(rowIndex){
6741        var ed = this.getEditor(rowIndex);
6742        if(ed){
6743            if(!ed.startEdit){
6744                if(!ed.gridEditor){
6745                    ed.gridEditor = new Ext.grid.GridEditor(ed);
6746                }
6747                ed = ed.gridEditor;
6748            }
6749        }
6750        return ed;
6751    }
6752});
6753
6754/**
6755 * @class Ext.grid.BooleanColumn
6756 * @extends Ext.grid.Column
6757 * <p>A Column definition class which renders boolean data fields.  See the {@link Ext.grid.Column#xtype xtype}
6758 * config option of {@link Ext.grid.Column} for more details.</p>
6759 */
6760Ext.grid.BooleanColumn = Ext.extend(Ext.grid.Column, {
6761    /**
6762     * @cfg {String} trueText
6763     * The string returned by the renderer when the column value is not falsy (defaults to <tt>'true'</tt>).
6764     */
6765    trueText: 'true',
6766    /**
6767     * @cfg {String} falseText
6768     * The string returned by the renderer when the column value is falsy (but not undefined) (defaults to
6769     * <tt>'false'</tt>).
6770     */
6771    falseText: 'false',
6772    /**
6773     * @cfg {String} undefinedText
6774     * The string returned by the renderer when the column value is undefined (defaults to <tt>'&amp;#160;'</tt>).
6775     */
6776    undefinedText: '&#160;',
6777
6778    constructor: function(cfg){
6779        Ext.grid.BooleanColumn.superclass.constructor.call(this, cfg);
6780        var t = this.trueText, f = this.falseText, u = this.undefinedText;
6781        this.renderer = function(v){
6782            if(v === undefined){
6783                return u;
6784            }
6785            if(!v || v === 'false'){
6786                return f;
6787            }
6788            return t;
6789        };
6790    }
6791});
6792
6793/**
6794 * @class Ext.grid.NumberColumn
6795 * @extends Ext.grid.Column
6796 * <p>A Column definition class which renders a numeric data field according to a {@link #format} string.  See the
6797 * {@link Ext.grid.Column#xtype xtype} config option of {@link Ext.grid.Column} for more details.</p>
6798 */
6799Ext.grid.NumberColumn = Ext.extend(Ext.grid.Column, {
6800    /**
6801     * @cfg {String} format
6802     * A formatting string as used by {@link Ext.util.Format#number} to format a numeric value for this Column
6803     * (defaults to <tt>'0,000.00'</tt>).
6804     */
6805    format : '0,000.00',
6806    constructor: function(cfg){
6807        Ext.grid.NumberColumn.superclass.constructor.call(this, cfg);
6808        this.renderer = Ext.util.Format.numberRenderer(this.format);
6809    }
6810});
6811
6812/**
6813 * @class Ext.grid.DateColumn
6814 * @extends Ext.grid.Column
6815 * <p>A Column definition class which renders a passed date according to the default locale, or a configured
6816 * {@link #format}. See the {@link Ext.grid.Column#xtype xtype} config option of {@link Ext.grid.Column}
6817 * for more details.</p>
6818 */
6819Ext.grid.DateColumn = Ext.extend(Ext.grid.Column, {
6820    /**
6821     * @cfg {String} format
6822     * A formatting string as used by {@link Date#format} to format a Date for this Column
6823     * (defaults to <tt>'m/d/Y'</tt>).
6824     */
6825    format : 'm/d/Y',
6826    constructor: function(cfg){
6827        Ext.grid.DateColumn.superclass.constructor.call(this, cfg);
6828        this.renderer = Ext.util.Format.dateRenderer(this.format);
6829    }
6830});
6831
6832/**
6833 * @class Ext.grid.TemplateColumn
6834 * @extends Ext.grid.Column
6835 * <p>A Column definition class which renders a value by processing a {@link Ext.data.Record Record}'s
6836 * {@link Ext.data.Record#data data} using a {@link #tpl configured} {@link Ext.XTemplate XTemplate}.
6837 * See the {@link Ext.grid.Column#xtype xtype} config option of {@link Ext.grid.Column} for more
6838 * details.</p>
6839 */
6840Ext.grid.TemplateColumn = Ext.extend(Ext.grid.Column, {
6841    /**
6842     * @cfg {String/XTemplate} tpl
6843     * An {@link Ext.XTemplate XTemplate}, or an XTemplate <i>definition string</i> to use to process a
6844     * {@link Ext.data.Record Record}'s {@link Ext.data.Record#data data} to produce a column's rendered value.
6845     */
6846    constructor: function(cfg){
6847        Ext.grid.TemplateColumn.superclass.constructor.call(this, cfg);
6848        var tpl = (!Ext.isPrimitive(this.tpl) && this.tpl.compile) ? this.tpl : new Ext.XTemplate(this.tpl);
6849        this.renderer = function(value, p, r){
6850            return tpl.apply(r.data);
6851        };
6852        this.tpl = tpl;
6853    }
6854});
6855
6856/**
6857 * @class Ext.grid.ActionColumn
6858 * @extends Ext.grid.Column
6859 * <p>A Grid column type which renders an icon, or a series of icons in a grid cell, and offers a scoped click
6860 * handler for each icon. Example usage:</p>
6861<pre><code>
6862new Ext.grid.GridPanel({
6863    store: myStore,
6864    columns: [
6865        {
6866            xtype: 'actioncolumn',
6867            width: 50,
6868            items: [
6869                {
6870                    icon   : 'sell.gif',                // Use a URL in the icon config
6871                    tooltip: 'Sell stock',
6872                    handler: function(grid, rowIndex, colIndex) {
6873                        var rec = store.getAt(rowIndex);
6874                        alert("Sell " + rec.get('company'));
6875                    }
6876                },
6877                {
6878                    getClass: function(v, meta, rec) {  // Or return a class from a function
6879                        if (rec.get('change') < 0) {
6880                            this.items[1].tooltip = 'Do not buy!';
6881                            return 'alert-col';
6882                        } else {
6883                            this.items[1].tooltip = 'Buy stock';
6884                            return 'buy-col';
6885                        }
6886                    },
6887                    handler: function(grid, rowIndex, colIndex) {
6888                        var rec = store.getAt(rowIndex);
6889                        alert("Buy " + rec.get('company'));
6890                    }
6891                }
6892            ]
6893        }
6894        //any other columns here
6895    ]
6896});
6897</pre></code>
6898 * <p>The action column can be at any index in the columns array, and a grid can have any number of
6899 * action columns. </p>
6900 */
6901Ext.grid.ActionColumn = Ext.extend(Ext.grid.Column, {
6902    /**
6903     * @cfg {String} icon
6904     * The URL of an image to display as the clickable element in the column.
6905     * Optional - defaults to <code>{@link Ext#BLANK_IMAGE_URL Ext.BLANK_IMAGE_URL}</code>.
6906     */
6907    /**
6908     * @cfg {String} iconCls
6909     * A CSS class to apply to the icon image. To determine the class dynamically, configure the Column with a <code>{@link #getClass}</code> function.
6910     */
6911    /**
6912     * @cfg {Function} handler A function called when the icon is clicked.
6913     * The handler is passed the following parameters:<div class="mdetail-params"><ul>
6914     * <li><code>grid</code> : GridPanel<div class="sub-desc">The owning GridPanel.</div></li>
6915     * <li><code>rowIndex</code> : Number<div class="sub-desc">The row index clicked on.</div></li>
6916     * <li><code>colIndex</code> : Number<div class="sub-desc">The column index clicked on.</div></li>
6917     * <li><code>item</code> : Object<div class="sub-desc">The clicked item (or this Column if multiple
6918     * {@link #items} were not configured).</div></li>
6919     * <li><code>e</code> : Event<div class="sub-desc">The click event.</div></li>
6920     * </ul></div>
6921     */
6922    /**
6923     * @cfg {Object} scope The scope (<tt><b>this</b></tt> reference) in which the <code>{@link #handler}</code>
6924     * and <code>{@link #getClass}</code> fuctions are executed. Defaults to this Column.
6925     */
6926    /**
6927     * @cfg {String} tooltip A tooltip message to be displayed on hover. {@link Ext.QuickTips#init Ext.QuickTips} must have
6928     * been initialized.
6929     */
6930    /**
6931     * @cfg {Boolean} stopSelection Defaults to <code>true</code>. Prevent grid <i>row</i> selection upon mousedown.
6932     */
6933    /**
6934     * @cfg {Function} getClass A function which returns the CSS class to apply to the icon image.
6935     * The function is passed the following parameters:<div class="mdetail-params"><ul>
6936     *     <li><b>v</b> : Object<p class="sub-desc">The value of the column's configured field (if any).</p></li>
6937     *     <li><b>metadata</b> : Object<p class="sub-desc">An object in which you may set the following attributes:<ul>
6938     *         <li><b>css</b> : String<p class="sub-desc">A CSS class name to add to the cell's TD element.</p></li>
6939     *         <li><b>attr</b> : String<p class="sub-desc">An HTML attribute definition string to apply to the data container element <i>within</i> the table cell
6940     *         (e.g. 'style="color:red;"').</p></li>
6941     *     </ul></p></li>
6942     *     <li><b>r</b> : Ext.data.Record<p class="sub-desc">The Record providing the data.</p></li>
6943     *     <li><b>rowIndex</b> : Number<p class="sub-desc">The row index..</p></li>
6944     *     <li><b>colIndex</b> : Number<p class="sub-desc">The column index.</p></li>
6945     *     <li><b>store</b> : Ext.data.Store<p class="sub-desc">The Store which is providing the data Model.</p></li>
6946     * </ul></div>
6947     */
6948    /**
6949     * @cfg {Array} items An Array which may contain multiple icon definitions, each element of which may contain:
6950     * <div class="mdetail-params"><ul>
6951     * <li><code>icon</code> : String<div class="sub-desc">The url of an image to display as the clickable element
6952     * in the column.</div></li>
6953     * <li><code>iconCls</code> : String<div class="sub-desc">A CSS class to apply to the icon image.
6954     * To determine the class dynamically, configure the item with a <code>getClass</code> function.</div></li>
6955     * <li><code>getClass</code> : Function<div class="sub-desc">A function which returns the CSS class to apply to the icon image.
6956     * The function is passed the following parameters:<ul>
6957     *     <li><b>v</b> : Object<p class="sub-desc">The value of the column's configured field (if any).</p></li>
6958     *     <li><b>metadata</b> : Object<p class="sub-desc">An object in which you may set the following attributes:<ul>
6959     *         <li><b>css</b> : String<p class="sub-desc">A CSS class name to add to the cell's TD element.</p></li>
6960     *         <li><b>attr</b> : String<p class="sub-desc">An HTML attribute definition string to apply to the data container element <i>within</i> the table cell
6961     *         (e.g. 'style="color:red;"').</p></li>
6962     *     </ul></p></li>
6963     *     <li><b>r</b> : Ext.data.Record<p class="sub-desc">The Record providing the data.</p></li>
6964     *     <li><b>rowIndex</b> : Number<p class="sub-desc">The row index..</p></li>
6965     *     <li><b>colIndex</b> : Number<p class="sub-desc">The column index.</p></li>
6966     *     <li><b>store</b> : Ext.data.Store<p class="sub-desc">The Store which is providing the data Model.</p></li>
6967     * </ul></div></li>
6968     * <li><code>handler</code> : Function<div class="sub-desc">A function called when the icon is clicked.</div></li>
6969     * <li><code>scope</code> : Scope<div class="sub-desc">The scope (<code><b>this</b></code> reference) in which the
6970     * <code>handler</code> and <code>getClass</code> functions are executed. Fallback defaults are this Column's
6971     * configured scope, then this Column.</div></li>
6972     * <li><code>tooltip</code> : String<div class="sub-desc">A tooltip message to be displayed on hover.
6973     * {@link Ext.QuickTips#init Ext.QuickTips} must have been initialized.</div></li>
6974     * </ul></div>
6975     */
6976    header: '&#160;',
6977
6978    actionIdRe: /x-action-col-(\d+)/,
6979   
6980    /**
6981     * @cfg {String} altText The alt text to use for the image element. Defaults to <tt>''</tt>.
6982     */
6983    altText: '',
6984
6985    constructor: function(cfg) {
6986        var me = this,
6987            items = cfg.items || (me.items = [me]),
6988            l = items.length,
6989            i,
6990            item;
6991
6992        Ext.grid.ActionColumn.superclass.constructor.call(me, cfg);
6993
6994//      Renderer closure iterates through items creating an <img> element for each and tagging with an identifying
6995//      class name x-action-col-{n}
6996        me.renderer = function(v, meta) {
6997//          Allow a configured renderer to create initial value (And set the other values in the "metadata" argument!)
6998            v = Ext.isFunction(cfg.renderer) ? cfg.renderer.apply(this, arguments)||'' : '';
6999
7000            meta.css += ' x-action-col-cell';
7001            for (i = 0; i < l; i++) {
7002                item = items[i];
7003                v += '<img alt="' + (item.altText || me.altText) + '" src="' + (item.icon || Ext.BLANK_IMAGE_URL) +
7004                    '" class="x-action-col-icon x-action-col-' + String(i) + ' ' + (item.iconCls || '') +
7005                    ' ' + (Ext.isFunction(item.getClass) ? item.getClass.apply(item.scope||this.scope||this, arguments) : '') + '"' +
7006                    ((item.tooltip) ? ' ext:qtip="' + item.tooltip + '"' : '') + ' />';
7007            }
7008            return v;
7009        };
7010    },
7011
7012    destroy: function() {
7013        delete this.items;
7014        delete this.renderer;
7015        return Ext.grid.ActionColumn.superclass.destroy.apply(this, arguments);
7016    },
7017
7018    /**
7019     * @private
7020     * Process and refire events routed from the GridView's processEvent method.
7021     * Also fires any configured click handlers. By default, cancels the mousedown event to prevent selection.
7022     * Returns the event handler's status to allow cancelling of GridView's bubbling process.
7023     */
7024    processEvent : function(name, e, grid, rowIndex, colIndex){
7025        var m = e.getTarget().className.match(this.actionIdRe),
7026            item, fn;
7027        if (m && (item = this.items[parseInt(m[1], 10)])) {
7028            if (name == 'click') {
7029                (fn = item.handler || this.handler) && fn.call(item.scope||this.scope||this, grid, rowIndex, colIndex, item, e);
7030            } else if ((name == 'mousedown') && (item.stopSelection !== false)) {
7031                return false;
7032            }
7033        }
7034        return Ext.grid.ActionColumn.superclass.processEvent.apply(this, arguments);
7035    }
7036});
7037
7038/*
7039 * @property types
7040 * @type Object
7041 * @member Ext.grid.Column
7042 * @static
7043 * <p>An object containing predefined Column classes keyed by a mnemonic code which may be referenced
7044 * by the {@link Ext.grid.ColumnModel#xtype xtype} config option of ColumnModel.</p>
7045 * <p>This contains the following properties</p><div class="mdesc-details"><ul>
7046 * <li>gridcolumn : <b>{@link Ext.grid.Column Column constructor}</b></li>
7047 * <li>booleancolumn : <b>{@link Ext.grid.BooleanColumn BooleanColumn constructor}</b></li>
7048 * <li>numbercolumn : <b>{@link Ext.grid.NumberColumn NumberColumn constructor}</b></li>
7049 * <li>datecolumn : <b>{@link Ext.grid.DateColumn DateColumn constructor}</b></li>
7050 * <li>templatecolumn : <b>{@link Ext.grid.TemplateColumn TemplateColumn constructor}</b></li>
7051 * </ul></div>
7052 */
7053Ext.grid.Column.types = {
7054    gridcolumn : Ext.grid.Column,
7055    booleancolumn: Ext.grid.BooleanColumn,
7056    numbercolumn: Ext.grid.NumberColumn,
7057    datecolumn: Ext.grid.DateColumn,
7058    templatecolumn: Ext.grid.TemplateColumn,
7059    actioncolumn: Ext.grid.ActionColumn
7060};/**
7061 * @class Ext.grid.RowNumberer
7062 * This is a utility class that can be passed into a {@link Ext.grid.ColumnModel} as a column config that provides
7063 * an automatic row numbering column.
7064 * <br>Usage:<br>
7065 <pre><code>
7066 // This is a typical column config with the first column providing row numbers
7067 var colModel = new Ext.grid.ColumnModel([
7068    new Ext.grid.RowNumberer(),
7069    {header: "Name", width: 80, sortable: true},
7070    {header: "Code", width: 50, sortable: true},
7071    {header: "Description", width: 200, sortable: true}
7072 ]);
7073 </code></pre>
7074 * @constructor
7075 * @param {Object} config The configuration options
7076 */
7077Ext.grid.RowNumberer = Ext.extend(Object, {
7078    /**
7079     * @cfg {String} header Any valid text or HTML fragment to display in the header cell for the row
7080     * number column (defaults to '').
7081     */
7082    header: "",
7083    /**
7084     * @cfg {Number} width The default width in pixels of the row number column (defaults to 23).
7085     */
7086    width: 23,
7087    /**
7088     * @cfg {Boolean} sortable True if the row number column is sortable (defaults to false).
7089     * @hide
7090     */
7091    sortable: false,
7092   
7093    constructor : function(config){
7094        Ext.apply(this, config);
7095        if(this.rowspan){
7096            this.renderer = this.renderer.createDelegate(this);
7097        }
7098    },
7099
7100    // private
7101    fixed:true,
7102    hideable: false,
7103    menuDisabled:true,
7104    dataIndex: '',
7105    id: 'numberer',
7106    rowspan: undefined,
7107
7108    // private
7109    renderer : function(v, p, record, rowIndex){
7110        if(this.rowspan){
7111            p.cellAttr = 'rowspan="'+this.rowspan+'"';
7112        }
7113        return rowIndex+1;
7114    }
7115});/**
7116 * @class Ext.grid.CheckboxSelectionModel
7117 * @extends Ext.grid.RowSelectionModel
7118 * A custom selection model that renders a column of checkboxes that can be toggled to select or deselect rows.
7119 * @constructor
7120 * @param {Object} config The configuration options
7121 */
7122Ext.grid.CheckboxSelectionModel = Ext.extend(Ext.grid.RowSelectionModel, {
7123
7124    /**
7125     * @cfg {Boolean} checkOnly <tt>true</tt> if rows can only be selected by clicking on the
7126     * checkbox column (defaults to <tt>false</tt>).
7127     */
7128    /**
7129     * @cfg {String} header Any valid text or HTML fragment to display in the header cell for the
7130     * checkbox column.  Defaults to:<pre><code>
7131     * '&lt;div class="x-grid3-hd-checker">&#38;#160;&lt;/div>'</tt>
7132     * </code></pre>
7133     * The default CSS class of <tt>'x-grid3-hd-checker'</tt> displays a checkbox in the header
7134     * and provides support for automatic check all/none behavior on header click. This string
7135     * can be replaced by any valid HTML fragment, including a simple text string (e.g.,
7136     * <tt>'Select Rows'</tt>), but the automatic check all/none behavior will only work if the
7137     * <tt>'x-grid3-hd-checker'</tt> class is supplied.
7138     */
7139    header : '<div class="x-grid3-hd-checker">&#160;</div>',
7140    /**
7141     * @cfg {Number} width The default width in pixels of the checkbox column (defaults to <tt>20</tt>).
7142     */
7143    width : 20,
7144    /**
7145     * @cfg {Boolean} sortable <tt>true</tt> if the checkbox column is sortable (defaults to
7146     * <tt>false</tt>).
7147     */
7148    sortable : false,
7149
7150    // private
7151    menuDisabled : true,
7152    fixed : true,
7153    hideable: false,
7154    dataIndex : '',
7155    id : 'checker',
7156    isColumn: true, // So that ColumnModel doesn't feed this through the Column constructor
7157
7158    constructor : function(){
7159        Ext.grid.CheckboxSelectionModel.superclass.constructor.apply(this, arguments);
7160        if(this.checkOnly){
7161            this.handleMouseDown = Ext.emptyFn;
7162        }
7163    },
7164
7165    // private
7166    initEvents : function(){
7167        Ext.grid.CheckboxSelectionModel.superclass.initEvents.call(this);
7168        this.grid.on('render', function(){
7169            Ext.fly(this.grid.getView().innerHd).on('mousedown', this.onHdMouseDown, this);
7170        }, this);
7171    },
7172
7173    /**
7174     * @private
7175     * Process and refire events routed from the GridView's processEvent method.
7176     */
7177    processEvent : function(name, e, grid, rowIndex, colIndex){
7178        if (name == 'mousedown') {
7179            this.onMouseDown(e, e.getTarget());
7180            return false;
7181        } else {
7182            return Ext.grid.Column.prototype.processEvent.apply(this, arguments);
7183        }
7184    },
7185
7186    // private
7187    onMouseDown : function(e, t){
7188        if(e.button === 0 && t.className == 'x-grid3-row-checker'){ // Only fire if left-click
7189            e.stopEvent();
7190            var row = e.getTarget('.x-grid3-row');
7191            if(row){
7192                var index = row.rowIndex;
7193                if(this.isSelected(index)){
7194                    this.deselectRow(index);
7195                }else{
7196                    this.selectRow(index, true);
7197                    this.grid.getView().focusRow(index);
7198                }
7199            }
7200        }
7201    },
7202
7203    // private
7204    onHdMouseDown : function(e, t) {
7205        if(t.className == 'x-grid3-hd-checker'){
7206            e.stopEvent();
7207            var hd = Ext.fly(t.parentNode);
7208            var isChecked = hd.hasClass('x-grid3-hd-checker-on');
7209            if(isChecked){
7210                hd.removeClass('x-grid3-hd-checker-on');
7211                this.clearSelections();
7212            }else{
7213                hd.addClass('x-grid3-hd-checker-on');
7214                this.selectAll();
7215            }
7216        }
7217    },
7218
7219    // private
7220    renderer : function(v, p, record){
7221        return '<div class="x-grid3-row-checker">&#160;</div>';
7222    },
7223   
7224    onEditorSelect: function(row, lastRow){
7225        if(lastRow != row && !this.checkOnly){
7226            this.selectRow(row); // *** highlight newly-selected cell and update selection
7227        }
7228    }
7229});
Note: See TracBrowser for help on using the repository browser.