commit extjs-2.2.1
[extjs.git] / docs / output / Ext.LoadMask.html
1         <div class="body-wrap">
2         <div class="top-tools">
3             <a class="inner-link" href="#Ext.LoadMask-props"><img src="../resources/images/default/s.gif" class="item-icon icon-prop">Properties</a>
4             <a class="inner-link" href="#Ext.LoadMask-methods"><img src="../resources/images/default/s.gif" class="item-icon icon-method">Methods</a>
5             <a class="inner-link" href="#Ext.LoadMask-events"><img src="../resources/images/default/s.gif" class="item-icon icon-event">Events</a>
6                             <a class="inner-link" href="#Ext.LoadMask-configs"><img src="../resources/images/default/s.gif" class="item-icon icon-config">Config Options</a>
7                         <a class="bookmark" href="../docs/?class=Ext.LoadMask"><img src="../resources/images/default/s.gif" class="item-icon icon-fav">Direct Link</a>
8         </div>
9                 <h1>Class Ext.LoadMask</h1>
10         <table cellspacing="0">
11             <tr><td class="label">Package:</td><td class="hd-info">Ext</td></tr>
12             <tr><td class="label">Defined In:</td><td class="hd-info"><a href="../src/LoadMask.js" target="_blank">LoadMask.js</a></td></tr>
13             <tr><td class="label">Class:</td><td class="hd-info">LoadMask</td></tr>
14                                     <tr><td class="label">Extends:</td><td class="hd-info">Object</td></tr>
15                     </table>
16         <div class="description">
17             *
18 A simple utility class for generically masking elements while loading data.  If the <a ext:cls="Ext.LoadMask" ext:member="store" href="output/Ext.LoadMask.html#store">store</a>
19 config option is specified, the masking will be automatically synchronized with the store's loading
20 process and the mask element will be cached for reuse.  For all other elements, this mask will replace the
21 element's Updater load indicator and will be destroyed after the initial load.
22 <p>Example usage:</p>
23 <pre><code><i>// Basic mask:</i>
24 <b>var</b> myMask = <b>new</b> Ext.LoadMask(Ext.getBody(), {msg:<em>"Please wait..."</em>});
25 myMask.show();</code></pre>        </div>
26         
27         <div class="hr"></div>
28                 <a id="Ext.LoadMask-configs"></a>
29         <h2>Config Options</h2>
30         <table cellspacing="0" class="member-table">
31             <tr>
32                 <th class="sig-header" colspan="2">Config Options</th>
33                 <th class="msource-header">Defined By</th>
34             </tr>
35                 <tr class="config-row">\r
36         <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
37         <td class="sig">\r
38         <a id="Ext.LoadMask-msg"></a>\r
39             <b>msg</b> : String            <div class="mdesc">\r
40                             The text to display in a centered loading message box (defaults to 'Loading...')                        </div>\r
41         </td>\r
42         <td class="msource">LoadMask</td>\r
43     </tr>\r
44         <tr class="config-row alt">\r
45         <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
46         <td class="sig">\r
47         <a id="Ext.LoadMask-msgCls"></a>\r
48             <b>msgCls</b> : String            <div class="mdesc">\r
49                             The CSS class to apply to the loading message element (defaults to "x-mask-loading")                        </div>\r
50         </td>\r
51         <td class="msource">LoadMask</td>\r
52     </tr>\r
53         <tr class="config-row expandable">\r
54         <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
55         <td class="sig">\r
56         <a id="Ext.LoadMask-removeMask"></a>\r
57             <b>removeMask</b> : Boolean            <div class="mdesc">\r
58                         <div class="short">True to create a single-use mask that is automatically destroyed after loading (useful for page loads), False to pers...</div>\r
59             <div class="long">\r
60                 True to create a single-use mask that is automatically destroyed after loading (useful for page loads), False to persist the mask element reference for multiple uses (e.g., for paged data widgets). Defaults to false.            </div>\r
61                         </div>\r
62         </td>\r
63         <td class="msource">LoadMask</td>\r
64     </tr>\r
65         <tr class="config-row alt expandable">\r
66         <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
67         <td class="sig">\r
68         <a id="Ext.LoadMask-store"></a>\r
69             <b>store</b> : Ext.data.Store            <div class="mdesc">\r
70                         <div class="short">Optional Store to which the mask is bound. The mask is displayed when a load request is issued, and hidden on either ...</div>\r
71             <div class="long">\r
72                 Optional Store to which the mask is bound. The mask is displayed when a load request is issued, and hidden on either load sucess, or load fail.            </div>\r
73                         </div>\r
74         </td>\r
75         <td class="msource">LoadMask</td>\r
76     </tr>\r
77             </table>
78                 <a id="Ext.LoadMask-props"></a>
79         <h2>Public Properties</h2>
80                 <table cellspacing="0" class="member-table">
81             <tr>
82                 <th class="sig-header" colspan="2">Property</th>
83                 <th class="msource-header">Defined By</th>
84             </tr>
85                 <tr class="property-row">\r
86         <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
87         <td class="sig">\r
88         <a id="Ext.LoadMask-disabled"></a>\r
89             <b>disabled</b> : Boolean            <div class="mdesc">\r
90                             Read-only. True if the mask is currently disabled so that it will not be displayed (defaults to false)                        </div>\r
91         </td>\r
92         <td class="msource">LoadMask</td>\r
93     </tr>\r
94             </table>
95                 <a id="Ext.LoadMask-methods"></a>
96         <h2>Public Methods</h2>
97                 <table cellspacing="0" class="member-table">
98             <tr>
99                 <th class="sig-header" colspan="2">Method</th>
100                 <th class="msource-header">Defined By</th>
101             </tr>
102                 <tr class="method-row expandable">\r
103         <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
104         <td class="sig">\r
105         <a id="Ext.LoadMask-LoadMask"></a>\r
106             <b>LoadMask</b>(&nbsp;<code>Mixed el</code>, <code>Object config</code>&nbsp;)            <div class="mdesc">\r
107                         <div class="short">Create a new LoadMask</div>\r
108             <div class="long">\r
109                 Create a new LoadMask    <div class="mdetail-params">\r
110         <strong>Parameters:</strong>\r
111         <ul><li><code>el</code> : Mixed<div class="sub-desc">The element or DOM node, or its id</div></li><li><code>config</code> : Object<div class="sub-desc">The config object</div></li>        </ul>\r
112         <strong>Returns:</strong>\r
113         <ul>\r
114             <li><code></code></li>\r
115         </ul>\r
116     </div>\r
117                 </div>\r
118                         </div>\r
119         </td>\r
120         <td class="msource">LoadMask</td>\r
121     </tr>\r
122         <tr class="method-row alt expandable">\r
123         <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
124         <td class="sig">\r
125         <a id="Ext.LoadMask-disable"></a>\r
126             <b>disable</b>() : void            <div class="mdesc">\r
127                         <div class="short">Disables the mask to prevent it from being displayed</div>\r
128             <div class="long">\r
129                 Disables the mask to prevent it from being displayed    <div class="mdetail-params">\r
130         <strong>Parameters:</strong>\r
131         <ul><li>None.</li>        </ul>\r
132         <strong>Returns:</strong>\r
133         <ul>\r
134             <li><code>void</code></li>\r
135         </ul>\r
136     </div>\r
137                 </div>\r
138                         </div>\r
139         </td>\r
140         <td class="msource">LoadMask</td>\r
141     </tr>\r
142         <tr class="method-row expandable">\r
143         <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
144         <td class="sig">\r
145         <a id="Ext.LoadMask-enable"></a>\r
146             <b>enable</b>() : void            <div class="mdesc">\r
147                         <div class="short">Enables the mask so that it can be displayed</div>\r
148             <div class="long">\r
149                 Enables the mask so that it can be displayed    <div class="mdetail-params">\r
150         <strong>Parameters:</strong>\r
151         <ul><li>None.</li>        </ul>\r
152         <strong>Returns:</strong>\r
153         <ul>\r
154             <li><code>void</code></li>\r
155         </ul>\r
156     </div>\r
157                 </div>\r
158                         </div>\r
159         </td>\r
160         <td class="msource">LoadMask</td>\r
161     </tr>\r
162         <tr class="method-row alt expandable">\r
163         <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
164         <td class="sig">\r
165         <a id="Ext.LoadMask-hide"></a>\r
166             <b>hide</b>() : void            <div class="mdesc">\r
167                         <div class="short">Hide this LoadMask.</div>\r
168             <div class="long">\r
169                 Hide this LoadMask.    <div class="mdetail-params">\r
170         <strong>Parameters:</strong>\r
171         <ul><li>None.</li>        </ul>\r
172         <strong>Returns:</strong>\r
173         <ul>\r
174             <li><code>void</code></li>\r
175         </ul>\r
176     </div>\r
177                 </div>\r
178                         </div>\r
179         </td>\r
180         <td class="msource">LoadMask</td>\r
181     </tr>\r
182         <tr class="method-row expandable">\r
183         <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
184         <td class="sig">\r
185         <a id="Ext.LoadMask-show"></a>\r
186             <b>show</b>() : void            <div class="mdesc">\r
187                         <div class="short">Show this LoadMask over the configured Element.</div>\r
188             <div class="long">\r
189                 Show this LoadMask over the configured Element.    <div class="mdetail-params">\r
190         <strong>Parameters:</strong>\r
191         <ul><li>None.</li>        </ul>\r
192         <strong>Returns:</strong>\r
193         <ul>\r
194             <li><code>void</code></li>\r
195         </ul>\r
196     </div>\r
197                 </div>\r
198                         </div>\r
199         </td>\r
200         <td class="msource">LoadMask</td>\r
201     </tr>\r
202             </table>
203                 <a id="Ext.LoadMask-events"></a>
204         <h2>Public Events</h2>
205         <div class="no-members">This class has no public events.</div>
206         </div>