X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/530ef4b6c5b943cfa68b779d11cf7de29aa878bf..7a654f8d43fdb43d78b63d90528bed6e86b608cc:/docs/api/Ext.util.DelayedTask.html diff --git a/docs/api/Ext.util.DelayedTask.html b/docs/api/Ext.util.DelayedTask.html new file mode 100644 index 00000000..64e430bd --- /dev/null +++ b/docs/api/Ext.util.DelayedTask.html @@ -0,0 +1,86 @@ +
The DelayedTask class provides a convenient way to "buffer" the execution of a method, +performing setTimeout where a new timeout cancels the old timeout. When called, the +task will wait the specified time period before executing. If durng that time period, +the task is called again, the original call will be cancelled. This continues so that +the function is only called a single time for each iteration.
+ +This method is especially useful for things like detecting whether a user has finished +typing in a text field. An example would be performing validation on a keypress. You can +use this class to buffer the keypress events for a certain number of milliseconds, and +perform only if they stop for that amount of time.
+ +var task = new Ext.util.DelayedTask(function(){
+ alert(Ext.getDom('myInputField').value.length);
+});
+
+// Wait 500ms before calling our function. If the user presses another key
+// during that 500ms, it will be cancelled and we'll wait another 500ms.
+Ext.get('myInputField').on('keypress', function(){
+ task.delay(500);
+});
+
+
+Note that we are using a DelayedTask here to illustrate a point. The configuration
+option buffer
for addListener/on will
+also setup a delayed task for you to buffer events.
The parameters to this constructor serve as defaults and are not required.
+The parameters to this constructor serve as defaults and are not required.
+(optional) The default function to call.
+The default scope (The this
reference) in which the
+function is called. If not specified, this
will refer to the browser window.
(optional) The default Array of arguments.
+Cancels any pending timeout and queues a new one
+Cancels any pending timeout and queues a new one
+The milliseconds to delay
+(optional) Overrides function passed to constructor
+(optional) Overrides scope passed to constructor. Remember that if no scope
+is specified, this
will refer to the browser window.
(optional) Overrides args passed to constructor
+