sync
[roojs1] / docs / symbols / Roo.BoxComponent.json
1 {
2   "name" : "Roo.BoxComponent",
3   "augments" : [
4     "Roo.Component",
5     "Roo.util.Observable"
6   ],
7   "desc" : "Base class for any visual {@link Roo.Component} that uses a box container.  BoxComponent provides automatic box\nmodel adjustments for sizing and positioning and will work correctly withnin the Component rendering model.  All\ncontainer classes should subclass BoxComponent so that they will work consistently when nested within other Ext\nlayout containers.",
8   "isSingleton" : false,
9   "isStatic" : false,
10   "isBuiltin" : false,
11   "memberOf" : "BoxComponent",
12   "example" : "",
13   "deprecated" : "",
14   "since" : "",
15   "see" : "",
16   "params" : [
17     {
18       "name" : "config",
19       "type" : "Roo.Element/String/Object",
20       "desc" : "The configuration options.",
21       "isOptional" : false
22     }
23   ],
24   "returns" : [
25   ],
26   "config" : [
27     {
28       "name" : "listeners",
29       "type" : "Object",
30       "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>",
31       "memberOf" : "Roo.util.Observable",
32       "values" : [
33       ]
34     },
35     {
36       "name" : "hideMode",
37       "type" : "String",
38       "desc" : "How this component should hidden. Supported values are\n\"visibility\" (css visibility), \"offsets\" (negative offset position) and\n\"display\" (css display) - defaults to \"display\".",
39       "memberOf" : "Roo.Component",
40       "values" : [
41         "(display",
42         "visibility)"
43       ]
44     },
45     {
46       "name" : "allowDomMove",
47       "type" : "Boolean",
48       "desc" : "Whether the component can move the Dom node when rendering (defaults to true).",
49       "memberOf" : "Roo.Component",
50       "values" : [
51       ]
52     },
53     {
54       "name" : "actionMode",
55       "type" : "String",
56       "desc" : "which property holds the element that used for  hide() / show() / disable() / enable()\ndefault is 'el' for forms you probably want to set this to fieldEl",
57       "memberOf" : "Roo.Component",
58       "values" : [
59       ]
60     },
61     {
62       "name" : "width",
63       "type" : "Number",
64       "desc" : "width (optional) size of component",
65       "memberOf" : "Roo.BoxComponent",
66       "values" : [
67       ]
68     },
69     {
70       "name" : "height",
71       "type" : "Number",
72       "desc" : "height (optional) size of component",
73       "memberOf" : "Roo.BoxComponent",
74       "values" : [
75       ]
76     },
77     {
78       "name" : "disableClass",
79       "type" : "String",
80       "desc" : "CSS class added to the component when it is disabled (defaults to \"x-item-disabled\").",
81       "memberOf" : "Roo.Component",
82       "values" : [
83       ]
84     }
85   ],
86   "methods" : [
87     {
88       "name" : "updateBox",
89       "desc" : "Sets the current box measurements of the component's underlying element.",
90       "isStatic" : false,
91       "isConstructor" : false,
92       "isPrivate" : false,
93       "memberOf" : "Roo.BoxComponent",
94       "example" : "",
95       "deprecated" : "",
96       "since" : "",
97       "see" : "",
98       "params" : [
99         {
100           "name" : "box",
101           "type" : "Object",
102           "desc" : "An object in the format {x, y, width, height}",
103           "isOptional" : false
104         }
105       ],
106       "returns" : [
107       ]
108     },
109     {
110       "name" : "setPagePosition",
111       "desc" : "Sets the page XY position of the component.  To set the left and top instead, use {@link #setPosition}.\nThis method fires the move event.",
112       "isStatic" : false,
113       "isConstructor" : false,
114       "isPrivate" : false,
115       "memberOf" : "Roo.BoxComponent",
116       "example" : "",
117       "deprecated" : "",
118       "since" : "",
119       "see" : "",
120       "params" : [
121         {
122           "name" : "x",
123           "type" : "Number",
124           "desc" : "The new x position",
125           "isOptional" : false
126         },
127         {
128           "name" : "y",
129           "type" : "Number",
130           "desc" : "The new y position",
131           "isOptional" : false
132         }
133       ],
134       "returns" : [
135       ]
136     },
137     {
138       "name" : "syncSize",
139       "desc" : "Force the component's size to recalculate based on the underlying element's current height and width.",
140       "isStatic" : false,
141       "isConstructor" : false,
142       "isPrivate" : false,
143       "memberOf" : "Roo.BoxComponent",
144       "example" : "",
145       "deprecated" : "",
146       "since" : "",
147       "see" : "",
148       "params" : [
149       ],
150       "returns" : [
151       ]
152     },
153     {
154       "name" : "setSize",
155       "desc" : "Sets the width and height of the component.  This method fires the resize event.  This method can accept\neither width and height as separate numeric arguments, or you can pass a size object like {width:10, height:20}.",
156       "isStatic" : false,
157       "isConstructor" : false,
158       "isPrivate" : false,
159       "memberOf" : "Roo.BoxComponent",
160       "example" : "",
161       "deprecated" : "",
162       "since" : "",
163       "see" : "",
164       "params" : [
165         {
166           "name" : "width",
167           "type" : "Number/Object",
168           "desc" : "The new width to set, or a size object in the format {width, height}",
169           "isOptional" : false
170         },
171         {
172           "name" : "height",
173           "type" : "Number",
174           "desc" : "The new height to set (not required if a size object is passed as the first arg)",
175           "isOptional" : false
176         }
177       ],
178       "returns" : [
179         {
180           "name" : "",
181           "type" : "Roo.BoxComponent",
182           "desc" : "this"
183         }
184       ]
185     },
186     {
187       "name" : "getPosition",
188       "desc" : "Gets the current XY position of the component's underlying element.",
189       "isStatic" : false,
190       "isConstructor" : false,
191       "isPrivate" : false,
192       "memberOf" : "Roo.BoxComponent",
193       "example" : "",
194       "deprecated" : "",
195       "since" : "",
196       "see" : "",
197       "params" : [
198         {
199           "name" : "local",
200           "type" : "Boolean",
201           "desc" : "(optional) If true the element's left and top are returned instead of page XY (defaults to false)",
202           "isOptional" : false
203         }
204       ],
205       "returns" : [
206         {
207           "name" : "",
208           "type" : "Array",
209           "desc" : "The XY position of the element (e.g., [100, 200])"
210         }
211       ]
212     },
213     {
214       "name" : "onResize",
215       "desc" : "Called after the component is resized, this method is empty by default but can be implemented by any\nsubclass that needs to perform custom logic after a resize occurs.",
216       "isStatic" : false,
217       "isConstructor" : false,
218       "isPrivate" : false,
219       "memberOf" : "Roo.BoxComponent",
220       "example" : "",
221       "deprecated" : "",
222       "since" : "",
223       "see" : "",
224       "params" : [
225         {
226           "name" : "adjWidth",
227           "type" : "Number",
228           "desc" : "The box-adjusted width that was set",
229           "isOptional" : false
230         },
231         {
232           "name" : "adjHeight",
233           "type" : "Number",
234           "desc" : "The box-adjusted height that was set",
235           "isOptional" : false
236         },
237         {
238           "name" : "rawWidth",
239           "type" : "Number",
240           "desc" : "The width that was originally specified",
241           "isOptional" : false
242         },
243         {
244           "name" : "rawHeight",
245           "type" : "Number",
246           "desc" : "The height that was originally specified",
247           "isOptional" : false
248         }
249       ],
250       "returns" : [
251       ]
252     },
253     {
254       "name" : "getBox",
255       "desc" : "Gets the current box measurements of the component's underlying element.",
256       "isStatic" : false,
257       "isConstructor" : false,
258       "isPrivate" : false,
259       "memberOf" : "Roo.BoxComponent",
260       "example" : "",
261       "deprecated" : "",
262       "since" : "",
263       "see" : "",
264       "params" : [
265         {
266           "name" : "local",
267           "type" : "Boolean",
268           "desc" : "(optional) If true the element's left and top are returned instead of page XY (defaults to false)",
269           "isOptional" : false
270         }
271       ],
272       "returns" : [
273       ]
274     },
275     {
276       "name" : "getSize",
277       "desc" : "Gets the current size of the component's underlying element.",
278       "isStatic" : false,
279       "isConstructor" : false,
280       "isPrivate" : false,
281       "memberOf" : "Roo.BoxComponent",
282       "example" : "",
283       "deprecated" : "",
284       "since" : "",
285       "see" : "",
286       "params" : [
287       ],
288       "returns" : [
289         {
290           "name" : "",
291           "type" : "Object",
292           "desc" : "An object containing the element's size {width: (element width), height: (element height)}"
293         }
294       ]
295     },
296     {
297       "name" : "onPosition",
298       "desc" : "Called after the component is moved, this method is empty by default but can be implemented by any\nsubclass that needs to perform custom logic after a move occurs.",
299       "isStatic" : false,
300       "isConstructor" : false,
301       "isPrivate" : false,
302       "memberOf" : "Roo.BoxComponent",
303       "example" : "",
304       "deprecated" : "",
305       "since" : "",
306       "see" : "",
307       "params" : [
308         {
309           "name" : "x",
310           "type" : "Number",
311           "desc" : "The new x position",
312           "isOptional" : false
313         },
314         {
315           "name" : "y",
316           "type" : "Number",
317           "desc" : "The new y position",
318           "isOptional" : false
319         }
320       ],
321       "returns" : [
322       ]
323     },
324     {
325       "name" : "setPosition",
326       "desc" : "Sets the left and top of the component.  To set the page XY position instead, use {@link #setPagePosition}.\nThis method fires the move event.",
327       "isStatic" : false,
328       "isConstructor" : false,
329       "isPrivate" : false,
330       "memberOf" : "Roo.BoxComponent",
331       "example" : "",
332       "deprecated" : "",
333       "since" : "",
334       "see" : "",
335       "params" : [
336         {
337           "name" : "left",
338           "type" : "Number",
339           "desc" : "The new left",
340           "isOptional" : false
341         },
342         {
343           "name" : "top",
344           "type" : "Number",
345           "desc" : "The new top",
346           "isOptional" : false
347         }
348       ],
349       "returns" : [
350       ]
351     },
352     {
353       "name" : "getId",
354       "desc" : "Returns the id of this component.",
355       "isStatic" : false,
356       "isConstructor" : false,
357       "isPrivate" : false,
358       "memberOf" : "Roo.Component",
359       "example" : "",
360       "deprecated" : "",
361       "since" : "",
362       "see" : "",
363       "params" : [
364       ],
365       "returns" : [
366         {
367           "name" : "",
368           "type" : "String",
369           "desc" : ""
370         }
371       ]
372     },
373     {
374       "name" : "render",
375       "desc" : "If this is a lazy rendering component, render it to its container element.",
376       "isStatic" : false,
377       "isConstructor" : false,
378       "isPrivate" : false,
379       "memberOf" : "Roo.Component",
380       "example" : "",
381       "deprecated" : "",
382       "since" : "",
383       "see" : "",
384       "params" : [
385         {
386           "name" : "container",
387           "type" : "String/HTMLElement/Element",
388           "desc" : "(optional) The element this component should be rendered into. If it is being applied to existing markup, this should be left off.",
389           "isOptional" : false
390         }
391       ],
392       "returns" : [
393       ]
394     },
395     {
396       "name" : "destroy",
397       "desc" : "Destroys this component by purging any event listeners, removing the component's element from the DOM,\nremoving the component from its {@link Roo.Container} (if applicable) and unregistering it from {@link Roo.ComponentMgr}.",
398       "isStatic" : false,
399       "isConstructor" : false,
400       "isPrivate" : false,
401       "memberOf" : "Roo.Component",
402       "example" : "",
403       "deprecated" : "",
404       "since" : "",
405       "see" : "",
406       "params" : [
407       ],
408       "returns" : [
409       ]
410     },
411     {
412       "name" : "isVisible",
413       "desc" : "Returns true if this component is visible.",
414       "isStatic" : false,
415       "isConstructor" : false,
416       "isPrivate" : false,
417       "memberOf" : "Roo.Component",
418       "example" : "",
419       "deprecated" : "",
420       "since" : "",
421       "see" : "",
422       "params" : [
423       ],
424       "returns" : [
425       ]
426     },
427     {
428       "name" : "setDisabled",
429       "desc" : "Convenience function for setting disabled/enabled by boolean.",
430       "isStatic" : false,
431       "isConstructor" : false,
432       "isPrivate" : false,
433       "memberOf" : "Roo.Component",
434       "example" : "",
435       "deprecated" : "",
436       "since" : "",
437       "see" : "",
438       "params" : [
439         {
440           "name" : "disabled",
441           "type" : "Boolean",
442           "desc" : "",
443           "isOptional" : false
444         }
445       ],
446       "returns" : [
447       ]
448     },
449     {
450       "name" : "hide",
451       "desc" : "Hide this component.",
452       "isStatic" : false,
453       "isConstructor" : false,
454       "isPrivate" : false,
455       "memberOf" : "Roo.Component",
456       "example" : "",
457       "deprecated" : "",
458       "since" : "",
459       "see" : "",
460       "params" : [
461       ],
462       "returns" : [
463         {
464           "name" : "",
465           "type" : "Roo.Component",
466           "desc" : "this"
467         }
468       ]
469     },
470     {
471       "name" : "focus",
472       "desc" : "Try to focus this component.",
473       "isStatic" : false,
474       "isConstructor" : false,
475       "isPrivate" : false,
476       "memberOf" : "Roo.Component",
477       "example" : "",
478       "deprecated" : "",
479       "since" : "",
480       "see" : "",
481       "params" : [
482         {
483           "name" : "selectText",
484           "type" : "Boolean",
485           "desc" : "True to also select the text in this component (if applicable)",
486           "isOptional" : false
487         }
488       ],
489       "returns" : [
490         {
491           "name" : "",
492           "type" : "Roo.Component",
493           "desc" : "this"
494         }
495       ]
496     },
497     {
498       "name" : "show",
499       "desc" : "Show this component.",
500       "isStatic" : false,
501       "isConstructor" : false,
502       "isPrivate" : false,
503       "memberOf" : "Roo.Component",
504       "example" : "",
505       "deprecated" : "",
506       "since" : "",
507       "see" : "",
508       "params" : [
509       ],
510       "returns" : [
511         {
512           "name" : "",
513           "type" : "Roo.Component",
514           "desc" : "this"
515         }
516       ]
517     },
518     {
519       "name" : "enable",
520       "desc" : "Enable this component.",
521       "isStatic" : false,
522       "isConstructor" : false,
523       "isPrivate" : false,
524       "memberOf" : "Roo.Component",
525       "example" : "",
526       "deprecated" : "",
527       "since" : "",
528       "see" : "",
529       "params" : [
530       ],
531       "returns" : [
532         {
533           "name" : "",
534           "type" : "Roo.Component",
535           "desc" : "this"
536         }
537       ]
538     },
539     {
540       "name" : "setVisible",
541       "desc" : "Convenience function to hide or show this component by boolean.",
542       "isStatic" : false,
543       "isConstructor" : false,
544       "isPrivate" : false,
545       "memberOf" : "Roo.Component",
546       "example" : "",
547       "deprecated" : "",
548       "since" : "",
549       "see" : "",
550       "params" : [
551         {
552           "name" : "visible",
553           "type" : "Boolean",
554           "desc" : "True to show, false to hide",
555           "isOptional" : false
556         }
557       ],
558       "returns" : [
559         {
560           "name" : "",
561           "type" : "Roo.Component",
562           "desc" : "this"
563         }
564       ]
565     },
566     {
567       "name" : "disable",
568       "desc" : "Disable this component.",
569       "isStatic" : false,
570       "isConstructor" : false,
571       "isPrivate" : false,
572       "memberOf" : "Roo.Component",
573       "example" : "",
574       "deprecated" : "",
575       "since" : "",
576       "see" : "",
577       "params" : [
578       ],
579       "returns" : [
580         {
581           "name" : "",
582           "type" : "Roo.Component",
583           "desc" : "this"
584         }
585       ]
586     },
587     {
588       "name" : "getEl",
589       "desc" : "Returns the underlying {@link Roo.Element}.",
590       "isStatic" : false,
591       "isConstructor" : false,
592       "isPrivate" : false,
593       "memberOf" : "Roo.Component",
594       "example" : "",
595       "deprecated" : "",
596       "since" : "",
597       "see" : "",
598       "params" : [
599       ],
600       "returns" : [
601         {
602           "name" : "",
603           "type" : "Roo.Element",
604           "desc" : "The element"
605         }
606       ]
607     },
608     {
609       "name" : "purgeListeners",
610       "desc" : "Removes all listeners for this object",
611       "isStatic" : false,
612       "isConstructor" : false,
613       "isPrivate" : false,
614       "memberOf" : "Roo.util.Observable",
615       "example" : "",
616       "deprecated" : "",
617       "since" : "",
618       "see" : "",
619       "params" : [
620       ],
621       "returns" : [
622       ]
623     },
624     {
625       "name" : "on",
626       "desc" : "Appends an event handler to this element (shorthand for addListener)",
627       "isStatic" : false,
628       "isConstructor" : false,
629       "isPrivate" : false,
630       "memberOf" : "Roo.util.Observable",
631       "example" : "",
632       "deprecated" : "",
633       "since" : "",
634       "see" : "",
635       "params" : [
636         {
637           "name" : "eventName",
638           "type" : "String",
639           "desc" : "The type of event to listen for",
640           "isOptional" : false
641         },
642         {
643           "name" : "handler",
644           "type" : "Function",
645           "desc" : "The method the event invokes",
646           "isOptional" : false
647         },
648         {
649           "name" : "scope",
650           "type" : "Object",
651           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
652           "isOptional" : false
653         },
654         {
655           "name" : "options",
656           "type" : "Object",
657           "desc" : "(optional)",
658           "isOptional" : false
659         }
660       ],
661       "returns" : [
662       ]
663     },
664     {
665       "name" : "un",
666       "desc" : "Removes a listener (shorthand for removeListener)",
667       "isStatic" : false,
668       "isConstructor" : false,
669       "isPrivate" : false,
670       "memberOf" : "Roo.util.Observable",
671       "example" : "",
672       "deprecated" : "",
673       "since" : "",
674       "see" : "",
675       "params" : [
676         {
677           "name" : "eventName",
678           "type" : "String",
679           "desc" : "The type of event to listen for",
680           "isOptional" : false
681         },
682         {
683           "name" : "handler",
684           "type" : "Function",
685           "desc" : "The handler to remove",
686           "isOptional" : false
687         },
688         {
689           "name" : "scope",
690           "type" : "Object",
691           "desc" : "(optional) The scope (this object) for the handler",
692           "isOptional" : false
693         }
694       ],
695       "returns" : [
696       ]
697     },
698     {
699       "name" : "addEvents",
700       "desc" : "Used to define events on this Observable",
701       "isStatic" : false,
702       "isConstructor" : false,
703       "isPrivate" : false,
704       "memberOf" : "Roo.util.Observable",
705       "example" : "",
706       "deprecated" : "",
707       "since" : "",
708       "see" : "",
709       "params" : [
710         {
711           "name" : "object",
712           "type" : "Object",
713           "desc" : "The object with the events defined",
714           "isOptional" : false
715         }
716       ],
717       "returns" : [
718       ]
719     },
720     {
721       "name" : "releaseCapture",
722       "desc" : "Removes <b>all</b> added captures from the Observable.",
723       "isStatic" : true,
724       "isConstructor" : false,
725       "isPrivate" : false,
726       "memberOf" : "Roo.util.Observable",
727       "example" : "",
728       "deprecated" : "",
729       "since" : "",
730       "see" : "",
731       "params" : [
732         {
733           "name" : "o",
734           "type" : "Observable",
735           "desc" : "The Observable to release",
736           "isOptional" : false
737         }
738       ],
739       "returns" : [
740       ]
741     },
742     {
743       "name" : "removeListener",
744       "desc" : "Removes a listener",
745       "isStatic" : false,
746       "isConstructor" : false,
747       "isPrivate" : false,
748       "memberOf" : "Roo.util.Observable",
749       "example" : "",
750       "deprecated" : "",
751       "since" : "",
752       "see" : "",
753       "params" : [
754         {
755           "name" : "eventName",
756           "type" : "String",
757           "desc" : "The type of event to listen for",
758           "isOptional" : false
759         },
760         {
761           "name" : "handler",
762           "type" : "Function",
763           "desc" : "The handler to remove",
764           "isOptional" : false
765         },
766         {
767           "name" : "scope",
768           "type" : "Object",
769           "desc" : "(optional) The scope (this object) for the handler",
770           "isOptional" : false
771         }
772       ],
773       "returns" : [
774       ]
775     },
776     {
777       "name" : "fireEvent",
778       "desc" : "Fires the specified event with the passed parameters (minus the event name).",
779       "isStatic" : false,
780       "isConstructor" : false,
781       "isPrivate" : false,
782       "memberOf" : "Roo.util.Observable",
783       "example" : "",
784       "deprecated" : "",
785       "since" : "",
786       "see" : "",
787       "params" : [
788         {
789           "name" : "eventName",
790           "type" : "String",
791           "desc" : "",
792           "isOptional" : false
793         },
794         {
795           "name" : "args",
796           "type" : "Object...",
797           "desc" : "Variable number of parameters are passed to handlers",
798           "isOptional" : false
799         }
800       ],
801       "returns" : [
802         {
803           "name" : "",
804           "type" : "Boolean",
805           "desc" : "returns false if any of the handlers return false otherwise it returns true"
806         }
807       ]
808     },
809     {
810       "name" : "hasListener",
811       "desc" : "Checks to see if this object has any listeners for a specified event",
812       "isStatic" : false,
813       "isConstructor" : false,
814       "isPrivate" : false,
815       "memberOf" : "Roo.util.Observable",
816       "example" : "",
817       "deprecated" : "",
818       "since" : "",
819       "see" : "",
820       "params" : [
821         {
822           "name" : "eventName",
823           "type" : "String",
824           "desc" : "The name of the event to check for",
825           "isOptional" : false
826         }
827       ],
828       "returns" : [
829         {
830           "name" : "",
831           "type" : "Boolean",
832           "desc" : "True if the event is being listened for, else false"
833         }
834       ]
835     },
836     {
837       "name" : "capture",
838       "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.",
839       "isStatic" : true,
840       "isConstructor" : false,
841       "isPrivate" : false,
842       "memberOf" : "Roo.util.Observable",
843       "example" : "",
844       "deprecated" : "",
845       "since" : "",
846       "see" : "",
847       "params" : [
848         {
849           "name" : "o",
850           "type" : "Observable",
851           "desc" : "The Observable to capture",
852           "isOptional" : false
853         },
854         {
855           "name" : "fn",
856           "type" : "Function",
857           "desc" : "The function to call",
858           "isOptional" : false
859         },
860         {
861           "name" : "scope",
862           "type" : "Object",
863           "desc" : "(optional) The scope (this object) for the fn",
864           "isOptional" : false
865         }
866       ],
867       "returns" : [
868       ]
869     },
870     {
871       "name" : "addListener",
872       "desc" : "Appends an event handler to this component",
873       "isStatic" : false,
874       "isConstructor" : false,
875       "isPrivate" : false,
876       "memberOf" : "Roo.util.Observable",
877       "example" : "",
878       "deprecated" : "",
879       "since" : "",
880       "see" : "",
881       "params" : [
882         {
883           "name" : "eventName",
884           "type" : "String",
885           "desc" : "The type of event to listen for",
886           "isOptional" : false
887         },
888         {
889           "name" : "handler",
890           "type" : "Function",
891           "desc" : "The method the event invokes",
892           "isOptional" : false
893         },
894         {
895           "name" : "scope",
896           "type" : "Object",
897           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
898           "isOptional" : false
899         },
900         {
901           "name" : "options",
902           "type" : "Object",
903           "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>",
904           "isOptional" : false
905         }
906       ],
907       "returns" : [
908       ]
909     }
910   ],
911   "events" : [
912     {
913       "name" : "move",
914       "desc" : "Fires after the component is moved.",
915       "memberOf" : "Roo.BoxComponent",
916       "example" : "",
917       "deprecated" : "",
918       "since" : "",
919       "see" : "",
920       "params" : [
921         {
922           "name" : "this",
923           "type" : "Roo.Component",
924           "desc" : "",
925           "isOptional" : false
926         },
927         {
928           "name" : "x",
929           "type" : "Number",
930           "desc" : "The new x position",
931           "isOptional" : false
932         },
933         {
934           "name" : "y",
935           "type" : "Number",
936           "desc" : "The new y position",
937           "isOptional" : false
938         }
939       ],
940       "returns" : [
941       ]
942     },
943     {
944       "name" : "resize",
945       "desc" : "Fires after the component is resized.",
946       "memberOf" : "Roo.BoxComponent",
947       "example" : "",
948       "deprecated" : "",
949       "since" : "",
950       "see" : "",
951       "params" : [
952         {
953           "name" : "this",
954           "type" : "Roo.Component",
955           "desc" : "",
956           "isOptional" : false
957         },
958         {
959           "name" : "adjWidth",
960           "type" : "Number",
961           "desc" : "The box-adjusted width that was set",
962           "isOptional" : false
963         },
964         {
965           "name" : "adjHeight",
966           "type" : "Number",
967           "desc" : "The box-adjusted height that was set",
968           "isOptional" : false
969         },
970         {
971           "name" : "rawWidth",
972           "type" : "Number",
973           "desc" : "The width that was originally specified",
974           "isOptional" : false
975         },
976         {
977           "name" : "rawHeight",
978           "type" : "Number",
979           "desc" : "The height that was originally specified",
980           "isOptional" : false
981         }
982       ],
983       "returns" : [
984       ]
985     },
986     {
987       "name" : "beforerender",
988       "desc" : "Fires before the component is rendered. Return false to stop the render.",
989       "memberOf" : "Roo.Component",
990       "example" : "",
991       "deprecated" : "",
992       "since" : "",
993       "see" : "",
994       "params" : [
995         {
996           "name" : "this",
997           "type" : "Roo.Component",
998           "desc" : "",
999           "isOptional" : false
1000         }
1001       ],
1002       "returns" : [
1003       ]
1004     },
1005     {
1006       "name" : "disable",
1007       "desc" : "Fires after the component is disabled.",
1008       "memberOf" : "Roo.Component",
1009       "example" : "",
1010       "deprecated" : "",
1011       "since" : "",
1012       "see" : "",
1013       "params" : [
1014         {
1015           "name" : "this",
1016           "type" : "Roo.Component",
1017           "desc" : "",
1018           "isOptional" : false
1019         }
1020       ],
1021       "returns" : [
1022       ]
1023     },
1024     {
1025       "name" : "render",
1026       "desc" : "Fires after the component is rendered.",
1027       "memberOf" : "Roo.Component",
1028       "example" : "",
1029       "deprecated" : "",
1030       "since" : "",
1031       "see" : "",
1032       "params" : [
1033         {
1034           "name" : "this",
1035           "type" : "Roo.Component",
1036           "desc" : "",
1037           "isOptional" : false
1038         }
1039       ],
1040       "returns" : [
1041       ]
1042     },
1043     {
1044       "name" : "destroy",
1045       "desc" : "Fires after the component is destroyed.",
1046       "memberOf" : "Roo.Component",
1047       "example" : "",
1048       "deprecated" : "",
1049       "since" : "",
1050       "see" : "",
1051       "params" : [
1052         {
1053           "name" : "this",
1054           "type" : "Roo.Component",
1055           "desc" : "",
1056           "isOptional" : false
1057         }
1058       ],
1059       "returns" : [
1060       ]
1061     },
1062     {
1063       "name" : "hide",
1064       "desc" : "Fires after the component is hidden.",
1065       "memberOf" : "Roo.Component",
1066       "example" : "",
1067       "deprecated" : "",
1068       "since" : "",
1069       "see" : "",
1070       "params" : [
1071         {
1072           "name" : "this",
1073           "type" : "Roo.Component",
1074           "desc" : "",
1075           "isOptional" : false
1076         }
1077       ],
1078       "returns" : [
1079       ]
1080     },
1081     {
1082       "name" : "beforehide",
1083       "desc" : "Fires before the component is hidden. Return false to stop the hide.",
1084       "memberOf" : "Roo.Component",
1085       "example" : "",
1086       "deprecated" : "",
1087       "since" : "",
1088       "see" : "",
1089       "params" : [
1090         {
1091           "name" : "this",
1092           "type" : "Roo.Component",
1093           "desc" : "",
1094           "isOptional" : false
1095         }
1096       ],
1097       "returns" : [
1098       ]
1099     },
1100     {
1101       "name" : "show",
1102       "desc" : "Fires after the component is shown.",
1103       "memberOf" : "Roo.Component",
1104       "example" : "",
1105       "deprecated" : "",
1106       "since" : "",
1107       "see" : "",
1108       "params" : [
1109         {
1110           "name" : "this",
1111           "type" : "Roo.Component",
1112           "desc" : "",
1113           "isOptional" : false
1114         }
1115       ],
1116       "returns" : [
1117       ]
1118     },
1119     {
1120       "name" : "beforeshow",
1121       "desc" : "Fires before the component is shown.  Return false to stop the show.",
1122       "memberOf" : "Roo.Component",
1123       "example" : "",
1124       "deprecated" : "",
1125       "since" : "",
1126       "see" : "",
1127       "params" : [
1128         {
1129           "name" : "this",
1130           "type" : "Roo.Component",
1131           "desc" : "",
1132           "isOptional" : false
1133         }
1134       ],
1135       "returns" : [
1136       ]
1137     },
1138     {
1139       "name" : "enable",
1140       "desc" : "Fires after the component is enabled.",
1141       "memberOf" : "Roo.Component",
1142       "example" : "",
1143       "deprecated" : "",
1144       "since" : "",
1145       "see" : "",
1146       "params" : [
1147         {
1148           "name" : "this",
1149           "type" : "Roo.Component",
1150           "desc" : "",
1151           "isOptional" : false
1152         }
1153       ],
1154       "returns" : [
1155       ]
1156     },
1157     {
1158       "name" : "beforedestroy",
1159       "desc" : "Fires before the component is destroyed. Return false to stop the destroy.",
1160       "memberOf" : "Roo.Component",
1161       "example" : "",
1162       "deprecated" : "",
1163       "since" : "",
1164       "see" : "",
1165       "params" : [
1166         {
1167           "name" : "this",
1168           "type" : "Roo.Component",
1169           "desc" : "",
1170           "isOptional" : false
1171         }
1172       ],
1173       "returns" : [
1174       ]
1175     }
1176   ]
1177 }