git.roojs.org Git - roojs1/blob - Roo/grid/Grid.js

   1 /*
   2  * Based on:
   3  * Ext JS Library 1.1.1
   4  * Copyright(c) 2006-2007, Ext JS, LLC.
   5  *
   6  * Originally Released Under LGPL - original licence link has changed is not relivant.
   7  *
   8  * Fork - LGPL
   9  * <script type="text/javascript">
  10  */
  11
  12 /**
  13  * @class Roo.grid.Grid
  14  * @extends Roo.util.Observable
  15  * This class represents the primary interface of a component based grid control.
  16  * <br><br>Usage:<pre><code>
  17  var grid = new Roo.grid.Grid("my-container-id", {
  18      ds: myDataStore,
  19      cm: myColModel,
  20      selModel: mySelectionModel,
  21      autoSizeColumns: true,
  22      monitorWindowResize: false,
  23      trackMouseOver: true
  24  });
  25  // set any options
  26  grid.render();
  27  * </code></pre>
  28  * <b>Common Problems:</b><br/>
  29  * - Grid does not resize properly when going smaller: Setting overflow hidden on the container
  30  * element will correct this<br/>
  31  * - If you get el.style[camel]= NaNpx or -2px or something related, be certain you have given your container element
  32  * dimensions. The grid adapts to your container's size, if your container has no size defined then the results
  33  * are unpredictable.<br/>
  34  * - Do not render the grid into an element with display:none. Try using visibility:hidden. Otherwise there is no way for the
  35  * grid to calculate dimensions/offsets.<br/>
  36   * @constructor
  37  * @param {String/HTMLElement/Roo.Element} container The element into which this grid will be rendered -
  38  * The container MUST have some type of size defined for the grid to fill. The container will be
  39  * automatically set to position relative if it isn't already.
  40  * @param {Object} config A config object that sets properties on this grid.
  41  */
  42 Roo.grid.Grid = function(container, config){
  43         // initialize the container
  44         this.container = Roo.get(container);
  45         this.container.update("");
  46         this.container.setStyle("overflow", "hidden");
  47     this.container.addClass('x-grid-container');
  48
  49     this.id = this.container.id;
  50
  51     Roo.apply(this, config);
  52     // check and correct shorthanded configs
  53     if(this.ds){
  54         this.dataSource = this.ds;
  55         delete this.ds;
  56     }
  57     if(this.cm){
  58         this.colModel = this.cm;
  59         delete this.cm;
  60     }
  61     if(this.sm){
  62         this.selModel = this.sm;
  63         delete this.sm;
  64     }
  65
  66     if (this.selModel) {
  67         this.selModel = Roo.factory(this.selModel, Roo.grid);
  68         this.sm = this.selModel;
  69         this.sm.xmodule = this.xmodule || false;
  70     }
  71     if (typeof(this.colModel.config) == 'undefined') {
  72         this.colModel = new Roo.grid.ColumnModel(this.colModel);
  73         this.cm = this.colModel;
  74         this.cm.xmodule = this.xmodule || false;
  75     }
  76     if (this.dataSource) {
  77         this.dataSource= Roo.factory(this.dataSource, Roo.data);
  78         this.ds = this.dataSource;
  79         this.ds.xmodule = this.xmodule || false;
  80
  81     }
  82
  83
  84
  85     if(this.width){
  86         this.container.setWidth(this.width);
  87     }
  88
  89     if(this.height){
  90         this.container.setHeight(this.height);
  91     }
  92     /** @private */
  93         this.addEvents({
  94         // raw events
  95         /**
  96          * @event click
  97          * The raw click event for the entire grid.
  98          * @param {Roo.EventObject} e
  99          */
 100         "click" : true,
 101         /**
 102          * @event dblclick
 103          * The raw dblclick event for the entire grid.
 104          * @param {Roo.EventObject} e
 105          */
 106         "dblclick" : true,
 107         /**
 108          * @event contextmenu
 109          * The raw contextmenu event for the entire grid.
 110          * @param {Roo.EventObject} e
 111          */
 112         "contextmenu" : true,
 113         /**
 114          * @event mousedown
 115          * The raw mousedown event for the entire grid.
 116          * @param {Roo.EventObject} e
 117          */
 118         "mousedown" : true,
 119         /**
 120          * @event mouseup
 121          * The raw mouseup event for the entire grid.
 122          * @param {Roo.EventObject} e
 123          */
 124         "mouseup" : true,
 125         /**
 126          * @event mouseover
 127          * The raw mouseover event for the entire grid.
 128          * @param {Roo.EventObject} e
 129          */
 130         "mouseover" : true,
 131         /**
 132          * @event mouseout
 133          * The raw mouseout event for the entire grid.
 134          * @param {Roo.EventObject} e
 135          */
 136         "mouseout" : true,
 137         /**
 138          * @event keypress
 139          * The raw keypress event for the entire grid.
 140          * @param {Roo.EventObject} e
 141          */
 142         "keypress" : true,
 143         /**
 144          * @event keydown
 145          * The raw keydown event for the entire grid.
 146          * @param {Roo.EventObject} e
 147          */
 148         "keydown" : true,
 149
 150         // custom events
 151
 152         /**
 153          * @event cellclick
 154          * Fires when a cell is clicked
 155          * @param {Grid} this
 156          * @param {Number} rowIndex
 157          * @param {Number} columnIndex
 158          * @param {Roo.EventObject} e
 159          */
 160         "cellclick" : true,
 161         /**
 162          * @event celldblclick
 163          * Fires when a cell is double clicked
 164          * @param {Grid} this
 165          * @param {Number} rowIndex
 166          * @param {Number} columnIndex
 167          * @param {Roo.EventObject} e
 168          */
 169         "celldblclick" : true,
 170         /**
 171          * @event rowclick
 172          * Fires when a row is clicked
 173          * @param {Grid} this
 174          * @param {Number} rowIndex
 175          * @param {Roo.EventObject} e
 176          */
 177         "rowclick" : true,
 178         /**
 179          * @event rowdblclick
 180          * Fires when a row is double clicked
 181          * @param {Grid} this
 182          * @param {Number} rowIndex
 183          * @param {Roo.EventObject} e
 184          */
 185         "rowdblclick" : true,
 186         /**
 187          * @event headerclick
 188          * Fires when a header is clicked
 189          * @param {Grid} this
 190          * @param {Number} columnIndex
 191          * @param {Roo.EventObject} e
 192          */
 193         "headerclick" : true,
 194         /**
 195          * @event headerdblclick
 196          * Fires when a header cell is double clicked
 197          * @param {Grid} this
 198          * @param {Number} columnIndex
 199          * @param {Roo.EventObject} e
 200          */
 201         "headerdblclick" : true,
 202         /**
 203          * @event rowcontextmenu
 204          * Fires when a row is right clicked
 205          * @param {Grid} this
 206          * @param {Number} rowIndex
 207          * @param {Roo.EventObject} e
 208          */
 209         "rowcontextmenu" : true,
 210         /**
 211          * @event cellcontextmenu
 212          * Fires when a cell is right clicked
 213          * @param {Grid} this
 214          * @param {Number} rowIndex
 215          * @param {Number} cellIndex
 216          * @param {Roo.EventObject} e
 217          */
 218          "cellcontextmenu" : true,
 219         /**
 220          * @event headercontextmenu
 221          * Fires when a header is right clicked
 222          * @param {Grid} this
 223          * @param {Number} columnIndex
 224          * @param {Roo.EventObject} e
 225          */
 226         "headercontextmenu" : true,
 227         /**
 228          * @event bodyscroll
 229          * Fires when the body element is scrolled
 230          * @param {Number} scrollLeft
 231          * @param {Number} scrollTop
 232          */
 233         "bodyscroll" : true,
 234         /**
 235          * @event columnresize
 236          * Fires when the user resizes a column
 237          * @param {Number} columnIndex
 238          * @param {Number} newSize
 239          */
 240         "columnresize" : true,
 241         /**
 242          * @event columnmove
 243          * Fires when the user moves a column
 244          * @param {Number} oldIndex
 245          * @param {Number} newIndex
 246          */
 247         "columnmove" : true,
 248         /**
 249          * @event startdrag
 250          * Fires when row(s) start being dragged
 251          * @param {Grid} this
 252          * @param {Roo.GridDD} dd The drag drop object
 253          * @param {event} e The raw browser event
 254          */
 255         "startdrag" : true,
 256         /**
 257          * @event enddrag
 258          * Fires when a drag operation is complete
 259          * @param {Grid} this
 260          * @param {Roo.GridDD} dd The drag drop object
 261          * @param {event} e The raw browser event
 262          */
 263         "enddrag" : true,
 264         /**
 265          * @event dragdrop
 266          * Fires when dragged row(s) are dropped on a valid DD target
 267          * @param {Grid} this
 268          * @param {Roo.GridDD} dd The drag drop object
 269          * @param {String} targetId The target drag drop object
 270          * @param {event} e The raw browser event
 271          */
 272         "dragdrop" : true,
 273         /**
 274          * @event dragover
 275          * Fires while row(s) are being dragged. "targetId" is the id of the Yahoo.util.DD object the selected rows are being dragged over.
 276          * @param {Grid} this
 277          * @param {Roo.GridDD} dd The drag drop object
 278          * @param {String} targetId The target drag drop object
 279          * @param {event} e The raw browser event
 280          */
 281         "dragover" : true,
 282         /**
 283          * @event dragenter
 284          *  Fires when the dragged row(s) first cross another DD target while being dragged
 285          * @param {Grid} this
 286          * @param {Roo.GridDD} dd The drag drop object
 287          * @param {String} targetId The target drag drop object
 288          * @param {event} e The raw browser event
 289          */
 290         "dragenter" : true,
 291         /**
 292          * @event dragout
 293          * Fires when the dragged row(s) leave another DD target while being dragged
 294          * @param {Grid} this
 295          * @param {Roo.GridDD} dd The drag drop object
 296          * @param {String} targetId The target drag drop object
 297          * @param {event} e The raw browser event
 298          */
 299         "dragout" : true,
 300         /**
 301          * @event rowclass
 302          * Fires when a row is rendered, so you can change add a style to it.
 303          * @param {GridView} gridview   The grid view
 304          * @param {Object} rowcfg   contains record  rowIndex and rowClass - set rowClass to add a style.
 305          */
 306         'rowclass' : true,
 307
 308         /**
 309          * @event render
 310          * Fires when the grid is rendered
 311          * @param {Grid} grid
 312          */
 313         'render' : true
 314     });
 315
 316     Roo.grid.Grid.superclass.constructor.call(this);
 317 };
 318 Roo.extend(Roo.grid.Grid, Roo.util.Observable, {
 319
 320     /**
 321          * @cfg {Roo.grid.AbstractSelectionModel} sm [default={Roo.grid.RowSelectionModel}] The selection Model
 322          */
 323         /**
 324          * @cfg {Roo.grid.GridView} view [default={Roo.grid.GridView}] The view that renders the grid
 325          */
 326         /**
 327      * @cfg {String} ddGroup - drag drop group.
 328      */
 329       /**
 330      * @cfg {String} dragGroup - drag group (?? not sure if needed.)
 331      */
 332
 333     /**
 334      * @cfg {Number} minColumnWidth The minimum width a column can be resized to. Default is 25.
 335      */
 336     minColumnWidth : 25,
 337
 338     /**
 339      * @cfg {Boolean} autoSizeColumns True to automatically resize the columns to fit their content
 340      * <b>on initial render.</b> It is more efficient to explicitly size the columns
 341      * through the ColumnModel's {@link Roo.grid.ColumnModel#width} config option.  Default is false.
 342      */
 343     autoSizeColumns : false,
 344
 345     /**
 346      * @cfg {Boolean} autoSizeHeaders True to measure headers with column data when auto sizing columns. Default is true.
 347      */
 348     autoSizeHeaders : true,
 349
 350     /**
 351      * @cfg {Boolean} monitorWindowResize True to autoSize the grid when the window resizes. Default is true.
 352      */
 353     monitorWindowResize : true,
 354
 355     /**
 356      * @cfg {Boolean} maxRowsToMeasure If autoSizeColumns is on, maxRowsToMeasure can be used to limit the number of
 357      * rows measured to get a columns size. Default is 0 (all rows).
 358      */
 359     maxRowsToMeasure : 0,
 360
 361     /**
 362      * @cfg {Boolean} trackMouseOver True to highlight rows when the mouse is over. Default is true.
 363      */
 364     trackMouseOver : true,
 365
 366     /**
 367     * @cfg {Boolean} enableDrag  True to enable drag of rows. Default is false. (double check if this is needed?)
 368     */
 369       /**
 370     * @cfg {Boolean} enableDrop  True to enable drop of elements. Default is false. (double check if this is needed?)
 371     */
 372
 373     /**
 374     * @cfg {Boolean} enableDragDrop True to enable drag and drop of rows. Default is false.
 375     */
 376     enableDragDrop : false,
 377
 378     /**
 379     * @cfg {Boolean} enableColumnMove True to enable drag and drop reorder of columns. Default is true.
 380     */
 381     enableColumnMove : true,
 382
 383     /**
 384     * @cfg {Boolean} enableColumnHide True to enable hiding of columns with the header context menu. Default is true.
 385     */
 386     enableColumnHide : true,
 387
 388     /**
 389     * @cfg {Boolean} enableRowHeightSync True to manually sync row heights across locked and not locked rows. Default is false.
 390     */
 391     enableRowHeightSync : false,
 392
 393     /**
 394     * @cfg {Boolean} stripeRows True to stripe the rows.  Default is true.
 395     */
 396     stripeRows : true,
 397
 398     /**
 399     * @cfg {Boolean} autoHeight True to fit the height of the grid container to the height of the data. Default is false.
 400     */
 401     autoHeight : false,
 402
 403     /**
 404      * @cfg {String} autoExpandColumn The id (or dataIndex) of a column in this grid that should expand to fill unused space. This id can not be 0. Default is false.
 405      */
 406     autoExpandColumn : false,
 407
 408     /**
 409     * @cfg {Number} autoExpandMin The minimum width the autoExpandColumn can have (if enabled).
 410     * Default is 50.
 411     */
 412     autoExpandMin : 50,
 413
 414     /**
 415     * @cfg {Number} autoExpandMax The maximum width the autoExpandColumn can have (if enabled). Default is 1000.
 416     */
 417     autoExpandMax : 1000,
 418
 419     /**
 420     * @cfg {Object} view The {@link Roo.grid.GridView} used by the grid. This can be set before a call to render().
 421     */
 422     view : null,
 423
 424     /**
 425     * @cfg {Object} loadMask An {@link Roo.LoadMask} config or true to mask the grid while loading. Default is false.
 426     */
 427     loadMask : false,
 428     /**
 429     * @cfg {Roo.dd.DropTarget} dropTarget An {@link Roo.dd.DropTarget} config
 430     */
 431     dropTarget: false,
 432
 433
 434
 435     // private
 436     rendered : false,
 437
 438     /**
 439     * @cfg {Boolean} autoWidth True to set the grid's width to the default total width of the grid's columns instead
 440     * of a fixed width. Default is false.
 441     */
 442     /**
 443     * @cfg {Number} maxHeight Sets the maximum height of the grid - ignored if autoHeight is not on.
 444     */
 445
 446
 447     /**
 448     * @cfg {String} ddText Configures the text is the drag proxy (defaults to "%0 selected row(s)").
 449     * %0 is replaced with the number of selected rows.
 450     */
 451     ddText : "{0} selected row{1}",
 452
 453
 454     /**
 455      * Called once after all setup has been completed and the grid is ready to be rendered.
 456      * @return {Roo.grid.Grid} this
 457      */
 458     render : function()
 459     {
 460         var c = this.container;
 461         // try to detect autoHeight/width mode
 462         if((!c.dom.offsetHeight || c.dom.offsetHeight < 20) || c.getStyle("height") == "auto"){
 463             this.autoHeight = true;
 464         }
 465         var view = this.getView();
 466         view.init(this);
 467
 468         c.on("click", this.onClick, this);
 469         c.on("dblclick", this.onDblClick, this);
 470         c.on("contextmenu", this.onContextMenu, this);
 471         c.on("keydown", this.onKeyDown, this);
 472         if (Roo.isTouch) {
 473             c.on("touchstart", this.onTouchStart, this);
 474         }
 475
 476         this.relayEvents(c, ["mousedown","mouseup","mouseover","mouseout","keypress"]);
 477
 478         this.getSelectionModel().init(this);
 479
 480         view.render();
 481
 482         if(this.loadMask){
 483             this.loadMask = new Roo.LoadMask(this.container,
 484                     Roo.apply({store:this.dataSource}, this.loadMask));
 485         }
 486
 487
 488         if (this.toolbar && this.toolbar.xtype) {
 489             this.toolbar.container = this.getView().getHeaderPanel(true);
 490             this.toolbar = new Roo.Toolbar(this.toolbar);
 491         }
 492         if (this.footer && this.footer.xtype) {
 493             this.footer.dataSource = this.getDataSource();
 494             this.footer.container = this.getView().getFooterPanel(true);
 495             this.footer = Roo.factory(this.footer, Roo);
 496         }
 497         if (this.dropTarget && this.dropTarget.xtype) {
 498             delete this.dropTarget.xtype;
 499             this.dropTarget =  new Roo.dd.DropTarget(this.getView().mainBody, this.dropTarget);
 500         }
 501
 502
 503         this.rendered = true;
 504         this.fireEvent('render', this);
 505         return this;
 506     },
 507
 508     /**
 509      * Reconfigures the grid to use a different Store and Column Model.
 510      * The View will be bound to the new objects and refreshed.
 511      * @param {Roo.data.Store} dataSource The new {@link Roo.data.Store} object
 512      * @param {Roo.grid.ColumnModel} The new {@link Roo.grid.ColumnModel} object
 513      */
 514     reconfigure : function(dataSource, colModel){
 515         if(this.loadMask){
 516             this.loadMask.destroy();
 517             this.loadMask = new Roo.LoadMask(this.container,
 518                     Roo.apply({store:dataSource}, this.loadMask));
 519         }
 520         this.view.bind(dataSource, colModel);
 521         this.dataSource = dataSource;
 522         this.colModel = colModel;
 523         this.view.refresh(true);
 524     },
 525     /**
 526      * addColumns
 527      * Add's a column, default at the end..
 528
 529      * @param {int} position to add (default end)
 530      * @param {Array} of objects of column configuration see {@link Roo.grid.ColumnModel}
 531      */
 532     addColumns : function(pos, ar)
 533     {
 534
 535         for (var i =0;i< ar.length;i++) {
 536             var cfg = ar[i];
 537             cfg.id = typeof(cfg.id) == 'undefined' ? Roo.id() : cfg.id; // don't normally use this..
 538             this.cm.lookup[cfg.id] = cfg;
 539         }
 540
 541
 542         if (typeof(pos) == 'undefined' || pos >= this.cm.config.length) {
 543             pos = this.cm.config.length; //this.cm.config.push(cfg);
 544         }
 545         pos = Math.max(0,pos);
 546         ar.unshift(0);
 547         ar.unshift(pos);
 548         this.cm.config.splice.apply(this.cm.config, ar);
 549
 550
 551
 552         this.view.generateRules(this.cm);
 553         this.view.refresh(true);
 554
 555     },
 556
 557
 558
 559
 560     // private
 561     onKeyDown : function(e){
 562         this.fireEvent("keydown", e);
 563     },
 564
 565     /**
 566      * Destroy this grid.
 567      * @param {Boolean} removeEl True to remove the element
 568      */
 569     destroy : function(removeEl, keepListeners){
 570         if(this.loadMask){
 571             this.loadMask.destroy();
 572         }
 573         var c = this.container;
 574         c.removeAllListeners();
 575         this.view.destroy();
 576         this.colModel.purgeListeners();
 577         if(!keepListeners){
 578             this.purgeListeners();
 579         }
 580         c.update("");
 581         if(removeEl === true){
 582             c.remove();
 583         }
 584     },
 585
 586     // private
 587     processEvent : function(name, e){
 588         // does this fire select???
 589         //Roo.log('grid:processEvent '  + name);
 590
 591         if (name != 'touchstart' ) {
 592             this.fireEvent(name, e);
 593         }
 594
 595         var t = e.getTarget();
 596         var v = this.view;
 597         var header = v.findHeaderIndex(t);
 598         if(header !== false){
 599             var ename = name == 'touchstart' ? 'click' : name;
 600
 601             this.fireEvent("header" + ename, this, header, e);
 602         }else{
 603             var row = v.findRowIndex(t);
 604             var cell = v.findCellIndex(t);
 605             if (name == 'touchstart') {
 606                 // first touch is always a click.
 607                 // hopefull this happens after selection is updated.?
 608                 name = false;
 609
 610                 if (typeof(this.selModel.getSelectedCell) != 'undefined') {
 611                     var cs = this.selModel.getSelectedCell();
 612                     if (row == cs[0] && cell == cs[1]){
 613                         name = 'dblclick';
 614                     }
 615                 }
 616                 if (typeof(this.selModel.getSelections) != 'undefined') {
 617                     var cs = this.selModel.getSelections();
 618                     var ds = this.dataSource;
 619                     if (cs.length == 1 && ds.getAt(row) == cs[0]){
 620                         name = 'dblclick';
 621                     }
 622                 }
 623                 if (!name) {
 624                     return;
 625                 }
 626             }
 627
 628
 629             if(row !== false){
 630                 this.fireEvent("row" + name, this, row, e);
 631                 if(cell !== false){
 632                     this.fireEvent("cell" + name, this, row, cell, e);
 633                 }
 634             }
 635         }
 636     },
 637
 638     // private
 639     onClick : function(e){
 640         this.processEvent("click", e);
 641     },
 642    // private
 643     onTouchStart : function(e){
 644         this.processEvent("touchstart", e);
 645     },
 646
 647     // private
 648     onContextMenu : function(e, t){
 649         this.processEvent("contextmenu", e);
 650     },
 651
 652     // private
 653     onDblClick : function(e){
 654         this.processEvent("dblclick", e);
 655     },
 656
 657     // private
 658     walkCells : function(row, col, step, fn, scope){
 659         var cm = this.colModel, clen = cm.getColumnCount();
 660         var ds = this.dataSource, rlen = ds.getCount(), first = true;
 661         if(step < 0){
 662             if(col < 0){
 663                 row--;
 664                 first = false;
 665             }
 666             while(row >= 0){
 667                 if(!first){
 668                     col = clen-1;
 669                 }
 670                 first = false;
 671                 while(col >= 0){
 672                     if(fn.call(scope || this, row, col, cm) === true){
 673                         return [row, col];
 674                     }
 675                     col--;
 676                 }
 677                 row--;
 678             }
 679         } else {
 680             if(col >= clen){
 681                 row++;
 682                 first = false;
 683             }
 684             while(row < rlen){
 685                 if(!first){
 686                     col = 0;
 687                 }
 688                 first = false;
 689                 while(col < clen){
 690                     if(fn.call(scope || this, row, col, cm) === true){
 691                         return [row, col];
 692                     }
 693                     col++;
 694                 }
 695                 row++;
 696             }
 697         }
 698         return null;
 699     },
 700
 701     // private
 702     getSelections : function(){
 703         return this.selModel.getSelections();
 704     },
 705
 706     /**
 707      * Causes the grid to manually recalculate its dimensions. Generally this is done automatically,
 708      * but if manual update is required this method will initiate it.
 709      */
 710     autoSize : function(){
 711         if(this.rendered){
 712             this.view.layout();
 713             if(this.view.adjustForScroll){
 714                 this.view.adjustForScroll();
 715             }
 716         }
 717     },
 718
 719     /**
 720      * Returns the grid's underlying element.
 721      * @return {Element} The element
 722      */
 723     getGridEl : function(){
 724         return this.container;
 725     },
 726
 727     // private for compatibility, overridden by editor grid
 728     stopEditing : function(){},
 729
 730     /**
 731      * Returns the grid's SelectionModel.
 732      * @return {SelectionModel}
 733      */
 734     getSelectionModel : function(){
 735         if(!this.selModel){
 736             this.selModel = new Roo.grid.RowSelectionModel();
 737         }
 738         return this.selModel;
 739     },
 740
 741     /**
 742      * Returns the grid's DataSource.
 743      * @return {DataSource}
 744      */
 745     getDataSource : function(){
 746         return this.dataSource;
 747     },
 748
 749     /**
 750      * Returns the grid's ColumnModel.
 751      * @return {ColumnModel}
 752      */
 753     getColumnModel : function(){
 754         return this.colModel;
 755     },
 756
 757     /**
 758      * Returns the grid's GridView object.
 759      * @return {GridView}
 760      */
 761     getView : function(){
 762         if(!this.view){
 763             this.view = new Roo.grid.GridView(this.viewConfig);
 764             this.relayEvents(this.view, [
 765                 "beforerowremoved", "beforerowsinserted",
 766                 "beforerefresh", "rowremoved",
 767                 "rowsinserted", "rowupdated" ,"refresh"
 768             ]);
 769         }
 770         return this.view;
 771     },
 772     /**
 773      * Called to get grid's drag proxy text, by default returns this.ddText.
 774      * Override this to put something different in the dragged text.
 775      * @return {String}
 776      */
 777     getDragDropText : function(){
 778         var count = this.selModel.getCount();
 779         return String.format(this.ddText, count, count == 1 ? '' : 's');
 780     }
 781 });