Upgrade to ExtJS 3.1.0 - Released 12/16/2009
[extjs.git] / docs / output / Ext.WindowMgr.html
index c660125..ade0d4b 100644 (file)
@@ -1,23 +1,39 @@
-<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">WindowManager.js</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><tr><td class="hd-info"></td></tr></table><div class="description">The default global window group that is available automatically.  To have more than one group of windows
-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 (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;)\r
+<div xmlns:ext="http://www.extjs.com" class="body-wrap"><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">WindowManager.js</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
+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;)\r
     :\r
-                                        Boolean<div class="mdesc"><div class="short">Brings the specified window to the front of any other active windows.</div><div class="long">Brings the specified window to the front of any other active windows.<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\r
+                                        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\r
 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;)\r
     :\r
-                                        void<div class="mdesc"><div class="short">Executes the specified function once for every window in the group, passing each\r
-window as the only parameter. Return...</div><div class="long">Executes the specified function once for every window in the group, passing each
-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 in which to execute the function</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;)\r
+                                        void<div class="mdesc"><div class="short">Executes the specified function once for every window in this WindowGroup, passing each\r
+window as the only parameter....</div><div class="long">Executes the specified function once for every window in this WindowGroup, passing each
+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;)\r
     :\r
                                         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>()\r
     :\r
-                                        Ext.Window<div class="mdesc"><div class="short">Gets the currently-active window in the group.</div><div class="long">Gets the currently-active window in the group.<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;)\r
+                                        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;)\r
     :\r
-                                        Array<div class="mdesc"><div class="short">Returns zero or more windows in the group using the custom search function passed to this method.\r
-The function should...</div><div class="long">Returns zero or more windows in the group using the custom search function passed to this method.
+                                        Array<div class="mdesc"><div class="short">Returns zero or more windows in this WindowGroup using the custom search function passed to this method.\r
+The function...</div><div class="long">Returns zero or more windows in this WindowGroup using the custom search function passed to this method.
 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
-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 in which to execute the function (defaults to the window
+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.
 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>()\r
     :\r
-                                        void<div class="mdesc"><div class="short">Hides all windows in the group.</div><div class="long">Hides all windows in the group.<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-sendToBack"></a><b><a href="source/WindowManager.html#method-Ext.WindowGroup-sendToBack">sendToBack</a></b>(&nbsp;<code>String/Object&nbsp;win</code>&nbsp;)\r
+                                        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;)\r
     :\r
-                                        Ext.Window<div class="mdesc"><div class="short">Sends the specified window to the back of other active windows.</div><div class="long">Sends the specified window to the back of other active windows.<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></tbody></table><a id="Ext.WindowMgr-events"></a><h2>Public Events</h2><div class="no-members">This class has no public events.</div></div>
\ No newline at end of file
+                                        void<div class="mdesc"><div class="short">Registers a Window with this WindowManager. This should not\r
+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
+need to be called under normal circumstances. Windows are automatically registered
+with a <a href="output/Ext.Window.html#Ext.Window-manager" ext:member="manager" ext:cls="Ext.Window">manager</a> at construction time.</p>
+<p>Where this may be useful is moving Windows between two WindowManagers. For example,
+to bring the Ext.MessageBox dialog under the same manager as the Desktop's
+WindowManager in the desktop sample app:</p><code><pre>
+<b>var</b> msgWin = Ext.MessageBox.getDialog();
+MyDesktop.getDesktop().getManager().register(msgWin);
+</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;)\r
+    :\r
+                                        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;)\r
+    :\r
+                                        void<div class="mdesc"><div class="short">Unregisters a Window from this WindowManager. This should not\r
+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
+need to be called. Windows are automatically unregistered upon destruction.
+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>
\ No newline at end of file