Upgrade to ExtJS 3.1.1 - Released 02/08/2010
[extjs.git] / docs / output / Ext.WindowGroup.html
1 <div xmlns:ext="http://www.extjs.com" class="body-wrap"><h1>Class <a href="source/WindowManager.html#cls-Ext.WindowGroup">Ext.WindowGroup</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">WindowManager.js</td></tr><tr><td class="label">Class:</td><td class="hd-info"><a href="source/WindowManager.html#cls-Ext.WindowGroup">WindowGroup</a></td></tr><tr><td class="label">Subclasses:</td><td class="hd-info"><a href="output/Ext.WindowMgr.html" ext:cls="Ext.WindowMgr">WindowMgr</a></td></tr><tr><td class="label">Extends:</td><td class="hd-info">Object</td></tr></table><div class="description">An object that manages a group of <a href="output/Ext.Window.html" ext:cls="Ext.Window">Ext.Window</a> instances and provides z-order management
2 and window activation behavior.</div><div class="hr"></div><a id="Ext.WindowGroup-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  "><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">WindowGroup</td></tr></tbody></table><a id="Ext.WindowGroup-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"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.WindowGroup-WindowGroup"></a><b><a href="source/WindowManager.html#cls-Ext.WindowGroup">WindowGroup</a></b>()
3     <div class="mdesc"><div class="short"></div><div class="long"><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">WindowGroup</td></tr><tr class="method-row expandable "><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;)
4     :
5                                         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
6 if it was already in front</div></li></ul></div></div></div></td><td class="msource">WindowGroup</td></tr><tr class="method-row expandable "><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;)
7     :
8                                         void<div class="mdesc"><div class="short">Executes the specified function once for every window in this WindowGroup, passing each
9 window as the only parameter....</div><div class="long">Executes the specified function once for every window in this WindowGroup, passing each
10 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">WindowGroup</td></tr><tr class="method-row expandable "><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;)
11     :
12                                         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">WindowGroup</td></tr><tr class="method-row expandable "><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>()
13     :
14                                         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">WindowGroup</td></tr><tr class="method-row expandable "><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;)
15     :
16                                         Array<div class="mdesc"><div class="short">Returns zero or more windows in this WindowGroup using the custom search function passed to this method.
17 The function...</div><div class="long">Returns zero or more windows in this WindowGroup using the custom search function passed to this method.
18 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
19 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.
20 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">WindowGroup</td></tr><tr class="method-row expandable "><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>()
21     :
22                                         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">WindowGroup</td></tr><tr class="method-row expandable "><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;)
23     :
24                                         void<div class="mdesc"><div class="short">Registers a Window with this WindowManager. This should not
25 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
26 need to be called under normal circumstances. Windows are automatically registered
27 with a <a href="output/Ext.Window.html#Ext.Window-manager" ext:member="manager" ext:cls="Ext.Window">manager</a> at construction time.</p>
28 <p>Where this may be useful is moving Windows between two WindowManagers. For example,
29 to bring the Ext.MessageBox dialog under the same manager as the Desktop's
30 WindowManager in the desktop sample app:</p><code><pre>
31 <b>var</b> msgWin = Ext.MessageBox.getDialog();
32 MyDesktop.getDesktop().getManager().register(msgWin);
33 </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">WindowGroup</td></tr><tr class="method-row expandable "><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;)
34     :
35                                         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">WindowGroup</td></tr><tr class="method-row expandable "><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;)
36     :
37                                         void<div class="mdesc"><div class="short">Unregisters a Window from this WindowManager. This should not
38 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
39 need to be called. Windows are automatically unregistered upon destruction.
40 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">WindowGroup</td></tr></tbody></table><a id="Ext.WindowGroup-events"></a><h2>Public Events</h2><div class="no-members">This class has no public events.</div></div>