Upgrade to ExtJS 3.1.0 - Released 12/16/2009
[extjs.git] / pkgs / window-debug.js
1 /*!
2  * Ext JS Library 3.1.0
3  * Copyright(c) 2006-2009 Ext JS, LLC
4  * licensing@extjs.com
5  * http://www.extjs.com/license
6  */
7 /**
8  * @class Ext.Window
9  * @extends Ext.Panel
10  * <p>A specialized panel intended for use as an application window.  Windows are floated, {@link #resizable}, and
11  * {@link #draggable} by default.  Windows can be {@link #maximizable maximized} to fill the viewport,
12  * restored to their prior size, and can be {@link #minimize}d.</p>
13  * <p>Windows can also be linked to a {@link Ext.WindowGroup} or managed by the {@link Ext.WindowMgr} to provide
14  * grouping, activation, to front, to back and other application-specific behavior.</p>
15  * <p>By default, Windows will be rendered to document.body. To {@link #constrain} a Window to another element
16  * specify {@link Ext.Component#renderTo renderTo}.</p>
17  * <p><b>Note:</b> By default, the <code>{@link #closable close}</code> header tool <i>destroys</i> the Window resulting in
18  * destruction of any child Components. This makes the Window object, and all its descendants <b>unusable</b>. To enable
19  * re-use of a Window, use <b><code>{@link #closeAction closeAction: 'hide'}</code></b>.</p>
20  * @constructor
21  * @param {Object} config The config object
22  * @xtype window
23  */
24 Ext.Window = Ext.extend(Ext.Panel, {
25     /**
26      * @cfg {Number} x
27      * The X position of the left edge of the window on initial showing. Defaults to centering the Window within
28      * the width of the Window's container {@link Ext.Element Element) (The Element that the Window is rendered to).
29      */
30     /**
31      * @cfg {Number} y
32      * The Y position of the top edge of the window on initial showing. Defaults to centering the Window within
33      * the height of the Window's container {@link Ext.Element Element) (The Element that the Window is rendered to).
34      */
35     /**
36      * @cfg {Boolean} modal
37      * True to make the window modal and mask everything behind it when displayed, false to display it without
38      * restricting access to other UI elements (defaults to false).
39      */
40     /**
41      * @cfg {String/Element} animateTarget
42      * Id or element from which the window should animate while opening (defaults to null with no animation).
43      */
44     /**
45      * @cfg {String} resizeHandles
46      * A valid {@link Ext.Resizable} handles config string (defaults to 'all').  Only applies when resizable = true.
47      */
48     /**
49      * @cfg {Ext.WindowGroup} manager
50      * A reference to the WindowGroup that should manage this window (defaults to {@link Ext.WindowMgr}).
51      */
52     /**
53     * @cfg {String/Number/Component} defaultButton
54     * <p>Specifies a Component to receive focus when this Window is focussed.</p>
55     * <p>This may be one of:</p><div class="mdetail-params"><ul>
56     * <li>The index of a footer Button.</li>
57     * <li>The id of a Component.</li>
58     * <li>A Component.</li>
59     * </ul></div>
60     */
61     /**
62     * @cfg {Function} onEsc
63     * Allows override of the built-in processing for the escape key. Default action
64     * is to close the Window (performing whatever action is specified in {@link #closeAction}.
65     * To prevent the Window closing when the escape key is pressed, specify this as
66     * Ext.emptyFn (See {@link Ext#emptyFn}).
67     */
68     /**
69      * @cfg {Boolean} collapsed
70      * True to render the window collapsed, false to render it expanded (defaults to false). Note that if
71      * {@link #expandOnShow} is true (the default) it will override the <tt>collapsed</tt> config and the window
72      * will always be expanded when shown.
73      */
74     /**
75      * @cfg {Boolean} maximized
76      * True to initially display the window in a maximized state. (Defaults to false).
77      */
78
79     /**
80     * @cfg {String} baseCls
81     * The base CSS class to apply to this panel's element (defaults to 'x-window').
82     */
83     baseCls : 'x-window',
84     /**
85      * @cfg {Boolean} resizable
86      * True to allow user resizing at each edge and corner of the window, false to disable resizing (defaults to true).
87      */
88     resizable : true,
89     /**
90      * @cfg {Boolean} draggable
91      * True to allow the window to be dragged by the header bar, false to disable dragging (defaults to true).  Note
92      * that by default the window will be centered in the viewport, so if dragging is disabled the window may need
93      * to be positioned programmatically after render (e.g., myWindow.setPosition(100, 100);).
94      */
95     draggable : true,
96     /**
97      * @cfg {Boolean} closable
98      * <p>True to display the 'close' tool button and allow the user to close the window, false to
99      * hide the button and disallow closing the window (defaults to true).</p>
100      * <p>By default, when close is requested by either clicking the close button in the header
101      * or pressing ESC when the Window has focus, the {@link #close} method will be called. This
102      * will <i>{@link Ext.Component#destroy destroy}</i> the Window and its content meaning that
103      * it may not be reused.</p>
104      * <p>To make closing a Window <i>hide</i> the Window so that it may be reused, set
105      * {@link #closeAction} to 'hide'.
106      */
107     closable : true,
108     /**
109      * @cfg {String} closeAction
110      * <p>The action to take when the close header tool is clicked:
111      * <div class="mdetail-params"><ul>
112      * <li><b><code>'{@link #close}'</code></b> : <b>Default</b><div class="sub-desc">
113      * {@link #close remove} the window from the DOM and {@link Ext.Component#destroy destroy}
114      * it and all descendant Components. The window will <b>not</b> be available to be
115      * redisplayed via the {@link #show} method.
116      * </div></li>
117      * <li><b><code>'{@link #hide}'</code></b> : <div class="sub-desc">
118      * {@link #hide} the window by setting visibility to hidden and applying negative offsets.
119      * The window will be available to be redisplayed via the {@link #show} method.
120      * </div></li>
121      * </ul></div>
122      * <p><b>Note:</b> This setting does not affect the {@link #close} method
123      * which will always {@link Ext.Component#destroy destroy} the window. To
124      * programatically <i>hide</i> a window, call {@link #hide}.</p>
125      */
126     closeAction : 'close',
127     /**
128      * @cfg {Boolean} constrain
129      * True to constrain the window within its containing element, false to allow it to fall outside of its
130      * containing element. By default the window will be rendered to document.body.  To render and constrain the
131      * window within another element specify {@link #renderTo}.
132      * (defaults to false).  Optionally the header only can be constrained using {@link #constrainHeader}.
133      */
134     constrain : false,
135     /**
136      * @cfg {Boolean} constrainHeader
137      * True to constrain the window header within its containing element (allowing the window body to fall outside
138      * of its containing element) or false to allow the header to fall outside its containing element (defaults to
139      * false). Optionally the entire window can be constrained using {@link #constrain}.
140      */
141     constrainHeader : false,
142     /**
143      * @cfg {Boolean} plain
144      * True to render the window body with a transparent background so that it will blend into the framing
145      * elements, false to add a lighter background color to visually highlight the body element and separate it
146      * more distinctly from the surrounding frame (defaults to false).
147      */
148     plain : false,
149     /**
150      * @cfg {Boolean} minimizable
151      * True to display the 'minimize' tool button and allow the user to minimize the window, false to hide the button
152      * and disallow minimizing the window (defaults to false).  Note that this button provides no implementation --
153      * the behavior of minimizing a window is implementation-specific, so the minimize event must be handled and a
154      * custom minimize behavior implemented for this option to be useful.
155      */
156     minimizable : false,
157     /**
158      * @cfg {Boolean} maximizable
159      * True to display the 'maximize' tool button and allow the user to maximize the window, false to hide the button
160      * and disallow maximizing the window (defaults to false).  Note that when a window is maximized, the tool button
161      * will automatically change to a 'restore' button with the appropriate behavior already built-in that will
162      * restore the window to its previous size.
163      */
164     maximizable : false,
165     /**
166      * @cfg {Number} minHeight
167      * The minimum height in pixels allowed for this window (defaults to 100).  Only applies when resizable = true.
168      */
169     minHeight : 100,
170     /**
171      * @cfg {Number} minWidth
172      * The minimum width in pixels allowed for this window (defaults to 200).  Only applies when resizable = true.
173      */
174     minWidth : 200,
175     /**
176      * @cfg {Boolean} expandOnShow
177      * True to always expand the window when it is displayed, false to keep it in its current state (which may be
178      * {@link #collapsed}) when displayed (defaults to true).
179      */
180     expandOnShow : true,
181
182     // inherited docs, same default
183     collapsible : false,
184
185     /**
186      * @cfg {Boolean} initHidden
187      * True to hide the window until show() is explicitly called (defaults to true).
188      * @deprecated
189      */
190     initHidden : undefined,
191
192     /**
193      * @cfg {Boolean} hidden
194      * Render this component hidden (default is <tt>true</tt>). If <tt>true</tt>, the
195      * {@link #hide} method will be called internally.
196      */
197     hidden : true,
198
199     /**
200     * @cfg {Boolean} monitorResize @hide
201     * This is automatically managed based on the value of constrain and constrainToHeader
202     */
203     monitorResize : true,
204
205     // The following configs are set to provide the basic functionality of a window.
206     // Changing them would require additional code to handle correctly and should
207     // usually only be done in subclasses that can provide custom behavior.  Changing them
208     // may have unexpected or undesirable results.
209     /** @cfg {String} elements @hide */
210     elements : 'header,body',
211     /** @cfg {Boolean} frame @hide */
212     frame : true,
213     /** @cfg {Boolean} floating @hide */
214     floating : true,
215
216     // private
217     initComponent : function(){
218         this.initTools();
219         Ext.Window.superclass.initComponent.call(this);
220         this.addEvents(
221             /**
222              * @event activate
223              * Fires after the window has been visually activated via {@link #setActive}.
224              * @param {Ext.Window} this
225              */
226             /**
227              * @event deactivate
228              * Fires after the window has been visually deactivated via {@link #setActive}.
229              * @param {Ext.Window} this
230              */
231             /**
232              * @event resize
233              * Fires after the window has been resized.
234              * @param {Ext.Window} this
235              * @param {Number} width The window's new width
236              * @param {Number} height The window's new height
237              */
238             'resize',
239             /**
240              * @event maximize
241              * Fires after the window has been maximized.
242              * @param {Ext.Window} this
243              */
244             'maximize',
245             /**
246              * @event minimize
247              * Fires after the window has been minimized.
248              * @param {Ext.Window} this
249              */
250             'minimize',
251             /**
252              * @event restore
253              * Fires after the window has been restored to its original size after being maximized.
254              * @param {Ext.Window} this
255              */
256             'restore'
257         );
258         // for backwards compat, this should be removed at some point
259         if(Ext.isDefined(this.initHidden)){
260             this.hidden = this.initHidden;
261         }
262         if(this.hidden === false){
263             this.hidden = true;
264             this.show();
265         }
266     },
267
268     // private
269     getState : function(){
270         return Ext.apply(Ext.Window.superclass.getState.call(this) || {}, this.getBox(true));
271     },
272
273     // private
274     onRender : function(ct, position){
275         Ext.Window.superclass.onRender.call(this, ct, position);
276
277         if(this.plain){
278             this.el.addClass('x-window-plain');
279         }
280
281         // this element allows the Window to be focused for keyboard events
282         this.focusEl = this.el.createChild({
283                     tag: 'a', href:'#', cls:'x-dlg-focus',
284                     tabIndex:'-1', html: '&#160;'});
285         this.focusEl.swallowEvent('click', true);
286
287         this.proxy = this.el.createProxy('x-window-proxy');
288         this.proxy.enableDisplayMode('block');
289
290         if(this.modal){
291             this.mask = this.container.createChild({cls:'ext-el-mask'}, this.el.dom);
292             this.mask.enableDisplayMode('block');
293             this.mask.hide();
294             this.mon(this.mask, 'click', this.focus, this);
295         }
296         if(this.maximizable){
297             this.mon(this.header, 'dblclick', this.toggleMaximize, this);
298         }
299     },
300
301     // private
302     initEvents : function(){
303         Ext.Window.superclass.initEvents.call(this);
304         if(this.animateTarget){
305             this.setAnimateTarget(this.animateTarget);
306         }
307
308         if(this.resizable){
309             this.resizer = new Ext.Resizable(this.el, {
310                 minWidth: this.minWidth,
311                 minHeight:this.minHeight,
312                 handles: this.resizeHandles || 'all',
313                 pinned: true,
314                 resizeElement : this.resizerAction
315             });
316             this.resizer.window = this;
317             this.mon(this.resizer, 'beforeresize', this.beforeResize, this);
318         }
319
320         if(this.draggable){
321             this.header.addClass('x-window-draggable');
322         }
323         this.mon(this.el, 'mousedown', this.toFront, this);
324         this.manager = this.manager || Ext.WindowMgr;
325         this.manager.register(this);
326         if(this.maximized){
327             this.maximized = false;
328             this.maximize();
329         }
330         if(this.closable){
331             var km = this.getKeyMap();
332             km.on(27, this.onEsc, this);
333             km.disable();
334         }
335     },
336
337     initDraggable : function(){
338         /**
339          * If this Window is configured {@link #draggable}, this property will contain
340          * an instance of {@link Ext.dd.DD} which handles dragging the Window's DOM Element.
341          * @type Ext.dd.DD
342          * @property dd
343          */
344         this.dd = new Ext.Window.DD(this);
345     },
346
347    // private
348     onEsc : function(){
349         this[this.closeAction]();
350     },
351
352     // private
353     beforeDestroy : function(){
354         if (this.rendered){
355             this.hide();
356           if(this.doAnchor){
357                 Ext.EventManager.removeResizeListener(this.doAnchor, this);
358               Ext.EventManager.un(window, 'scroll', this.doAnchor, this);
359             }
360             Ext.destroy(
361                 this.focusEl,
362                 this.resizer,
363                 this.dd,
364                 this.proxy,
365                 this.mask
366             );
367         }
368         Ext.Window.superclass.beforeDestroy.call(this);
369     },
370
371     // private
372     onDestroy : function(){
373         if(this.manager){
374             this.manager.unregister(this);
375         }
376         Ext.Window.superclass.onDestroy.call(this);
377     },
378
379     // private
380     initTools : function(){
381         if(this.minimizable){
382             this.addTool({
383                 id: 'minimize',
384                 handler: this.minimize.createDelegate(this, [])
385             });
386         }
387         if(this.maximizable){
388             this.addTool({
389                 id: 'maximize',
390                 handler: this.maximize.createDelegate(this, [])
391             });
392             this.addTool({
393                 id: 'restore',
394                 handler: this.restore.createDelegate(this, []),
395                 hidden:true
396             });
397         }
398         if(this.closable){
399             this.addTool({
400                 id: 'close',
401                 handler: this[this.closeAction].createDelegate(this, [])
402             });
403         }
404     },
405
406     // private
407     resizerAction : function(){
408         var box = this.proxy.getBox();
409         this.proxy.hide();
410         this.window.handleResize(box);
411         return box;
412     },
413
414     // private
415     beforeResize : function(){
416         this.resizer.minHeight = Math.max(this.minHeight, this.getFrameHeight() + 40); // 40 is a magic minimum content size?
417         this.resizer.minWidth = Math.max(this.minWidth, this.getFrameWidth() + 40);
418         this.resizeBox = this.el.getBox();
419     },
420
421     // private
422     updateHandles : function(){
423         if(Ext.isIE && this.resizer){
424             this.resizer.syncHandleHeight();
425             this.el.repaint();
426         }
427     },
428
429     // private
430     handleResize : function(box){
431         var rz = this.resizeBox;
432         if(rz.x != box.x || rz.y != box.y){
433             this.updateBox(box);
434         }else{
435             this.setSize(box);
436         }
437         this.focus();
438         this.updateHandles();
439         this.saveState();
440     },
441
442     /**
443      * Focuses the window.  If a defaultButton is set, it will receive focus, otherwise the
444      * window itself will receive focus.
445      */
446     focus : function(){
447         var f = this.focusEl, db = this.defaultButton, t = typeof db;
448         if(Ext.isDefined(db)){
449             if(Ext.isNumber(db) && this.fbar){
450                 f = this.fbar.items.get(db);
451             }else if(Ext.isString(db)){
452                 f = Ext.getCmp(db);
453             }else{
454                 f = db;
455             }
456         }
457         f = f || this.focusEl;
458         f.focus.defer(10, f);
459     },
460
461     /**
462      * Sets the target element from which the window should animate while opening.
463      * @param {String/Element} el The target element or id
464      */
465     setAnimateTarget : function(el){
466         el = Ext.get(el);
467         this.animateTarget = el;
468     },
469
470     // private
471     beforeShow : function(){
472         delete this.el.lastXY;
473         delete this.el.lastLT;
474         if(this.x === undefined || this.y === undefined){
475             var xy = this.el.getAlignToXY(this.container, 'c-c');
476             var pos = this.el.translatePoints(xy[0], xy[1]);
477             this.x = this.x === undefined? pos.left : this.x;
478             this.y = this.y === undefined? pos.top : this.y;
479         }
480         this.el.setLeftTop(this.x, this.y);
481
482         if(this.expandOnShow){
483             this.expand(false);
484         }
485
486         if(this.modal){
487             Ext.getBody().addClass('x-body-masked');
488             this.mask.setSize(Ext.lib.Dom.getViewWidth(true), Ext.lib.Dom.getViewHeight(true));
489             this.mask.show();
490         }
491     },
492
493     /**
494      * Shows the window, rendering it first if necessary, or activates it and brings it to front if hidden.
495      * @param {String/Element} animateTarget (optional) The target element or id from which the window should
496      * animate while opening (defaults to null with no animation)
497      * @param {Function} callback (optional) A callback function to call after the window is displayed
498      * @param {Object} scope (optional) The scope (<code>this</code> reference) in which the callback is executed. Defaults to this Window.
499      * @return {Ext.Window} this
500      */
501     show : function(animateTarget, cb, scope){
502         if(!this.rendered){
503             this.render(Ext.getBody());
504         }
505         if(this.hidden === false){
506             this.toFront();
507             return this;
508         }
509         if(this.fireEvent('beforeshow', this) === false){
510             return this;
511         }
512         if(cb){
513             this.on('show', cb, scope, {single:true});
514         }
515         this.hidden = false;
516         if(Ext.isDefined(animateTarget)){
517             this.setAnimateTarget(animateTarget);
518         }
519         this.beforeShow();
520         if(this.animateTarget){
521             this.animShow();
522         }else{
523             this.afterShow();
524         }
525         return this;
526     },
527
528     // private
529     afterShow : function(isAnim){
530         this.proxy.hide();
531         this.el.setStyle('display', 'block');
532         this.el.show();
533         if(this.maximized){
534             this.fitContainer();
535         }
536         if(Ext.isMac && Ext.isGecko2){ // work around stupid FF 2.0/Mac scroll bar bug
537             this.cascade(this.setAutoScroll);
538         }
539
540         if(this.monitorResize || this.modal || this.constrain || this.constrainHeader){
541             Ext.EventManager.onWindowResize(this.onWindowResize, this);
542         }
543         this.doConstrain();
544         this.doLayout();
545         if(this.keyMap){
546             this.keyMap.enable();
547         }
548         this.toFront();
549         this.updateHandles();
550         if(isAnim && (Ext.isIE || Ext.isWebKit)){
551             var sz = this.getSize();
552             this.onResize(sz.width, sz.height);
553         }
554         this.onShow();
555         this.fireEvent('show', this);
556     },
557
558     // private
559     animShow : function(){
560         this.proxy.show();
561         this.proxy.setBox(this.animateTarget.getBox());
562         this.proxy.setOpacity(0);
563         var b = this.getBox();
564         this.el.setStyle('display', 'none');
565         this.proxy.shift(Ext.apply(b, {
566             callback: this.afterShow.createDelegate(this, [true], false),
567             scope: this,
568             easing: 'easeNone',
569             duration: 0.25,
570             opacity: 0.5
571         }));
572     },
573
574     /**
575      * Hides the window, setting it to invisible and applying negative offsets.
576      * @param {String/Element} animateTarget (optional) The target element or id to which the window should
577      * animate while hiding (defaults to null with no animation)
578      * @param {Function} callback (optional) A callback function to call after the window is hidden
579      * @param {Object} scope (optional) The scope (<code>this</code> reference) in which the callback is executed. Defaults to this Window.
580      * @return {Ext.Window} this
581      */
582     hide : function(animateTarget, cb, scope){
583         if(this.hidden || this.fireEvent('beforehide', this) === false){
584             return this;
585         }
586         if(cb){
587             this.on('hide', cb, scope, {single:true});
588         }
589         this.hidden = true;
590         if(animateTarget !== undefined){
591             this.setAnimateTarget(animateTarget);
592         }
593         if(this.modal){
594             this.mask.hide();
595             Ext.getBody().removeClass('x-body-masked');
596         }
597         if(this.animateTarget){
598             this.animHide();
599         }else{
600             this.el.hide();
601             this.afterHide();
602         }
603         return this;
604     },
605
606     // private
607     afterHide : function(){
608         this.proxy.hide();
609         if(this.monitorResize || this.modal || this.constrain || this.constrainHeader){
610             Ext.EventManager.removeResizeListener(this.onWindowResize, this);
611         }
612         if(this.keyMap){
613             this.keyMap.disable();
614         }
615         this.onHide();
616         this.fireEvent('hide', this);
617     },
618
619     // private
620     animHide : function(){
621         this.proxy.setOpacity(0.5);
622         this.proxy.show();
623         var tb = this.getBox(false);
624         this.proxy.setBox(tb);
625         this.el.hide();
626         this.proxy.shift(Ext.apply(this.animateTarget.getBox(), {
627             callback: this.afterHide,
628             scope: this,
629             duration: 0.25,
630             easing: 'easeNone',
631             opacity: 0
632         }));
633     },
634
635     /**
636      * Method that is called immediately before the <code>show</code> event is fired.
637      * Defaults to <code>Ext.emptyFn</code>.
638      */
639     onShow : Ext.emptyFn,
640
641     /**
642      * Method that is called immediately before the <code>hide</code> event is fired.
643      * Defaults to <code>Ext.emptyFn</code>.
644      */
645     onHide : Ext.emptyFn,
646
647     // private
648     onWindowResize : function(){
649         if(this.maximized){
650             this.fitContainer();
651         }
652         if(this.modal){
653             this.mask.setSize('100%', '100%');
654             var force = this.mask.dom.offsetHeight;
655             this.mask.setSize(Ext.lib.Dom.getViewWidth(true), Ext.lib.Dom.getViewHeight(true));
656         }
657         this.doConstrain();
658     },
659
660     // private
661     doConstrain : function(){
662         if(this.constrain || this.constrainHeader){
663             var offsets;
664             if(this.constrain){
665                 offsets = {
666                     right:this.el.shadowOffset,
667                     left:this.el.shadowOffset,
668                     bottom:this.el.shadowOffset
669                 };
670             }else {
671                 var s = this.getSize();
672                 offsets = {
673                     right:-(s.width - 100),
674                     bottom:-(s.height - 25)
675                 };
676             }
677
678             var xy = this.el.getConstrainToXY(this.container, true, offsets);
679             if(xy){
680                 this.setPosition(xy[0], xy[1]);
681             }
682         }
683     },
684
685     // private - used for dragging
686     ghost : function(cls){
687         var ghost = this.createGhost(cls);
688         var box = this.getBox(true);
689         ghost.setLeftTop(box.x, box.y);
690         ghost.setWidth(box.width);
691         this.el.hide();
692         this.activeGhost = ghost;
693         return ghost;
694     },
695
696     // private
697     unghost : function(show, matchPosition){
698         if(!this.activeGhost) {
699             return;
700         }
701         if(show !== false){
702             this.el.show();
703             this.focus();
704             if(Ext.isMac && Ext.isGecko2){ // work around stupid FF 2.0/Mac scroll bar bug
705                 this.cascade(this.setAutoScroll);
706             }
707         }
708         if(matchPosition !== false){
709             this.setPosition(this.activeGhost.getLeft(true), this.activeGhost.getTop(true));
710         }
711         this.activeGhost.hide();
712         this.activeGhost.remove();
713         delete this.activeGhost;
714     },
715
716     /**
717      * Placeholder method for minimizing the window.  By default, this method simply fires the {@link #minimize} event
718      * since the behavior of minimizing a window is application-specific.  To implement custom minimize behavior,
719      * either the minimize event can be handled or this method can be overridden.
720      * @return {Ext.Window} this
721      */
722     minimize : function(){
723         this.fireEvent('minimize', this);
724         return this;
725     },
726
727     /**
728      * <p>Closes the Window, removes it from the DOM, {@link Ext.Component#destroy destroy}s
729      * the Window object and all its descendant Components. The {@link Ext.Panel#beforeclose beforeclose}
730      * event is fired before the close happens and will cancel the close action if it returns false.<p>
731      * <p><b>Note:</b> This method is not affected by the {@link #closeAction} setting which
732      * only affects the action triggered when clicking the {@link #closable 'close' tool in the header}.
733      * To hide the Window without destroying it, call {@link #hide}.</p>
734      */
735     close : function(){
736         if(this.fireEvent('beforeclose', this) !== false){
737             if(this.hidden){
738                 this.doClose();
739             }else{
740                 this.hide(null, this.doClose, this);
741             }
742         }
743     },
744
745     // private
746     doClose : function(){
747         this.fireEvent('close', this);
748         this.destroy();
749     },
750
751     /**
752      * Fits the window within its current container and automatically replaces
753      * the {@link #maximizable 'maximize' tool button} with the 'restore' tool button.
754      * Also see {@link #toggleMaximize}.
755      * @return {Ext.Window} this
756      */
757     maximize : function(){
758         if(!this.maximized){
759             this.expand(false);
760             this.restoreSize = this.getSize();
761             this.restorePos = this.getPosition(true);
762             if (this.maximizable){
763                 this.tools.maximize.hide();
764                 this.tools.restore.show();
765             }
766             this.maximized = true;
767             this.el.disableShadow();
768
769             if(this.dd){
770                 this.dd.lock();
771             }
772             if(this.collapsible){
773                 this.tools.toggle.hide();
774             }
775             this.el.addClass('x-window-maximized');
776             this.container.addClass('x-window-maximized-ct');
777
778             this.setPosition(0, 0);
779             this.fitContainer();
780             this.fireEvent('maximize', this);
781         }
782         return this;
783     },
784
785     /**
786      * Restores a {@link #maximizable maximized}  window back to its original
787      * size and position prior to being maximized and also replaces
788      * the 'restore' tool button with the 'maximize' tool button.
789      * Also see {@link #toggleMaximize}.
790      * @return {Ext.Window} this
791      */
792     restore : function(){
793         if(this.maximized){
794             var t = this.tools;
795             this.el.removeClass('x-window-maximized');
796             if(t.restore){
797                 t.restore.hide();
798             }
799             if(t.maximize){
800                 t.maximize.show();
801             }
802             this.setPosition(this.restorePos[0], this.restorePos[1]);
803             this.setSize(this.restoreSize.width, this.restoreSize.height);
804             delete this.restorePos;
805             delete this.restoreSize;
806             this.maximized = false;
807             this.el.enableShadow(true);
808
809             if(this.dd){
810                 this.dd.unlock();
811             }
812             if(this.collapsible && t.toggle){
813                 t.toggle.show();
814             }
815             this.container.removeClass('x-window-maximized-ct');
816
817             this.doConstrain();
818             this.fireEvent('restore', this);
819         }
820         return this;
821     },
822
823     /**
824      * A shortcut method for toggling between {@link #maximize} and {@link #restore} based on the current maximized
825      * state of the window.
826      * @return {Ext.Window} this
827      */
828     toggleMaximize : function(){
829         return this[this.maximized ? 'restore' : 'maximize']();
830     },
831
832     // private
833     fitContainer : function(){
834         var vs = this.container.getViewSize(false);
835         this.setSize(vs.width, vs.height);
836     },
837
838     // private
839     // z-index is managed by the WindowManager and may be overwritten at any time
840     setZIndex : function(index){
841         if(this.modal){
842             this.mask.setStyle('z-index', index);
843         }
844         this.el.setZIndex(++index);
845         index += 5;
846
847         if(this.resizer){
848             this.resizer.proxy.setStyle('z-index', ++index);
849         }
850
851         this.lastZIndex = index;
852     },
853
854     /**
855      * Aligns the window to the specified element
856      * @param {Mixed} element The element to align to.
857      * @param {String} position (optional, defaults to "tl-bl?") The position to align to (see {@link Ext.Element#alignTo} for more details).
858      * @param {Array} offsets (optional) Offset the positioning by [x, y]
859      * @return {Ext.Window} this
860      */
861     alignTo : function(element, position, offsets){
862         var xy = this.el.getAlignToXY(element, position, offsets);
863         this.setPagePosition(xy[0], xy[1]);
864         return this;
865     },
866
867     /**
868      * Anchors this window to another element and realigns it when the window is resized or scrolled.
869      * @param {Mixed} element The element to align to.
870      * @param {String} position The position to align to (see {@link Ext.Element#alignTo} for more details)
871      * @param {Array} offsets (optional) Offset the positioning by [x, y]
872      * @param {Boolean/Number} monitorScroll (optional) true to monitor body scroll and reposition. If this parameter
873      * is a number, it is used as the buffer delay (defaults to 50ms).
874      * @return {Ext.Window} this
875      */
876     anchorTo : function(el, alignment, offsets, monitorScroll){
877       if(this.doAnchor){
878           Ext.EventManager.removeResizeListener(this.doAnchor, this);
879           Ext.EventManager.un(window, 'scroll', this.doAnchor, this);
880       }
881       this.doAnchor = function(){
882           this.alignTo(el, alignment, offsets);
883       };
884       Ext.EventManager.onWindowResize(this.doAnchor, this);
885
886       var tm = typeof monitorScroll;
887       if(tm != 'undefined'){
888           Ext.EventManager.on(window, 'scroll', this.doAnchor, this,
889               {buffer: tm == 'number' ? monitorScroll : 50});
890       }
891       this.doAnchor();
892       return this;
893     },
894
895     /**
896      * Brings this window to the front of any other visible windows
897      * @param {Boolean} e (optional) Specify <tt>false</tt> to prevent the window from being focused.
898      * @return {Ext.Window} this
899      */
900     toFront : function(e){
901         if(this.manager.bringToFront(this)){
902             if(!e || !e.getTarget().focus){
903                 this.focus();
904             }
905         }
906         return this;
907     },
908
909     /**
910      * Makes this the active window by showing its shadow, or deactivates it by hiding its shadow.  This method also
911      * fires the {@link #activate} or {@link #deactivate} event depending on which action occurred. This method is
912      * called internally by {@link Ext.WindowMgr}.
913      * @param {Boolean} active True to activate the window, false to deactivate it (defaults to false)
914      */
915     setActive : function(active){
916         if(active){
917             if(!this.maximized){
918                 this.el.enableShadow(true);
919             }
920             this.fireEvent('activate', this);
921         }else{
922             this.el.disableShadow();
923             this.fireEvent('deactivate', this);
924         }
925     },
926
927     /**
928      * Sends this window to the back of (lower z-index than) any other visible windows
929      * @return {Ext.Window} this
930      */
931     toBack : function(){
932         this.manager.sendToBack(this);
933         return this;
934     },
935
936     /**
937      * Centers this window in the viewport
938      * @return {Ext.Window} this
939      */
940     center : function(){
941         var xy = this.el.getAlignToXY(this.container, 'c-c');
942         this.setPagePosition(xy[0], xy[1]);
943         return this;
944     }
945
946     /**
947      * @cfg {Boolean} autoWidth @hide
948      **/
949 });
950 Ext.reg('window', Ext.Window);
951
952 // private - custom Window DD implementation
953 Ext.Window.DD = function(win){
954     this.win = win;
955     Ext.Window.DD.superclass.constructor.call(this, win.el.id, 'WindowDD-'+win.id);
956     this.setHandleElId(win.header.id);
957     this.scroll = false;
958 };
959
960 Ext.extend(Ext.Window.DD, Ext.dd.DD, {
961     moveOnly:true,
962     headerOffsets:[100, 25],
963     startDrag : function(){
964         var w = this.win;
965         this.proxy = w.ghost();
966         if(w.constrain !== false){
967             var so = w.el.shadowOffset;
968             this.constrainTo(w.container, {right: so, left: so, bottom: so});
969         }else if(w.constrainHeader !== false){
970             var s = this.proxy.getSize();
971             this.constrainTo(w.container, {right: -(s.width-this.headerOffsets[0]), bottom: -(s.height-this.headerOffsets[1])});
972         }
973     },
974     b4Drag : Ext.emptyFn,
975
976     onDrag : function(e){
977         this.alignElWithMouse(this.proxy, e.getPageX(), e.getPageY());
978     },
979
980     endDrag : function(e){
981         this.win.unghost();
982         this.win.saveState();
983     }
984 });
985 /**
986  * @class Ext.WindowGroup
987  * An object that manages a group of {@link Ext.Window} instances and provides z-order management
988  * and window activation behavior.
989  * @constructor
990  */
991 Ext.WindowGroup = function(){
992     var list = {};
993     var accessList = [];
994     var front = null;
995
996     // private
997     var sortWindows = function(d1, d2){
998         return (!d1._lastAccess || d1._lastAccess < d2._lastAccess) ? -1 : 1;
999     };
1000
1001     // private
1002     var orderWindows = function(){
1003         var a = accessList, len = a.length;
1004         if(len > 0){
1005             a.sort(sortWindows);
1006             var seed = a[0].manager.zseed;
1007             for(var i = 0; i < len; i++){
1008                 var win = a[i];
1009                 if(win && !win.hidden){
1010                     win.setZIndex(seed + (i*10));
1011                 }
1012             }
1013         }
1014         activateLast();
1015     };
1016
1017     // private
1018     var setActiveWin = function(win){
1019         if(win != front){
1020             if(front){
1021                 front.setActive(false);
1022             }
1023             front = win;
1024             if(win){
1025                 win.setActive(true);
1026             }
1027         }
1028     };
1029
1030     // private
1031     var activateLast = function(){
1032         for(var i = accessList.length-1; i >=0; --i) {
1033             if(!accessList[i].hidden){
1034                 setActiveWin(accessList[i]);
1035                 return;
1036             }
1037         }
1038         // none to activate
1039         setActiveWin(null);
1040     };
1041
1042     return {
1043         /**
1044          * The starting z-index for windows in this WindowGroup (defaults to 9000)
1045          * @type Number The z-index value
1046          */
1047         zseed : 9000,
1048
1049         /**
1050          * <p>Registers a {@link Ext.Window Window} with this WindowManager. This should not
1051          * need to be called under normal circumstances. Windows are automatically registered
1052          * with a {@link Ext.Window#manager manager} at construction time.</p>
1053          * <p>Where this may be useful is moving Windows between two WindowManagers. For example,
1054          * to bring the Ext.MessageBox dialog under the same manager as the Desktop's
1055          * WindowManager in the desktop sample app:</p><code><pre>
1056 var msgWin = Ext.MessageBox.getDialog();
1057 MyDesktop.getDesktop().getManager().register(msgWin);
1058 </pre></code>
1059          * @param {Window} win The Window to register.
1060          */
1061         register : function(win){
1062             if(win.manager){
1063                 win.manager.unregister(win);
1064             }
1065             win.manager = this;
1066
1067             list[win.id] = win;
1068             accessList.push(win);
1069             win.on('hide', activateLast);
1070         },
1071
1072         /**
1073          * <p>Unregisters a {@link Ext.Window Window} from this WindowManager. This should not
1074          * need to be called. Windows are automatically unregistered upon destruction.
1075          * See {@link #register}.</p>
1076          * @param {Window} win The Window to unregister.
1077          */
1078         unregister : function(win){
1079             delete win.manager;
1080             delete list[win.id];
1081             win.un('hide', activateLast);
1082             accessList.remove(win);
1083         },
1084
1085         /**
1086          * Gets a registered window by id.
1087          * @param {String/Object} id The id of the window or a {@link Ext.Window} instance
1088          * @return {Ext.Window}
1089          */
1090         get : function(id){
1091             return typeof id == "object" ? id : list[id];
1092         },
1093
1094         /**
1095          * Brings the specified window to the front of any other active windows in this WindowGroup.
1096          * @param {String/Object} win The id of the window or a {@link Ext.Window} instance
1097          * @return {Boolean} True if the dialog was brought to the front, else false
1098          * if it was already in front
1099          */
1100         bringToFront : function(win){
1101             win = this.get(win);
1102             if(win != front){
1103                 win._lastAccess = new Date().getTime();
1104                 orderWindows();
1105                 return true;
1106             }
1107             return false;
1108         },
1109
1110         /**
1111          * Sends the specified window to the back of other active windows in this WindowGroup.
1112          * @param {String/Object} win The id of the window or a {@link Ext.Window} instance
1113          * @return {Ext.Window} The window
1114          */
1115         sendToBack : function(win){
1116             win = this.get(win);
1117             win._lastAccess = -(new Date().getTime());
1118             orderWindows();
1119             return win;
1120         },
1121
1122         /**
1123          * Hides all windows in this WindowGroup.
1124          */
1125         hideAll : function(){
1126             for(var id in list){
1127                 if(list[id] && typeof list[id] != "function" && list[id].isVisible()){
1128                     list[id].hide();
1129                 }
1130             }
1131         },
1132
1133         /**
1134          * Gets the currently-active window in this WindowGroup.
1135          * @return {Ext.Window} The active window
1136          */
1137         getActive : function(){
1138             return front;
1139         },
1140
1141         /**
1142          * Returns zero or more windows in this WindowGroup using the custom search function passed to this method.
1143          * The function should accept a single {@link Ext.Window} reference as its only argument and should
1144          * return true if the window matches the search criteria, otherwise it should return false.
1145          * @param {Function} fn The search function
1146          * @param {Object} scope (optional) The scope (<code>this</code> reference) in which the function is executed. Defaults to the Window being tested.
1147          * that gets passed to the function if not specified)
1148          * @return {Array} An array of zero or more matching windows
1149          */
1150         getBy : function(fn, scope){
1151             var r = [];
1152             for(var i = accessList.length-1; i >=0; --i) {
1153                 var win = accessList[i];
1154                 if(fn.call(scope||win, win) !== false){
1155                     r.push(win);
1156                 }
1157             }
1158             return r;
1159         },
1160
1161         /**
1162          * Executes the specified function once for every window in this WindowGroup, passing each
1163          * window as the only parameter. Returning false from the function will stop the iteration.
1164          * @param {Function} fn The function to execute for each item
1165          * @param {Object} scope (optional) The scope (<code>this</code> reference) in which the function is executed. Defaults to the current Window in the iteration.
1166          */
1167         each : function(fn, scope){
1168             for(var id in list){
1169                 if(list[id] && typeof list[id] != "function"){
1170                     if(fn.call(scope || list[id], list[id]) === false){
1171                         return;
1172                     }
1173                 }
1174             }
1175         }
1176     };
1177 };
1178
1179
1180 /**
1181  * @class Ext.WindowMgr
1182  * @extends Ext.WindowGroup
1183  * The default global window group that is available automatically.  To have more than one group of windows
1184  * with separate z-order stacks, create additional instances of {@link Ext.WindowGroup} as needed.
1185  * @singleton
1186  */
1187 Ext.WindowMgr = new Ext.WindowGroup();/**\r
1188  * @class Ext.MessageBox\r
1189  * <p>Utility class for generating different styles of message boxes.  The alias Ext.Msg can also be used.<p/>\r
1190  * <p>Note that the MessageBox is asynchronous.  Unlike a regular JavaScript <code>alert</code> (which will halt\r
1191  * browser execution), showing a MessageBox will not cause the code to stop.  For this reason, if you have code\r
1192  * that should only run <em>after</em> some user feedback from the MessageBox, you must use a callback function\r
1193  * (see the <code>function</code> parameter for {@link #show} for more details).</p>\r
1194  * <p>Example usage:</p>\r
1195  *<pre><code>\r
1196 // Basic alert:\r
1197 Ext.Msg.alert('Status', 'Changes saved successfully.');\r
1198 \r
1199 // Prompt for user data and process the result using a callback:\r
1200 Ext.Msg.prompt('Name', 'Please enter your name:', function(btn, text){\r
1201     if (btn == 'ok'){\r
1202         // process text value and close...\r
1203     }\r
1204 });\r
1205 \r
1206 // Show a dialog using config options:\r
1207 Ext.Msg.show({\r
1208    title:'Save Changes?',\r
1209    msg: 'You are closing a tab that has unsaved changes. Would you like to save your changes?',\r
1210    buttons: Ext.Msg.YESNOCANCEL,\r
1211    fn: processResult,\r
1212    animEl: 'elId',\r
1213    icon: Ext.MessageBox.QUESTION\r
1214 });\r
1215 </code></pre>\r
1216  * @singleton\r
1217  */\r
1218 Ext.MessageBox = function(){\r
1219     var dlg, opt, mask, waitTimer,\r
1220         bodyEl, msgEl, textboxEl, textareaEl, progressBar, pp, iconEl, spacerEl,\r
1221         buttons, activeTextEl, bwidth, bufferIcon = '', iconCls = '',\r
1222         buttonNames = ['ok', 'yes', 'no', 'cancel'];\r
1223 \r
1224     // private\r
1225     var handleButton = function(button){\r
1226         buttons[button].blur();\r
1227         if(dlg.isVisible()){\r
1228             dlg.hide();\r
1229             handleHide();\r
1230             Ext.callback(opt.fn, opt.scope||window, [button, activeTextEl.dom.value, opt], 1);\r
1231         }\r
1232     };\r
1233 \r
1234     // private\r
1235     var handleHide = function(){\r
1236         if(opt && opt.cls){\r
1237             dlg.el.removeClass(opt.cls);\r
1238         }\r
1239         progressBar.reset();        \r
1240     };\r
1241 \r
1242     // private\r
1243     var handleEsc = function(d, k, e){\r
1244         if(opt && opt.closable !== false){\r
1245             dlg.hide();\r
1246             handleHide();\r
1247         }\r
1248         if(e){\r
1249             e.stopEvent();\r
1250         }\r
1251     };\r
1252 \r
1253     // private\r
1254     var updateButtons = function(b){\r
1255         var width = 0,\r
1256             cfg;\r
1257         if(!b){\r
1258             Ext.each(buttonNames, function(name){\r
1259                 buttons[name].hide();\r
1260             });\r
1261             return width;\r
1262         }\r
1263         dlg.footer.dom.style.display = '';\r
1264         Ext.iterate(buttons, function(name, btn){\r
1265             cfg = b[name];\r
1266             if(cfg){\r
1267                 btn.show();\r
1268                 btn.setText(Ext.isString(cfg) ? cfg : Ext.MessageBox.buttonText[name]);\r
1269                 width += btn.getEl().getWidth() + 15;\r
1270             }else{\r
1271                 btn.hide();\r
1272             }\r
1273         });\r
1274         return width;\r
1275     };\r
1276 \r
1277     return {\r
1278         /**\r
1279          * Returns a reference to the underlying {@link Ext.Window} element\r
1280          * @return {Ext.Window} The window\r
1281          */\r
1282         getDialog : function(titleText){\r
1283            if(!dlg){\r
1284                 var btns = [];\r
1285                 \r
1286                 buttons = {};\r
1287                 Ext.each(buttonNames, function(name){\r
1288                     btns.push(buttons[name] = new Ext.Button({\r
1289                         text: this.buttonText[name],\r
1290                         handler: handleButton.createCallback(name),\r
1291                         hideMode: 'offsets'\r
1292                     }));\r
1293                 }, this);\r
1294                 dlg = new Ext.Window({\r
1295                     autoCreate : true,\r
1296                     title:titleText,\r
1297                     resizable:false,\r
1298                     constrain:true,\r
1299                     constrainHeader:true,\r
1300                     minimizable : false,\r
1301                     maximizable : false,\r
1302                     stateful: false,\r
1303                     modal: true,\r
1304                     shim:true,\r
1305                     buttonAlign:"center",\r
1306                     width:400,\r
1307                     height:100,\r
1308                     minHeight: 80,\r
1309                     plain:true,\r
1310                     footer:true,\r
1311                     closable:true,\r
1312                     close : function(){\r
1313                         if(opt && opt.buttons && opt.buttons.no && !opt.buttons.cancel){\r
1314                             handleButton("no");\r
1315                         }else{\r
1316                             handleButton("cancel");\r
1317                         }\r
1318                     },\r
1319                     fbar: new Ext.Toolbar({\r
1320                         items: btns,\r
1321                         enableOverflow: false\r
1322                     })\r
1323                 });\r
1324                 dlg.render(document.body);\r
1325                 dlg.getEl().addClass('x-window-dlg');\r
1326                 mask = dlg.mask;\r
1327                 bodyEl = dlg.body.createChild({\r
1328                     html:'<div class="ext-mb-icon"></div><div class="ext-mb-content"><span class="ext-mb-text"></span><br /><div class="ext-mb-fix-cursor"><input type="text" class="ext-mb-input" /><textarea class="ext-mb-textarea"></textarea></div></div>'\r
1329                 });\r
1330                 iconEl = Ext.get(bodyEl.dom.firstChild);\r
1331                 var contentEl = bodyEl.dom.childNodes[1];\r
1332                 msgEl = Ext.get(contentEl.firstChild);\r
1333                 textboxEl = Ext.get(contentEl.childNodes[2].firstChild);\r
1334                 textboxEl.enableDisplayMode();\r
1335                 textboxEl.addKeyListener([10,13], function(){\r
1336                     if(dlg.isVisible() && opt && opt.buttons){\r
1337                         if(opt.buttons.ok){\r
1338                             handleButton("ok");\r
1339                         }else if(opt.buttons.yes){\r
1340                             handleButton("yes");\r
1341                         }\r
1342                     }\r
1343                 });\r
1344                 textareaEl = Ext.get(contentEl.childNodes[2].childNodes[1]);\r
1345                 textareaEl.enableDisplayMode();\r
1346                 progressBar = new Ext.ProgressBar({\r
1347                     renderTo:bodyEl\r
1348                 });\r
1349                bodyEl.createChild({cls:'x-clear'});\r
1350             }\r
1351             return dlg;\r
1352         },\r
1353 \r
1354         /**\r
1355          * Updates the message box body text\r
1356          * @param {String} text (optional) Replaces the message box element's innerHTML with the specified string (defaults to\r
1357          * the XHTML-compliant non-breaking space character '&amp;#160;')\r
1358          * @return {Ext.MessageBox} this\r
1359          */\r
1360         updateText : function(text){\r
1361             if(!dlg.isVisible() && !opt.width){\r
1362                 dlg.setSize(this.maxWidth, 100); // resize first so content is never clipped from previous shows\r
1363             }\r
1364             msgEl.update(text || '&#160;');\r
1365 \r
1366             var iw = iconCls != '' ? (iconEl.getWidth() + iconEl.getMargins('lr')) : 0;\r
1367             var mw = msgEl.getWidth() + msgEl.getMargins('lr');\r
1368             var fw = dlg.getFrameWidth('lr');\r
1369             var bw = dlg.body.getFrameWidth('lr');\r
1370             if (Ext.isIE && iw > 0){\r
1371                 //3 pixels get subtracted in the icon CSS for an IE margin issue,\r
1372                 //so we have to add it back here for the overall width to be consistent\r
1373                 iw += 3;\r
1374             }\r
1375             var w = Math.max(Math.min(opt.width || iw+mw+fw+bw, this.maxWidth),\r
1376                         Math.max(opt.minWidth || this.minWidth, bwidth || 0));\r
1377 \r
1378             if(opt.prompt === true){\r
1379                 activeTextEl.setWidth(w-iw-fw-bw);\r
1380             }\r
1381             if(opt.progress === true || opt.wait === true){\r
1382                 progressBar.setSize(w-iw-fw-bw);\r
1383             }\r
1384             if(Ext.isIE && w == bwidth){\r
1385                 w += 4; //Add offset when the content width is smaller than the buttons.    \r
1386             }\r
1387             dlg.setSize(w, 'auto').center();\r
1388             return this;\r
1389         },\r
1390 \r
1391         /**\r
1392          * Updates a progress-style message box's text and progress bar. Only relevant on message boxes\r
1393          * initiated via {@link Ext.MessageBox#progress} or {@link Ext.MessageBox#wait},\r
1394          * or by calling {@link Ext.MessageBox#show} with progress: true.\r
1395          * @param {Number} value Any number between 0 and 1 (e.g., .5, defaults to 0)\r
1396          * @param {String} progressText The progress text to display inside the progress bar (defaults to '')\r
1397          * @param {String} msg The message box's body text is replaced with the specified string (defaults to undefined\r
1398          * so that any existing body text will not get overwritten by default unless a new value is passed in)\r
1399          * @return {Ext.MessageBox} this\r
1400          */\r
1401         updateProgress : function(value, progressText, msg){\r
1402             progressBar.updateProgress(value, progressText);\r
1403             if(msg){\r
1404                 this.updateText(msg);\r
1405             }\r
1406             return this;\r
1407         },\r
1408 \r
1409         /**\r
1410          * Returns true if the message box is currently displayed\r
1411          * @return {Boolean} True if the message box is visible, else false\r
1412          */\r
1413         isVisible : function(){\r
1414             return dlg && dlg.isVisible();\r
1415         },\r
1416 \r
1417         /**\r
1418          * Hides the message box if it is displayed\r
1419          * @return {Ext.MessageBox} this\r
1420          */\r
1421         hide : function(){\r
1422             var proxy = dlg ? dlg.activeGhost : null;\r
1423             if(this.isVisible() || proxy){\r
1424                 dlg.hide();\r
1425                 handleHide();\r
1426                 if (proxy){\r
1427                     // unghost is a private function, but i saw no better solution\r
1428                     // to fix the locking problem when dragging while it closes\r
1429                     dlg.unghost(false, false);\r
1430                 } \r
1431             }\r
1432             return this;\r
1433         },\r
1434 \r
1435         /**\r
1436          * Displays a new message box, or reinitializes an existing message box, based on the config options\r
1437          * passed in. All display functions (e.g. prompt, alert, etc.) on MessageBox call this function internally,\r
1438          * although those calls are basic shortcuts and do not support all of the config options allowed here.\r
1439          * @param {Object} config The following config options are supported: <ul>\r
1440          * <li><b>animEl</b> : String/Element<div class="sub-desc">An id or Element from which the message box should animate as it\r
1441          * opens and closes (defaults to undefined)</div></li>\r
1442          * <li><b>buttons</b> : Object/Boolean<div class="sub-desc">A button config object (e.g., Ext.MessageBox.OKCANCEL or {ok:'Foo',\r
1443          * cancel:'Bar'}), or false to not show any buttons (defaults to false)</div></li>\r
1444          * <li><b>closable</b> : Boolean<div class="sub-desc">False to hide the top-right close button (defaults to true). Note that\r
1445          * progress and wait dialogs will ignore this property and always hide the close button as they can only\r
1446          * be closed programmatically.</div></li>\r
1447          * <li><b>cls</b> : String<div class="sub-desc">A custom CSS class to apply to the message box's container element</div></li>\r
1448          * <li><b>defaultTextHeight</b> : Number<div class="sub-desc">The default height in pixels of the message box's multiline textarea\r
1449          * if displayed (defaults to 75)</div></li>\r
1450          * <li><b>fn</b> : Function<div class="sub-desc">A callback function which is called when the dialog is dismissed either\r
1451          * by clicking on the configured buttons, or on the dialog close button, or by pressing\r
1452          * the return button to enter input.\r
1453          * <p>Progress and wait dialogs will ignore this option since they do not respond to user\r
1454          * actions and can only be closed programmatically, so any required function should be called\r
1455          * by the same code after it closes the dialog. Parameters passed:<ul>\r
1456          * <li><b>buttonId</b> : String<div class="sub-desc">The ID of the button pressed, one of:<div class="sub-desc"><ul>\r
1457          * <li><tt>ok</tt></li>\r
1458          * <li><tt>yes</tt></li>\r
1459          * <li><tt>no</tt></li>\r
1460          * <li><tt>cancel</tt></li>\r
1461          * </ul></div></div></li>\r
1462          * <li><b>text</b> : String<div class="sub-desc">Value of the input field if either <tt><a href="#show-option-prompt" ext:member="show-option-prompt" ext:cls="Ext.MessageBox">prompt</a></tt>\r
1463          * or <tt><a href="#show-option-multiline" ext:member="show-option-multiline" ext:cls="Ext.MessageBox">multiline</a></tt> is true</div></li>\r
1464          * <li><b>opt</b> : Object<div class="sub-desc">The config object passed to show.</div></li>\r
1465          * </ul></p></div></li>\r
1466          * <li><b>scope</b> : Object<div class="sub-desc">The scope of the callback function</div></li>\r
1467          * <li><b>icon</b> : String<div class="sub-desc">A CSS class that provides a background image to be used as the body icon for the\r
1468          * dialog (e.g. Ext.MessageBox.WARNING or 'custom-class') (defaults to '')</div></li>\r
1469          * <li><b>iconCls</b> : String<div class="sub-desc">The standard {@link Ext.Window#iconCls} to\r
1470          * add an optional header icon (defaults to '')</div></li>\r
1471          * <li><b>maxWidth</b> : Number<div class="sub-desc">The maximum width in pixels of the message box (defaults to 600)</div></li>\r
1472          * <li><b>minWidth</b> : Number<div class="sub-desc">The minimum width in pixels of the message box (defaults to 100)</div></li>\r
1473          * <li><b>modal</b> : Boolean<div class="sub-desc">False to allow user interaction with the page while the message box is\r
1474          * displayed (defaults to true)</div></li>\r
1475          * <li><b>msg</b> : String<div class="sub-desc">A string that will replace the existing message box body text (defaults to the\r
1476          * XHTML-compliant non-breaking space character '&amp;#160;')</div></li>\r
1477          * <li><a id="show-option-multiline"></a><b>multiline</b> : Boolean<div class="sub-desc">\r
1478          * True to prompt the user to enter multi-line text (defaults to false)</div></li>\r
1479          * <li><b>progress</b> : Boolean<div class="sub-desc">True to display a progress bar (defaults to false)</div></li>\r
1480          * <li><b>progressText</b> : String<div class="sub-desc">The text to display inside the progress bar if progress = true (defaults to '')</div></li>\r
1481          * <li><a id="show-option-prompt"></a><b>prompt</b> : Boolean<div class="sub-desc">True to prompt the user to enter single-line text (defaults to false)</div></li>\r
1482          * <li><b>proxyDrag</b> : Boolean<div class="sub-desc">True to display a lightweight proxy while dragging (defaults to false)</div></li>\r
1483          * <li><b>title</b> : String<div class="sub-desc">The title text</div></li>\r
1484          * <li><b>value</b> : String<div class="sub-desc">The string value to set into the active textbox element if displayed</div></li>\r
1485          * <li><b>wait</b> : Boolean<div class="sub-desc">True to display a progress bar (defaults to false)</div></li>\r
1486          * <li><b>waitConfig</b> : Object<div class="sub-desc">A {@link Ext.ProgressBar#waitConfig} object (applies only if wait = true)</div></li>\r
1487          * <li><b>width</b> : Number<div class="sub-desc">The width of the dialog in pixels</div></li>\r
1488          * </ul>\r
1489          * Example usage:\r
1490          * <pre><code>\r
1491 Ext.Msg.show({\r
1492    title: 'Address',\r
1493    msg: 'Please enter your address:',\r
1494    width: 300,\r
1495    buttons: Ext.MessageBox.OKCANCEL,\r
1496    multiline: true,\r
1497    fn: saveAddress,\r
1498    animEl: 'addAddressBtn',\r
1499    icon: Ext.MessageBox.INFO\r
1500 });\r
1501 </code></pre>\r
1502          * @return {Ext.MessageBox} this\r
1503          */\r
1504         show : function(options){\r
1505             if(this.isVisible()){\r
1506                 this.hide();\r
1507             }\r
1508             opt = options;\r
1509             var d = this.getDialog(opt.title || "&#160;");\r
1510 \r
1511             d.setTitle(opt.title || "&#160;");\r
1512             var allowClose = (opt.closable !== false && opt.progress !== true && opt.wait !== true);\r
1513             d.tools.close.setDisplayed(allowClose);\r
1514             activeTextEl = textboxEl;\r
1515             opt.prompt = opt.prompt || (opt.multiline ? true : false);\r
1516             if(opt.prompt){\r
1517                 if(opt.multiline){\r
1518                     textboxEl.hide();\r
1519                     textareaEl.show();\r
1520                     textareaEl.setHeight(Ext.isNumber(opt.multiline) ? opt.multiline : this.defaultTextHeight);\r
1521                     activeTextEl = textareaEl;\r
1522                 }else{\r
1523                     textboxEl.show();\r
1524                     textareaEl.hide();\r
1525                 }\r
1526             }else{\r
1527                 textboxEl.hide();\r
1528                 textareaEl.hide();\r
1529             }\r
1530             activeTextEl.dom.value = opt.value || "";\r
1531             if(opt.prompt){\r
1532                 d.focusEl = activeTextEl;\r
1533             }else{\r
1534                 var bs = opt.buttons;\r
1535                 var db = null;\r
1536                 if(bs && bs.ok){\r
1537                     db = buttons["ok"];\r
1538                 }else if(bs && bs.yes){\r
1539                     db = buttons["yes"];\r
1540                 }\r
1541                 if (db){\r
1542                     d.focusEl = db;\r
1543                 }\r
1544             }\r
1545             if(opt.iconCls){\r
1546               d.setIconClass(opt.iconCls);\r
1547             }\r
1548             this.setIcon(Ext.isDefined(opt.icon) ? opt.icon : bufferIcon);\r
1549             bwidth = updateButtons(opt.buttons);\r
1550             progressBar.setVisible(opt.progress === true || opt.wait === true);\r
1551             this.updateProgress(0, opt.progressText);\r
1552             this.updateText(opt.msg);\r
1553             if(opt.cls){\r
1554                 d.el.addClass(opt.cls);\r
1555             }\r
1556             d.proxyDrag = opt.proxyDrag === true;\r
1557             d.modal = opt.modal !== false;\r
1558             d.mask = opt.modal !== false ? mask : false;\r
1559             if(!d.isVisible()){\r
1560                 // force it to the end of the z-index stack so it gets a cursor in FF\r
1561                 document.body.appendChild(dlg.el.dom);\r
1562                 d.setAnimateTarget(opt.animEl);\r
1563                 //workaround for window internally enabling keymap in afterShow\r
1564                 d.on('show', function(){\r
1565                     if(allowClose === true){\r
1566                         d.keyMap.enable();\r
1567                     }else{\r
1568                         d.keyMap.disable();\r
1569                     }\r
1570                 }, this, {single:true});\r
1571                 d.show(opt.animEl);\r
1572             }\r
1573             if(opt.wait === true){\r
1574                 progressBar.wait(opt.waitConfig);\r
1575             }\r
1576             return this;\r
1577         },\r
1578 \r
1579         /**\r
1580          * Adds the specified icon to the dialog.  By default, the class 'ext-mb-icon' is applied for default\r
1581          * styling, and the class passed in is expected to supply the background image url. Pass in empty string ('')\r
1582          * to clear any existing icon. This method must be called before the MessageBox is shown.\r
1583          * The following built-in icon classes are supported, but you can also pass in a custom class name:\r
1584          * <pre>\r
1585 Ext.MessageBox.INFO\r
1586 Ext.MessageBox.WARNING\r
1587 Ext.MessageBox.QUESTION\r
1588 Ext.MessageBox.ERROR\r
1589          *</pre>\r
1590          * @param {String} icon A CSS classname specifying the icon's background image url, or empty string to clear the icon\r
1591          * @return {Ext.MessageBox} this\r
1592          */\r
1593         setIcon : function(icon){\r
1594             if(!dlg){\r
1595                 bufferIcon = icon;\r
1596                 return;\r
1597             }\r
1598             bufferIcon = undefined;\r
1599             if(icon && icon != ''){\r
1600                 iconEl.removeClass('x-hidden');\r
1601                 iconEl.replaceClass(iconCls, icon);\r
1602                 bodyEl.addClass('x-dlg-icon');\r
1603                 iconCls = icon;\r
1604             }else{\r
1605                 iconEl.replaceClass(iconCls, 'x-hidden');\r
1606                 bodyEl.removeClass('x-dlg-icon');\r
1607                 iconCls = '';\r
1608             }\r
1609             return this;\r
1610         },\r
1611 \r
1612         /**\r
1613          * Displays a message box with a progress bar.  This message box has no buttons and is not closeable by\r
1614          * the user.  You are responsible for updating the progress bar as needed via {@link Ext.MessageBox#updateProgress}\r
1615          * and closing the message box when the process is complete.\r
1616          * @param {String} title The title bar text\r
1617          * @param {String} msg The message box body text\r
1618          * @param {String} progressText (optional) The text to display inside the progress bar (defaults to '')\r
1619          * @return {Ext.MessageBox} this\r
1620          */\r
1621         progress : function(title, msg, progressText){\r
1622             this.show({\r
1623                 title : title,\r
1624                 msg : msg,\r
1625                 buttons: false,\r
1626                 progress:true,\r
1627                 closable:false,\r
1628                 minWidth: this.minProgressWidth,\r
1629                 progressText: progressText\r
1630             });\r
1631             return this;\r
1632         },\r
1633 \r
1634         /**\r
1635          * Displays a message box with an infinitely auto-updating progress bar.  This can be used to block user\r
1636          * interaction while waiting for a long-running process to complete that does not have defined intervals.\r
1637          * You are responsible for closing the message box when the process is complete.\r
1638          * @param {String} msg The message box body text\r
1639          * @param {String} title (optional) The title bar text\r
1640          * @param {Object} config (optional) A {@link Ext.ProgressBar#waitConfig} object\r
1641          * @return {Ext.MessageBox} this\r
1642          */\r
1643         wait : function(msg, title, config){\r
1644             this.show({\r
1645                 title : title,\r
1646                 msg : msg,\r
1647                 buttons: false,\r
1648                 closable:false,\r
1649                 wait:true,\r
1650                 modal:true,\r
1651                 minWidth: this.minProgressWidth,\r
1652                 waitConfig: config\r
1653             });\r
1654             return this;\r
1655         },\r
1656 \r
1657         /**\r
1658          * Displays a standard read-only message box with an OK button (comparable to the basic JavaScript alert prompt).\r
1659          * If a callback function is passed it will be called after the user clicks the button, and the\r
1660          * id of the button that was clicked will be passed as the only parameter to the callback\r
1661          * (could also be the top-right close button).\r
1662          * @param {String} title The title bar text\r
1663          * @param {String} msg The message box body text\r
1664          * @param {Function} fn (optional) The callback function invoked after the message box is closed\r
1665          * @param {Object} scope (optional) The scope (<code>this</code> reference) in which the callback is executed. Defaults to the browser wnidow.\r
1666          * @return {Ext.MessageBox} this\r
1667          */\r
1668         alert : function(title, msg, fn, scope){\r
1669             this.show({\r
1670                 title : title,\r
1671                 msg : msg,\r
1672                 buttons: this.OK,\r
1673                 fn: fn,\r
1674                 scope : scope\r
1675             });\r
1676             return this;\r
1677         },\r
1678 \r
1679         /**\r
1680          * Displays a confirmation message box with Yes and No buttons (comparable to JavaScript's confirm).\r
1681          * If a callback function is passed it will be called after the user clicks either button,\r
1682          * and the id of the button that was clicked will be passed as the only parameter to the callback\r
1683          * (could also be the top-right close button).\r
1684          * @param {String} title The title bar text\r
1685          * @param {String} msg The message box body text\r
1686          * @param {Function} fn (optional) The callback function invoked after the message box is closed\r
1687          * @param {Object} scope (optional) The scope (<code>this</code> reference) in which the callback is executed. Defaults to the browser wnidow.\r
1688          * @return {Ext.MessageBox} this\r
1689          */\r
1690         confirm : function(title, msg, fn, scope){\r
1691             this.show({\r
1692                 title : title,\r
1693                 msg : msg,\r
1694                 buttons: this.YESNO,\r
1695                 fn: fn,\r
1696                 scope : scope,\r
1697                 icon: this.QUESTION\r
1698             });\r
1699             return this;\r
1700         },\r
1701 \r
1702         /**\r
1703          * Displays a message box with OK and Cancel buttons prompting the user to enter some text (comparable to JavaScript's prompt).\r
1704          * The prompt can be a single-line or multi-line textbox.  If a callback function is passed it will be called after the user\r
1705          * clicks either button, and the id of the button that was clicked (could also be the top-right\r
1706          * close button) and the text that was entered will be passed as the two parameters to the callback.\r
1707          * @param {String} title The title bar text\r
1708          * @param {String} msg The message box body text\r
1709          * @param {Function} fn (optional) The callback function invoked after the message box is closed\r
1710          * @param {Object} scope (optional) The scope (<code>this</code> reference) in which the callback is executed. Defaults to the browser wnidow.\r
1711          * @param {Boolean/Number} multiline (optional) True to create a multiline textbox using the defaultTextHeight\r
1712          * property, or the height in pixels to create the textbox (defaults to false / single-line)\r
1713          * @param {String} value (optional) Default value of the text input element (defaults to '')\r
1714          * @return {Ext.MessageBox} this\r
1715          */\r
1716         prompt : function(title, msg, fn, scope, multiline, value){\r
1717             this.show({\r
1718                 title : title,\r
1719                 msg : msg,\r
1720                 buttons: this.OKCANCEL,\r
1721                 fn: fn,\r
1722                 minWidth:250,\r
1723                 scope : scope,\r
1724                 prompt:true,\r
1725                 multiline: multiline,\r
1726                 value: value\r
1727             });\r
1728             return this;\r
1729         },\r
1730 \r
1731         /**\r
1732          * Button config that displays a single OK button\r
1733          * @type Object\r
1734          */\r
1735         OK : {ok:true},\r
1736         /**\r
1737          * Button config that displays a single Cancel button\r
1738          * @type Object\r
1739          */\r
1740         CANCEL : {cancel:true},\r
1741         /**\r
1742          * Button config that displays OK and Cancel buttons\r
1743          * @type Object\r
1744          */\r
1745         OKCANCEL : {ok:true, cancel:true},\r
1746         /**\r
1747          * Button config that displays Yes and No buttons\r
1748          * @type Object\r
1749          */\r
1750         YESNO : {yes:true, no:true},\r
1751         /**\r
1752          * Button config that displays Yes, No and Cancel buttons\r
1753          * @type Object\r
1754          */\r
1755         YESNOCANCEL : {yes:true, no:true, cancel:true},\r
1756         /**\r
1757          * The CSS class that provides the INFO icon image\r
1758          * @type String\r
1759          */\r
1760         INFO : 'ext-mb-info',\r
1761         /**\r
1762          * The CSS class that provides the WARNING icon image\r
1763          * @type String\r
1764          */\r
1765         WARNING : 'ext-mb-warning',\r
1766         /**\r
1767          * The CSS class that provides the QUESTION icon image\r
1768          * @type String\r
1769          */\r
1770         QUESTION : 'ext-mb-question',\r
1771         /**\r
1772          * The CSS class that provides the ERROR icon image\r
1773          * @type String\r
1774          */\r
1775         ERROR : 'ext-mb-error',\r
1776 \r
1777         /**\r
1778          * The default height in pixels of the message box's multiline textarea if displayed (defaults to 75)\r
1779          * @type Number\r
1780          */\r
1781         defaultTextHeight : 75,\r
1782         /**\r
1783          * The maximum width in pixels of the message box (defaults to 600)\r
1784          * @type Number\r
1785          */\r
1786         maxWidth : 600,\r
1787         /**\r
1788          * The minimum width in pixels of the message box (defaults to 100)\r
1789          * @type Number\r
1790          */\r
1791         minWidth : 100,\r
1792         /**\r
1793          * The minimum width in pixels of the message box if it is a progress-style dialog.  This is useful\r
1794          * for setting a different minimum width than text-only dialogs may need (defaults to 250)\r
1795          * @type Number\r
1796          */\r
1797         minProgressWidth : 250,\r
1798         /**\r
1799          * An object containing the default button text strings that can be overriden for localized language support.\r
1800          * Supported properties are: ok, cancel, yes and no.  Generally you should include a locale-specific\r
1801          * resource file for handling language support across the framework.\r
1802          * Customize the default text like so: Ext.MessageBox.buttonText.yes = "oui"; //french\r
1803          * @type Object\r
1804          */\r
1805         buttonText : {\r
1806             ok : "OK",\r
1807             cancel : "Cancel",\r
1808             yes : "Yes",\r
1809             no : "No"\r
1810         }\r
1811     };\r
1812 }();\r
1813 \r
1814 /**\r
1815  * Shorthand for {@link Ext.MessageBox}\r
1816  */\r
1817 Ext.Msg = Ext.MessageBox;/**\r
1818  * @class Ext.dd.PanelProxy\r
1819  * A custom drag proxy implementation specific to {@link Ext.Panel}s. This class is primarily used internally\r
1820  * for the Panel's drag drop implementation, and should never need to be created directly.\r
1821  * @constructor\r
1822  * @param panel The {@link Ext.Panel} to proxy for\r
1823  * @param config Configuration options\r
1824  */\r
1825 Ext.dd.PanelProxy = function(panel, config){\r
1826     this.panel = panel;\r
1827     this.id = this.panel.id +'-ddproxy';\r
1828     Ext.apply(this, config);\r
1829 };\r
1830 \r
1831 Ext.dd.PanelProxy.prototype = {\r
1832     /**\r
1833      * @cfg {Boolean} insertProxy True to insert a placeholder proxy element while dragging the panel,\r
1834      * false to drag with no proxy (defaults to true).\r
1835      */\r
1836     insertProxy : true,\r
1837 \r
1838     // private overrides\r
1839     setStatus : Ext.emptyFn,\r
1840     reset : Ext.emptyFn,\r
1841     update : Ext.emptyFn,\r
1842     stop : Ext.emptyFn,\r
1843     sync: Ext.emptyFn,\r
1844 \r
1845     /**\r
1846      * Gets the proxy's element\r
1847      * @return {Element} The proxy's element\r
1848      */\r
1849     getEl : function(){\r
1850         return this.ghost;\r
1851     },\r
1852 \r
1853     /**\r
1854      * Gets the proxy's ghost element\r
1855      * @return {Element} The proxy's ghost element\r
1856      */\r
1857     getGhost : function(){\r
1858         return this.ghost;\r
1859     },\r
1860 \r
1861     /**\r
1862      * Gets the proxy's element\r
1863      * @return {Element} The proxy's element\r
1864      */\r
1865     getProxy : function(){\r
1866         return this.proxy;\r
1867     },\r
1868 \r
1869     /**\r
1870      * Hides the proxy\r
1871      */\r
1872     hide : function(){\r
1873         if(this.ghost){\r
1874             if(this.proxy){\r
1875                 this.proxy.remove();\r
1876                 delete this.proxy;\r
1877             }\r
1878             this.panel.el.dom.style.display = '';\r
1879             this.ghost.remove();\r
1880             delete this.ghost;\r
1881         }\r
1882     },\r
1883 \r
1884     /**\r
1885      * Shows the proxy\r
1886      */\r
1887     show : function(){\r
1888         if(!this.ghost){\r
1889             this.ghost = this.panel.createGhost(undefined, undefined, Ext.getBody());\r
1890             this.ghost.setXY(this.panel.el.getXY())\r
1891             if(this.insertProxy){\r
1892                 this.proxy = this.panel.el.insertSibling({cls:'x-panel-dd-spacer'});\r
1893                 this.proxy.setSize(this.panel.getSize());\r
1894             }\r
1895             this.panel.el.dom.style.display = 'none';\r
1896         }\r
1897     },\r
1898 \r
1899     // private\r
1900     repair : function(xy, callback, scope){\r
1901         this.hide();\r
1902         if(typeof callback == "function"){\r
1903             callback.call(scope || this);\r
1904         }\r
1905     },\r
1906 \r
1907     /**\r
1908      * Moves the proxy to a different position in the DOM.  This is typically called while dragging the Panel\r
1909      * to keep the proxy sync'd to the Panel's location.\r
1910      * @param {HTMLElement} parentNode The proxy's parent DOM node\r
1911      * @param {HTMLElement} before (optional) The sibling node before which the proxy should be inserted (defaults\r
1912      * to the parent's last child if not specified)\r
1913      */\r
1914     moveProxy : function(parentNode, before){\r
1915         if(this.proxy){\r
1916             parentNode.insertBefore(this.proxy.dom, before);\r
1917         }\r
1918     }\r
1919 };\r
1920 \r
1921 // private - DD implementation for Panels\r
1922 Ext.Panel.DD = function(panel, cfg){\r
1923     this.panel = panel;\r
1924     this.dragData = {panel: panel};\r
1925     this.proxy = new Ext.dd.PanelProxy(panel, cfg);\r
1926     Ext.Panel.DD.superclass.constructor.call(this, panel.el, cfg);\r
1927     var h = panel.header;\r
1928     if(h){\r
1929         this.setHandleElId(h.id);\r
1930     }\r
1931     (h ? h : this.panel.body).setStyle('cursor', 'move');\r
1932     this.scroll = false;\r
1933 };\r
1934 \r
1935 Ext.extend(Ext.Panel.DD, Ext.dd.DragSource, {\r
1936     showFrame: Ext.emptyFn,\r
1937     startDrag: Ext.emptyFn,\r
1938     b4StartDrag: function(x, y) {\r
1939         this.proxy.show();\r
1940     },\r
1941     b4MouseDown: function(e) {\r
1942         var x = e.getPageX();\r
1943         var y = e.getPageY();\r
1944         this.autoOffset(x, y);\r
1945     },\r
1946     onInitDrag : function(x, y){\r
1947         this.onStartDrag(x, y);\r
1948         return true;\r
1949     },\r
1950     createFrame : Ext.emptyFn,\r
1951     getDragEl : function(e){\r
1952         return this.proxy.ghost.dom;\r
1953     },\r
1954     endDrag : function(e){\r
1955         this.proxy.hide();\r
1956         this.panel.saveState();\r
1957     },\r
1958 \r
1959     autoOffset : function(x, y) {\r
1960         x -= this.startPageX;\r
1961         y -= this.startPageY;\r
1962         this.setDelta(x, y);\r
1963     }\r
1964 });