Hide hour sum per default
[misc/kostenrechnung] / lib / rico / ricoLiveGrid.js
1 /*
2  *  (c) 2005-2009 Richard Cowin (http://openrico.org)
3  *  (c) 2005-2009 Matt Brown (http://dowdybrown.com)
4  *
5  *  Rico is licensed under the Apache License, Version 2.0 (the "License"); you may not use this
6  *  file except in compliance with the License. You may obtain a copy of the License at
7  *
8  *         http://www.apache.org/licenses/LICENSE-2.0
9  *
10  *  Unless required by applicable law or agreed to in writing, software distributed under the
11  *  License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
12  *  either express or implied. See the License for the specific language governing permissions
13  *  and limitations under the License.
14  */
15
16 if(typeof Rico=='undefined') throw("LiveGrid requires the Rico JavaScript framework");
17 if(typeof RicoUtil=='undefined') throw("LiveGrid requires the RicoUtil Library");
18 if(typeof RicoTranslate=='undefined') throw("LiveGrid requires the RicoTranslate Library");
19 if(typeof Rico.TableColumn=='undefined') throw("LiveGrid requires ricoGridCommon.js");
20
21
22 /** @namespace */
23 Rico.Buffer = {};
24
25 Rico.Buffer.Base = Class.create(
26 /** @lends Rico.Buffer.Base# */
27 {
28 /**
29  * @class Defines the static buffer class (no AJAX).
30  * Loads buffer with data that already exists in the document as an HTML table or passed via javascript.
31  * Also serves as a base class for AJAX-enabled buffers.
32  * @constructs
33  */
34   initialize: function(dataTable, options) {
35     this.clear();
36     this.updateInProgress = false;
37     this.lastOffset = 0;
38     this.rcvdRowCount = false;  // true if an eof element was included in the last xml response
39     this.foundRowCount = false; // true if an xml response is ever received with eof true
40     this.totalRows = 0;
41     this.rowcntContent = "";
42     this.rcvdOffset = -1;
43     this.options = {
44       fixedHdrRows     : 0,
45       canFilter        : true,  // does buffer object support filtering?
46       isEncoded        : true,  // is the data received via ajax html encoded?
47       acceptAttr       : []     // attributes that can be copied from original/ajax data (e.g. className, style, id)
48     };
49     Object.extend(this.options, options || {});
50     if (dataTable) {
51       this.loadRowsFromTable(dataTable,this.options.fixedHdrRows);
52     } else {
53       this.clear();
54     }
55   },
56
57   registerGrid: function(liveGrid) {
58     this.liveGrid = liveGrid;
59   },
60
61   setTotalRows: function( newTotalRows ) {
62     if (typeof(newTotalRows)!='number') newTotalRows=this.size;
63     if (this.totalRows == newTotalRows) return;
64     this.totalRows = newTotalRows;
65     if (this.liveGrid) {
66       Rico.writeDebugMsg("setTotalRows, newTotalRows="+newTotalRows);
67       if (this.liveGrid.sizeTo=='data') this.liveGrid.resizeWindow();
68       this.liveGrid.updateHeightDiv();
69     }
70   },
71
72   loadRowsFromTable: function(tableElement,firstRow) {
73     var newRows = new Array();
74     var trs = tableElement.getElementsByTagName("tr");
75     for ( var i=firstRow || 0; i < trs.length; i++ ) {
76       var row = new Array();
77       var cells = trs[i].getElementsByTagName("td");
78       for ( var j=0; j < cells.length ; j++ )
79         row[j]=cells[j].innerHTML;
80       newRows.push( row );
81     }
82     this.loadRows(newRows);
83   },
84
85   loadRowsFromArray: function(array2D) {
86     for ( var i=0; i < array2D.length; i++ ) {
87       for ( var j=0; j < array2D[i].length ; j++ ) {
88         array2D[i][j]=array2D[i][j].toString();
89       }
90     }
91     this.loadRows(array2D);
92   },
93
94   loadRows: function(jstable) {
95     this.baseRows = jstable;
96     this.startPos = 0;
97     this.size = this.baseRows.length;
98   },
99
100   dom2jstable: function(rowsElement) {
101     Rico.writeDebugMsg('dom2jstable: encoded='+this.options.isEncoded);
102     var newRows = new Array();
103     var trs = rowsElement.getElementsByTagName("tr");
104     for ( var i=0; i < trs.length; i++ ) {
105       var row = new Array();
106       var cells = trs[i].getElementsByTagName("td");
107       for ( var j=0; j < cells.length ; j++ )
108         row[j]=RicoUtil.getContentAsString(cells[j],this.options.isEncoded);
109       newRows.push( row );
110     }
111     return newRows;
112   },
113
114   dom2jstableAttr: function(rowsElement,firstRow) {
115     var acceptAttr=this.options.acceptAttr;
116     Rico.writeDebugMsg("dom2jstableAttr start, # attr="+acceptAttr.length);
117     var newRows = new Array();
118     var trs = rowsElement.getElementsByTagName("tr");
119     for ( var i=firstRow || 0; i < trs.length; i++ ) {
120       var row = new Array();
121       var cells = trs[i].getElementsByTagName("td");
122       for ( var j=0; j < cells.length ; j++ ) {
123         row[j]={};
124         for (var k=0; k<acceptAttr.length; k++)
125           row[j]['_'+acceptAttr[k]]=cells[j].getAttribute(acceptAttr[k]);
126         if (Prototype.Browser.IE) row[j]._class=cells[j].getAttribute('className');
127       }
128       newRows.push( row );
129     }
130     Rico.writeDebugMsg("dom2jstableAttr end");
131     return newRows;
132   },
133
134   _blankRow: function() {
135     var newRow=[];
136     for (var i=0; i<this.liveGrid.columns.length; i++) {
137       newRow[i]='';
138     }
139     return newRow;
140   },
141
142   deleteRows: function(rowIndex,cnt) {
143     this.baseRows.splice(rowIndex,typeof(cnt)=='number' ? cnt : 1);
144     this.liveGrid.isPartialBlank=true;
145     this.size=this.baseRows.length;
146   },
147
148   insertRow: function(beforeRowIndex) {
149     var r=this._blankRow();
150     this.baseRows.splice(beforeRowIndex,0,r);
151     this.size=this.baseRows.length;
152     this.liveGrid.isPartialBlank=true;
153     if (this.startPos < 0) this.startPos=0;
154     return r;
155   },
156
157   appendRows: function(cnt) {
158     var newRows=[];
159     for (var i=0; i<cnt; i++) {
160       var r=this._blankRow();
161       this.baseRows.push(r);
162       newRows.push(r);
163     }
164     this.size=this.baseRows.length;
165     this.liveGrid.isPartialBlank=true;
166     if (this.startPos < 0) this.startPos=0;
167     return newRows;
168   },
169   
170   sortFunc: function(coltype) {
171     switch (coltype) {
172       case 'number': return this._sortNumeric.bind(this);
173       case 'control':return this._sortControl.bind(this);
174       default:       return this._sortAlpha.bind(this);
175     }
176   },
177
178   sortBuffer: function(colnum) {
179     if (!this.baseRows) {
180       this.delayedSortCol=colnum;
181       return;
182     }
183     this.liveGrid.showMsg(RicoTranslate.getPhraseById("sorting"));
184     this.sortColumn=colnum;
185     var col=this.liveGrid.columns[colnum];
186     this.getValFunc=col._sortfunc;
187     this.baseRows.sort(this.sortFunc(col.format.type));
188     if (col.getSortDirection()=='DESC') this.baseRows.reverse();
189   },
190   
191   _sortAlpha: function(a,b) {
192     var aa = this.sortColumn<a.length ? RicoUtil.getInnerText(a[this.sortColumn]) : '';
193     var bb = this.sortColumn<b.length ? RicoUtil.getInnerText(b[this.sortColumn]) : '';
194     if (aa==bb) return 0;
195     if (aa<bb) return -1;
196     return 1;
197   },
198
199   _sortNumeric: function(a,b) {
200     var aa = this.sortColumn<a.length ? this.nan2zero(RicoUtil.getInnerText(a[this.sortColumn])) : 0;
201     var bb = this.sortColumn<b.length ? this.nan2zero(RicoUtil.getInnerText(b[this.sortColumn])) : 0;
202     return aa-bb;
203   },
204
205   nan2zero: function(n) {
206     if (typeof(n)=='string') n=parseFloat(n);
207     return isNaN(n) || typeof(n)=='undefined' ? 0 : n;
208   },
209   
210   _sortControl: function(a,b) {
211     var aa = this.sortColumn<a.length ? RicoUtil.getInnerText(a[this.sortColumn]) : '';
212     var bb = this.sortColumn<b.length ? RicoUtil.getInnerText(b[this.sortColumn]) : '';
213     if (this.getValFunc) {
214       aa=this.getValFunc(aa);
215       bb=this.getValFunc(bb);
216     }
217     if (aa==bb) return 0;
218     if (aa<bb) return -1;
219     return 1;
220   },
221
222   clear: function() {
223     this.baseRows = [];
224     this.rows = [];
225     this.startPos = -1;
226     this.size = 0;
227     this.windowPos = 0;
228   },
229
230   isInRange: function(position) {
231     var lastRow=Math.min(this.totalRows, position + this.liveGrid.pageSize);
232     return (position >= this.startPos) && (lastRow <= this.endPos()); // && (this.size != 0);
233   },
234
235   endPos: function() {
236     return this.startPos + this.rows.length;
237   },
238
239   fetch: function(offset) {
240     Rico.writeDebugMsg('fetch '+this.liveGrid.tableId+': offset='+offset);
241     this.applyFilters();
242     this.setTotalRows();
243     this.rcvdRowCount = true;
244     this.foundRowCount = true;
245     if (offset < 0) offset=0;
246     this.liveGrid.refreshContents(offset);
247     return;
248   },
249
250   exportAllRows: function(populate,finish) {
251     populate(this.getRows(0,this.totalRows));
252     finish();
253   },
254   
255 /**
256  * @return a 2D array of buffer data representing the rows that are currently visible on the grid
257  */
258   visibleRows: function() {
259     return this.rows.slice(this.windowStart,this.windowEnd);
260   },
261
262   setWindow: function(start, count) {
263     this.windowStart = start - this.startPos;                       // position in the buffer of first visible row
264     this.windowEnd = Math.min(this.windowStart + count,this.size);  // position in the buffer of last visible row containing data+1
265     this.windowPos = start;                                         // position in the dataset of first visible row
266   },
267
268 /**
269  * @return true if bufRow is currently visible in the grid
270  */
271   isVisible: function(bufRow) {
272     return bufRow < this.rows.length && bufRow >= this.windowStart && bufRow < this.windowEnd;
273   },
274   
275 /**
276  * takes a window row index and returns the corresponding buffer row index
277  */
278   bufferRow: function(windowRow) {
279     return this.windowStart+windowRow;
280   },
281
282 /**
283  * @return buffer cell at the specified visible row/col index
284  */
285   getWindowCell: function(windowRow,col) {
286     var bufrow=this.bufferRow(windowRow);
287     return this.isVisible(bufrow) && col < this.rows[bufrow].length ? this.rows[bufrow][col] : null;
288   },
289
290   getWindowAttr: function(windowRow,col) {
291     var bufrow=this.bufferRow(windowRow);
292     return this.attr && this.isVisible(bufrow) && col < this.attr[bufrow].length ? this.attr[bufrow][col] : null;
293   },
294
295   getWindowValue: function(windowRow,col) {
296     return this.getWindowCell(windowRow,col);
297   },
298
299   setWindowValue: function(windowRow,col,newval) {
300     var bufrow=this.bufferRow(windowRow);
301     if (bufrow >= this.windowEnd) return false;
302     return this.setValue(bufrow,col,newval);
303   },
304
305   getCell: function(bufRow,col) {
306     return bufRow < this.size ? this.rows[bufRow][col] : null;
307   },
308
309   getValue: function(bufRow,col) {
310     return this.getCell(bufRow,col);
311   },
312
313   setValue: function(bufRow,col,newval,newstyle) {
314     if (bufRow>=this.size) return false;
315     if (!this.rows[bufRow][col]) this.rows[bufRow][col]={};
316     this.rows[bufRow][col]=newval;
317     if (typeof newstyle=='string') this.rows[bufRow][col]._style=newstyle;
318     this.rows[bufRow][col].modified=true;
319     return true;
320   },
321
322   getRows: function(start, count) {
323     var begPos = start - this.startPos;
324     var endPos = Math.min(begPos + count,this.size);
325     var results = new Array();
326     for ( var i=begPos; i < endPos; i++ ) {
327       results.push(this.rows[i]);
328     }
329     return results;
330   },
331
332   applyFilters: function() {
333     var newRows=[],re=[];
334     var r,c,n,i,showRow,filtercnt;
335     var cols=this.liveGrid.columns;
336     for (n=0,filtercnt=0; n<cols.length; n++) {
337       c=cols[n];
338       if (c.filterType == Rico.TableColumn.UNFILTERED) continue;
339       filtercnt++;
340       if (c.filterOp=='LIKE') re[n]=new RegExp(c.filterValues[0],'i');
341     }
342     Rico.writeDebugMsg('applyFilters: # of filters='+filtercnt);
343     if (filtercnt==0) {
344       this.rows = this.baseRows;
345     } else {
346       for (r=0; r<this.baseRows.length; r++) {
347         showRow=true;
348         for (n=0; n<cols.length && showRow; n++) {
349           c=cols[n];
350           if (c.filterType == Rico.TableColumn.UNFILTERED) continue;
351           switch (c.filterOp) {
352             case 'LIKE':
353               showRow=re[n].test(this.baseRows[r][n]);
354               break;
355             case 'EQ':
356               showRow=this.baseRows[r][n]==c.filterValues[0];
357               break;
358             case 'NE':
359               for (i=0; i<c.filterValues.length && showRow; i++)
360                 showRow=this.baseRows[r][n]!=c.filterValues[i];
361               break;
362             case 'LE':
363               if (c.format.type=='number')
364                 showRow=this.nan2zero(this.baseRows[r][n])<=this.nan2zero(c.filterValues[0]);
365               else
366                 showRow=this.baseRows[r][n]<=c.filterValues[0];
367               break;
368             case 'GE':
369               if (c.format.type=='number')
370                 showRow=this.nan2zero(this.baseRows[r][n])>=this.nan2zero(c.filterValues[0]);
371               else
372                 showRow=this.baseRows[r][n]>=c.filterValues[0];
373               break;
374             case 'NULL':
375               showRow=this.baseRows[r][n]=='';
376               break;
377             case 'NOTNULL':
378               showRow=this.baseRows[r][n]!='';
379               break;
380           }
381         }
382         if (showRow) newRows.push(this.baseRows[r]);
383       }
384       this.rows = newRows;
385     }
386     this.rowcntContent = this.size = this.rows.length;
387   }
388
389 });
390
391
392 // Rico.LiveGrid -----------------------------------------------------
393
394 Rico.LiveGrid = Class.create(
395 /** 
396  * @lends Rico.LiveGrid#
397  * @property tableId id string for this grid
398  * @property options the options object passed to the constructor extended with defaults
399  * @property buffer the buffer object containing the data for this grid
400  * @property columns array of {@link Rico.TableColumn} objects
401  */
402 {
403 /**
404  * @class Buffered LiveGrid component
405  * @extends Rico.GridCommon
406  * @constructs
407  */
408   initialize: function( tableId, buffer, options ) {
409     Object.extend(this, new Rico.GridCommon);
410     Object.extend(this, new Rico.LiveGridMethods);
411     this.baseInit();
412     this.tableId = tableId;
413     this.buffer = buffer;
414     Rico.setDebugArea(tableId+"_debugmsgs");    // if used, this should be a textarea
415
416     Object.extend(this.options, {
417       visibleRows      : -1,    // -1 or 'window'=size grid to client window; -2 or 'data'=size grid to min(window,data); -3 or 'body'=size so body does not have a scrollbar; -4 or 'parent'=size to parent element (e.g. if grid is inside a div)
418       frozenColumns    : 0,
419       offset           : 0,     // first row to be displayed
420       prefetchBuffer   : true,  // load table on page load?
421       minPageRows      : 2,
422       maxPageRows      : 50,
423       canSortDefault   : true,  // can be overridden in the column specs
424       canFilterDefault : buffer.options.canFilter, // can be overridden in the column specs
425       canHideDefault   : true,  // can be overridden in the column specs
426
427       // highlight & selection parameters
428       highlightElem    : 'none',// what gets highlighted/selected (cursorRow, cursorCell, menuRow, menuCell, selection, or none)
429       highlightSection : 3,     // which section gets highlighted (frozen=1, scrolling=2, all=3, none=0)
430       highlightMethod  : 'class', // outline, class, both (outline is less CPU intensive on the client)
431       highlightClass   : 'ricoLG_selection',
432
433       // export/print parameters
434       maxPrint         : 1000,  // max # of rows that can be printed/exported, 0=disable print/export feature
435
436       // heading parameters
437       headingSort      : 'link', // link: make headings a link that will sort column, hover: make headings a hoverset, none: events on headings are disabled
438       hdrIconsFirst    : true,   // true: put sort & filter icons before header text, false: after
439       sortAscendImg    : 'sort_asc.gif',
440       sortDescendImg   : 'sort_desc.gif',
441       filterImg        : 'filtercol.gif'
442     });
443     // other options:
444     //   sortCol: initial sort column
445
446     this.options.sortHandler = this.sortHandler.bind(this);
447     this.options.filterHandler = this.filterHandler.bind(this);
448     this.options.onRefreshComplete = this.bookmarkHandler.bind(this);
449     this.options.rowOverHandler = this.rowMouseOver.bindAsEventListener(this);
450     this.options.mouseDownHandler = this.selectMouseDown.bindAsEventListener(this);
451     this.options.mouseOverHandler = this.selectMouseOver.bindAsEventListener(this);
452     this.options.mouseUpHandler  = this.selectMouseUp.bindAsEventListener(this);
453     Object.extend(this.options, options || {});
454
455     switch (typeof this.options.visibleRows) {
456       case 'string':
457         this.sizeTo=this.options.visibleRows;
458         switch (this.options.visibleRows) {
459           case 'data':   this.options.visibleRows=-2; break;
460           case 'body':   this.options.visibleRows=-3; break;
461           case 'parent': this.options.visibleRows=-4; break;
462           default:       this.options.visibleRows=-1; break;
463         }
464         break;
465       case 'number':
466         switch (this.options.visibleRows) {
467           case -1: this.sizeTo='window'; break;
468           case -2: this.sizeTo='data'; break;
469           case -3: this.sizeTo='body'; break;
470           case -4: this.sizeTo='parent'; break;
471           default: this.sizeTo='fixed'; break;
472         }
473         break;
474       default:
475         this.sizeTo='window';
476         this.options.visibleRows=-1;
477         break;
478     }
479     this.highlightEnabled=this.options.highlightSection>0;
480     this.pageSize=0;
481     this.createTables();
482     if (this.headerColCnt==0) {
483       alert('ERROR: no columns found in "'+this.tableId+'"');
484       return;
485     }
486     this.createColumnArray('TableColumn');
487     if (this.options.headingSort=='hover')
488       this.createHoverSet();
489
490     this.bookmark=$(this.tableId+"_bookmark");
491     this.sizeDivs();
492     var filterUIrow=this.buffer.options.canFilter ? this.options.FilterLocation : false;
493     if (typeof(filterUIrow)=='number' && filterUIrow<0)
494       filterUIrow=this.addHeadingRow();
495     this.createDataCells(this.options.visibleRows);
496     if (this.pageSize == 0) return;
497     this.buffer.registerGrid(this);
498     if (this.buffer.setBufferSize) this.buffer.setBufferSize(this.pageSize);
499     this.scrollTimeout = null;
500     this.lastScrollPos = 0;
501     this.attachMenuEvents();
502
503     // preload the images...
504     new Image().src = Rico.imgDir+this.options.filterImg;
505     new Image().src = Rico.imgDir+this.options.sortAscendImg;
506     new Image().src = Rico.imgDir+this.options.sortDescendImg;
507     Rico.writeDebugMsg("images preloaded");
508
509     this.setSortUI( this.options.sortCol, this.options.sortDir );
510     this.setImages();
511     if (this.listInvisible().length==this.columns.length)
512       this.columns[0].showColumn();
513     this.sizeDivs();
514     this.scrollDiv.style.display="";
515     if (this.buffer.totalRows>0)
516       this.updateHeightDiv();
517     if (this.options.prefetchBuffer) {
518       if (this.bookmark) this.bookmark.innerHTML = RicoTranslate.getPhraseById('bookmarkLoading');
519       if (this.options.canFilterDefault && this.options.getQueryParms)
520         this.checkForFilterParms();
521       this.buffer.fetch(this.options.offset);
522     }
523     if (typeof(filterUIrow)=='number')
524       this.createFilters(filterUIrow);
525     this.scrollEventFunc=this.handleScroll.bindAsEventListener(this);
526     this.wheelEventFunc=this.handleWheel.bindAsEventListener(this);
527     this.wheelEvent=(Prototype.Browser.IE || Prototype.Browser.Opera || Prototype.Browser.WebKit) ? 'mousewheel' : 'DOMMouseScroll';
528     if (this.options.offset && this.options.offset < this.buffer.totalRows)
529       setTimeout(this.scrollToRow.bind(this,this.options.offset),50);  // Safari requires a delay
530     this.pluginScroll();
531     this.setHorizontalScroll();
532     if (this.options.windowResize)
533       setTimeout(this.pluginWindowResize.bind(this),100);
534   }
535 });
536
537 Rico.LiveGridMethods = function() {};
538
539 Rico.LiveGridMethods.prototype = {
540 /** @lends Rico.LiveGrid# */
541
542   createHoverSet: function() {
543     var hdrs=[];
544     for( var c=0; c < this.headerColCnt; c++ ) {
545       if (this.columns[c].sortable) {
546         hdrs.push(this.columns[c].hdrCellDiv);
547       }
548     }
549     this.hoverSet = new Rico.HoverSet(hdrs);
550   },
551
552   checkForFilterParms: function() {
553     var s=window.location.search;
554     if (s.charAt(0)=='?') s=s.substring(1);
555     var pairs = s.split('&');
556     for (var i=0; i<pairs.length; i++) {
557       if (pairs[i].match(/^f\[\d+\]/)) {
558         this.buffer.options.requestParameters.push(pairs[i]);
559       }
560     }
561   },
562
563 /**
564  * set filter on a detail grid that is in a master-detail relationship
565  */
566   setDetailFilter: function(colNumber,filterValue) {
567     var c=this.columns[colNumber];
568     c.format.ColData=filterValue;
569     c.setSystemFilter('EQ',filterValue);
570   },
571
572 /**
573  * Create one table for frozen columns and one for scrolling columns.
574  * Also create div's to contain them.
575  * @returns true on success
576  */
577   createTables: function() {
578     var insertloc,hdrSrc,i;
579     var table = $(this.tableId) || $(this.tableId+'_outerDiv');
580     if (!table) return false;
581     if (table.tagName.toLowerCase()=='table') {
582       var theads=table.getElementsByTagName("thead");
583       if (theads.length == 1) {
584         Rico.writeDebugMsg("createTables: using thead section, id="+this.tableId);
585         if (this.options.PanelNamesOnTabHdr && this.options.panels) {
586           var r=theads[0].insertRow(0);
587           this.insertPanelNames(r, 0, this.options.frozenColumns, 'ricoFrozen');
588           this.insertPanelNames(r, this.options.frozenColumns, this.options.columnSpecs.length);
589         }
590         hdrSrc=theads[0].rows;
591       } else {
592         Rico.writeDebugMsg("createTables: using tbody section, id="+this.tableId);
593         hdrSrc=new Array(table.rows[0]);
594       }
595       insertloc=table;
596     } else if (this.options.columnSpecs.length > 0) {
597       if (!table.id.match(/_outerDiv$/)) insertloc=table;
598       Rico.writeDebugMsg("createTables: inserting at "+table.tagName+", id="+this.tableId);
599     } else {
600       alert("ERROR!\n\nUnable to initialize '"+this.tableId+"'\n\nLiveGrid terminated");
601       return false;
602     }
603
604     this.createDivs();
605     this.scrollTabs = this.createDiv("scrollTabs",this.innerDiv);
606     this.shadowDiv  = this.createDiv("shadow",this.scrollDiv);
607     this.shadowDiv.style.direction='ltr';  // avoid FF bug
608     this.scrollDiv.style.display="none";
609     this.scrollDiv.scrollTop=0;
610     if (this.options.highlightMethod!='class') {
611       this.highlightDiv=[];
612       switch (this.options.highlightElem) {
613         case 'menuRow':
614         case 'cursorRow':
615           this.highlightDiv[0] = this.createDiv("highlight",this.outerDiv);
616           this.highlightDiv[0].style.display="none";
617           break;
618         case 'menuCell':
619         case 'cursorCell':
620           for (i=0; i<2; i++) {
621             this.highlightDiv[i] = this.createDiv("highlight",i==0 ? this.frozenTabs : this.scrollTabs);
622             this.highlightDiv[i].style.display="none";
623             this.highlightDiv[i].id+=i;
624           }
625           break;
626         case 'selection':
627           // create one div for each side of the rectangle
628           var parentDiv=this.options.highlightSection==1 ? this.frozenTabs : this.scrollTabs;
629           for (i=0; i<4; i++) {
630             this.highlightDiv[i] = this.createDiv("highlight",parentDiv);
631             this.highlightDiv[i].style.display="none";
632             this.highlightDiv[i].style.overflow="hidden";
633             this.highlightDiv[i].id+=i;
634             this.highlightDiv[i].style[i % 2==0 ? 'height' : 'width']="0px";
635           }
636           break;
637       }
638     }
639
640     // create new tables
641     for (i=0; i<2; i++) {
642       this.tabs[i] = document.createElement("table");
643       this.tabs[i].className = 'ricoLG_table';
644       this.tabs[i].border=0;
645       this.tabs[i].cellPadding=0;
646       this.tabs[i].cellSpacing=0;
647       this.tabs[i].id = this.tableId+"_tab"+i;
648       this.thead[i]=this.tabs[i].createTHead();
649       this.thead[i].className='ricoLG_top';
650       if (this.tabs[i].tBodies.length==0)
651         this.tbody[i]=this.tabs[i].appendChild(document.createElement("tbody"));
652       else
653         this.tbody[i]=this.tabs[i].tBodies[0];
654       this.tbody[i].className='ricoLG_bottom';
655       this.tbody[i].insertRow(-1);
656     }
657     this.frozenTabs.appendChild(this.tabs[0]);
658     this.scrollTabs.appendChild(this.tabs[1]);
659     if (insertloc) insertloc.parentNode.insertBefore(this.outerDiv,insertloc);
660     if (hdrSrc) {
661       this.headerColCnt = this.getColumnInfo(hdrSrc);
662       this.loadHdrSrc(hdrSrc);
663     } else {
664       this.createHdr(0,0,this.options.frozenColumns);
665       this.createHdr(1,this.options.frozenColumns,this.options.columnSpecs.length);
666       if (this.options.PanelNamesOnTabHdr && this.options.panels) {
667         this.insertPanelNames(this.thead[0].insertRow(0), 0, this.options.frozenColumns);
668         this.insertPanelNames(this.thead[1].insertRow(0), this.options.frozenColumns, this.options.columnSpecs.length);
669       }
670       for (i=0; i<2; i++)
671         this.headerColCnt = this.getColumnInfo(this.thead[i].rows);
672     }
673     for( var c=0; c < this.headerColCnt; c++ )
674       this.tbody[c<this.options.frozenColumns ? 0 : 1].rows[0].insertCell(-1);
675     if (insertloc) table.parentNode.removeChild(table);
676     Rico.writeDebugMsg('createTables end');
677     return true;
678   },
679
680   createDataCells: function(visibleRows) {
681     if (visibleRows < 0) {
682       for (var i=0; i<this.options.minPageRows; i++)
683         this.appendBlankRow();
684       this.sizeDivs();
685       this.autoAppendRows(this.remainingHt());
686     } else {
687       for( var r=0; r < visibleRows; r++ )
688         this.appendBlankRow();
689     }
690     var s=this.options.highlightSection;
691     if (s & 1) this.attachHighlightEvents(this.tbody[0]);
692     if (s & 2) this.attachHighlightEvents(this.tbody[1]);
693   },
694
695 /**
696  * @param colnum column number
697  * @return id string for a filter element
698  */
699   filterId: function(colnum) {
700     return 'RicoFilter_'+this.tableId+'_'+colnum;
701   },
702
703 /**
704  * Create filter elements in heading
705  * Reads this.columns[].filterUI to determine type of filter element for each column (t=text box, s=select list, c=custom)
706  * @param r heading row where filter elements will be placed
707  */
708   createFilters: function(r) {
709     for( var c=0; c < this.headerColCnt; c++ ) {
710       var col=this.columns[c];
711       var fmt=col.format;
712       if (typeof fmt.filterUI!='string') continue;
713       var cell=this.hdrCells[r][c].cell;
714       var field,name=this.filterId(c);
715       var divs=cell.getElementsByTagName('div');
716       // copy text alignment from data cell
717       var align=Element.getStyle(this.cell(0,c),'textAlign');
718       Element.setStyle(divs[1], { textAlign: align });
719       switch (fmt.filterUI.charAt(0)) {
720         case 't':
721           // text field
722           field=RicoUtil.createFormField(divs[1],'input','text',name,name);
723           var size=fmt.filterUI.match(/\d+/);
724           field.maxLength=fmt.Length || 50;
725           field.size=size ? parseInt(size,10) : 10;
726           var clrimg = document.createElement('img');
727           clrimg.style.paddingLeft='4px';
728           clrimg.style.cursor='pointer';
729           clrimg.align='top';
730           clrimg.src=Rico.imgDir+'delete.gif';
731           clrimg.alt=RicoTranslate.getPhraseById('clear');
732           divs[1].appendChild(clrimg);
733           Event.observe(clrimg,'click',col.filterClear.bindAsEventListener(col,field),false);
734           if (col.filterType==Rico.TableColumn.USERFILTER && col.filterOp=='LIKE') {
735             var v=col.filterValues[0];
736             if (v.charAt(0)=='*') v=v.substr(1);
737             if (v.slice(-1)=='*') v=v.slice(0,-1);
738             field.value=v;
739             col.lastKeyFilter=v;
740           }
741           Event.observe(field,'keyup',col.filterKeypress.bindAsEventListener(col),false);
742           break;
743         case 's':
744           // drop-down select
745           field=RicoUtil.createFormField(divs[1],'select',null,name);
746           RicoUtil.addSelectOption(field,this.options.FilterAllToken,RicoTranslate.getPhraseById("filterAll"));
747           var options={};
748           Object.extend(options, this.buffer.ajaxOptions);
749           var colnum=typeof(fmt.filterCol)=='number' ? fmt.filterCol : c;
750           options.parameters = 'id='+this.tableId+'&distinct='+colnum;
751           options.onComplete = this.filterValuesUpdate.bind(this,c);
752           new Ajax.Request(this.buffer.dataSource, options);
753           break;
754         case 'c':
755           // custom
756           if (typeof col._createFilters == 'function')
757             col._createFilters(divs[1], name);
758           break;
759       }
760     }
761     this.initFilterImage(r);
762   },
763
764 /**
765  * update select list filter with values in AJAX response
766  * @returns true on success
767  */
768   filterValuesUpdate: function(colnum,request) {
769     var response = request.responseXML.getElementsByTagName("ajax-response");
770     Rico.writeDebugMsg("filterValuesUpdate: "+request.status);
771     if (response == null || response.length != 1) return false;
772     response=response[0];
773     var error = response.getElementsByTagName('error');
774     if (error.length > 0) {
775       Rico.writeDebugMsg("Data provider returned an error:\n"+RicoUtil.getContentAsString(error[0],this.buffer.isEncoded));
776       alert(RicoTranslate.getPhraseById("requestError",RicoUtil.getContentAsString(error[0],this.buffer.isEncoded)));
777       return false;
778     }
779     response=response.getElementsByTagName('response')[0];
780     var rowsElement = response.getElementsByTagName('rows')[0];
781     //var colnum = rowsElement.getAttribute("distinct");
782     var col=this.columns[parseInt(colnum,10)];
783     var rows = this.buffer.dom2jstable(rowsElement);
784     var c0,c1,opt,v, field=$(this.filterId(colnum));
785     if (col.filterType==Rico.TableColumn.USERFILTER && col.filterOp=='EQ') v=col.filterValues[0];
786     Rico.writeDebugMsg('filterValuesUpdate: col='+colnum+' rows='+rows.length);
787     for (var i=0; i<rows.length; i++) {
788       if (rows[i].length>0) {
789         c0=c1=rows[i][0];
790         if (c0.match(/<span\s+class=(['"]?)ricolookup\1>(.*)<\/span>/i)) {
791           c1=RegExp.leftContext;
792         }
793         if (col._getdesc) c1 = col._getdesc(c1);
794         opt=RicoUtil.addSelectOption(field,c0,c1 || RicoTranslate.getPhraseById("filterBlank"));
795         if (col.filterType==Rico.TableColumn.USERFILTER && c0==v) opt.selected=true;
796       }
797     }
798     Event.observe(field,'change',col.filterChange.bindAsEventListener(col),false);
799     return true;
800   },
801
802   unplugHighlightEvents: function() {
803     var s=this.options.highlightSection;
804     if (s & 1) this.detachHighlightEvents(this.tbody[0]);
805     if (s & 2) this.detachHighlightEvents(this.tbody[1]);
806   },
807
808 /**
809  * place panel names on first row of grid header (used by LiveGridForms)
810  */
811   insertPanelNames: function(r,start,limit,cellClass) {
812     Rico.writeDebugMsg('insertPanelNames: start='+start+' limit='+limit);
813     r.className='ricoLG_hdg';
814     var lastIdx=-1, span, newCell=null, spanIdx=0;
815     for( var c=start; c < limit; c++ ) {
816       if (lastIdx == this.options.columnSpecs[c].panelIdx) {
817         span++;
818       } else {
819         if (newCell) newCell.colSpan=span;
820         newCell = r.insertCell(-1);
821         if (cellClass) newCell.className=cellClass;
822         span=1;
823         lastIdx=this.options.columnSpecs[c].panelIdx;
824         newCell.innerHTML=this.options.panels[lastIdx];
825       }
826     }
827     if (newCell) newCell.colSpan=span;
828   },
829
830 /**
831  * create grid header for table i (if none was provided)
832  */
833   createHdr: function(i,start,limit) {
834     Rico.writeDebugMsg('createHdr: i='+i+' start='+start+' limit='+limit);
835     var mainRow = this.thead[i].insertRow(-1);
836     mainRow.id=this.tableId+'_tab'+i+'h_main';
837     mainRow.className='ricoLG_hdg';
838     for( var c=start; c < limit; c++ ) {
839       var newCell = mainRow.insertCell(-1);
840       newCell.innerHTML=this.options.columnSpecs[c].Hdg;
841     }
842   },
843
844 /**
845  * move header cells in original table to grid
846  */
847   loadHdrSrc: function(hdrSrc) {
848     var i,h,c,r,newrow,cells;
849     Rico.writeDebugMsg('loadHdrSrc start');
850     for (i=0; i<2; i++) {
851       for (r=0; r<hdrSrc.length; r++) {
852         newrow = this.thead[i].insertRow(-1);
853         newrow.className='ricoLG_hdg '+this.tableId+'_hdg'+r;
854       }
855     }
856     if (hdrSrc.length==1) {
857       cells=hdrSrc[0].cells;
858       for (c=0; cells.length > 0; c++)
859         this.thead[c<this.options.frozenColumns ? 0 : 1].rows[0].appendChild(cells[0]);
860     } else {
861       for (r=0; r<hdrSrc.length; r++) {
862         cells=hdrSrc[r].cells;
863         for (c=0,h=0; cells.length > 0; c++) {
864           if (cells[0].className=='ricoFrozen') {
865             if (r==this.headerRowIdx) this.options.frozenColumns=c+1;
866           } else {
867             h=1;
868           }
869           this.thead[h].rows[r].appendChild(cells[0]);
870         }
871       }
872     }
873     Rico.writeDebugMsg('loadHdrSrc end');
874   },
875
876 /**
877  * Size div elements
878  */
879   sizeDivs: function() {
880     Rico.writeDebugMsg('sizeDivs: '+this.tableId);
881     //this.cancelMenu();
882     this.unhighlight();
883     this.baseSizeDivs();
884     var firstVisible=this.firstVisible();
885     if (this.pageSize == 0 || firstVisible < 0) return;
886     var totRowHt=this.columns[firstVisible].dataColDiv.offsetHeight;
887     this.rowHeight = Math.round(totRowHt/this.pageSize);
888     var scrHt=this.dataHt;
889     if (this.scrWi>0 || Prototype.Browser.IE || Prototype.Browser.WebKit)
890       scrHt+=this.options.scrollBarWidth;
891     this.scrollDiv.style.height=scrHt+'px';
892     this.innerDiv.style.width=(this.scrWi-this.options.scrollBarWidth+1)+'px';
893     this.resizeDiv.style.height=this.frozenTabs.style.height=this.innerDiv.style.height=(this.hdrHt+this.dataHt+1)+'px';
894     Rico.writeDebugMsg('sizeDivs scrHt='+scrHt+' innerHt='+this.innerDiv.style.height+' rowHt='+this.rowHeight+' pageSize='+this.pageSize);
895     var pad=(this.scrWi-this.scrTabWi < this.options.scrollBarWidth) ? 2 : 0;
896     this.shadowDiv.style.width=(this.scrTabWi+pad)+'px';
897     this.outerDiv.style.height=(this.hdrHt+scrHt)+'px';
898     this.setHorizontalScroll();
899   },
900
901   setHorizontalScroll: function() {
902     var scrleft=this.scrollDiv.scrollLeft;
903     this.scrollTabs.style.left=(-scrleft)+'px';
904   },
905
906   remainingHt: function() {
907     var tabHt;
908     var winHt=RicoUtil.windowHeight();
909     var margin=Prototype.Browser.IE ? 15 : 10;
910     // if there is a horizontal scrollbar take it into account
911     if (!Prototype.Browser.IE && window.frameElement && window.frameElement.scrolling=='yes' && this.sizeTo!='parent') margin+=this.options.scrollBarWidth;
912     switch (this.sizeTo) {
913       case 'window':
914       case 'data':
915         var divPos=Position.page(this.outerDiv);
916         tabHt=Math.max(this.tabs[0].offsetHeight,this.tabs[1].offsetHeight);
917         Rico.writeDebugMsg("remainingHt, winHt="+winHt+' tabHt='+tabHt+' gridY='+divPos[1]);
918         return winHt-divPos[1]-tabHt-this.options.scrollBarWidth-margin;  // allow for scrollbar and some margin
919       case 'parent':
920         var offset=this.offsetFromParent(this.outerDiv);
921         tabHt=Math.max(this.tabs[0].offsetHeight,this.tabs[1].offsetHeight);
922         if (Prototype.Browser.IE) Element.hide(this.outerDiv);
923         var parentHt=this.outerDiv.parentNode.offsetHeight;
924         if (Prototype.Browser.IE) Element.show(this.outerDiv);
925         Rico.writeDebugMsg("remainingHt, parentHt="+parentHt+' gridY='+offset+' winHt='+winHt+' tabHt='+tabHt);
926         return parentHt - tabHt - offset - this.options.scrollBarWidth;
927       case 'body':
928         //Rico.writeDebugMsg("remainingHt, document.height="+document.height);
929         //Rico.writeDebugMsg("remainingHt, body.offsetHeight="+document.body.offsetHeight);
930         //Rico.writeDebugMsg("remainingHt, body.scrollHeight="+document.body.scrollHeight);
931         //Rico.writeDebugMsg("remainingHt, documentElement.scrollHeight="+document.documentElement.scrollHeight);
932         var bodyHt=Prototype.Browser.IE ? document.body.scrollHeight : document.body.offsetHeight;
933         var remHt=winHt-bodyHt-margin;
934         if (!Prototype.Browser.WebKit) remHt-=this.options.scrollBarWidth;
935         Rico.writeDebugMsg("remainingHt, winHt="+winHt+' pageHt='+bodyHt+' remHt='+remHt);
936         return remHt;
937       default:
938         tabHt=Math.max(this.tabs[0].offsetHeight,this.tabs[1].offsetHeight);
939         Rico.writeDebugMsg("remainingHt, winHt="+winHt+' tabHt='+tabHt);
940         if (this.sizeTo.slice(-1)=='%') winHt*=parseFloat(this.sizeTo)/100.0;
941         else if (this.sizeTo.slice(-2)=='px') winHt=parseInt(this.sizeTo,10);
942         return winHt-tabHt-this.options.scrollBarWidth-margin;  // allow for scrollbar and some margin
943     }
944   },
945
946   offsetFromParent: function(element) {
947     var valueT = 0;
948     var elParent=element.parentNode;
949     do {
950       //Rico.writeDebugMsg("offsetFromParent: "+element.tagName+' id='+element.id+' otop='+element.offsetTop);
951       valueT += element.offsetTop  || 0;
952       element = element.offsetParent;
953       if (!element || element==null) break;
954       var p = Element.getStyle(element, 'position');
955       if (element.tagName=='BODY' || element.tagName=='HTML' || p=='absolute') return valueT-elParent.offsetTop;
956     } while (element != elParent);
957     return valueT;
958   },
959
960   adjustPageSize: function() {
961     var remHt=this.remainingHt();
962     Rico.writeDebugMsg('adjustPageSize remHt='+remHt+' lastRow='+this.lastRowPos);
963     if (remHt > this.rowHeight)
964       this.autoAppendRows(remHt);
965     else if (remHt < 0 || this.sizeTo=='data')
966       this.autoRemoveRows(-remHt);
967   },
968
969   pluginWindowResize: function() {
970     this.resizeWindowHandler=this.resizeWindow.bindAsEventListener(this);
971     Event.observe(window, "resize", this.resizeWindowHandler, false);
972   },
973
974   unplugWindowResize: function() {
975     if (!this.resizeWindowHandler) return;
976     Event.stopObserving(window,"resize", this.resizeWindowHandler, false);
977     this.resizeWindowHandler=null;
978   },
979
980   resizeWindow: function() {
981     Rico.writeDebugMsg('resizeWindow '+this.tableId+' lastRow='+this.lastRowPos);
982     if (this.resizeState=='finish') {
983       Rico.writeDebugMsg('resizeWindow postponed');
984       this.resizeState='resize';
985       return;
986     }
987     if (!this.sizeTo || this.sizeTo=='fixed') {
988       this.sizeDivs();
989       return;
990     }
991     if (this.sizeTo=='parent' && Element.getStyle(this.outerDiv.parentNode,'display') == 'none') return;
992     var oldSize=this.pageSize;
993     this.adjustPageSize();
994     if (this.pageSize > oldSize && this.buffer.totalRows>0) {
995       this.isPartialBlank=true;
996       var adjStart=this.adjustRow(this.lastRowPos);
997       this.buffer.fetch(adjStart);
998     } else if (this.pageSize < oldSize) {
999       if (this.options.onRefreshComplete) this.options.onRefreshComplete(this.contentStartPos,this.contentStartPos+this.pageSize-1);  // update bookmark
1000     }
1001     this.resizeState='finish';
1002     setTimeout(this.finishResize.bind(this),20);
1003     Rico.writeDebugMsg('resizeWindow '+this.tableId+' complete. old size='+oldSize+' new size='+this.pageSize);
1004   },
1005
1006   finishResize: function() {
1007     this.sizeDivs();
1008     this.updateHeightDiv();
1009     if (this.resizeState=='resize') {
1010       this.resizeWindow();
1011     } else {
1012       this.resizeState='';
1013     }
1014   },
1015
1016   topOfLastPage: function() {
1017     return Math.max(this.buffer.totalRows-this.pageSize,0);
1018   },
1019
1020   updateHeightDiv: function() {
1021     var notdisp=this.topOfLastPage();
1022     var ht = this.scrollDiv.clientHeight + this.rowHeight * notdisp;
1023     Rico.writeDebugMsg("updateHeightDiv, ht="+ht+' scrollDiv.clientHeight='+this.scrollDiv.clientHeight+' rowsNotDisplayed='+notdisp);
1024     this.shadowDiv.style.height=ht+'px';
1025   },
1026
1027   autoRemoveRows: function(overage) {
1028     if (!this.rowHeight) return;
1029     var removeCnt=Math.ceil(overage / this.rowHeight);
1030     if (this.sizeTo=='data')
1031       removeCnt=Math.max(removeCnt,this.pageSize-this.buffer.totalRows);
1032     Rico.writeDebugMsg("autoRemoveRows overage="+overage+" removeCnt="+removeCnt);
1033     for (var i=0; i<removeCnt; i++)
1034       this.removeRow();
1035   },
1036
1037   removeRow: function() {
1038     if (this.pageSize <= this.options.minPageRows) return;
1039     this.pageSize--;
1040     for( var c=0; c < this.headerColCnt; c++ ) {
1041       var cell=this.columns[c].cell(this.pageSize);
1042       this.columns[c].dataColDiv.removeChild(cell);
1043     }
1044   },
1045
1046   autoAppendRows: function(overage) {
1047     if (!this.rowHeight) return;
1048     var addCnt=Math.floor(overage / this.rowHeight);
1049     Rico.writeDebugMsg("autoAppendRows overage="+overage+" cnt="+addCnt+" rowHt="+this.rowHeight);
1050     for (var i=0; i<addCnt; i++) {
1051       if (this.sizeTo=='data' && this.pageSize>=this.buffer.totalRows) break;
1052       this.appendBlankRow();
1053     }
1054   },
1055
1056 /**
1057  * on older systems, this can be fairly slow
1058  */
1059   appendBlankRow: function() {
1060     if (this.pageSize >= this.options.maxPageRows) return;
1061     Rico.writeDebugMsg("appendBlankRow #"+this.pageSize);
1062     var cls=this.defaultRowClass(this.pageSize);
1063     for( var c=0; c < this.headerColCnt; c++ ) {
1064       var newdiv = document.createElement("div");
1065       newdiv.className = 'ricoLG_cell '+cls;
1066       newdiv.id=this.tableId+'_'+this.pageSize+'_'+c;
1067       this.columns[c].dataColDiv.appendChild(newdiv);
1068       newdiv.innerHTML='&nbsp;';
1069       if (this.columns[c].format.canDrag && dndMgr)
1070         dndMgr.registerDraggable( new Rico.LiveGridDraggable(this, this.pageSize, c) );
1071       if (this.columns[c]._create)
1072         this.columns[c]._create(newdiv,this.pageSize);
1073     }
1074     this.pageSize++;
1075   },
1076
1077   defaultRowClass: function(rownum) {
1078     return (rownum % 2==0) ? 'ricoLG_evenRow' : 'ricoLG_oddRow';
1079   },
1080
1081   handleMenuClick: function(e) {
1082     if (!this.menu) return;
1083     this.cancelMenu();
1084     this.unhighlight(); // in case highlighting was invoked externally
1085     var idx;
1086     var cell=Event.element(e);
1087     if (cell.className=='ricoLG_highlightDiv') {
1088       idx=this.highlightIdx;
1089     } else {
1090       cell=RicoUtil.getParentByTagName(cell,'div','ricoLG_cell');
1091       if (!cell) return;
1092       idx=this.winCellIndex(cell);
1093       if ((this.options.highlightSection & (idx.tabIdx+1))==0) return;
1094     }
1095     this.highlight(idx);
1096     this.highlightEnabled=false;
1097     if (this.hideScroll) this.scrollDiv.style.overflow="hidden";
1098     this.menuIdx=idx;
1099     if (!this.menu.div) this.menu.createDiv();
1100     this.menu.liveGrid=this;
1101     if (this.menu.buildGridMenu) {
1102       var showMenu=this.menu.buildGridMenu(idx.row, idx.column, idx.tabIdx);
1103       if (!showMenu) return;
1104     }
1105     if (this.options.highlightElem=='selection' && !this.isSelected(idx.cell)) {
1106       this.selectCell(idx.cell);
1107     }
1108     this.menu.showmenu(e,this.closeMenu.bind(this));
1109   },
1110
1111   closeMenu: function() {
1112     if (!this.menuIdx) return;
1113     if (this.hideScroll) this.scrollDiv.style.overflow="";
1114     this.unhighlight();
1115     this.highlightEnabled=true;
1116     this.menuIdx=null;
1117   },
1118
1119 /**
1120  * @return index of cell within the window
1121  */
1122   winCellIndex: function(cell) {
1123     var a=cell.id.split(/_/);
1124     var l=a.length;
1125     var r=parseInt(a[l-2],10);
1126     var c=parseInt(a[l-1],10);
1127     return {row:r, column:c, tabIdx:this.columns[c].tabIdx, cell:cell};
1128   },
1129
1130 /**
1131  * @return index of cell within the dataset
1132  */
1133   datasetIndex: function(cell) {
1134     var idx=this.winCellIndex(cell);
1135     idx.row+=this.buffer.windowPos;
1136     idx.onBlankRow=(idx.row >= this.buffer.endPos());
1137     return idx;
1138   },
1139
1140   attachHighlightEvents: function(tBody) {
1141     switch (this.options.highlightElem) {
1142       case 'selection':
1143         Event.observe(tBody,"mousedown", this.options.mouseDownHandler, false);
1144         /** @ignore */
1145         tBody.ondrag = function () { return false; };
1146         /** @ignore */
1147         tBody.onselectstart = function () { return false; };
1148         break;
1149       case 'cursorRow':
1150       case 'cursorCell':
1151         Event.observe(tBody,"mouseover", this.options.rowOverHandler, false);
1152         break;
1153     }
1154   },
1155
1156   detachHighlightEvents: function(tBody) {
1157     switch (this.options.highlightElem) {
1158       case 'selection':
1159         Event.stopObserving(tBody,"mousedown", this.options.mouseDownHandler, false);
1160         tBody.ondrag = null;
1161         tBody.onselectstart = null;
1162         break;
1163       case 'cursorRow':
1164       case 'cursorCell':
1165         Event.stopObserving(tBody,"mouseover", this.options.rowOverHandler, false);
1166         break;
1167     }
1168   },
1169
1170 /**
1171  * @return array of objects containing row/col indexes (index values are relative to the start of the window)
1172  */
1173   getVisibleSelection: function() {
1174     var cellList=[];
1175     if (this.SelectIdxStart && this.SelectIdxEnd) {
1176       var r1=Math.max(Math.min(this.SelectIdxEnd.row,this.SelectIdxStart.row)-this.buffer.startPos,this.buffer.windowStart);
1177       var r2=Math.min(Math.max(this.SelectIdxEnd.row,this.SelectIdxStart.row)-this.buffer.startPos,this.buffer.windowEnd-1);
1178       var c1=Math.min(this.SelectIdxEnd.column,this.SelectIdxStart.column);
1179       var c2=Math.max(this.SelectIdxEnd.column,this.SelectIdxStart.column);
1180       //Rico.writeDebugMsg("getVisibleSelection "+r1+','+c1+' to '+r2+','+c2+' ('+this.SelectIdxStart.row+',startPos='+this.buffer.startPos+',windowPos='+this.buffer.windowPos+',windowEnd='+this.buffer.windowEnd+')');
1181       for (var r=r1; r<=r2; r++) {
1182         for (var c=c1; c<=c2; c++)
1183           cellList.push({row:r-this.buffer.windowStart,column:c});
1184       }
1185     }
1186     if (this.SelectCtrl) {
1187       for (var i=0; i<this.SelectCtrl.length; i++) {
1188         if (this.SelectCtrl[i].row>=this.buffer.windowStart && this.SelectCtrl[i].row<this.buffer.windowEnd)
1189           cellList.push({row:this.SelectCtrl[i].row-this.buffer.windowStart,column:this.SelectCtrl[i].column});
1190       }
1191     }
1192     return cellList;
1193   },
1194
1195   updateSelectOutline: function() {
1196     if (!this.SelectIdxStart || !this.SelectIdxEnd) return;
1197     var r1=Math.max(Math.min(this.SelectIdxEnd.row,this.SelectIdxStart.row), this.buffer.windowStart);
1198     var r2=Math.min(Math.max(this.SelectIdxEnd.row,this.SelectIdxStart.row), this.buffer.windowEnd-1);
1199     if (r1 > r2) {
1200       this.HideSelection();
1201       return;
1202     }
1203     var c1=Math.min(this.SelectIdxEnd.column,this.SelectIdxStart.column);
1204     var c2=Math.max(this.SelectIdxEnd.column,this.SelectIdxStart.column);
1205     var top1=this.columns[c1].cell(r1-this.buffer.windowStart).offsetTop;
1206     var cell2=this.columns[c1].cell(r2-this.buffer.windowStart);
1207     var bottom2=cell2.offsetTop+cell2.offsetHeight;
1208     var left1=this.columns[c1].dataCell.offsetLeft;
1209     var left2=this.columns[c2].dataCell.offsetLeft;
1210     var right2=left2+this.columns[c2].dataCell.offsetWidth;
1211     //window.status='updateSelectOutline: '+r1+' '+r2+' top='+top1+' bot='+bottom2;
1212     this.highlightDiv[0].style.top=this.highlightDiv[3].style.top=this.highlightDiv[1].style.top=(this.hdrHt+top1-1) + 'px';
1213     this.highlightDiv[2].style.top=(this.hdrHt+bottom2-1)+'px';
1214     this.highlightDiv[3].style.left=(left1-2)+'px';
1215     this.highlightDiv[0].style.left=this.highlightDiv[2].style.left=(left1-1)+'px';
1216     this.highlightDiv[1].style.left=(right2-1)+'px';
1217     this.highlightDiv[0].style.width=this.highlightDiv[2].style.width=(right2-left1-1) + 'px';
1218     this.highlightDiv[1].style.height=this.highlightDiv[3].style.height=(bottom2-top1) + 'px';
1219     //this.highlightDiv[0].style.right=this.highlightDiv[2].style.right=this.highlightDiv[1].style.right=()+'px';
1220     //this.highlightDiv[2].style.bottom=this.highlightDiv[3].style.bottom=this.highlightDiv[1].style.bottom=(this.hdrHt+bottom2) + 'px';
1221     for (var i=0; i<4; i++)
1222       this.highlightDiv[i].style.display='';
1223   },
1224
1225   HideSelection: function() {
1226     var i;
1227     if (this.options.highlightMethod!='class') {
1228       for (i=0; i<this.highlightDiv.length; i++)
1229         this.highlightDiv[i].style.display='none';
1230     }
1231     if (this.options.highlightMethod!='outline') {
1232       var cellList=this.getVisibleSelection();
1233       Rico.writeDebugMsg("HideSelection "+cellList.length);
1234       for (i=0; i<cellList.length; i++)
1235         this.unhighlightCell(this.columns[cellList[i].column].cell(cellList[i].row));
1236     }
1237   },
1238
1239   ShowSelection: function() {
1240     if (this.options.highlightMethod!='class')
1241       this.updateSelectOutline();
1242     if (this.options.highlightMethod!='outline') {
1243       var cellList=this.getVisibleSelection();
1244       for (var i=0; i<cellList.length; i++)
1245         this.highlightCell(this.columns[cellList[i].column].cell(cellList[i].row));
1246     }
1247   },
1248
1249   ClearSelection: function() {
1250     Rico.writeDebugMsg("ClearSelection");
1251     this.HideSelection();
1252     this.SelectIdxStart=null;
1253     this.SelectIdxEnd=null;
1254     this.SelectCtrl=[];
1255   },
1256
1257   selectCell: function(cell) {
1258     this.ClearSelection();
1259     this.SelectIdxStart=this.SelectIdxEnd=this.datasetIndex(cell);
1260     this.ShowSelection();
1261   },
1262
1263   AdjustSelection: function(cell) {
1264     var newIdx=this.datasetIndex(cell);
1265     if (this.SelectIdxStart.tabIdx != newIdx.tabIdx) return;
1266     this.HideSelection();
1267     this.SelectIdxEnd=newIdx;
1268     this.ShowSelection();
1269   },
1270
1271   RefreshSelection: function() {
1272     var cellList=this.getVisibleSelection();
1273     for (var i=0; i<cellList.length; i++) {
1274       this.columns[cellList[i].column].displayValue(cellList[i].row);
1275     }
1276   },
1277
1278   FillSelection: function(newVal,newStyle) {
1279     if (this.SelectIdxStart && this.SelectIdxEnd) {
1280       var r1=Math.min(this.SelectIdxEnd.row,this.SelectIdxStart.row);
1281       var r2=Math.max(this.SelectIdxEnd.row,this.SelectIdxStart.row);
1282       var c1=Math.min(this.SelectIdxEnd.column,this.SelectIdxStart.column);
1283       var c2=Math.max(this.SelectIdxEnd.column,this.SelectIdxStart.column);
1284       for (var r=r1; r<=r2; r++) {
1285         for (var c=c1; c<=c2; c++) {
1286           this.buffer.setValue(r,c,newVal,newStyle);
1287         }
1288       }
1289     }
1290     if (this.SelectCtrl) {
1291       for (var i=0; i<this.SelectCtrl.length; i++) {
1292         this.buffer.setValue(this.SelectCtrl[i].row,this.SelectCtrl[i].column,newVal,newStyle);
1293       }
1294     }
1295     this.RefreshSelection();
1296   },
1297
1298 /**
1299  * Process mouse down event
1300  * @param e event object
1301  */
1302   selectMouseDown: function(e) {
1303     if (this.highlightEnabled==false) return true;
1304     this.cancelMenu();
1305     var cell=Event.element(e);
1306     if (!Event.isLeftClick(e)) return true;
1307     cell=RicoUtil.getParentByTagName(cell,'div','ricoLG_cell');
1308     if (!cell) return true;
1309     Event.stop(e);
1310     var newIdx=this.datasetIndex(cell);
1311     if (newIdx.onBlankRow) return true;
1312     Rico.writeDebugMsg("selectMouseDown @"+newIdx.row+','+newIdx.column);
1313     if (e.ctrlKey) {
1314       if (!this.SelectIdxStart || this.options.highlightMethod!='class') return true;
1315       if (!this.isSelected(cell)) {
1316         this.highlightCell(cell);
1317         this.SelectCtrl.push(this.datasetIndex(cell));
1318       } else {
1319         for (var i=0; i<this.SelectCtrl.length; i++) {
1320           if (this.SelectCtrl[i].row==newIdx.row && this.SelectCtrl[i].column==newIdx.column) {
1321             this.unhighlightCell(cell);
1322             this.SelectCtrl.splice(i,1);
1323             break;
1324           }
1325         }
1326       }
1327     } else if (e.shiftKey) {
1328       if (!this.SelectIdxStart) return true;
1329       this.AdjustSelection(cell);
1330     } else {
1331       this.selectCell(cell);
1332       this.pluginSelect();
1333     }
1334     return false;
1335   },
1336
1337   pluginSelect: function() {
1338     if (this.selectPluggedIn) return;
1339     var tBody=this.tbody[this.SelectIdxStart.tabIdx];
1340     Event.observe(tBody,"mouseover", this.options.mouseOverHandler, false);
1341     Event.observe(this.outerDiv,"mouseup",  this.options.mouseUpHandler,  false);
1342     this.selectPluggedIn=true;
1343   },
1344
1345   unplugSelect: function() {
1346     if (!this.selectPluggedIn) return;
1347     var tBody=this.tbody[this.SelectIdxStart.tabIdx];
1348     Event.stopObserving(tBody,"mouseover", this.options.mouseOverHandler , false);
1349     Event.stopObserving(this.outerDiv,"mouseup", this.options.mouseUpHandler , false);
1350     this.selectPluggedIn=false;
1351   },
1352
1353   selectMouseUp: function(e) {
1354     this.unplugSelect();
1355     var cell=Event.element(e);
1356     cell=RicoUtil.getParentByTagName(cell,'div','ricoLG_cell');
1357     if (!cell) return;
1358     if (this.SelectIdxStart && this.SelectIdxEnd)
1359       this.AdjustSelection(cell);
1360     else
1361       this.ClearSelection();
1362   },
1363
1364   selectMouseOver: function(e) {
1365     var cell=Event.element(e);
1366     cell=RicoUtil.getParentByTagName(cell,'div','ricoLG_cell');
1367     if (!cell) return;
1368     this.AdjustSelection(cell);
1369     Event.stop(e);
1370   },
1371
1372   isSelected: function(cell) {
1373     if (this.options.highlightMethod!='outline') return Element.hasClassName(cell,this.options.highlightClass);
1374     if (!this.SelectIdxStart || !this.SelectIdxEnd) return false;
1375     var r1=Math.max(Math.min(this.SelectIdxEnd.row,this.SelectIdxStart.row), this.buffer.windowStart);
1376     var r2=Math.min(Math.max(this.SelectIdxEnd.row,this.SelectIdxStart.row), this.buffer.windowEnd-1);
1377     if (r1 > r2) return false;
1378     var c1=Math.min(this.SelectIdxEnd.column,this.SelectIdxStart.column);
1379     var c2=Math.max(this.SelectIdxEnd.column,this.SelectIdxStart.column);
1380     var curIdx=this.datasetIndex(cell);
1381     return (r1<=curIdx.row && curIdx.row<=r2 && c1<=curIdx.column && curIdx.column<=c2);
1382   },
1383
1384   highlightCell: function(cell) {
1385     Element.addClassName(cell,this.options.highlightClass);
1386   },
1387
1388   unhighlightCell: function(cell) {
1389     if (cell==null) return;
1390     Element.removeClassName(cell,this.options.highlightClass);
1391   },
1392
1393   selectRow: function(r) {
1394     for (var c=0; c<this.columns.length; c++)
1395       this.highlightCell(this.columns[c].cell(r));
1396   },
1397
1398   unselectRow: function(r) {
1399     for (var c=0; c<this.columns.length; c++)
1400       this.unhighlightCell(this.columns[c].cell(r));
1401   },
1402
1403   rowMouseOver: function(e) {
1404     if (!this.highlightEnabled) return;
1405     var cell=Event.element(e);
1406     cell=RicoUtil.getParentByTagName(cell,'div','ricoLG_cell');
1407     if (!cell) return;
1408     var newIdx=this.winCellIndex(cell);
1409     if ((this.options.highlightSection & (newIdx.tabIdx+1))==0) return;
1410     this.highlight(newIdx);
1411   },
1412
1413   highlight: function(newIdx) {
1414     if (this.options.highlightMethod!='outline') this.cursorSetClass(newIdx);
1415     if (this.options.highlightMethod!='class') this.cursorOutline(newIdx);
1416     this.highlightIdx=newIdx;
1417   },
1418
1419   cursorSetClass: function(newIdx) {
1420     switch (this.options.highlightElem) {
1421       case 'menuCell':
1422       case 'cursorCell':
1423         if (this.highlightIdx) this.unhighlightCell(this.highlightIdx.cell);
1424         this.highlightCell(newIdx.cell);
1425         break;
1426       case 'menuRow':
1427       case 'cursorRow':
1428         if (this.highlightIdx) this.unselectRow(this.highlightIdx.row);
1429         var s1=this.options.highlightSection & 1;
1430         var s2=this.options.highlightSection & 2;
1431         var c0=s1 ? 0 : this.options.frozenColumns;
1432         var c1=s2 ? this.columns.length : this.options.frozenColumns;
1433         for (var c=c0; c<c1; c++)
1434           this.highlightCell(this.columns[c].cell(newIdx.row));
1435         break;
1436       default: return;
1437     }
1438   },
1439
1440   cursorOutline: function(newIdx) {
1441     var div;
1442     switch (this.options.highlightElem) {
1443       case 'menuCell':
1444       case 'cursorCell':
1445         div=this.highlightDiv[newIdx.tabIdx];
1446         div.style.left=(this.columns[newIdx.column].dataCell.offsetLeft-1)+'px';
1447         div.style.width=this.columns[newIdx.column].colWidth;
1448         this.highlightDiv[1-newIdx.tabIdx].style.display='none';
1449         break;
1450       case 'menuRow':
1451       case 'cursorRow':
1452         div=this.highlightDiv[0];
1453         var s1=this.options.highlightSection & 1;
1454         var s2=this.options.highlightSection & 2;
1455         div.style.left=s1 ? '0px' : this.frozenTabs.style.width;
1456         div.style.width=((s1 ? this.frozenTabs.offsetWidth : 0) + (s2 ? this.innerDiv.offsetWidth : 0) - 4)+'px';
1457         break;
1458       default: return;
1459     }
1460     div.style.top=(this.hdrHt+newIdx.row*this.rowHeight-1)+'px';
1461     div.style.height=(this.rowHeight-1)+'px';
1462     div.style.display='';
1463   },
1464
1465   unhighlight: function() {
1466     switch (this.options.highlightElem) {
1467       case 'menuCell':
1468         this.highlightIdx=this.menuIdx;
1469         /*jsl:fallthru*/
1470       case 'cursorCell':
1471         if (this.highlightIdx) this.unhighlightCell(this.highlightIdx.cell);
1472         if (!this.highlightDiv) return;
1473         for (var i=0; i<2; i++)
1474           this.highlightDiv[i].style.display='none';
1475         break;
1476       case 'menuRow':
1477         this.highlightIdx=this.menuIdx;
1478         /*jsl:fallthru*/
1479       case 'cursorRow':
1480         if (this.highlightIdx) this.unselectRow(this.highlightIdx.row);
1481         if (this.highlightDiv) this.highlightDiv[0].style.display='none';
1482         break;
1483     }
1484   },
1485
1486   resetContents: function(resetHt) {
1487     Rico.writeDebugMsg("resetContents("+resetHt+")");
1488     this.ClearSelection();
1489     this.buffer.clear();
1490     this.clearRows();
1491     if (typeof resetHt=='undefined' || resetHt==true) {
1492       this.buffer.setTotalRows(0);
1493     } else {
1494       this.scrollToRow(0);
1495     }
1496     this.clearBookmark();
1497   },
1498
1499   setImages: function() {
1500     for (var n=0; n<this.columns.length; n++)
1501       this.columns[n].setImage();
1502   },
1503
1504   // returns column index, or -1 if there are no sorted columns
1505   findSortedColumn: function() {
1506     for (var n=0; n<this.columns.length; n++) {
1507       if (this.columns[n].isSorted()) return n;
1508     }
1509     return -1;
1510   },
1511
1512   findColumnName: function(name) {
1513     for (var n=0; n<this.columns.length; n++) {
1514       if (this.columns[n].fieldName == name) return n;
1515     }
1516     return -1;
1517   },
1518
1519 /**
1520  * Set initial sort
1521  */
1522   setSortUI: function( columnNameOrNum, sortDirection ) {
1523     Rico.writeDebugMsg("setSortUI: "+columnNameOrNum+' '+sortDirection);
1524     var colnum=this.findSortedColumn();
1525     if (colnum >= 0) {
1526       sortDirection=this.columns[colnum].getSortDirection();
1527     } else {
1528       if (typeof sortDirection!='string') {
1529         sortDirection=Rico.TableColumn.SORT_ASC;
1530       } else {
1531         sortDirection=sortDirection.toUpperCase();
1532         if (sortDirection != Rico.TableColumn.SORT_DESC) sortDirection=Rico.TableColumn.SORT_ASC;
1533       }
1534       switch (typeof columnNameOrNum) {
1535         case 'string':
1536           colnum=this.findColumnName(columnNameOrNum);
1537           break;
1538         case 'number':
1539           colnum=columnNameOrNum;
1540           break;
1541       }
1542     }
1543     if (typeof(colnum)!='number' || colnum < 0) return;
1544     this.clearSort();
1545     this.columns[colnum].setSorted(sortDirection);
1546     this.buffer.sortBuffer(colnum);
1547   },
1548
1549 /**
1550  * clear sort flag on all columns
1551  */
1552   clearSort: function() {
1553     for (var x=0;x<this.columns.length;x++)
1554       this.columns[x].setUnsorted();
1555   },
1556
1557 /**
1558  * clear filters on all columns
1559  */
1560   clearFilters: function() {
1561     for (var x=0;x<this.columns.length;x++) {
1562       this.columns[x].setUnfiltered(true);
1563     }
1564     if (this.options.filterHandler) {
1565       this.options.filterHandler();
1566     }
1567   },
1568
1569 /**
1570  * returns number of columns with a user filter set
1571  */
1572   filterCount: function() {
1573     for (var x=0,cnt=0;x<this.columns.length;x++) {
1574       if (this.columns[x].isFiltered()) cnt++;
1575     }
1576     return cnt;
1577   },
1578
1579   sortHandler: function() {
1580     this.cancelMenu();
1581     this.ClearSelection();
1582     this.setImages();
1583     var n=this.findSortedColumn();
1584     if (n < 0) return;
1585     Rico.writeDebugMsg("sortHandler: sorting column "+n);
1586     this.buffer.sortBuffer(n);
1587     this.clearRows();
1588     this.scrollDiv.scrollTop = 0;
1589     this.buffer.fetch(0);
1590   },
1591
1592   filterHandler: function() {
1593     Rico.writeDebugMsg("filterHandler");
1594     this.cancelMenu();
1595     if (this.buffer.processingRequest) {
1596       this.queueFilter=true;
1597       return;
1598     }
1599     this.unplugScroll();
1600     this.ClearSelection();
1601     this.setImages();
1602     this.clearBookmark();
1603     this.clearRows();
1604     this.buffer.fetch(-1);
1605     setTimeout(this.pluginScroll.bind(this), 1); // resetting ht div can cause a scroll event, triggering an extra fetch
1606   },
1607
1608   clearBookmark: function() {
1609     if (this.bookmark) this.bookmark.innerHTML="&nbsp;";
1610   },
1611
1612   bookmarkHandler: function(firstrow,lastrow) {
1613     var newhtml;
1614     if (isNaN(firstrow) || !this.bookmark) return;
1615     var totrows=this.buffer.totalRows;
1616     if (totrows < lastrow) lastrow=totrows;
1617     if (totrows<=0) {
1618       newhtml = RicoTranslate.getPhraseById('bookmarkNoMatch');
1619     } else if (lastrow<0) {
1620       newhtml = RicoTranslate.getPhraseById('bookmarkNoRec');
1621     } else if (this.buffer.foundRowCount) {
1622       newhtml = RicoTranslate.getPhraseById('bookmarkExact',firstrow,lastrow,totrows);
1623     } else {
1624       newhtml = RicoTranslate.getPhraseById('bookmarkAbout',firstrow,lastrow,totrows);
1625     }
1626     this.bookmark.innerHTML = newhtml;
1627   },
1628
1629   clearRows: function() {
1630     if (this.isBlank==true) return;
1631     for (var c=0; c < this.columns.length; c++)
1632       this.columns[c].clearColumn();
1633     this.isBlank = true;
1634   },
1635
1636   refreshContents: function(startPos) {
1637     Rico.writeDebugMsg("refreshContents: startPos="+startPos+" lastRow="+this.lastRowPos+" PartBlank="+this.isPartialBlank+" pageSize="+this.pageSize);
1638     this.hideMsg();
1639     this.cancelMenu();
1640     this.unhighlight(); // in case highlighting was manually invoked
1641     if (this.queueFilter) {
1642       Rico.writeDebugMsg("refreshContents: cancelling refresh because filter has changed");
1643       this.queueFilter=false;
1644       this.filterHandler();
1645       return;
1646     }
1647     this.highlightEnabled=this.options.highlightSection!='none';
1648     if (startPos == this.lastRowPos && !this.isPartialBlank && !this.isBlank) return;
1649     this.isBlank = false;
1650     var viewPrecedesBuffer = this.buffer.startPos > startPos;
1651     var contentStartPos = viewPrecedesBuffer ? this.buffer.startPos: startPos;
1652     this.contentStartPos = contentStartPos+1;
1653     var contentEndPos = Math.min(this.buffer.startPos + this.buffer.size, startPos + this.pageSize);
1654     var onRefreshComplete = this.options.onRefreshComplete;
1655
1656     if ((startPos + this.pageSize < this.buffer.startPos) ||
1657         (this.buffer.startPos + this.buffer.size < startPos) ||
1658         (this.buffer.size == 0)) {
1659       this.clearRows();
1660       if (onRefreshComplete) onRefreshComplete(this.contentStartPos,contentEndPos);  // update bookmark
1661       return;
1662     }
1663
1664     Rico.writeDebugMsg('refreshContents: contentStartPos='+contentStartPos+' contentEndPos='+contentEndPos+' viewPrecedesBuffer='+viewPrecedesBuffer);
1665     var rowSize = contentEndPos - contentStartPos;
1666     this.buffer.setWindow(contentStartPos, rowSize );
1667     var blankSize = this.pageSize - rowSize;
1668     var blankOffset = viewPrecedesBuffer ? 0: rowSize;
1669     var contentOffset = viewPrecedesBuffer ? blankSize: 0;
1670
1671     for (var r=0; r < rowSize; r++) { //initialize what we have
1672       for (var c=0; c < this.columns.length; c++)
1673         this.columns[c].displayValue(r + contentOffset);
1674     }
1675     for (var i=0; i < blankSize; i++)     // blank out the rest
1676       this.blankRow(i + blankOffset);
1677     if (this.options.highlightElem=='selection') this.ShowSelection();
1678     this.isPartialBlank = blankSize > 0;
1679     this.lastRowPos = startPos;
1680     Rico.writeDebugMsg("refreshContents complete, startPos="+startPos);
1681     if (onRefreshComplete) onRefreshComplete(this.contentStartPos,contentEndPos);  // update bookmark
1682   },
1683
1684   scrollToRow: function(rowOffset) {
1685      var p=this.rowToPixel(rowOffset);
1686      Rico.writeDebugMsg("scrollToRow, rowOffset="+rowOffset+" pixel="+p);
1687      this.scrollDiv.scrollTop = p; // this causes a scroll event
1688      if ( this.options.onscroll )
1689         this.options.onscroll( this, rowOffset );
1690   },
1691
1692   scrollUp: function() {
1693      this.moveRelative(-1);
1694   },
1695
1696   scrollDown: function() {
1697      this.moveRelative(1);
1698   },
1699
1700   pageUp: function() {
1701      this.moveRelative(-this.pageSize);
1702   },
1703
1704   pageDown: function() {
1705      this.moveRelative(this.pageSize);
1706   },
1707
1708   adjustRow: function(rowOffset) {
1709      var notdisp=this.topOfLastPage();
1710      if (notdisp == 0 || !rowOffset) return 0;
1711      return Math.min(notdisp,rowOffset);
1712   },
1713
1714   rowToPixel: function(rowOffset) {
1715      return this.adjustRow(rowOffset) * this.rowHeight;
1716   },
1717
1718 /**
1719  * @returns row to display at top of scroll div
1720  */
1721   pixeltorow: function(p) {
1722      var notdisp=this.topOfLastPage();
1723      if (notdisp == 0) return 0;
1724      var prow=parseInt(p/this.rowHeight,10);
1725      return Math.min(notdisp,prow);
1726   },
1727
1728   moveRelative: function(relOffset) {
1729      var newoffset=Math.max(this.scrollDiv.scrollTop+relOffset*this.rowHeight,0);
1730      newoffset=Math.min(newoffset,this.scrollDiv.scrollHeight);
1731      //Rico.writeDebugMsg("moveRelative, newoffset="+newoffset);
1732      this.scrollDiv.scrollTop=newoffset;
1733   },
1734
1735   pluginScroll: function() {
1736      if (this.scrollPluggedIn) return;
1737      Rico.writeDebugMsg("pluginScroll: wheelEvent="+this.wheelEvent);
1738      Event.observe(this.scrollDiv,"scroll",this.scrollEventFunc, false);
1739      for (var t=0; t<2; t++)
1740        Event.observe(this.tabs[t],this.wheelEvent,this.wheelEventFunc, false);
1741      this.scrollPluggedIn=true;
1742   },
1743
1744   unplugScroll: function() {
1745      if (!this.scrollPluggedIn) return;
1746      Rico.writeDebugMsg("unplugScroll");
1747      Event.stopObserving(this.scrollDiv,"scroll", this.scrollEventFunc , false);
1748      for (var t=0; t<2; t++)
1749        Event.stopObserving(this.tabs[t],this.wheelEvent,this.wheelEventFunc, false);
1750      this.scrollPluggedIn=false;
1751   },
1752
1753   handleWheel: function(e) {
1754     var delta = 0;
1755     if (e.wheelDelta) {
1756       if (Prototype.Browser.Opera)
1757         delta = e.wheelDelta/120;
1758       else if (Prototype.Browser.WebKit)
1759         delta = -e.wheelDelta/12;
1760       else
1761         delta = -e.wheelDelta/120;
1762     } else if (e.detail) {
1763       delta = e.detail/3; /* Mozilla/Gecko */
1764     }
1765     if (delta) this.moveRelative(delta);
1766     Event.stop(e);
1767     return false;
1768   },
1769
1770   handleScroll: function(e) {
1771      if ( this.scrollTimeout )
1772        clearTimeout( this.scrollTimeout );
1773      this.setHorizontalScroll();
1774      var scrtop=this.scrollDiv.scrollTop;
1775      var vscrollDiff = this.lastScrollPos-scrtop;
1776      if (vscrollDiff == 0.00) return;
1777      var newrow=this.pixeltorow(scrtop);
1778      if (newrow == this.lastRowPos && !this.isPartialBlank && !this.isBlank) return;
1779      var stamp1 = new Date();
1780      //Rico.writeDebugMsg("handleScroll, newrow="+newrow+" scrtop="+scrtop);
1781      if (this.options.highlightElem=='selection') this.HideSelection();
1782      this.buffer.fetch(newrow);
1783      if (this.options.onscroll) this.options.onscroll(this, newrow);
1784      this.scrollTimeout = setTimeout(this.scrollIdle.bind(this), 1200 );
1785      this.lastScrollPos = this.scrollDiv.scrollTop;
1786      var stamp2 = new Date();
1787      //Rico.writeDebugMsg("handleScroll, time="+(stamp2.getTime()-stamp1.getTime()));
1788   },
1789
1790   scrollIdle: function() {
1791      if ( this.options.onscrollidle )
1792         this.options.onscrollidle();
1793   },
1794
1795   printAll: function(exportType) {
1796     this.showMsg(RicoTranslate.getPhraseById('exportInProgress'));
1797     setTimeout(this._printAll.bind(this,exportType),10);  // allow message to paint
1798   },
1799
1800 /**
1801  * Support function for printAll()
1802  */
1803   _printAll: function(exportType) {
1804     this.exportStart();
1805     this.buffer.exportAllRows(this.exportBuffer.bind(this),this.exportFinish.bind(this,exportType));
1806   },
1807
1808   _printVisible: function(exportType) {
1809     this.exportStart();
1810     this.exportBuffer(this.buffer.visibleRows(),0);
1811     this.exportFinish(exportType);
1812   },
1813
1814 /**
1815  * Send all rows to print/export window
1816  */
1817   exportBuffer: function(rows,startPos) {
1818     var r,c,v,col,exportText;
1819     Rico.writeDebugMsg("exportBuffer: "+rows.length+" rows");
1820     var tdstyle=[];
1821     var totalcnt=startPos || 0;
1822     for (c=0; c<this.columns.length; c++) {
1823       if (this.columns[c].visible) tdstyle[c]=this.exportStyle(this.columns[c].cell(0));  // assumes row 0 style applies to all rows
1824     }
1825     for(r=0; r < rows.length; r++) {
1826       exportText='';
1827       for (c=0; c<this.columns.length; c++) {
1828         if (!this.columns[c].visible) continue;
1829         col=this.columns[c];
1830         col.expStyle=tdstyle[c];
1831         v=col._export(rows[r][c],rows[r]);
1832         if (v.match(/<span\s+class=(['"]?)ricolookup\1>(.*)<\/span>/i))
1833           v=RegExp.leftContext;
1834         if (v=='') v='&nbsp;';
1835         exportText+="<td style='"+col.expStyle+"'>"+v+"</td>";
1836       }
1837       this.exportRows.push(exportText);
1838       totalcnt++;
1839       if (totalcnt % 10 == 0) window.status=RicoTranslate.getPhraseById('exportStatus',totalcnt);
1840     }
1841   }
1842
1843 };
1844
1845
1846 Rico.TableColumn.prototype = 
1847 /** @lends Rico.TableColumn# */
1848 {
1849 /**
1850  * Implements a LiveGrid column. Also contains static properties used by SimpleGrid columns.
1851  * @extends Rico.TableColumnBase
1852  * @constructs
1853  */
1854 initialize: function(liveGrid,colIdx,hdrInfo,tabIdx) {
1855   Object.extend(this, new Rico.TableColumnBase());
1856   this.baseInit(liveGrid,colIdx,hdrInfo,tabIdx);
1857   if (typeof this.format.type!='string') this.format.type='raw';
1858   if (typeof this.isNullable!='boolean') this.isNullable = /number|date/.test(this.format.type);
1859   this.isText = /raw|text|showTags/.test(this.format.type);
1860   Rico.writeDebugMsg(" sortable="+this.sortable+" filterable="+this.filterable+" hideable="+this.hideable+" isNullable="+this.isNullable+' isText='+this.isText);
1861   this.fixHeaders(this.liveGrid.tableId, this.options.hdrIconsFirst);
1862   if (this.format.control) {
1863     // copy all properties/methods that start with '_'
1864     if (typeof this.format.control=='string') {
1865       this.format.control=eval(this.format.control);
1866     }
1867     for (var property in this.format.control) {
1868       if (property.charAt(0)=='_') {
1869         Rico.writeDebugMsg("Copying control property "+property);
1870         this[property] = this.format.control[property];
1871       }
1872     }
1873   }
1874   if (this['format_'+this.format.type])
1875     this._format=this['format_'+this.format.type].bind(this);
1876 },
1877
1878 /**
1879  * Sorts the column in ascending order
1880  */
1881 sortAsc: function() {
1882   this.setColumnSort(Rico.TableColumn.SORT_ASC);
1883 },
1884
1885 /**
1886  * Sorts the column in descending order
1887  */
1888 sortDesc: function() {
1889   this.setColumnSort(Rico.TableColumn.SORT_DESC);
1890 },
1891
1892 /**
1893  * Sorts the column in the specified direction
1894  * @param direction must be one of Rico.TableColumn.UNSORTED, .SORT_ASC, or .SORT_DESC
1895  */
1896 setColumnSort: function(direction) {
1897   this.liveGrid.clearSort();
1898   this.setSorted(direction);
1899   if (this.liveGrid.options.saveColumnInfo.sort)
1900     this.liveGrid.setCookie();
1901   if (this.options.sortHandler)
1902     this.options.sortHandler();
1903 },
1904
1905 /**
1906  * @returns true if this column is allowed to be sorted
1907  */
1908 isSortable: function() {
1909   return this.sortable;
1910 },
1911
1912 /**
1913  * @returns true if this column is currently sorted
1914  */
1915 isSorted: function() {
1916   return this.currentSort != Rico.TableColumn.UNSORTED;
1917 },
1918
1919 /**
1920  * @returns Rico.TableColumn.UNSORTED, .SORT_ASC, or .SORT_DESC
1921  */
1922 getSortDirection: function() {
1923   return this.currentSort;
1924 },
1925
1926 /**
1927  * toggle the sort sequence for this column
1928  */
1929 toggleSort: function() {
1930   if (this.liveGrid.buffer && this.liveGrid.buffer.totalRows==0) return;
1931   if (this.currentSort == Rico.TableColumn.SORT_ASC)
1932     this.sortDesc();
1933   else
1934     this.sortAsc();
1935 },
1936
1937 /**
1938  * Flags that this column is not sorted
1939  */
1940 setUnsorted: function() {
1941   this.setSorted(Rico.TableColumn.UNSORTED);
1942 },
1943
1944 /**
1945  * Flags that this column is sorted, but doesn't actually carry out the sort
1946  * @param direction must be one of Rico.TableColumn.UNSORTED, .SORT_ASC, or .SORT_DESC
1947  */
1948 setSorted: function(direction) {
1949   this.currentSort = direction;
1950 },
1951
1952 /**
1953  * @returns true if this column is allowed to be filtered
1954  */
1955 canFilter: function() {
1956   return this.filterable;
1957 },
1958
1959 /**
1960  * @returns a textual representation of how this column is filtered
1961  */
1962 getFilterText: function() {
1963   var vals=[];
1964   for (var i=0; i<this.filterValues.length; i++) {
1965     var v=this.filterValues[i];
1966     if (typeof(v)=='string' && v.match(/<span\s+class=(['"]?)ricolookup\1>(.*)<\/span>/i)) v=RegExp.leftContext;
1967     vals.push(v=='' ? RicoTranslate.getPhraseById('filterBlank') : v);
1968   }
1969   switch (this.filterOp) {
1970     case 'EQ':   return '= '+(vals[0]);
1971     case 'NE':   return RicoTranslate.getPhraseById('filterNot',vals.join(', '));
1972     case 'LE':   return '<= '+vals[0];
1973     case 'GE':   return '>= '+vals[0];
1974     case 'LIKE': return RicoTranslate.getPhraseById('filterLike',vals[0]);
1975     case 'NULL': return RicoTranslate.getPhraseById('filterEmpty');
1976     case 'NOTNULL': return RicoTranslate.getPhraseById('filterNotEmpty');
1977   }
1978   return '?';
1979 },
1980
1981 /**
1982  * @returns returns the query string representation of the filter
1983  */
1984 getFilterQueryParm: function() {
1985   if (this.filterType == Rico.TableColumn.UNFILTERED) return '';
1986   var retval='&f['+this.index+'][op]='+this.filterOp;
1987   retval+='&f['+this.index+'][len]='+this.filterValues.length;
1988   for (var i=0; i<this.filterValues.length; i++) {
1989     retval+='&f['+this.index+']['+i+']='+escape(this.filterValues[i]);
1990   }
1991   return retval;
1992 },
1993
1994 /**
1995  * removes the filter from this column
1996  */
1997 setUnfiltered: function(skipHandler) {
1998   this.filterType = Rico.TableColumn.UNFILTERED;
1999   if (this.liveGrid.options.saveColumnInfo.filter)
2000     this.liveGrid.setCookie();
2001   if (this.removeFilterFunc)
2002     this.removeFilterFunc();
2003   if (this.options.filterHandler && !skipHandler)
2004     this.options.filterHandler();
2005 },
2006
2007 setFilterEQ: function() {
2008   this.setUserFilter('EQ');
2009 },
2010 setFilterNE: function() {
2011   this.setUserFilter('NE');
2012 },
2013 addFilterNE: function() {
2014   this.filterValues.push(this.userFilter);
2015   if (this.liveGrid.options.saveColumnInfo.filter)
2016     this.liveGrid.setCookie();
2017   if (this.options.filterHandler)
2018     this.options.filterHandler();
2019 },
2020 setFilterGE: function() { this.setUserFilter('GE'); },
2021 setFilterLE: function() { this.setUserFilter('LE'); },
2022 setFilterKW: function(keyword) {
2023   if (keyword!='' && keyword!=null) {
2024     this.setFilter('LIKE',keyword,Rico.TableColumn.USERFILTER);
2025   } else {
2026     this.setUnfiltered(false);
2027   }
2028 },
2029
2030 setUserFilter: function(relop) {
2031   this.setFilter(relop,this.userFilter,Rico.TableColumn.USERFILTER);
2032 },
2033
2034 setSystemFilter: function(relop,filter) {
2035   this.setFilter(relop,filter,Rico.TableColumn.SYSTEMFILTER);
2036 },
2037
2038 setFilter: function(relop,filter,type,removeFilterFunc) {
2039   this.filterValues = [filter];
2040   this.filterType = type;
2041   this.filterOp = relop;
2042   if (type == Rico.TableColumn.USERFILTER && this.liveGrid.options.saveColumnInfo.filter)
2043     this.liveGrid.setCookie();
2044   this.removeFilterFunc=removeFilterFunc;
2045   if (this.options.filterHandler)
2046     this.options.filterHandler();
2047 },
2048
2049 isFiltered: function() {
2050   return this.filterType == Rico.TableColumn.USERFILTER;
2051 },
2052
2053 filterChange: function(e) {
2054   var selbox=Event.element(e);
2055   if (selbox.value==this.liveGrid.options.FilterAllToken)
2056     this.setUnfiltered();
2057   else
2058     this.setFilter('EQ',selbox.value,Rico.TableColumn.USERFILTER,function() {selbox.selectedIndex=0;});
2059 },
2060
2061 filterClear: function(e,txtbox) {
2062   txtbox.value='';
2063   this.setUnfiltered();
2064 },
2065
2066 filterKeypress: function(e) {
2067   var txtbox=Event.element(e);
2068   if (typeof this.lastKeyFilter != 'string') this.lastKeyFilter='';
2069   if (this.lastKeyFilter==txtbox.value) return;
2070   var v=txtbox.value;
2071   Rico.writeDebugMsg("filterKeypress: "+this.index+' '+v);
2072   this.lastKeyFilter=v;
2073   if (v=='' || v=='*')
2074     this.setUnfiltered();
2075   else {
2076     this.setFilter('LIKE', v, Rico.TableColumn.USERFILTER, function() {txtbox.value='';});
2077   }
2078 },
2079
2080 format_text: function(v) {
2081   if (typeof v!='string')
2082     return '&nbsp;';
2083   else
2084     return v.stripTags();
2085 },
2086
2087 format_showTags: function(v) {
2088   if (typeof v!='string')
2089     return '&nbsp;';
2090   else
2091     return v.replace(/&/g, '&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;');
2092 },
2093
2094 format_number: function(v) {
2095   if (typeof v=='undefined' || v=='' || v==null)
2096     return '&nbsp;';
2097   else
2098     return v.formatNumber(this.format);
2099 },
2100
2101 format_datetime: function(v) {
2102   if (typeof v=='undefined' || v=='' || v==null)
2103     return '&nbsp;';
2104   else {
2105     var d=new Date();
2106     if (!d.setISO8601(v)) return v;
2107     return (this.format.prefix || '')+d.formatDate(this.format.dateFmt || 'translateDateTime')+(this.format.suffix || '');
2108   }
2109 },
2110
2111 // converts GMT/UTC to local time
2112 format_UTCasLocalTime: function(v) {
2113   if (typeof v=='undefined' || v=='' || v==null)
2114     return '&nbsp;';
2115   else {
2116     var d=new Date();
2117     if (!d.setISO8601(v,-d.getTimezoneOffset())) return v;
2118     return (this.format.prefix || '')+d.formatDate(this.format.dateFmt || 'translateDateTime')+(this.format.suffix || '');
2119   }
2120 },
2121
2122 format_date: function(v) {
2123   if (typeof v=='undefined' || v==null || v=='')
2124     return '&nbsp;';
2125   else {
2126     var d=new Date();
2127     if (!d.setISO8601(v)) return v;
2128     return (this.format.prefix || '')+d.formatDate(this.format.dateFmt || 'translateDate')+(this.format.suffix || '');
2129   }
2130 },
2131
2132 fixHeaders: function(prefix, iconsfirst) {
2133   if (this.sortable) {
2134     switch (this.options.headingSort) {
2135       case 'link':
2136         var a=RicoUtil.wrapChildren(this.hdrCellDiv,'ricoSort',undefined,'a');
2137         a.href = "javascript:void(0)";
2138         a.onclick = this.toggleSort.bindAsEventListener(this);
2139         break;
2140       case 'hover':
2141         this.hdrCellDiv.onclick = this.toggleSort.bindAsEventListener(this);
2142         break;
2143     }
2144   }
2145   this.imgFilter = document.createElement('img');
2146   this.imgFilter.style.display='none';
2147   this.imgFilter.src=Rico.imgDir+this.options.filterImg;
2148   this.imgFilter.className='ricoLG_HdrIcon';
2149   this.imgSort = document.createElement('img');
2150   this.imgSort.style.display='none';
2151   this.imgSort.src=Rico.imgDir+this.options.sortAscendImg;
2152   this.imgSort.className='ricoLG_HdrIcon';
2153   if (iconsfirst) {
2154     this.hdrCellDiv.insertBefore(this.imgSort,this.hdrCellDiv.firstChild);
2155     this.hdrCellDiv.insertBefore(this.imgFilter,this.hdrCellDiv.firstChild);
2156   } else {
2157     this.hdrCellDiv.appendChild(this.imgFilter);
2158     this.hdrCellDiv.appendChild(this.imgSort);
2159   }
2160   if (!this.format.filterUI) {
2161     Event.observe(this.imgFilter, 'click', this.filterClick.bindAsEventListener(this), false);
2162   }
2163 },
2164
2165 filterClick: function(e) {
2166   if (this.filterType==Rico.TableColumn.USERFILTER && this.filterOp=='LIKE') {
2167     this.liveGrid.openKeyword(this.index);
2168   }
2169 },
2170
2171 getValue: function(windowRow) {
2172   return this.liveGrid.buffer.getWindowValue(windowRow,this.index);
2173 },
2174
2175 getBufferCell: function(windowRow) {
2176   return this.liveGrid.buffer.getWindowCell(windowRow,this.index);
2177 },
2178
2179 getBufferAttr: function(windowRow) {
2180   return this.liveGrid.buffer.getWindowAttr(windowRow,this.index);
2181 },
2182
2183 setValue: function(windowRow,newval) {
2184   this.liveGrid.buffer.setWindowValue(windowRow,this.index,newval);
2185 },
2186
2187 _format: function(v) {
2188   return v;
2189 },
2190
2191 _display: function(v,gridCell) {
2192   gridCell.innerHTML=this._format(v);
2193 },
2194
2195 _export: function(v) {
2196   return this._format(v);
2197 },
2198
2199 displayValue: function(windowRow) {
2200   var bufCell=this.getBufferCell(windowRow);
2201   if (bufCell==null) {
2202     this.clearCell(windowRow);
2203     return;
2204   }
2205   var gridCell=this.cell(windowRow);
2206   this._display(bufCell,gridCell,windowRow);
2207   var acceptAttr=this.liveGrid.buffer.options.acceptAttr;
2208   if (acceptAttr.length==0) return;
2209   var bufAttr=this.getBufferAttr(windowRow);
2210   if (bufAttr==null) return;
2211   for (var k=0; k<acceptAttr.length; k++) {
2212     bufAttr=bufAttr['_'+acceptAttr[k]] || '';
2213     switch (acceptAttr[k]) {
2214       case 'style': gridCell.style.cssText=bufAttr; break;
2215       case 'class': gridCell.className=bufAttr; break;
2216       default:      gridCell['_'+acceptAttr[k]]=bufAttr; break;
2217     }
2218   }
2219 }
2220
2221 };
2222
2223 Rico.includeLoaded('ricoLiveGrid.js');