Fix #7151 - parse block for figure
[roojs1] / docs / symbols / Roo.Button.json
1 {
2   "name" : "Roo.Button",
3   "augments" : [
4     "Roo.util.Observable"
5   ],
6   "childClasses" : {
7     "Roo.Button" : [
8       "Roo.SplitButton",
9       "Roo.Toolbar.Button"
10     ],
11     "Roo.SplitButton" : [
12       "Roo.Toolbar.SplitButton"
13     ]
14   },
15   "tree_children" : [],
16   "tree_parent" : [],
17   "desc" : "Simple Button class",
18   "isSingleton" : false,
19   "isStatic" : false,
20   "isBuiltin" : false,
21   "isAbstract" : false,
22   "isBuilderTop" : false,
23   "memberOf" : "Button",
24   "example" : "",
25   "deprecated" : "",
26   "since" : "",
27   "see" : "",
28   "params" : [
29     {
30       "name" : "config",
31       "type" : "Object",
32       "desc" : "The config object",
33       "isOptional" : false
34     }
35   ],
36   "returns" : [],
37   "throws" : "",
38   "requires" : "",
39   "config" : [
40     {
41       "name" : "listeners",
42       "type" : "Object",
43       "desc" : "list of events and functions to call for this object, \nFor example :\n<pre><code>\n    listeners :  { \n       'click' : function(e) {\n           ..... \n        } ,\n        .... \n    } \n  </code></pre>",
44       "memberOf" : "Roo.util.Observable",
45       "isOptional" : false,
46       "optvals" : []
47     },
48     {
49       "name" : "tooltip",
50       "type" : "String/Object",
51       "desc" : "The tooltip for the button - can be a string or QuickTips config object",
52       "memberOf" : "",
53       "isOptional" : false,
54       "optvals" : []
55     },
56     {
57       "name" : "text",
58       "type" : "String",
59       "desc" : "The button text",
60       "memberOf" : "",
61       "isOptional" : false,
62       "optvals" : []
63     },
64     {
65       "name" : "renderTo",
66       "type" : "String/HTMLElement/Element",
67       "desc" : "The element to append the button to",
68       "memberOf" : "",
69       "isOptional" : false,
70       "optvals" : []
71     },
72     {
73       "name" : "hidden",
74       "type" : "Boolean",
75       "desc" : "True to start hidden (defaults to false)",
76       "memberOf" : "",
77       "isOptional" : false,
78       "optvals" : []
79     },
80     {
81       "name" : "toggleGroup",
82       "type" : "String",
83       "desc" : "The group this toggle button is a member of (only 1 per group can be pressed, only\n   applies if enableToggle = true)",
84       "memberOf" : "",
85       "isOptional" : false,
86       "optvals" : []
87     },
88     {
89       "name" : "handleMouseEvents",
90       "type" : "Boolean",
91       "desc" : "False to disable visual cues on mouseover, mouseout and mousedown (defaults to true)",
92       "memberOf" : "",
93       "isOptional" : false,
94       "optvals" : []
95     },
96     {
97       "name" : "menu",
98       "type" : "Roo.menu.Menu",
99       "desc" : "Standard menu attribute consisting of a reference to a menu object, a menu id or a menu config blob (defaults to undefined).",
100       "memberOf" : "",
101       "isOptional" : false,
102       "optvals" : []
103     },
104     {
105       "name" : "enableToggle",
106       "type" : "Boolean",
107       "desc" : "True to enable pressed/not pressed toggling (defaults to false)",
108       "memberOf" : "",
109       "isOptional" : false,
110       "optvals" : []
111     },
112     {
113       "name" : "handler",
114       "type" : "Function",
115       "desc" : "A function called when the button is clicked (can be used instead of click event)",
116       "memberOf" : "",
117       "isOptional" : false,
118       "optvals" : []
119     },
120     {
121       "name" : "scope",
122       "type" : "Object",
123       "desc" : "The scope of the handler",
124       "memberOf" : "",
125       "isOptional" : false,
126       "optvals" : []
127     },
128     {
129       "name" : "minWidth",
130       "type" : "Number",
131       "desc" : "The minimum width for this button (used to give a set of buttons a common width)",
132       "memberOf" : "",
133       "isOptional" : false,
134       "optvals" : []
135     },
136     {
137       "name" : "disabled",
138       "type" : "Boolean",
139       "desc" : "True to start disabled (defaults to false)",
140       "memberOf" : "",
141       "isOptional" : false,
142       "optvals" : []
143     },
144     {
145       "name" : "pressed",
146       "type" : "Boolean",
147       "desc" : "True to start pressed (only if enableToggle = true)",
148       "memberOf" : "",
149       "isOptional" : false,
150       "optvals" : []
151     },
152     {
153       "name" : "template",
154       "type" : "Roo.Template",
155       "desc" : "An {@link Roo.Template} with which to create the Button's main element. This Template must\ncontain numeric substitution parameter 0 if it is to display the tRoo property. Changing the template could\nrequire code modifications if required elements (e.g. a button) aren't present.",
156       "memberOf" : "",
157       "isOptional" : false,
158       "optvals" : []
159     },
160     {
161       "name" : "cls",
162       "type" : "String",
163       "desc" : "A CSS class to apply to the button's main element.",
164       "memberOf" : "",
165       "isOptional" : false,
166       "optvals" : []
167     },
168     {
169       "name" : "tabIndex",
170       "type" : "Number",
171       "desc" : "The DOM tabIndex for this button (defaults to undefined)",
172       "memberOf" : "",
173       "isOptional" : false,
174       "optvals" : []
175     },
176     {
177       "name" : "iconCls",
178       "type" : "String",
179       "desc" : "A css class which sets a background image to be used as the icon for this button (defaults to undefined).",
180       "memberOf" : "",
181       "isOptional" : false,
182       "optvals" : []
183     },
184     {
185       "name" : "menuAlign",
186       "type" : "String",
187       "desc" : "The position to align the menu to (see {@link Roo.Element#alignTo} for more details, defaults to 'tl-bl?').",
188       "memberOf" : "",
189       "isOptional" : false,
190       "optvals" : []
191     },
192     {
193       "name" : "icon",
194       "type" : "String",
195       "desc" : "The path to an image to display in the button (the image will be set as the background-image\nCSS property of the button by default, so if you want a mixed icon/text button, set cls:\"x-btn-text-icon\")",
196       "memberOf" : "",
197       "isOptional" : false,
198       "optvals" : []
199     },
200     {
201       "name" : "tooltipType",
202       "type" : "String",
203       "desc" : "The type of tooltip to use. Either \"qtip\" (default) for QuickTips or \"title\" for title attribute.",
204       "memberOf" : "",
205       "isOptional" : false,
206       "optvals" : []
207     },
208     {
209       "name" : "clickEvent",
210       "type" : "String",
211       "desc" : "The type of event to map to the button's event handler (defaults to 'click')",
212       "memberOf" : "",
213       "isOptional" : false,
214       "optvals" : []
215     },
216     {
217       "name" : "repeat",
218       "type" : "Boolean/Object",
219       "desc" : "True to repeat fire the click event while the mouse is down. This can also be\n  an {@link Roo.util.ClickRepeater} config object (defaults to false).",
220       "memberOf" : "",
221       "isOptional" : false,
222       "optvals" : []
223     },
224     {
225       "name" : "type",
226       "type" : "String",
227       "desc" : "The button's type, corresponding to the DOM input element type attribute.  Either \"submit,\" \"reset\" or \"button\" (default).",
228       "memberOf" : "",
229       "isOptional" : false,
230       "optvals" : []
231     }
232   ],
233   "methods" : [
234     {
235       "name" : "show",
236       "type" : "function",
237       "desc" : "Show this button",
238       "sig" : "()\n{\n\n}",
239       "static" : false,
240       "memberOf" : "",
241       "isStatic" : false,
242       "isConstructor" : false,
243       "isPrivate" : false,
244       "example" : "",
245       "deprecated" : "",
246       "since" : "",
247       "see" : "",
248       "exceptions" : "",
249       "requires" : "",
250       "params" : [],
251       "returns" : []
252     },
253     {
254       "name" : "focus",
255       "type" : "function",
256       "desc" : "Focus the button",
257       "sig" : "()\n{\n\n}",
258       "static" : false,
259       "memberOf" : "",
260       "isStatic" : false,
261       "isConstructor" : false,
262       "isPrivate" : false,
263       "example" : "",
264       "deprecated" : "",
265       "since" : "",
266       "see" : "",
267       "exceptions" : "",
268       "requires" : "",
269       "params" : [],
270       "returns" : []
271     },
272     {
273       "name" : "setHandler",
274       "type" : "function",
275       "desc" : "Assigns this button's click handler",
276       "sig" : "(handler, scope)",
277       "static" : false,
278       "memberOf" : "",
279       "isStatic" : false,
280       "isConstructor" : false,
281       "isPrivate" : false,
282       "example" : "",
283       "deprecated" : "",
284       "since" : "",
285       "see" : "",
286       "exceptions" : "",
287       "requires" : "",
288       "params" : [
289         {
290           "name" : "handler",
291           "type" : "Function",
292           "desc" : "The function to call when the button is clicked",
293           "isOptional" : false
294         },
295         {
296           "name" : "scope",
297           "type" : "Object",
298           "desc" : "(optional) Scope for the function passed in",
299           "isOptional" : false
300         }
301       ],
302       "returns" : []
303     },
304     {
305       "name" : "disable",
306       "type" : "function",
307       "desc" : "Disable this button",
308       "sig" : "()\n{\n\n}",
309       "static" : false,
310       "memberOf" : "",
311       "isStatic" : false,
312       "isConstructor" : false,
313       "isPrivate" : false,
314       "example" : "",
315       "deprecated" : "",
316       "since" : "",
317       "see" : "",
318       "exceptions" : "",
319       "requires" : "",
320       "params" : [],
321       "returns" : []
322     },
323     {
324       "name" : "enable",
325       "type" : "function",
326       "desc" : "Enable this button",
327       "sig" : "()\n{\n\n}",
328       "static" : false,
329       "memberOf" : "",
330       "isStatic" : false,
331       "isConstructor" : false,
332       "isPrivate" : false,
333       "example" : "",
334       "deprecated" : "",
335       "since" : "",
336       "see" : "",
337       "exceptions" : "",
338       "requires" : "",
339       "params" : [],
340       "returns" : []
341     },
342     {
343       "name" : "getEl",
344       "type" : "function",
345       "desc" : "Returns the button's underlying element",
346       "sig" : "()\n{\n\n}",
347       "static" : false,
348       "memberOf" : "",
349       "isStatic" : false,
350       "isConstructor" : false,
351       "isPrivate" : false,
352       "example" : "",
353       "deprecated" : "",
354       "since" : "",
355       "see" : "",
356       "exceptions" : "",
357       "requires" : "",
358       "params" : [],
359       "returns" : [
360         {
361           "name" : "",
362           "type" : "Roo.Element",
363           "desc" : "The element"
364         }
365       ]
366     },
367     {
368       "name" : "setDisabled",
369       "type" : "function",
370       "desc" : "Convenience function for boolean enable/disable",
371       "sig" : "(enabled)",
372       "static" : false,
373       "memberOf" : "",
374       "isStatic" : false,
375       "isConstructor" : false,
376       "isPrivate" : false,
377       "example" : "",
378       "deprecated" : "",
379       "since" : "",
380       "see" : "",
381       "exceptions" : "",
382       "requires" : "",
383       "params" : [
384         {
385           "name" : "enabled",
386           "type" : "Boolean",
387           "desc" : "True to enable, false to disable",
388           "isOptional" : false
389         }
390       ],
391       "returns" : []
392     },
393     {
394       "name" : "setPressed",
395       "type" : "function",
396       "desc" : "Similar to toggle, but does not trigger event.",
397       "sig" : "(state)",
398       "static" : false,
399       "memberOf" : "",
400       "isStatic" : false,
401       "isConstructor" : false,
402       "isPrivate" : false,
403       "example" : "",
404       "deprecated" : "",
405       "since" : "",
406       "see" : "",
407       "exceptions" : "",
408       "requires" : "",
409       "params" : [
410         {
411           "name" : "state",
412           "type" : "Boolean",
413           "desc" : "[required] Force a particular state",
414           "isOptional" : false
415         }
416       ],
417       "returns" : []
418     },
419     {
420       "name" : "setVisible",
421       "type" : "function",
422       "desc" : "Convenience function for boolean show/hide",
423       "sig" : "(visible)",
424       "static" : false,
425       "memberOf" : "",
426       "isStatic" : false,
427       "isConstructor" : false,
428       "isPrivate" : false,
429       "example" : "",
430       "deprecated" : "",
431       "since" : "",
432       "see" : "",
433       "exceptions" : "",
434       "requires" : "",
435       "params" : [
436         {
437           "name" : "visible",
438           "type" : "Boolean",
439           "desc" : "True to show, false to hide",
440           "isOptional" : false
441         }
442       ],
443       "returns" : []
444     },
445     {
446       "name" : "destroy",
447       "type" : "function",
448       "desc" : "Destroys this Button and removes any listeners.",
449       "sig" : "()\n{\n\n}",
450       "static" : false,
451       "memberOf" : "",
452       "isStatic" : false,
453       "isConstructor" : false,
454       "isPrivate" : false,
455       "example" : "",
456       "deprecated" : "",
457       "since" : "",
458       "see" : "",
459       "exceptions" : "",
460       "requires" : "",
461       "params" : [],
462       "returns" : []
463     },
464     {
465       "name" : "getText",
466       "type" : "function",
467       "desc" : "Gets the text for this button",
468       "sig" : "()\n{\n\n}",
469       "static" : false,
470       "memberOf" : "",
471       "isStatic" : false,
472       "isConstructor" : false,
473       "isPrivate" : false,
474       "example" : "",
475       "deprecated" : "",
476       "since" : "",
477       "see" : "",
478       "exceptions" : "",
479       "requires" : "",
480       "params" : [],
481       "returns" : [
482         {
483           "name" : "",
484           "type" : "String",
485           "desc" : "The button text"
486         }
487       ]
488     },
489     {
490       "name" : "setText",
491       "type" : "function",
492       "desc" : "Sets this button's text",
493       "sig" : "(text)",
494       "static" : false,
495       "memberOf" : "",
496       "isStatic" : false,
497       "isConstructor" : false,
498       "isPrivate" : false,
499       "example" : "",
500       "deprecated" : "",
501       "since" : "",
502       "see" : "",
503       "exceptions" : "",
504       "requires" : "",
505       "params" : [
506         {
507           "name" : "text",
508           "type" : "String",
509           "desc" : "The button text",
510           "isOptional" : false
511         }
512       ],
513       "returns" : []
514     },
515     {
516       "name" : "toggle",
517       "type" : "function",
518       "desc" : "If a state it passed, it becomes the pressed state otherwise the current state is toggled.",
519       "sig" : "(state)",
520       "static" : false,
521       "memberOf" : "",
522       "isStatic" : false,
523       "isConstructor" : false,
524       "isPrivate" : false,
525       "example" : "",
526       "deprecated" : "",
527       "since" : "",
528       "see" : "",
529       "exceptions" : "",
530       "requires" : "",
531       "params" : [
532         {
533           "name" : "state",
534           "type" : "Boolean",
535           "desc" : "(optional) Force a particular state",
536           "isOptional" : false
537         }
538       ],
539       "returns" : []
540     },
541     {
542       "name" : "hide",
543       "type" : "function",
544       "desc" : "Hide this button",
545       "sig" : "()\n{\n\n}",
546       "static" : false,
547       "memberOf" : "",
548       "isStatic" : false,
549       "isConstructor" : false,
550       "isPrivate" : false,
551       "example" : "",
552       "deprecated" : "",
553       "since" : "",
554       "see" : "",
555       "exceptions" : "",
556       "requires" : "",
557       "params" : [],
558       "returns" : []
559     },
560     {
561       "name" : "purgeListeners",
562       "type" : "function",
563       "desc" : "Removes all listeners for this object",
564       "sig" : "()\n{\n\n}",
565       "static" : false,
566       "memberOf" : "Roo.util.Observable",
567       "isStatic" : false,
568       "isConstructor" : false,
569       "isPrivate" : false,
570       "example" : "",
571       "deprecated" : "",
572       "since" : "",
573       "see" : "",
574       "exceptions" : "",
575       "requires" : "",
576       "params" : [],
577       "returns" : []
578     },
579     {
580       "name" : "on",
581       "type" : "function",
582       "desc" : "Appends an event handler to this element (shorthand for addListener)",
583       "sig" : "(eventName, handler, scope, options)",
584       "static" : false,
585       "memberOf" : "Roo.util.Observable",
586       "isStatic" : false,
587       "isConstructor" : false,
588       "isPrivate" : false,
589       "example" : "",
590       "deprecated" : "",
591       "since" : "",
592       "see" : "",
593       "exceptions" : "",
594       "requires" : "",
595       "params" : [
596         {
597           "name" : "eventName",
598           "type" : "String",
599           "desc" : "The type of event to listen for",
600           "isOptional" : false
601         },
602         {
603           "name" : "handler",
604           "type" : "Function",
605           "desc" : "The method the event invokes",
606           "isOptional" : false
607         },
608         {
609           "name" : "scope",
610           "type" : "Object",
611           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
612           "isOptional" : false
613         },
614         {
615           "name" : "options",
616           "type" : "Object",
617           "desc" : "(optional)",
618           "isOptional" : false
619         }
620       ],
621       "returns" : []
622     },
623     {
624       "name" : "un",
625       "type" : "function",
626       "desc" : "Removes a listener (shorthand for removeListener)",
627       "sig" : "(eventName, handler, scope)",
628       "static" : false,
629       "memberOf" : "Roo.util.Observable",
630       "isStatic" : false,
631       "isConstructor" : false,
632       "isPrivate" : false,
633       "example" : "",
634       "deprecated" : "",
635       "since" : "",
636       "see" : "",
637       "exceptions" : "",
638       "requires" : "",
639       "params" : [
640         {
641           "name" : "eventName",
642           "type" : "String",
643           "desc" : "The type of event to listen for",
644           "isOptional" : false
645         },
646         {
647           "name" : "handler",
648           "type" : "Function",
649           "desc" : "The handler to remove",
650           "isOptional" : false
651         },
652         {
653           "name" : "scope",
654           "type" : "Object",
655           "desc" : "(optional) The scope (this object) for the handler",
656           "isOptional" : false
657         }
658       ],
659       "returns" : []
660     },
661     {
662       "name" : "addEvents",
663       "type" : "function",
664       "desc" : "Used to define events on this Observable",
665       "sig" : "(object)",
666       "static" : false,
667       "memberOf" : "Roo.util.Observable",
668       "isStatic" : false,
669       "isConstructor" : false,
670       "isPrivate" : false,
671       "example" : "",
672       "deprecated" : "",
673       "since" : "",
674       "see" : "",
675       "exceptions" : "",
676       "requires" : "",
677       "params" : [
678         {
679           "name" : "object",
680           "type" : "Object",
681           "desc" : "The object with the events defined",
682           "isOptional" : false
683         }
684       ],
685       "returns" : []
686     },
687     {
688       "name" : "releaseCapture",
689       "type" : "function",
690       "desc" : "Removes <b>all</b> added captures from the Observable.",
691       "sig" : "(o)",
692       "static" : true,
693       "memberOf" : "Roo.util.Observable",
694       "isStatic" : true,
695       "isConstructor" : false,
696       "isPrivate" : false,
697       "example" : "",
698       "deprecated" : "",
699       "since" : "",
700       "see" : "",
701       "exceptions" : "",
702       "requires" : "",
703       "params" : [
704         {
705           "name" : "o",
706           "type" : "Observable",
707           "desc" : "The Observable to release",
708           "isOptional" : false
709         }
710       ],
711       "returns" : []
712     },
713     {
714       "name" : "removeListener",
715       "type" : "function",
716       "desc" : "Removes a listener",
717       "sig" : "(eventName, handler, scope)",
718       "static" : false,
719       "memberOf" : "Roo.util.Observable",
720       "isStatic" : false,
721       "isConstructor" : false,
722       "isPrivate" : false,
723       "example" : "",
724       "deprecated" : "",
725       "since" : "",
726       "see" : "",
727       "exceptions" : "",
728       "requires" : "",
729       "params" : [
730         {
731           "name" : "eventName",
732           "type" : "String",
733           "desc" : "The type of event to listen for",
734           "isOptional" : false
735         },
736         {
737           "name" : "handler",
738           "type" : "Function",
739           "desc" : "The handler to remove",
740           "isOptional" : false
741         },
742         {
743           "name" : "scope",
744           "type" : "Object",
745           "desc" : "(optional) The scope (this object) for the handler",
746           "isOptional" : false
747         }
748       ],
749       "returns" : []
750     },
751     {
752       "name" : "fireEvent",
753       "type" : "function",
754       "desc" : "Fires the specified event with the passed parameters (minus the event name).",
755       "sig" : "(eventName, args)",
756       "static" : false,
757       "memberOf" : "Roo.util.Observable",
758       "isStatic" : false,
759       "isConstructor" : false,
760       "isPrivate" : false,
761       "example" : "",
762       "deprecated" : "",
763       "since" : "",
764       "see" : "",
765       "exceptions" : "",
766       "requires" : "",
767       "params" : [
768         {
769           "name" : "eventName",
770           "type" : "String",
771           "desc" : "",
772           "isOptional" : false
773         },
774         {
775           "name" : "args",
776           "type" : "Object...",
777           "desc" : "Variable number of parameters are passed to handlers",
778           "isOptional" : false
779         }
780       ],
781       "returns" : [
782         {
783           "name" : "",
784           "type" : "Boolean",
785           "desc" : "returns false if any of the handlers return false otherwise it returns true"
786         }
787       ]
788     },
789     {
790       "name" : "hasListener",
791       "type" : "function",
792       "desc" : "Checks to see if this object has any listeners for a specified event",
793       "sig" : "(eventName)",
794       "static" : false,
795       "memberOf" : "Roo.util.Observable",
796       "isStatic" : false,
797       "isConstructor" : false,
798       "isPrivate" : false,
799       "example" : "",
800       "deprecated" : "",
801       "since" : "",
802       "see" : "",
803       "exceptions" : "",
804       "requires" : "",
805       "params" : [
806         {
807           "name" : "eventName",
808           "type" : "String",
809           "desc" : "The name of the event to check for",
810           "isOptional" : false
811         }
812       ],
813       "returns" : [
814         {
815           "name" : "",
816           "type" : "Boolean",
817           "desc" : "True if the event is being listened for, else false"
818         }
819       ]
820     },
821     {
822       "name" : "capture",
823       "type" : "function",
824       "desc" : "Starts capture on the specified Observable. All events will be passed\nto the supplied function with the event name + standard signature of the event\n<b>before</b> the event is fired. If the supplied function returns false,\nthe event will not fire.",
825       "sig" : "(o, fn, scope)",
826       "static" : true,
827       "memberOf" : "Roo.util.Observable",
828       "isStatic" : true,
829       "isConstructor" : false,
830       "isPrivate" : false,
831       "example" : "",
832       "deprecated" : "",
833       "since" : "",
834       "see" : "",
835       "exceptions" : "",
836       "requires" : "",
837       "params" : [
838         {
839           "name" : "o",
840           "type" : "Observable",
841           "desc" : "The Observable to capture",
842           "isOptional" : false
843         },
844         {
845           "name" : "fn",
846           "type" : "Function",
847           "desc" : "The function to call",
848           "isOptional" : false
849         },
850         {
851           "name" : "scope",
852           "type" : "Object",
853           "desc" : "(optional) The scope (this object) for the fn",
854           "isOptional" : false
855         }
856       ],
857       "returns" : []
858     },
859     {
860       "name" : "addListener",
861       "type" : "function",
862       "desc" : "Appends an event handler to this component",
863       "sig" : "(eventName, handler, scope, options)",
864       "static" : false,
865       "memberOf" : "Roo.util.Observable",
866       "isStatic" : false,
867       "isConstructor" : false,
868       "isPrivate" : false,
869       "example" : "",
870       "deprecated" : "",
871       "since" : "",
872       "see" : "",
873       "exceptions" : "",
874       "requires" : "",
875       "params" : [
876         {
877           "name" : "eventName",
878           "type" : "String",
879           "desc" : "The type of event to listen for",
880           "isOptional" : false
881         },
882         {
883           "name" : "handler",
884           "type" : "Function",
885           "desc" : "The method the event invokes",
886           "isOptional" : false
887         },
888         {
889           "name" : "scope",
890           "type" : "Object",
891           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
892           "isOptional" : false
893         },
894         {
895           "name" : "options",
896           "type" : "Object",
897           "desc" : "(optional) An object containing handler configuration\nproperties. This may contain any of the following properties:<ul>\n<li>scope {Object} The scope in which to execute the handler function. The handler function's \"this\" context.</li>\n<li>delay {Number} The number of milliseconds to delay the invocation of the handler after te event fires.</li>\n<li>single {Boolean} True to add a handler to handle just the next firing of the event, and then remove itself.</li>\n<li>buffer {Number} Causes the handler to be scheduled to run in an {@link Roo.util.DelayedTask} delayed\nby the specified number of milliseconds. If the event fires again within that time, the original\nhandler is <em>not</em> invoked, but the new handler is scheduled in its place.</li>\n</ul><br>\n<p>\n<b>Combining Options</b><br>\nUsing the options argument, it is possible to combine different types of listeners:<br>\n<br>\nA normalized, delayed, one-time listener that auto stops the event and passes a custom argument (forumId)\n\t\t<pre><code>\n\t\tel.on('click', this.onClick, this, {\n \t\t\tsingle: true,\n    \t\tdelay: 100,\n    \t\tforumId: 4\n\t\t});\n\t\t</code></pre>\n<p>\n<b>Attaching multiple handlers in 1 call</b><br>\nThe method also allows for a single argument to be passed which is a config object containing properties\nwhich specify multiple handlers.\n<pre><code>\n\t\tel.on({\n\t\t\t'click': {\n        \t\tfn: this.onClick,\n        \t\tscope: this,\n        \t\tdelay: 100\n    \t\t}, \n    \t\t'mouseover': {\n        \t\tfn: this.onMouseOver,\n        \t\tscope: this\n    \t\t},\n    \t\t'mouseout': {\n        \t\tfn: this.onMouseOut,\n        \t\tscope: this\n    \t\t}\n\t\t});\n\t\t</code></pre>\n<p>\nOr a shorthand syntax which passes the same scope object to all handlers:\n     \t<pre><code>\n\t\tel.on({\n\t\t\t'click': this.onClick,\n    \t\t'mouseover': this.onMouseOver,\n    \t\t'mouseout': this.onMouseOut,\n    \t\tscope: this\n\t\t});\n\t\t</code></pre>",
898           "isOptional" : false
899         }
900       ],
901       "returns" : []
902     }
903   ],
904   "events" : [
905     {
906       "name" : "render",
907       "type" : "function",
908       "desc" : "Fires when the button is rendered",
909       "sig" : "function (_self)\n{\n\n}",
910       "memberOf" : "",
911       "example" : "",
912       "deprecated" : "",
913       "since" : "",
914       "see" : "",
915       "params" : [
916         {
917           "name" : "this",
918           "type" : "Button",
919           "desc" : "",
920           "isOptional" : false
921         }
922       ],
923       "returns" : []
924     },
925     {
926       "name" : "click",
927       "type" : "function",
928       "desc" : "Fires when this button is clicked",
929       "sig" : "function (_self, e)\n{\n\n}",
930       "memberOf" : "",
931       "example" : "",
932       "deprecated" : "",
933       "since" : "",
934       "see" : "",
935       "params" : [
936         {
937           "name" : "this",
938           "type" : "Button",
939           "desc" : "",
940           "isOptional" : false
941         },
942         {
943           "name" : "e",
944           "type" : "EventObject",
945           "desc" : "The click event",
946           "isOptional" : false
947         }
948       ],
949       "returns" : []
950     },
951     {
952       "name" : "mouseover",
953       "type" : "function",
954       "desc" : "Fires when the mouse hovers over the button",
955       "sig" : "function (_self, e)\n{\n\n}",
956       "memberOf" : "",
957       "example" : "",
958       "deprecated" : "",
959       "since" : "",
960       "see" : "",
961       "params" : [
962         {
963           "name" : "this",
964           "type" : "Button",
965           "desc" : "",
966           "isOptional" : false
967         },
968         {
969           "name" : "e",
970           "type" : "Event",
971           "desc" : "The event object",
972           "isOptional" : false
973         }
974       ],
975       "returns" : []
976     },
977     {
978       "name" : "toggle",
979       "type" : "function",
980       "desc" : "Fires when the \"pressed\" state of this button changes (only if enableToggle = true)",
981       "sig" : "function (_self, pressed)\n{\n\n}",
982       "memberOf" : "",
983       "example" : "",
984       "deprecated" : "",
985       "since" : "",
986       "see" : "",
987       "params" : [
988         {
989           "name" : "this",
990           "type" : "Button",
991           "desc" : "",
992           "isOptional" : false
993         },
994         {
995           "name" : "pressed",
996           "type" : "Boolean",
997           "desc" : "",
998           "isOptional" : false
999         }
1000       ],
1001       "returns" : []
1002     },
1003     {
1004       "name" : "mouseout",
1005       "type" : "function",
1006       "desc" : "Fires when the mouse exits the button",
1007       "sig" : "function (_self, e)\n{\n\n}",
1008       "memberOf" : "",
1009       "example" : "",
1010       "deprecated" : "",
1011       "since" : "",
1012       "see" : "",
1013       "params" : [
1014         {
1015           "name" : "this",
1016           "type" : "Button",
1017           "desc" : "",
1018           "isOptional" : false
1019         },
1020         {
1021           "name" : "e",
1022           "type" : "Event",
1023           "desc" : "The event object",
1024           "isOptional" : false
1025         }
1026       ],
1027       "returns" : []
1028     }
1029   ]
1030 }