Upgrade to ExtJS 3.3.0 - Released 10/06/2010
[extjs.git] / docs / output / Ext.WindowMgr.html
1 <div class="body-wrap" xmlns:ext="http://www.extjs.com"><div class="top-tools"><a class="inner-link" href="#Ext.WindowMgr-props"><img src="resources/images/default/s.gif" class="item-icon icon-prop">Properties</a>&#13;<a class="inner-link" href="#Ext.WindowMgr-methods"><img src="resources/images/default/s.gif" class="item-icon icon-method">Methods</a>&#13;<a class="inner-link" href="#Ext.WindowMgr-events"><img src="resources/images/default/s.gif" class="item-icon icon-event">Events</a>&#13;<a class="bookmark" href="../docs/?class=Ext.WindowMgr"><img src="resources/images/default/s.gif" class="item-icon icon-fav">Direct Link</a>&#13;</div><div class="inheritance res-block"><pre class="res-block-inner"><a href="output/Ext.WindowGroup.html" ext:member="" ext:cls="Ext.WindowGroup">WindowGroup</a>&#13;&nbsp;&nbsp;<img src="resources/elbow-end.gif">WindowMgr</pre></div><h1>Class <a href="source/WindowManager.html#cls-Ext.WindowMgr">Ext.WindowMgr</a></h1><table cellspacing="0"><tr><td class="label">Package:</td><td class="hd-info">Ext</td></tr><tr><td class="label">Defined In:</td><td class="hd-info"><a href="source/WindowManager.html#cls-Ext.WindowMgr">WindowManager.js</a></td></tr><tr><td class="label">Class:</td><td class="hd-info"><a href="source/WindowManager.html#cls-Ext.WindowMgr">WindowMgr</a></td></tr><tr><td class="label">Extends:</td><td class="hd-info"><a href="output/Ext.WindowGroup.html" ext:cls="Ext.WindowGroup" ext:member="">WindowGroup</a></td></tr></table><div class="description">The default global window group that is available automatically.  To have more than one group of windows
2 with separate z-order stacks, create additional instances of <a href="output/Ext.WindowGroup.html" ext:cls="Ext.WindowGroup">Ext.WindowGroup</a> as needed.<br><br><i>This class is a singleton and cannot be created directly.</i></div><div class="hr"></div><a id="Ext.WindowMgr-props"></a><h2>Public Properties</h2><table cellspacing="0" class="member-table"><tbody><tr><th colspan="2" class="sig-header">Property</th><th class="msource-header">Defined By</th></tr><tr class="property-row  inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.WindowGroup-zseed"></a><b><a href="source/WindowManager.html#prop-Ext.WindowGroup-zseed">zseed</a></b> : Number The z-index value<div class="mdesc">The starting z-index for windows in this WindowGroup (defaults to 9000)</div></td><td class="msource"><a href="output/Ext.WindowGroup.html#zseed" ext:member="#zseed" ext:cls="Ext.WindowGroup">WindowGroup</a></td></tr></tbody></table><a id="Ext.WindowMgr-methods"></a><h2>Public Methods</h2><table cellspacing="0" class="member-table"><tbody><tr><th colspan="2" class="sig-header">Method</th><th class="msource-header">Defined By</th></tr><tr class="method-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.WindowGroup-bringToFront"></a><b><a href="source/WindowManager.html#method-Ext.WindowGroup-bringToFront">bringToFront</a></b>(&nbsp;<code>String/Object&nbsp;win</code>&nbsp;)
3     :
4                                         Boolean<div class="mdesc"><div class="short">Brings the specified window to the front of any other active windows in this WindowGroup.</div><div class="long">Brings the specified window to the front of any other active windows in this WindowGroup.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>win</code> : String/Object<div class="sub-desc">The id of the window or a <a href="output/Ext.Window.html" ext:cls="Ext.Window">Ext.Window</a> instance</div></li></ul><strong>Returns:</strong><ul><li><code>Boolean</code><div class="sub-desc">True if the dialog was brought to the front, else false
5 if it was already in front</div></li></ul></div></div></div></td><td class="msource"><a href="output/Ext.WindowGroup.html#bringToFront" ext:member="#bringToFront" ext:cls="Ext.WindowGroup">WindowGroup</a></td></tr><tr class="method-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.WindowGroup-each"></a><b><a href="source/WindowManager.html#method-Ext.WindowGroup-each">each</a></b>(&nbsp;<code>Function&nbsp;fn</code>,&nbsp;<span title="Optional" class="optional">[<code>Object&nbsp;scope</code>]</span>&nbsp;)
6     :
7                                         void<div class="mdesc"><div class="short">Executes the specified function once for every window in this WindowGroup, passing each
8 window as the only parameter....</div><div class="long">Executes the specified function once for every window in this WindowGroup, passing each
9 window as the only parameter. Returning false from the function will stop the iteration.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>fn</code> : Function<div class="sub-desc">The function to execute for each item</div></li><li><code>scope</code> : Object<div class="sub-desc">(optional) The scope (<code>this</code> reference) in which the function is executed. Defaults to the current Window in the iteration.</div></li></ul><strong>Returns:</strong><ul><li>void</li></ul></div></div></div></td><td class="msource"><a href="output/Ext.WindowGroup.html#each" ext:member="#each" ext:cls="Ext.WindowGroup">WindowGroup</a></td></tr><tr class="method-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.WindowGroup-get"></a><b><a href="source/WindowManager.html#method-Ext.WindowGroup-get">get</a></b>(&nbsp;<code>String/Object&nbsp;id</code>&nbsp;)
10     :
11                                         Ext.Window<div class="mdesc"><div class="short">Gets a registered window by id.</div><div class="long">Gets a registered window by id.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>id</code> : String/Object<div class="sub-desc">The id of the window or a <a href="output/Ext.Window.html" ext:cls="Ext.Window">Ext.Window</a> instance</div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Window</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource"><a href="output/Ext.WindowGroup.html#get" ext:member="#get" ext:cls="Ext.WindowGroup">WindowGroup</a></td></tr><tr class="method-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.WindowGroup-getActive"></a><b><a href="source/WindowManager.html#method-Ext.WindowGroup-getActive">getActive</a></b>()
12     :
13                                         Ext.Window<div class="mdesc"><div class="short">Gets the currently-active window in this WindowGroup.</div><div class="long">Gets the currently-active window in this WindowGroup.<div class="mdetail-params"><strong>Parameters:</strong><ul><li>None.</li></ul><strong>Returns:</strong><ul><li><code>Ext.Window</code><div class="sub-desc">The active window</div></li></ul></div></div></div></td><td class="msource"><a href="output/Ext.WindowGroup.html#getActive" ext:member="#getActive" ext:cls="Ext.WindowGroup">WindowGroup</a></td></tr><tr class="method-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.WindowGroup-getBy"></a><b><a href="source/WindowManager.html#method-Ext.WindowGroup-getBy">getBy</a></b>(&nbsp;<code>Function&nbsp;fn</code>,&nbsp;<span title="Optional" class="optional">[<code>Object&nbsp;scope</code>]</span>&nbsp;)
14     :
15                                         Array<div class="mdesc"><div class="short">Returns zero or more windows in this WindowGroup using the custom search function passed to this method.
16 The function...</div><div class="long">Returns zero or more windows in this WindowGroup using the custom search function passed to this method.
17 The function should accept a single <a href="output/Ext.Window.html" ext:cls="Ext.Window">Ext.Window</a> reference as its only argument and should
18 return true if the window matches the search criteria, otherwise it should return false.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>fn</code> : Function<div class="sub-desc">The search function</div></li><li><code>scope</code> : Object<div class="sub-desc">(optional) The scope (<code>this</code> reference) in which the function is executed. Defaults to the Window being tested.
19 that gets passed to the function if not specified)</div></li></ul><strong>Returns:</strong><ul><li><code>Array</code><div class="sub-desc">An array of zero or more matching windows</div></li></ul></div></div></div></td><td class="msource"><a href="output/Ext.WindowGroup.html#getBy" ext:member="#getBy" ext:cls="Ext.WindowGroup">WindowGroup</a></td></tr><tr class="method-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.WindowGroup-hideAll"></a><b><a href="source/WindowManager.html#method-Ext.WindowGroup-hideAll">hideAll</a></b>()
20     :
21                                         void<div class="mdesc"><div class="short">Hides all windows in this WindowGroup.</div><div class="long">Hides all windows in this WindowGroup.<div class="mdetail-params"><strong>Parameters:</strong><ul><li>None.</li></ul><strong>Returns:</strong><ul><li>void</li></ul></div></div></div></td><td class="msource"><a href="output/Ext.WindowGroup.html#hideAll" ext:member="#hideAll" ext:cls="Ext.WindowGroup">WindowGroup</a></td></tr><tr class="method-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.WindowGroup-register"></a><b><a href="source/WindowManager.html#method-Ext.WindowGroup-register">register</a></b>(&nbsp;<code>Window&nbsp;win</code>&nbsp;)
22     :
23                                         void<div class="mdesc"><div class="short">Registers a Window with this WindowManager. This should not
24 need to be called under normal circumstances. Windows are...</div><div class="long"><p>Registers a <a href="output/Ext.Window.html" ext:cls="Ext.Window">Window</a> with this WindowManager. This should not
25 need to be called under normal circumstances. Windows are automatically registered
26 with a <a href="output/Ext.Window.html#Ext.Window-manager" ext:member="manager" ext:cls="Ext.Window">manager</a> at construction time.</p>
27 <p>Where this may be useful is moving Windows between two WindowManagers. For example,
28 to bring the Ext.MessageBox dialog under the same manager as the Desktop's
29 WindowManager in the desktop sample app:</p><code><pre>
30 <b>var</b> msgWin = Ext.MessageBox.getDialog();
31 MyDesktop.getDesktop().getManager().register(msgWin);
32 </pre></code><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>win</code> : Window<div class="sub-desc">The Window to register.</div></li></ul><strong>Returns:</strong><ul><li>void</li></ul></div></div></div></td><td class="msource"><a href="output/Ext.WindowGroup.html#register" ext:member="#register" ext:cls="Ext.WindowGroup">WindowGroup</a></td></tr><tr class="method-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.WindowGroup-sendToBack"></a><b><a href="source/WindowManager.html#method-Ext.WindowGroup-sendToBack">sendToBack</a></b>(&nbsp;<code>String/Object&nbsp;win</code>&nbsp;)
33     :
34                                         Ext.Window<div class="mdesc"><div class="short">Sends the specified window to the back of other active windows in this WindowGroup.</div><div class="long">Sends the specified window to the back of other active windows in this WindowGroup.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>win</code> : String/Object<div class="sub-desc">The id of the window or a <a href="output/Ext.Window.html" ext:cls="Ext.Window">Ext.Window</a> instance</div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Window</code><div class="sub-desc">The window</div></li></ul></div></div></div></td><td class="msource"><a href="output/Ext.WindowGroup.html#sendToBack" ext:member="#sendToBack" ext:cls="Ext.WindowGroup">WindowGroup</a></td></tr><tr class="method-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.WindowGroup-unregister"></a><b><a href="source/WindowManager.html#method-Ext.WindowGroup-unregister">unregister</a></b>(&nbsp;<code>Window&nbsp;win</code>&nbsp;)
35     :
36                                         void<div class="mdesc"><div class="short">Unregisters a Window from this WindowManager. This should not
37 need to be called. Windows are automatically unregister...</div><div class="long"><p>Unregisters a <a href="output/Ext.Window.html" ext:cls="Ext.Window">Window</a> from this WindowManager. This should not
38 need to be called. Windows are automatically unregistered upon destruction.
39 See <a href="output/Ext.WindowGroup.html#Ext.WindowGroup-register" ext:member="register" ext:cls="Ext.WindowGroup">register</a>.</p><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>win</code> : Window<div class="sub-desc">The Window to unregister.</div></li></ul><strong>Returns:</strong><ul><li>void</li></ul></div></div></div></td><td class="msource"><a href="output/Ext.WindowGroup.html#unregister" ext:member="#unregister" ext:cls="Ext.WindowGroup">WindowGroup</a></td></tr></tbody></table><a id="Ext.WindowMgr-events"></a><h2>Public Events</h2><div class="no-members">This class has no public events.</div></div>