1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7 <meta http-equiv="content-type" content="text/html; charset=undefined" />
8 <meta name="generator" content="JsDoc Toolkit" />
11 <title>JsDoc Reference - Roo.UpdateManager</title>
14 <link rel="stylesheet" type="text/css" href="../../css/roojs.css" />
15 <link rel="stylesheet" type="text/css" href="../default.css" />
18 <script type="text/javascript" src="../page.js">
25 <body onload="RooDocsPage.onload();">
28 <div class="body-wrap">
30 <!-- ============================== links to methods. ================================= -->
32 <div class="top-tools">
34 <a class="inner-link" href="#Roo.UpdateManager-props"><img src="resources/s.gif" class="item-icon icon-prop">Properties</a>
35 <a class="inner-link" href="#Roo.UpdateManager-methods"><img src="resources/s.gif" class="item-icon icon-method">Methods</a>
36 <a class="inner-link" href="#Roo.UpdateManager-events"><img src="resources/s.gif" class="item-icon icon-event">Events</a>
37 <a class="inner-link" href="#Roo.UpdateManager-configs"><img src="resources/s.gif" class="item-icon icon-config">Config Options</a>
38 <a class="bookmark" href="NEED_TO_CREATE_DIRECT_LINK_HREF"><img src="resources/s.gif" class="item-icon icon-fav">Direct Link</a>
43 <!-- ============================== inheritance Block. ================================= -->
45 <div class="inheritance res-block">
46 <pre class="res-block-inner"><a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
47 <img src="../../images/default/s.gif" height="1" width="20"/><img class="elbow" src="../../images/default/tree/elbow-end.gif"/>Roo.UpdateManager
52 <!-- ============================== class title / details ============================ -->
55 <h1 class="classTitle">
57 Class Roo.UpdateManager
60 <table cellspacing="0" class="class-summary-table">
62 <tr><td class="label">Package:</td><td class="hd-info">Roo</td></tr>
64 <tr><td class="label">Defined In:</td><td class="hd-info">
66 <a href="./src/Roo_UpdateManager.js.html">Roo/UpdateManager.js</a>.
69 <tr><td class="label">Class:</td><td class="hd-info">UpdateManager</td></tr>
74 <tr><td class="label">Extends:</td><td class="hd-info">
75 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
83 <!-- ============================== class summary ========================== -->
84 <div class="description">
85 Provides AJAX-style update for Element object.<br><br><br/>Usage:<br><br/><pre><code><br/>// Get it from a Roo.Element object<br/>var el = Roo.get("foo");<br/>var mgr = el.getUpdateManager();<br/>mgr.update("http://myserver.com/index.php", "param1=1&param2=2");<br/>...<br/>mgr.formUpdate("myFormId", "http://myserver.com/index.php");<br/><br><br/>// or directly (returns the same UpdateManager instance)<br/>var mgr = new Roo.UpdateManager("myElementId");<br/>mgr.startAutoRefresh(60, "http://myserver.com/index.php");<br/>mgr.on("update", myFcnNeedsToKnow);<br/><br><br/> // short handed call directly from the element object<br/> Roo.get("foo").load({<br/> url: "bar.php",<br/> scripts:true,<br/> params: "for=bar",<br/> text: "Loading Foo..."<br/> });<br/></code></pre>
89 <!-- ============================== Class comment block... ========================== -->
91 <div class="comments">
92 <b>Class Comments / Notes</B> =>
93 <u onclick="parent.CommentDialog.showCommentId = 'Roo.UpdateManager';">[Add Your comment/notes about this class]</u>
95 <iframe frameborder="0" id="comments-Roo" style="border: none;width:100%;"
96 src="/blog.php/GtkDjsComments/Roo.UpdateManager.html"></iframe>
101 <!-- ============================== config options ========================== -->
106 <div class="hr"></div>
107 <a id="Roo.UpdateManager-configs"></a>
113 <table cellspacing="0" class="member-table">
114 <caption>Config Options (Usually are also Properties)</caption>
118 <th class="sig-header" colspan="2">Options</th>
120 <th class="msource-header">Defined By</th>
127 <tr class="config-row expandable config-row-alt0">
128 <td class="micon"><a class="exi" href="#expand"> </a></td>
131 <a id="Roo.util.Observable-cfg-listeners" name=".listeners"></a>
132 <div class="fixedFont">
133 <b class="itemname">listeners</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a>
139 <div class="short">list of events and functions to call for this object, <br/>For example :<br/><pre><code><br/> listeners : { <br/> 'click' : function(e) {<br/> .</div>
144 list of events and functions to call for this object, <br/>For example :<br/><pre><code><br/> listeners : { <br/> 'click' : function(e) {<br/> ..... <br/> } ,<br/> .... <br/> } <br/> </code></pre>
154 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
170 <!-- ============================== public properties ==================== -->
174 <a id="Roo.UpdateManager-props"></a>
180 <table cellspacing="0" class="member-table">
181 <caption class="Empty">Public Properties - Has None</caption>
187 <!-- ============================== methods summary / details ======================== -->
190 <a id="Roo.UpdateManager-methods"></a>
191 <!-- constructor?? -->
198 <!-- then dynamics first -->
205 <table cellspacing="0" class="member-table">
206 <caption>Public Methods</caption>
208 <th class="sig-header" colspan="2">Method</th>
209 <th class="msource-header">Defined By</th>
219 <tr class="method-row config-row-alt0 expandable notInherited">
220 <td class="micon"><a class="exi" href="#expand"> </a></td>
224 <a id="Roo-method-UpdateManager" name=".UpdateManager"></a>
225 <div class="fixedFont">
226 <span class="attributes">new <B>Roo.</B></span><b class="itemname">UpdateManager</b>
228 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/HTMLElement/Roo.Element <B><i>el</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a> <B><i>forceNew</i></B>)
236 <div class="short">Create a new Roo.UpdateManager</div>
243 Create a new Roo.UpdateManager
246 <dl class="detailList">
247 <dt class="heading">Parameters:</dt>
250 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/HTMLElement/Roo.Element</span> <b>el</b>
253 <dd>The element to update</dd>
256 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a></span> <b>forceNew</b>
259 <dd>(optional) By default the constructor checks to see if the passed element already has an UpdateManager and if it does it returns the same instance. This will skip that check (useful for extending this class).</dd>
283 <tr class="method-row config-row-alt1 expandable notInherited">
284 <td class="micon"><a class="exi" href="#expand"> </a></td>
288 <a id="Roo.UpdateManager-method-updateElement" name=".updateElement"></a>
289 <div class="fixedFont">
290 <span class="attributes">Roo.UpdateManager.</span><b class="itemname">updateElement</b>
292 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/HTMLElement/Roo.Element <B><i>el</i></B>, <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>url</i></B>, <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/Object <B><i>params</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>options</i></B>)
299 <div class="short">Static convenience method.</div>
305 Static convenience method. This method is deprecated in favor of el.load({url:'foo.php', ...}).<br/>Usage:<br/><pre><code>Roo.UpdateManager.updateElement("my-div", "stuff.php");</code></pre>
312 <dl class="detailList">
313 <dt class="heading">Parameters:</dt>
316 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/HTMLElement/Roo.Element</span> <b>el</b>
319 <dd>The element to update</dd>
322 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>url</b>
328 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/Object</span> <b>params</b>
331 <dd>(optional) Url encoded param string or an object of name/value pairs</dd>
334 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>options</b>
337 <dd>(optional) A config object with any of the UpdateManager properties you want to set - for example: {disableCaching:true, indicatorText: "Loading data..."}</dd>
363 <tr class="method-row config-row-alt0 expandable notInherited">
364 <td class="micon"><a class="exi" href="#expand"> </a></td>
368 <a id="Roo.UpdateManager-method-abort" name=".abort"></a>
369 <div class="fixedFont">
370 <span class="attributes"></span><b class="itemname">abort</b>
379 <div class="short">Aborts the executing transaction</div>
385 Aborts the executing transaction
414 <tr class="method-row config-row-alt1 expandable">
415 <td class="micon"><a class="exi" href="#expand"> </a></td>
419 <a id="Roo.util.Observable-method-addEvents" name=".addEvents"></a>
420 <div class="fixedFont">
421 <span class="attributes"></span><b class="itemname">addEvents</b>
423 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>object</i></B>)
430 <div class="short">Used to define events on this Observable</div>
436 Used to define events on this Observable
443 <dl class="detailList">
444 <dt class="heading">Parameters:</dt>
447 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>object</b>
450 <dd>The object with the events defined</dd>
470 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
476 <tr class="method-row config-row-alt0 expandable">
477 <td class="micon"><a class="exi" href="#expand"> </a></td>
481 <a id="Roo.util.Observable-method-addListener" name=".addListener"></a>
482 <div class="fixedFont">
483 <span class="attributes"></span><b class="itemname">addListener</b>
485 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>eventName</i></B>, <a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a> <B><i>handler</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>scope</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>options</i></B>)
492 <div class="short">Appends an event handler to this component</div>
498 Appends an event handler to this component
505 <dl class="detailList">
506 <dt class="heading">Parameters:</dt>
509 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
512 <dd>The type of event to listen for</dd>
515 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>handler</b>
518 <dd>The method the event invokes</dd>
521 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>scope</b>
524 <dd>(optional) The scope in which to execute the handler<br/>function. The handler function's "this" context.</dd>
527 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>options</b>
530 <dd>(optional) An object containing handler configuration<br/>properties. This may contain any of the following properties:<ul><br/><li>scope {Object} The scope in which to execute the handler function. The handler function's "this" context.</li><br/><li>delay {Number} The number of milliseconds to delay the invocation of the handler after te event fires.</li><br/><li>single {Boolean} True to add a handler to handle just the next firing of the event, and then remove itself.</li><br/><li>buffer {Number} Causes the handler to be scheduled to run in an {<b>link</b> Roo.util.DelayedTask} delayed<br/>by the specified number of milliseconds. If the event fires again within that time, the original<br/>handler is <em>not</em> invoked, but the new handler is scheduled in its place.</li><br/></ul><br><br/><p><br/><b>Combining Options</b><br><br/>Using the options argument, it is possible to combine different types of listeners:<br><br/><br><br/>A normalized, delayed, one-time listener that auto stops the event and passes a custom argument (forumId)<br/> <pre><code><br/> el.on('click', this.onClick, this, {<br/> single: true,<br/> delay: 100,<br/> forumId: 4<br/> });<br/> </code></pre><br/><p><br/><b>Attaching multiple handlers in 1 call</b><br><br/>The method also allows for a single argument to be passed which is a config object containing properties<br/>which specify multiple handlers.<br/><pre><code><br/> el.on({<br/> 'click': {<br/> fn: this.onClick,<br/> scope: this,<br/> delay: 100<br/> }, <br/> 'mouseover': {<br/> fn: this.onMouseOver,<br/> scope: this<br/> },<br/> 'mouseout': {<br/> fn: this.onMouseOut,<br/> scope: this<br/> }<br/> });<br/> </code></pre><br/><p><br/>Or a shorthand syntax which passes the same scope object to all handlers:<br/> <pre><code><br/> el.on({<br/> 'click': this.onClick,<br/> 'mouseover': this.onMouseOver,<br/> 'mouseout': this.onMouseOut,<br/> scope: this<br/> });<br/> </code></pre></dd>
550 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
556 <tr class="method-row config-row-alt1 expandable">
557 <td class="micon"><a class="exi" href="#expand"> </a></td>
561 <a id="Roo.util.Observable-method-fireEvent" name=".fireEvent"></a>
562 <div class="fixedFont">
563 <span class="attributes"></span><b class="itemname">fireEvent</b>
565 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>eventName</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object...</a> <B><i>args</i></B>)
571 <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
580 <div class="short">Fires the specified event with the passed parameters (minus the event name).</div>
586 Fires the specified event with the passed parameters (minus the event name).
593 <dl class="detailList">
594 <dt class="heading">Parameters:</dt>
597 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
603 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object...</a></span> <b>args</b>
606 <dd>Variable number of parameters are passed to handlers</dd>
614 <dl class="detailList">
615 <dt class="heading">Returns:</dt>
617 <dd><span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a></span> returns false if any of the handlers return false otherwise it returns true</dd>
633 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
639 <tr class="method-row config-row-alt0 expandable notInherited">
640 <td class="micon"><a class="exi" href="#expand"> </a></td>
644 <a id="Roo.UpdateManager-method-formUpdate" name=".formUpdate"></a>
645 <div class="fixedFont">
646 <span class="attributes"></span><b class="itemname">formUpdate</b>
648 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/HTMLElement <B><i>form</i></B>, <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>url</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a> <B><i>reset</i></B>, <a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a> <B><i>callback</i></B>)
655 <div class="short">Performs an async form post, updating this element with the response.</div>
661 Performs an async form post, updating this element with the response. If the form has the attribute enctype="multipart/form-data", it assumes it's a file upload.<br/>Uses this.sslBlankUrl for SSL file uploads to prevent IE security warning.
668 <dl class="detailList">
669 <dt class="heading">Parameters:</dt>
672 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/HTMLElement</span> <b>form</b>
675 <dd>The form Id or form element</dd>
678 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>url</b>
681 <dd>(optional) The url to pass the form to. If omitted the action attribute on the form will be used.</dd>
684 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a></span> <b>reset</b>
687 <dd>(optional) Whether to try to reset the form after the update</dd>
690 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>callback</b>
693 <dd>(optional) Callback when transaction is complete - called with signature (oElement, bSuccess, oResponse)</dd>
719 <tr class="method-row config-row-alt1 expandable notInherited">
720 <td class="micon"><a class="exi" href="#expand"> </a></td>
724 <a id="Roo.UpdateManager-method-getEl" name=".getEl"></a>
725 <div class="fixedFont">
726 <span class="attributes"></span><b class="itemname">getEl</b>
734 <a href="./Roo.Element.html#constructor" roo:cls="Roo.Element.html#constructor">Roo.Element</a>
743 <div class="short">Get the Element this UpdateManager is bound to</div>
749 Get the Element this UpdateManager is bound to
760 <dl class="detailList">
761 <dt class="heading">Returns:</dt>
763 <dd><span class="fixedFont"><a href="./Roo.Element.html#constructor" roo:cls="Roo.Element.html#constructor">Roo.Element</a></span> The element</dd>
785 <tr class="method-row config-row-alt0 expandable">
786 <td class="micon"><a class="exi" href="#expand"> </a></td>
790 <a id="Roo.util.Observable-method-hasListener" name=".hasListener"></a>
791 <div class="fixedFont">
792 <span class="attributes"></span><b class="itemname">hasListener</b>
794 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>eventName</i></B>)
800 <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
809 <div class="short">Checks to see if this object has any listeners for a specified event</div>
815 Checks to see if this object has any listeners for a specified event
822 <dl class="detailList">
823 <dt class="heading">Parameters:</dt>
826 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
829 <dd>The name of the event to check for</dd>
837 <dl class="detailList">
838 <dt class="heading">Returns:</dt>
840 <dd><span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a></span> True if the event is being listened for, else false</dd>
856 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
862 <tr class="method-row config-row-alt1 expandable notInherited">
863 <td class="micon"><a class="exi" href="#expand"> </a></td>
867 <a id="Roo.UpdateManager-method-isUpdating" name=".isUpdating"></a>
868 <div class="fixedFont">
869 <span class="attributes"></span><b class="itemname">isUpdating</b>
877 <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
886 <div class="short">Returns true if an update is in progress</div>
892 Returns true if an update is in progress
903 <dl class="detailList">
904 <dt class="heading">Returns:</dt>
906 <dd><span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a></span> </dd>
928 <tr class="method-row config-row-alt0 expandable">
929 <td class="micon"><a class="exi" href="#expand"> </a></td>
933 <a id="Roo.util.Observable-method-on" name=".on"></a>
934 <div class="fixedFont">
935 <span class="attributes"></span><b class="itemname">on</b>
937 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>eventName</i></B>, <a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a> <B><i>handler</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>scope</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>options</i></B>)
944 <div class="short">Appends an event handler to this element (shorthand for addListener)</div>
950 Appends an event handler to this element (shorthand for addListener)
957 <dl class="detailList">
958 <dt class="heading">Parameters:</dt>
961 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
964 <dd>The type of event to listen for</dd>
967 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>handler</b>
970 <dd>The method the event invokes</dd>
973 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>scope</b>
976 <dd>(optional) The scope in which to execute the handler<br/>function. The handler function's "this" context.</dd>
979 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>options</b>
1000 <td class="msource">
1002 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
1008 <tr class="method-row config-row-alt1 expandable">
1009 <td class="micon"><a class="exi" href="#expand"> </a></td>
1013 <a id="Roo.util.Observable-method-purgeListeners" name=".purgeListeners"></a>
1014 <div class="fixedFont">
1015 <span class="attributes"></span><b class="itemname">purgeListeners</b>
1024 <div class="short">Removes all listeners for this object</div>
1030 Removes all listeners for this object
1051 <td class="msource">
1053 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
1059 <tr class="method-row config-row-alt0 expandable notInherited">
1060 <td class="micon"><a class="exi" href="#expand"> </a></td>
1064 <a id="Roo.UpdateManager-method-refresh" name=".refresh"></a>
1065 <div class="fixedFont">
1066 <span class="attributes"></span><b class="itemname">refresh</b>
1068 (<a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a> <B><i>callback</i></B>)
1075 <div class="short">Refresh the element with the last used url or defaultUrl.</div>
1081 Refresh the element with the last used url or defaultUrl. If there is no url, it returns immediately
1088 <dl class="detailList">
1089 <dt class="heading">Parameters:</dt>
1092 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>callback</b>
1095 <dd>(optional) Callback when transaction is complete - called with signature (oElement, bSuccess)</dd>
1113 <td class="msource">
1121 <tr class="method-row config-row-alt1 expandable">
1122 <td class="micon"><a class="exi" href="#expand"> </a></td>
1126 <a id="Roo.util.Observable-method-removeListener" name=".removeListener"></a>
1127 <div class="fixedFont">
1128 <span class="attributes"></span><b class="itemname">removeListener</b>
1130 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>eventName</i></B>, <a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a> <B><i>handler</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>scope</i></B>)
1137 <div class="short">Removes a listener</div>
1150 <dl class="detailList">
1151 <dt class="heading">Parameters:</dt>
1154 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
1157 <dd>The type of event to listen for</dd>
1160 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>handler</b>
1163 <dd>The handler to remove</dd>
1166 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>scope</b>
1169 <dd>(optional) The scope (this object) for the handler</dd>
1187 <td class="msource">
1189 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
1195 <tr class="method-row config-row-alt0 expandable notInherited">
1196 <td class="micon"><a class="exi" href="#expand"> </a></td>
1200 <a id="Roo.UpdateManager-method-setDefaultUrl" name=".setDefaultUrl"></a>
1201 <div class="fixedFont">
1202 <span class="attributes"></span><b class="itemname">setDefaultUrl</b>
1204 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/Function <B><i>defaultUrl</i></B>)
1211 <div class="short">Set the defaultUrl used for updates</div>
1217 Set the defaultUrl used for updates
1224 <dl class="detailList">
1225 <dt class="heading">Parameters:</dt>
1228 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/Function</span> <b>defaultUrl</b>
1231 <dd>The url or a function to call to get the url</dd>
1249 <td class="msource">
1257 <tr class="method-row config-row-alt1 expandable notInherited">
1258 <td class="micon"><a class="exi" href="#expand"> </a></td>
1262 <a id="Roo.UpdateManager-method-setRenderer" name=".setRenderer"></a>
1263 <div class="fixedFont">
1264 <span class="attributes"></span><b class="itemname">setRenderer</b>
1266 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>renderer</i></B>)
1273 <div class="short">Set the content renderer for this UpdateManager.</div>
1279 Set the content renderer for this UpdateManager. See {<b>link</b> Roo.UpdateManager.BasicRenderer<b>render</b>} for more details.
1286 <dl class="detailList">
1287 <dt class="heading">Parameters:</dt>
1290 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>renderer</b>
1293 <dd>The object implementing the render() method</dd>
1311 <td class="msource">
1319 <tr class="method-row config-row-alt0 expandable notInherited">
1320 <td class="micon"><a class="exi" href="#expand"> </a></td>
1324 <a id="Roo.UpdateManager-method-showLoading" name=".showLoading"></a>
1325 <div class="fixedFont">
1326 <span class="attributes"></span><b class="itemname">showLoading</b>
1335 <div class="short">Called to update the element to "Loading" state.</div>
1341 Called to update the element to "Loading" state. Override to perform custom action.
1362 <td class="msource">
1370 <tr class="method-row config-row-alt1 expandable notInherited">
1371 <td class="micon"><a class="exi" href="#expand"> </a></td>
1375 <a id="Roo.UpdateManager-method-startAutoRefresh" name=".startAutoRefresh"></a>
1376 <div class="fixedFont">
1377 <span class="attributes"></span><b class="itemname">startAutoRefresh</b>
1379 (<a href="./Number.html#constructor" roo:cls="Number.html#constructor">Number</a> <B><i>interval</i></B>, <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/Function <B><i>url</i></B>, <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/Object <B><i>params</i></B>, <a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a> <B><i>callback</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a> <B><i>refreshNow</i></B>)
1386 <div class="short">Set this element to auto refresh.</div>
1392 Set this element to auto refresh.
1399 <dl class="detailList">
1400 <dt class="heading">Parameters:</dt>
1403 <span class="fixedFont"><a href="./Number.html#constructor" roo:cls="Number.html#constructor">Number</a></span> <b>interval</b>
1406 <dd>How often to update (in seconds).</dd>
1409 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/Function</span> <b>url</b>
1412 <dd>(optional) The url for this request or a function to call to get the url (Defaults to the last used url)</dd>
1415 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/Object</span> <b>params</b>
1418 <dd>(optional) The parameters to pass as either a url encoded string "¶m1=1¶m2=2" or as an object {param1: 1, param2: 2}</dd>
1421 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>callback</b>
1424 <dd>(optional) Callback when transaction is complete - called with signature (oElement, bSuccess)</dd>
1427 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a></span> <b>refreshNow</b>
1430 <dd>(optional) Whether to execute the refresh now, or wait the interval</dd>
1448 <td class="msource">
1456 <tr class="method-row config-row-alt0 expandable notInherited">
1457 <td class="micon"><a class="exi" href="#expand"> </a></td>
1461 <a id="Roo.UpdateManager-method-stopAutoRefresh" name=".stopAutoRefresh"></a>
1462 <div class="fixedFont">
1463 <span class="attributes"></span><b class="itemname">stopAutoRefresh</b>
1472 <div class="short">Stop auto refresh on this element.</div>
1478 Stop auto refresh on this element.
1499 <td class="msource">
1507 <tr class="method-row config-row-alt1 expandable">
1508 <td class="micon"><a class="exi" href="#expand"> </a></td>
1512 <a id="Roo.util.Observable-method-un" name=".un"></a>
1513 <div class="fixedFont">
1514 <span class="attributes"></span><b class="itemname">un</b>
1516 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>eventName</i></B>, <a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a> <B><i>handler</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>scope</i></B>)
1523 <div class="short">Removes a listener (shorthand for removeListener)</div>
1529 Removes a listener (shorthand for removeListener)
1536 <dl class="detailList">
1537 <dt class="heading">Parameters:</dt>
1540 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
1543 <dd>The type of event to listen for</dd>
1546 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>handler</b>
1549 <dd>The handler to remove</dd>
1552 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>scope</b>
1555 <dd>(optional) The scope (this object) for the handler</dd>
1573 <td class="msource">
1575 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
1581 <tr class="method-row config-row-alt0 expandable notInherited">
1582 <td class="micon"><a class="exi" href="#expand"> </a></td>
1586 <a id="Roo.UpdateManager-method-update" name=".update"></a>
1587 <div class="fixedFont">
1588 <span class="attributes"></span><b class="itemname">update</b>
1590 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a>/String/Function <B><i>url</i></B>, <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/Object <B><i>params</i></B>, <a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a> <B><i>callback</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a> <B><i>discardUrl</i></B>)
1597 <div class="short">Performs an async request, updating this element with the response.</div>
1603 Performs an async request, updating this element with the response. If params are specified it uses POST, otherwise it uses GET.
1610 <dl class="detailList">
1611 <dt class="heading">Parameters:</dt>
1614 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a>/String/Function</span> <b>url</b>
1617 <dd>The url for this request or a function to call to get the url or a config object containing any of the following options:<br/><pre><code><br/>um.update({<br/><br/> url: "your-url.php",<br/><br/> params: {param1: "foo", param2: "bar"}, // or a URL encoded string<br/><br/> callback: yourFunction,<br/><br/> scope: yourObject, //(optional scope) <br/><br/> discardUrl: false, <br/><br/> nocache: false,<br/><br/> text: "Loading...",<br/><br/> timeout: 30,<br/><br/> scripts: false<br/><br/>});<br/></code></pre><br/>The only required property is url. The optional properties nocache, text and scripts<br/>are shorthand for disableCaching, indicatorText and loadScripts and are used to set their associated property on this UpdateManager instance.</dd>
1620 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/Object</span> <b>params</b>
1623 <dd>(optional) The parameters to pass as either a url encoded string "param1=1&param2=2" or an object {param1: 1, param2: 2}</dd>
1626 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>callback</b>
1629 <dd>(optional) Callback when transaction is complete - called with signature (oElement, bSuccess, oResponse)</dd>
1632 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a></span> <b>discardUrl</b>
1635 <dd>(optional) By default when you execute an update the defaultUrl is changed to the last used url. If true, it will not store the url.</dd>
1653 <td class="msource">
1664 <!-- ============================== events summary / details ======================== -->
1667 <a id="Roo.UpdateManager-events"></a>
1676 <table cellspacing="0" class="member-table">
1677 <caption>Events</caption>
1680 <th class="sig-header" colspan="2">Event</th>
1681 <th class="msource-header">Defined By</th>
1690 <tr class="method-row expandable config-row-alt0 notInherited">
1691 <td class="micon"><a class="exi" href="#expand"> </a></td>
1694 <a id="Roo.UpdateManager-event-*beforeupdate"></a>
1696 <div class="fixedFont">
1697 <b class="itemname">beforeupdate</b> (<a href="./Roo.Element.html#constructor" roo:cls="Roo.Element.html#constructor">Roo.Element</a> <B><i>el</i></B>, <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/Object/Function <B><i>url</i></B>, <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/Object <B><i>params</i></B>)
1703 <div class="short">Fired before an update is made, return false from your handler and the update is cancelled.
1709 Fired before an update is made, return false from your handler and the update is cancelled.
1715 <dl class="detailList">
1716 <dt class="heading">Parameters:</dt>
1719 <span class="fixedFont"><a href="./Roo.Element.html#constructor" roo:cls="Roo.Element.html#constructor">Roo.Element</a></span> <b>el</b>
1725 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/Object/Function</span> <b>url</b>
1731 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/Object</span> <b>params</b>
1752 <td class="msource">
1757 <tr class="method-row expandable config-row-alt1 notInherited">
1758 <td class="micon"><a class="exi" href="#expand"> </a></td>
1761 <a id="Roo.UpdateManager-event-*failure"></a>
1763 <div class="fixedFont">
1764 <b class="itemname">failure</b> (<a href="./Roo.Element.html#constructor" roo:cls="Roo.Element.html#constructor">Roo.Element</a> <B><i>el</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>oResponseObject</i></B>)
1770 <div class="short">Fired on update failure.
1776 Fired on update failure.
1782 <dl class="detailList">
1783 <dt class="heading">Parameters:</dt>
1786 <span class="fixedFont"><a href="./Roo.Element.html#constructor" roo:cls="Roo.Element.html#constructor">Roo.Element</a></span> <b>el</b>
1792 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>oResponseObject</b>
1795 <dd>The response Object</dd>
1813 <td class="msource">
1818 <tr class="method-row expandable config-row-alt0 notInherited">
1819 <td class="micon"><a class="exi" href="#expand"> </a></td>
1822 <a id="Roo.UpdateManager-event-*update"></a>
1824 <div class="fixedFont">
1825 <b class="itemname">update</b> (<a href="./Roo.Element.html#constructor" roo:cls="Roo.Element.html#constructor">Roo.Element</a> <B><i>el</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>oResponseObject</i></B>)
1831 <div class="short">Fired after successful update is made.
1837 Fired after successful update is made.
1843 <dl class="detailList">
1844 <dt class="heading">Parameters:</dt>
1847 <span class="fixedFont"><a href="./Roo.Element.html#constructor" roo:cls="Roo.Element.html#constructor">Roo.Element</a></span> <b>el</b>
1853 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>oResponseObject</b>
1856 <dd>The response Object</dd>
1874 <td class="msource">
1886 <!-- ============================== footer ================================= -->
1887 <div class="fineprint" style="clear:both">
1889 Documentation generated by <a href="http://www.akbkhome.com" target="_blankt">Introspection Doc Generator</a> on Tue Apr 05 2016 18:29:25 GMT+0800 (HKT)
1891 <a href="http://www.jsdoctoolkit.org/" target="_blank">JsDoc Toolkit</a>