sync
[roojs1] / docs / symbols / Roo.util.MixedCollection.json
1 {
2   "name" : "Roo.util.MixedCollection",
3   "augments" : [
4     "Roo.util.Observable"
5   ],
6   "childClasses" : {  },
7   "tree_children" : [],
8   "tree_parent" : [],
9   "desc" : "A Collection class that maintains both numeric indexes and keys and exposes events.",
10   "isSingleton" : false,
11   "isStatic" : true,
12   "isBuiltin" : false,
13   "isAbstract" : false,
14   "isBuilderTop" : false,
15   "memberOf" : "MixedCollection",
16   "example" : "",
17   "deprecated" : "",
18   "since" : "",
19   "see" : "",
20   "params" : [
21     {
22       "name" : "allowFunctions",
23       "type" : "Boolean",
24       "desc" : "True if the addAll function should add function references to the\ncollection (defaults to false)",
25       "isOptional" : false
26     },
27     {
28       "name" : "keyFn",
29       "type" : "Function",
30       "desc" : "A function that can accept an item of the type(s) stored in this MixedCollection\nand return the key value for that item.  This is used when available to look up the key on items that\nwere passed without an explicit key parameter to a MixedCollection method.  Passing this parameter is\nequivalent to providing an implementation for the {@link #getKey} method.",
31       "isOptional" : false
32     }
33   ],
34   "returns" : [],
35   "throws" : "",
36   "requires" : "",
37   "config" : [
38     {
39       "name" : "listeners",
40       "type" : "Object",
41       "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>",
42       "memberOf" : "Roo.util.Observable"
43     }
44   ],
45   "methods" : [
46     {
47       "name" : "remove",
48       "type" : "function",
49       "desc" : "Removed an item from the collection.",
50       "sig" : "(o)",
51       "static" : false,
52       "memberOf" : "",
53       "isStatic" : false,
54       "isConstructor" : false,
55       "isPrivate" : false,
56       "example" : "",
57       "deprecated" : "",
58       "since" : "",
59       "see" : "",
60       "exceptions" : "",
61       "requires" : "",
62       "params" : [
63         {
64           "name" : "o",
65           "type" : "Object",
66           "desc" : "The item to remove.",
67           "isOptional" : false
68         }
69       ],
70       "returns" : [
71         {
72           "name" : "",
73           "type" : "Object",
74           "desc" : "The item removed."
75         }
76       ]
77     },
78     {
79       "name" : "get",
80       "type" : "function",
81       "desc" : "Returns the item associated with the passed key or index.",
82       "sig" : "(key)",
83       "static" : false,
84       "memberOf" : "",
85       "isStatic" : false,
86       "isConstructor" : false,
87       "isPrivate" : false,
88       "example" : "",
89       "deprecated" : "",
90       "since" : "",
91       "see" : "",
92       "exceptions" : "",
93       "requires" : "",
94       "params" : [
95         {
96           "name" : "key",
97           "type" : "String/Number",
98           "desc" : "The key or index of the item.",
99           "isOptional" : false
100         }
101       ],
102       "returns" : [
103         {
104           "name" : "",
105           "type" : "Object",
106           "desc" : "The item associated with the passed key."
107         }
108       ]
109     },
110     {
111       "name" : "itemAt",
112       "type" : "function",
113       "desc" : "Returns the item at the specified index.",
114       "sig" : "(index)",
115       "static" : false,
116       "memberOf" : "",
117       "isStatic" : false,
118       "isConstructor" : false,
119       "isPrivate" : false,
120       "example" : "",
121       "deprecated" : "",
122       "since" : "",
123       "see" : "",
124       "exceptions" : "",
125       "requires" : "",
126       "params" : [
127         {
128           "name" : "index",
129           "type" : "Number",
130           "desc" : "The index of the item.",
131           "isOptional" : false
132         }
133       ],
134       "returns" : [
135         {
136           "name" : "",
137           "type" : "Object",
138           "desc" : ""
139         }
140       ]
141     },
142     {
143       "name" : "each",
144       "type" : "function",
145       "desc" : "Executes the specified function once for every item in the collection, passing each\nitem as the first and only parameter. returning false from the function will stop the iteration.",
146       "sig" : "(fn, scope)",
147       "static" : false,
148       "memberOf" : "",
149       "isStatic" : false,
150       "isConstructor" : false,
151       "isPrivate" : false,
152       "example" : "",
153       "deprecated" : "",
154       "since" : "",
155       "see" : "",
156       "exceptions" : "",
157       "requires" : "",
158       "params" : [
159         {
160           "name" : "fn",
161           "type" : "Function",
162           "desc" : "The function to execute for each item.",
163           "isOptional" : false
164         },
165         {
166           "name" : "scope",
167           "type" : "Object",
168           "desc" : "(optional) The scope in which to execute the function.",
169           "isOptional" : false
170         }
171       ],
172       "returns" : []
173     },
174     {
175       "name" : "insert",
176       "type" : "function",
177       "desc" : "Inserts an item at the specified index in the collection.",
178       "sig" : "(index, key, o)",
179       "static" : false,
180       "memberOf" : "",
181       "isStatic" : false,
182       "isConstructor" : false,
183       "isPrivate" : false,
184       "example" : "",
185       "deprecated" : "",
186       "since" : "",
187       "see" : "",
188       "exceptions" : "",
189       "requires" : "",
190       "params" : [
191         {
192           "name" : "index",
193           "type" : "Number",
194           "desc" : "The index to insert the item at.",
195           "isOptional" : false
196         },
197         {
198           "name" : "key",
199           "type" : "String",
200           "desc" : "The key to associate with the new item, or the item itself.",
201           "isOptional" : false
202         },
203         {
204           "name" : "o",
205           "type" : "Object",
206           "desc" : "(optional) If the second parameter was a key, the new item.",
207           "isOptional" : false
208         }
209       ],
210       "returns" : [
211         {
212           "name" : "",
213           "type" : "Object",
214           "desc" : "The item inserted."
215         }
216       ]
217     },
218     {
219       "name" : "getCount",
220       "type" : "function",
221       "desc" : "Returns the number of items in the collection.",
222       "sig" : "()\n{\n\n}",
223       "static" : false,
224       "memberOf" : "",
225       "isStatic" : false,
226       "isConstructor" : false,
227       "isPrivate" : false,
228       "example" : "",
229       "deprecated" : "",
230       "since" : "",
231       "see" : "",
232       "exceptions" : "",
233       "requires" : "",
234       "params" : [],
235       "returns" : [
236         {
237           "name" : "",
238           "type" : "Number",
239           "desc" : "the number of items in the collection."
240         }
241       ]
242     },
243     {
244       "name" : "clear",
245       "type" : "function",
246       "desc" : "Removes all items from the collection.",
247       "sig" : "()\n{\n\n}",
248       "static" : false,
249       "memberOf" : "",
250       "isStatic" : false,
251       "isConstructor" : false,
252       "isPrivate" : false,
253       "example" : "",
254       "deprecated" : "",
255       "since" : "",
256       "see" : "",
257       "exceptions" : "",
258       "requires" : "",
259       "params" : [],
260       "returns" : []
261     },
262     {
263       "name" : "keySort",
264       "type" : "function",
265       "desc" : "Sorts this collection by keys",
266       "sig" : "(direction, fn)",
267       "static" : false,
268       "memberOf" : "",
269       "isStatic" : false,
270       "isConstructor" : false,
271       "isPrivate" : false,
272       "example" : "",
273       "deprecated" : "",
274       "since" : "",
275       "see" : "",
276       "exceptions" : "",
277       "requires" : "",
278       "params" : [
279         {
280           "name" : "direction",
281           "type" : "String",
282           "desc" : "(optional) \"ASC\" or \"DESC\"",
283           "isOptional" : false
284         },
285         {
286           "name" : "fn",
287           "type" : "Function",
288           "desc" : "(optional) a comparison function (defaults to case insensitive string)",
289           "isOptional" : false
290         }
291       ],
292       "returns" : []
293     },
294     {
295       "name" : "indexOf",
296       "type" : "function",
297       "desc" : "Returns index within the collection of the passed Object.",
298       "sig" : "(o)",
299       "static" : false,
300       "memberOf" : "",
301       "isStatic" : false,
302       "isConstructor" : false,
303       "isPrivate" : false,
304       "example" : "",
305       "deprecated" : "",
306       "since" : "",
307       "see" : "",
308       "exceptions" : "",
309       "requires" : "",
310       "params" : [
311         {
312           "name" : "o",
313           "type" : "Object",
314           "desc" : "The item to find the index of.",
315           "isOptional" : false
316         }
317       ],
318       "returns" : [
319         {
320           "name" : "",
321           "type" : "Number",
322           "desc" : "index of the item."
323         }
324       ]
325     },
326     {
327       "name" : "clone",
328       "type" : "function",
329       "desc" : "Creates a duplicate of this collection",
330       "sig" : "()\n{\n\n}",
331       "static" : false,
332       "memberOf" : "",
333       "isStatic" : false,
334       "isConstructor" : false,
335       "isPrivate" : false,
336       "example" : "",
337       "deprecated" : "",
338       "since" : "",
339       "see" : "",
340       "exceptions" : "",
341       "requires" : "",
342       "params" : [],
343       "returns" : [
344         {
345           "name" : "",
346           "type" : "MixedCollection",
347           "desc" : ""
348         }
349       ]
350     },
351     {
352       "name" : "containsKey",
353       "type" : "function",
354       "desc" : "Returns true if the collection contains the passed Object as a key.",
355       "sig" : "(key)",
356       "static" : false,
357       "memberOf" : "",
358       "isStatic" : false,
359       "isConstructor" : false,
360       "isPrivate" : false,
361       "example" : "",
362       "deprecated" : "",
363       "since" : "",
364       "see" : "",
365       "exceptions" : "",
366       "requires" : "",
367       "params" : [
368         {
369           "name" : "key",
370           "type" : "String",
371           "desc" : "The key to look for in the collection.",
372           "isOptional" : false
373         }
374       ],
375       "returns" : [
376         {
377           "name" : "",
378           "type" : "Boolean",
379           "desc" : "True if the collection contains the Object as a key."
380         }
381       ]
382     },
383     {
384       "name" : "getKey",
385       "type" : "function",
386       "desc" : "MixedCollection has a generic way to fetch keys if you implement getKey.\n<pre><code>\n// normal way\nvar mc = new Roo.util.MixedCollection();\nmc.add(someEl.dom.id, someEl);\nmc.add(otherEl.dom.id, otherEl);\n//and so on\n\n// using getKey\nvar mc = new Roo.util.MixedCollection();\nmc.getKey = function(el){\n   return el.dom.id;\n};\nmc.add(someEl);\nmc.add(otherEl);\n\n// or via the constructor\nvar mc = new Roo.util.MixedCollection(false, function(el){\n   return el.dom.id;\n});\nmc.add(someEl);\nmc.add(otherEl);\n</code></pre>",
387       "sig" : "(o)",
388       "static" : false,
389       "memberOf" : "",
390       "isStatic" : false,
391       "isConstructor" : false,
392       "isPrivate" : false,
393       "example" : "",
394       "deprecated" : "",
395       "since" : "",
396       "see" : "",
397       "exceptions" : "",
398       "requires" : "",
399       "params" : [
400         {
401           "name" : "o",
402           "type" : "",
403           "desc" : "{Object} The item for which to find the key.",
404           "isOptional" : false
405         }
406       ],
407       "returns" : [
408         {
409           "name" : "",
410           "type" : "Object",
411           "desc" : "The key for the passed item."
412         }
413       ]
414     },
415     {
416       "name" : "find",
417       "type" : "function",
418       "desc" : "Returns the first item in the collection which elicits a true return value from the\npassed selection function.",
419       "sig" : "(fn, scope)",
420       "static" : false,
421       "memberOf" : "",
422       "isStatic" : false,
423       "isConstructor" : false,
424       "isPrivate" : false,
425       "example" : "",
426       "deprecated" : "",
427       "since" : "",
428       "see" : "",
429       "exceptions" : "",
430       "requires" : "",
431       "params" : [
432         {
433           "name" : "fn",
434           "type" : "Function",
435           "desc" : "The selection function to execute for each item.",
436           "isOptional" : false
437         },
438         {
439           "name" : "scope",
440           "type" : "Object",
441           "desc" : "(optional) The scope in which to execute the function.",
442           "isOptional" : false
443         }
444       ],
445       "returns" : [
446         {
447           "name" : "",
448           "type" : "Object",
449           "desc" : "The first item in the collection which returned true from the selection function."
450         }
451       ]
452     },
453     {
454       "name" : "getRange",
455       "type" : "function",
456       "desc" : "Returns a range of items in this collection",
457       "sig" : "(startIndex, endIndex)",
458       "static" : false,
459       "memberOf" : "",
460       "isStatic" : false,
461       "isConstructor" : false,
462       "isPrivate" : false,
463       "example" : "",
464       "deprecated" : "",
465       "since" : "",
466       "see" : "",
467       "exceptions" : "",
468       "requires" : "",
469       "params" : [
470         {
471           "name" : "startIndex",
472           "type" : "Number",
473           "desc" : "(optional) defaults to 0",
474           "isOptional" : false
475         },
476         {
477           "name" : "endIndex",
478           "type" : "Number",
479           "desc" : "(optional) default to the last item",
480           "isOptional" : false
481         }
482       ],
483       "returns" : [
484         {
485           "name" : "",
486           "type" : "Array",
487           "desc" : "An array of items"
488         }
489       ]
490     },
491     {
492       "name" : "eachKey",
493       "type" : "function",
494       "desc" : "Executes the specified function once for every key in the collection, passing each\nkey, and its associated item as the first two parameters.",
495       "sig" : "(fn, scope)",
496       "static" : false,
497       "memberOf" : "",
498       "isStatic" : false,
499       "isConstructor" : false,
500       "isPrivate" : false,
501       "example" : "",
502       "deprecated" : "",
503       "since" : "",
504       "see" : "",
505       "exceptions" : "",
506       "requires" : "",
507       "params" : [
508         {
509           "name" : "fn",
510           "type" : "Function",
511           "desc" : "The function to execute for each item.",
512           "isOptional" : false
513         },
514         {
515           "name" : "scope",
516           "type" : "Object",
517           "desc" : "(optional) The scope in which to execute the function.",
518           "isOptional" : false
519         }
520       ],
521       "returns" : []
522     },
523     {
524       "name" : "indexOfKey",
525       "type" : "function",
526       "desc" : "Returns index within the collection of the passed key.",
527       "sig" : "(key)",
528       "static" : false,
529       "memberOf" : "",
530       "isStatic" : false,
531       "isConstructor" : false,
532       "isPrivate" : false,
533       "example" : "",
534       "deprecated" : "",
535       "since" : "",
536       "see" : "",
537       "exceptions" : "",
538       "requires" : "",
539       "params" : [
540         {
541           "name" : "key",
542           "type" : "String",
543           "desc" : "The key to find the index of.",
544           "isOptional" : false
545         }
546       ],
547       "returns" : [
548         {
549           "name" : "",
550           "type" : "Number",
551           "desc" : "index of the key."
552         }
553       ]
554     },
555     {
556       "name" : "contains",
557       "type" : "function",
558       "desc" : "Returns true if the collection contains the passed Object as an item.",
559       "sig" : "(o)",
560       "static" : false,
561       "memberOf" : "",
562       "isStatic" : false,
563       "isConstructor" : false,
564       "isPrivate" : false,
565       "example" : "",
566       "deprecated" : "",
567       "since" : "",
568       "see" : "",
569       "exceptions" : "",
570       "requires" : "",
571       "params" : [
572         {
573           "name" : "o",
574           "type" : "Object",
575           "desc" : "The Object to look for in the collection.",
576           "isOptional" : false
577         }
578       ],
579       "returns" : [
580         {
581           "name" : "",
582           "type" : "Boolean",
583           "desc" : "True if the collection contains the Object as an item."
584         }
585       ]
586     },
587     {
588       "name" : "addAll",
589       "type" : "function",
590       "desc" : "Adds all elements of an Array or an Object to the collection.",
591       "sig" : "(objs)",
592       "static" : false,
593       "memberOf" : "",
594       "isStatic" : false,
595       "isConstructor" : false,
596       "isPrivate" : false,
597       "example" : "",
598       "deprecated" : "",
599       "since" : "",
600       "see" : "",
601       "exceptions" : "",
602       "requires" : "",
603       "params" : [
604         {
605           "name" : "objs",
606           "type" : "Object/Array",
607           "desc" : "An Object containing properties which will be added to the collection, or\nan Array of values, each of which are added to the collection.",
608           "isOptional" : false
609         }
610       ],
611       "returns" : []
612     },
613     {
614       "name" : "key",
615       "type" : "function",
616       "desc" : "Returns the item associated with the passed key.",
617       "sig" : "(key)",
618       "static" : false,
619       "memberOf" : "",
620       "isStatic" : false,
621       "isConstructor" : false,
622       "isPrivate" : false,
623       "example" : "",
624       "deprecated" : "",
625       "since" : "",
626       "see" : "",
627       "exceptions" : "",
628       "requires" : "",
629       "params" : [
630         {
631           "name" : "key",
632           "type" : "String/Number",
633           "desc" : "The key of the item.",
634           "isOptional" : false
635         }
636       ],
637       "returns" : [
638         {
639           "name" : "",
640           "type" : "Object",
641           "desc" : "The item associated with the passed key."
642         }
643       ]
644     },
645     {
646       "name" : "item",
647       "type" : "function",
648       "desc" : "Returns the item associated with the passed key OR index. Key has priority over index.",
649       "sig" : "(key)",
650       "static" : false,
651       "memberOf" : "",
652       "isStatic" : false,
653       "isConstructor" : false,
654       "isPrivate" : false,
655       "example" : "",
656       "deprecated" : "",
657       "since" : "",
658       "see" : "",
659       "exceptions" : "",
660       "requires" : "",
661       "params" : [
662         {
663           "name" : "key",
664           "type" : "String/Number",
665           "desc" : "The key or index of the item.",
666           "isOptional" : false
667         }
668       ],
669       "returns" : [
670         {
671           "name" : "",
672           "type" : "Object",
673           "desc" : "The item associated with the passed key."
674         }
675       ]
676     },
677     {
678       "name" : "filterBy",
679       "type" : "function",
680       "desc" : "Filter by a function. * Returns a new collection that has been filtered.\nThe passed function will be called with each \nobject in the collection. If the function returns true, the value is included \notherwise it is filtered.",
681       "sig" : "(fn, scope)",
682       "static" : false,
683       "memberOf" : "",
684       "isStatic" : false,
685       "isConstructor" : false,
686       "isPrivate" : false,
687       "example" : "",
688       "deprecated" : "",
689       "since" : "",
690       "see" : "",
691       "exceptions" : "",
692       "requires" : "",
693       "params" : [
694         {
695           "name" : "fn",
696           "type" : "Function",
697           "desc" : "The function to be called, it will receive the args o (the object), k (the key)",
698           "isOptional" : false
699         },
700         {
701           "name" : "scope",
702           "type" : "Object",
703           "desc" : "(optional) The scope of the function (defaults to this)",
704           "isOptional" : false
705         }
706       ],
707       "returns" : [
708         {
709           "name" : "",
710           "type" : "MixedCollection",
711           "desc" : "The new filtered collection"
712         }
713       ]
714     },
715     {
716       "name" : "add",
717       "type" : "function",
718       "desc" : "Adds an item to the collection.",
719       "sig" : "(key, o)",
720       "static" : false,
721       "memberOf" : "",
722       "isStatic" : false,
723       "isConstructor" : false,
724       "isPrivate" : false,
725       "example" : "",
726       "deprecated" : "",
727       "since" : "",
728       "see" : "",
729       "exceptions" : "",
730       "requires" : "",
731       "params" : [
732         {
733           "name" : "key",
734           "type" : "String",
735           "desc" : "The key to associate with the item",
736           "isOptional" : false
737         },
738         {
739           "name" : "o",
740           "type" : "Object",
741           "desc" : "The item to add.",
742           "isOptional" : false
743         }
744       ],
745       "returns" : [
746         {
747           "name" : "",
748           "type" : "Object",
749           "desc" : "The item added."
750         }
751       ]
752     },
753     {
754       "name" : "removeAt",
755       "type" : "function",
756       "desc" : "Remove an item from a specified index in the collection.",
757       "sig" : "(index)",
758       "static" : false,
759       "memberOf" : "",
760       "isStatic" : false,
761       "isConstructor" : false,
762       "isPrivate" : false,
763       "example" : "",
764       "deprecated" : "",
765       "since" : "",
766       "see" : "",
767       "exceptions" : "",
768       "requires" : "",
769       "params" : [
770         {
771           "name" : "index",
772           "type" : "Number",
773           "desc" : "The index within the collection of the item to remove.",
774           "isOptional" : false
775         }
776       ],
777       "returns" : []
778     },
779     {
780       "name" : "removeKey",
781       "type" : "function",
782       "desc" : "Removed an item associated with the passed key fom the collection.",
783       "sig" : "(key)",
784       "static" : false,
785       "memberOf" : "",
786       "isStatic" : false,
787       "isConstructor" : false,
788       "isPrivate" : false,
789       "example" : "",
790       "deprecated" : "",
791       "since" : "",
792       "see" : "",
793       "exceptions" : "",
794       "requires" : "",
795       "params" : [
796         {
797           "name" : "key",
798           "type" : "String",
799           "desc" : "The key of the item to remove.",
800           "isOptional" : false
801         }
802       ],
803       "returns" : []
804     },
805     {
806       "name" : "filter",
807       "type" : "function",
808       "desc" : "Filter the <i>objects</i> in this collection by a specific property. \nReturns a new collection that has been filtered.",
809       "sig" : "(property, value)",
810       "static" : false,
811       "memberOf" : "",
812       "isStatic" : false,
813       "isConstructor" : false,
814       "isPrivate" : false,
815       "example" : "",
816       "deprecated" : "",
817       "since" : "",
818       "see" : "",
819       "exceptions" : "",
820       "requires" : "",
821       "params" : [
822         {
823           "name" : "property",
824           "type" : "String",
825           "desc" : "A property on your objects",
826           "isOptional" : false
827         },
828         {
829           "name" : "value",
830           "type" : "String/RegExp",
831           "desc" : "Either string that the property values \nshould start with or a RegExp to test against the property",
832           "isOptional" : false
833         }
834       ],
835       "returns" : [
836         {
837           "name" : "",
838           "type" : "MixedCollection",
839           "desc" : "The new filtered collection"
840         }
841       ]
842     },
843     {
844       "name" : "last",
845       "type" : "function",
846       "desc" : "Returns the last item in the collection.",
847       "sig" : "()\n{\n\n}",
848       "static" : false,
849       "memberOf" : "",
850       "isStatic" : false,
851       "isConstructor" : false,
852       "isPrivate" : false,
853       "example" : "",
854       "deprecated" : "",
855       "since" : "",
856       "see" : "",
857       "exceptions" : "",
858       "requires" : "",
859       "params" : [],
860       "returns" : [
861         {
862           "name" : "",
863           "type" : "Object",
864           "desc" : "the last item in the collection.."
865         }
866       ]
867     },
868     {
869       "name" : "replace",
870       "type" : "function",
871       "desc" : "Replaces an item in the collection.",
872       "sig" : "(key, o)",
873       "static" : false,
874       "memberOf" : "",
875       "isStatic" : false,
876       "isConstructor" : false,
877       "isPrivate" : false,
878       "example" : "",
879       "deprecated" : "",
880       "since" : "",
881       "see" : "",
882       "exceptions" : "",
883       "requires" : "",
884       "params" : [
885         {
886           "name" : "key",
887           "type" : "String",
888           "desc" : "The key associated with the item to replace, or the item to replace.",
889           "isOptional" : false
890         },
891         {
892           "name" : "o",
893           "type" : "",
894           "desc" : "{Object} o (optional) If the first parameter passed was a key, the item to associate with that key.",
895           "isOptional" : false
896         }
897       ],
898       "returns" : [
899         {
900           "name" : "",
901           "type" : "Object",
902           "desc" : "The new item."
903         }
904       ]
905     },
906     {
907       "name" : "first",
908       "type" : "function",
909       "desc" : "Returns the first item in the collection.",
910       "sig" : "()\n{\n\n}",
911       "static" : false,
912       "memberOf" : "",
913       "isStatic" : false,
914       "isConstructor" : false,
915       "isPrivate" : false,
916       "example" : "",
917       "deprecated" : "",
918       "since" : "",
919       "see" : "",
920       "exceptions" : "",
921       "requires" : "",
922       "params" : [],
923       "returns" : [
924         {
925           "name" : "",
926           "type" : "Object",
927           "desc" : "the first item in the collection.."
928         }
929       ]
930     },
931     {
932       "name" : "sort",
933       "type" : "function",
934       "desc" : "Sorts this collection with the passed comparison function",
935       "sig" : "(direction, fn)",
936       "static" : false,
937       "memberOf" : "",
938       "isStatic" : false,
939       "isConstructor" : false,
940       "isPrivate" : false,
941       "example" : "",
942       "deprecated" : "",
943       "since" : "",
944       "see" : "",
945       "exceptions" : "",
946       "requires" : "",
947       "params" : [
948         {
949           "name" : "direction",
950           "type" : "String",
951           "desc" : "(optional) \"ASC\" or \"DESC\"",
952           "isOptional" : false
953         },
954         {
955           "name" : "fn",
956           "type" : "Function",
957           "desc" : "(optional) comparison function",
958           "isOptional" : false
959         }
960       ],
961       "returns" : []
962     },
963     {
964       "name" : "purgeListeners",
965       "type" : "function",
966       "desc" : "Removes all listeners for this object",
967       "sig" : "()\n{\n\n}",
968       "static" : false,
969       "memberOf" : "Roo.util.Observable",
970       "isStatic" : false,
971       "isConstructor" : false,
972       "isPrivate" : false,
973       "example" : "",
974       "deprecated" : "",
975       "since" : "",
976       "see" : "",
977       "exceptions" : "",
978       "requires" : "",
979       "params" : [],
980       "returns" : []
981     },
982     {
983       "name" : "on",
984       "type" : "function",
985       "desc" : "Appends an event handler to this element (shorthand for addListener)",
986       "sig" : "(eventName, handler, scope, options)",
987       "static" : false,
988       "memberOf" : "Roo.util.Observable",
989       "isStatic" : false,
990       "isConstructor" : false,
991       "isPrivate" : false,
992       "example" : "",
993       "deprecated" : "",
994       "since" : "",
995       "see" : "",
996       "exceptions" : "",
997       "requires" : "",
998       "params" : [
999         {
1000           "name" : "eventName",
1001           "type" : "String",
1002           "desc" : "The type of event to listen for",
1003           "isOptional" : false
1004         },
1005         {
1006           "name" : "handler",
1007           "type" : "Function",
1008           "desc" : "The method the event invokes",
1009           "isOptional" : false
1010         },
1011         {
1012           "name" : "scope",
1013           "type" : "Object",
1014           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
1015           "isOptional" : false
1016         },
1017         {
1018           "name" : "options",
1019           "type" : "Object",
1020           "desc" : "(optional)",
1021           "isOptional" : false
1022         }
1023       ],
1024       "returns" : []
1025     },
1026     {
1027       "name" : "un",
1028       "type" : "function",
1029       "desc" : "Removes a listener (shorthand for removeListener)",
1030       "sig" : "(eventName, handler, scope)",
1031       "static" : false,
1032       "memberOf" : "Roo.util.Observable",
1033       "isStatic" : false,
1034       "isConstructor" : false,
1035       "isPrivate" : false,
1036       "example" : "",
1037       "deprecated" : "",
1038       "since" : "",
1039       "see" : "",
1040       "exceptions" : "",
1041       "requires" : "",
1042       "params" : [
1043         {
1044           "name" : "eventName",
1045           "type" : "String",
1046           "desc" : "The type of event to listen for",
1047           "isOptional" : false
1048         },
1049         {
1050           "name" : "handler",
1051           "type" : "Function",
1052           "desc" : "The handler to remove",
1053           "isOptional" : false
1054         },
1055         {
1056           "name" : "scope",
1057           "type" : "Object",
1058           "desc" : "(optional) The scope (this object) for the handler",
1059           "isOptional" : false
1060         }
1061       ],
1062       "returns" : []
1063     },
1064     {
1065       "name" : "addEvents",
1066       "type" : "function",
1067       "desc" : "Used to define events on this Observable",
1068       "sig" : "(object)",
1069       "static" : false,
1070       "memberOf" : "Roo.util.Observable",
1071       "isStatic" : false,
1072       "isConstructor" : false,
1073       "isPrivate" : false,
1074       "example" : "",
1075       "deprecated" : "",
1076       "since" : "",
1077       "see" : "",
1078       "exceptions" : "",
1079       "requires" : "",
1080       "params" : [
1081         {
1082           "name" : "object",
1083           "type" : "Object",
1084           "desc" : "The object with the events defined",
1085           "isOptional" : false
1086         }
1087       ],
1088       "returns" : []
1089     },
1090     {
1091       "name" : "releaseCapture",
1092       "type" : "function",
1093       "desc" : "Removes <b>all</b> added captures from the Observable.",
1094       "sig" : "(o)",
1095       "static" : true,
1096       "memberOf" : "Roo.util.Observable",
1097       "isStatic" : true,
1098       "isConstructor" : false,
1099       "isPrivate" : false,
1100       "example" : "",
1101       "deprecated" : "",
1102       "since" : "",
1103       "see" : "",
1104       "exceptions" : "",
1105       "requires" : "",
1106       "params" : [
1107         {
1108           "name" : "o",
1109           "type" : "Observable",
1110           "desc" : "The Observable to release",
1111           "isOptional" : false
1112         }
1113       ],
1114       "returns" : []
1115     },
1116     {
1117       "name" : "removeListener",
1118       "type" : "function",
1119       "desc" : "Removes a listener",
1120       "sig" : "(eventName, handler, scope)",
1121       "static" : false,
1122       "memberOf" : "Roo.util.Observable",
1123       "isStatic" : false,
1124       "isConstructor" : false,
1125       "isPrivate" : false,
1126       "example" : "",
1127       "deprecated" : "",
1128       "since" : "",
1129       "see" : "",
1130       "exceptions" : "",
1131       "requires" : "",
1132       "params" : [
1133         {
1134           "name" : "eventName",
1135           "type" : "String",
1136           "desc" : "The type of event to listen for",
1137           "isOptional" : false
1138         },
1139         {
1140           "name" : "handler",
1141           "type" : "Function",
1142           "desc" : "The handler to remove",
1143           "isOptional" : false
1144         },
1145         {
1146           "name" : "scope",
1147           "type" : "Object",
1148           "desc" : "(optional) The scope (this object) for the handler",
1149           "isOptional" : false
1150         }
1151       ],
1152       "returns" : []
1153     },
1154     {
1155       "name" : "fireEvent",
1156       "type" : "function",
1157       "desc" : "Fires the specified event with the passed parameters (minus the event name).",
1158       "sig" : "(eventName, args)",
1159       "static" : false,
1160       "memberOf" : "Roo.util.Observable",
1161       "isStatic" : false,
1162       "isConstructor" : false,
1163       "isPrivate" : false,
1164       "example" : "",
1165       "deprecated" : "",
1166       "since" : "",
1167       "see" : "",
1168       "exceptions" : "",
1169       "requires" : "",
1170       "params" : [
1171         {
1172           "name" : "eventName",
1173           "type" : "String",
1174           "desc" : "",
1175           "isOptional" : false
1176         },
1177         {
1178           "name" : "args",
1179           "type" : "Object...",
1180           "desc" : "Variable number of parameters are passed to handlers",
1181           "isOptional" : false
1182         }
1183       ],
1184       "returns" : [
1185         {
1186           "name" : "",
1187           "type" : "Boolean",
1188           "desc" : "returns false if any of the handlers return false otherwise it returns true"
1189         }
1190       ]
1191     },
1192     {
1193       "name" : "hasListener",
1194       "type" : "function",
1195       "desc" : "Checks to see if this object has any listeners for a specified event",
1196       "sig" : "(eventName)",
1197       "static" : false,
1198       "memberOf" : "Roo.util.Observable",
1199       "isStatic" : false,
1200       "isConstructor" : false,
1201       "isPrivate" : false,
1202       "example" : "",
1203       "deprecated" : "",
1204       "since" : "",
1205       "see" : "",
1206       "exceptions" : "",
1207       "requires" : "",
1208       "params" : [
1209         {
1210           "name" : "eventName",
1211           "type" : "String",
1212           "desc" : "The name of the event to check for",
1213           "isOptional" : false
1214         }
1215       ],
1216       "returns" : [
1217         {
1218           "name" : "",
1219           "type" : "Boolean",
1220           "desc" : "True if the event is being listened for, else false"
1221         }
1222       ]
1223     },
1224     {
1225       "name" : "capture",
1226       "type" : "function",
1227       "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.",
1228       "sig" : "(o, fn, scope)",
1229       "static" : true,
1230       "memberOf" : "Roo.util.Observable",
1231       "isStatic" : true,
1232       "isConstructor" : false,
1233       "isPrivate" : false,
1234       "example" : "",
1235       "deprecated" : "",
1236       "since" : "",
1237       "see" : "",
1238       "exceptions" : "",
1239       "requires" : "",
1240       "params" : [
1241         {
1242           "name" : "o",
1243           "type" : "Observable",
1244           "desc" : "The Observable to capture",
1245           "isOptional" : false
1246         },
1247         {
1248           "name" : "fn",
1249           "type" : "Function",
1250           "desc" : "The function to call",
1251           "isOptional" : false
1252         },
1253         {
1254           "name" : "scope",
1255           "type" : "Object",
1256           "desc" : "(optional) The scope (this object) for the fn",
1257           "isOptional" : false
1258         }
1259       ],
1260       "returns" : []
1261     },
1262     {
1263       "name" : "addListener",
1264       "type" : "function",
1265       "desc" : "Appends an event handler to this component",
1266       "sig" : "(eventName, handler, scope, options)",
1267       "static" : false,
1268       "memberOf" : "Roo.util.Observable",
1269       "isStatic" : false,
1270       "isConstructor" : false,
1271       "isPrivate" : false,
1272       "example" : "",
1273       "deprecated" : "",
1274       "since" : "",
1275       "see" : "",
1276       "exceptions" : "",
1277       "requires" : "",
1278       "params" : [
1279         {
1280           "name" : "eventName",
1281           "type" : "String",
1282           "desc" : "The type of event to listen for",
1283           "isOptional" : false
1284         },
1285         {
1286           "name" : "handler",
1287           "type" : "Function",
1288           "desc" : "The method the event invokes",
1289           "isOptional" : false
1290         },
1291         {
1292           "name" : "scope",
1293           "type" : "Object",
1294           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
1295           "isOptional" : false
1296         },
1297         {
1298           "name" : "options",
1299           "type" : "Object",
1300           "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>",
1301           "isOptional" : false
1302         }
1303       ],
1304       "returns" : []
1305     }
1306   ],
1307   "events" : [
1308     {
1309       "name" : "remove",
1310       "type" : "function",
1311       "desc" : "Fires when an item is removed from the collection.",
1312       "sig" : "function (o, key)\n{\n\n}",
1313       "memberOf" : "",
1314       "example" : "",
1315       "deprecated" : "",
1316       "since" : "",
1317       "see" : "",
1318       "params" : [
1319         {
1320           "name" : "o",
1321           "type" : "Object",
1322           "desc" : "The item being removed.",
1323           "isOptional" : false
1324         },
1325         {
1326           "name" : "key",
1327           "type" : "String",
1328           "desc" : "(optional) The key associated with the removed item.",
1329           "isOptional" : false
1330         }
1331       ],
1332       "returns" : []
1333     },
1334     {
1335       "name" : "add",
1336       "type" : "function",
1337       "desc" : "Fires when an item is added to the collection.",
1338       "sig" : "function (index, o, key)\n{\n\n}",
1339       "memberOf" : "",
1340       "example" : "",
1341       "deprecated" : "",
1342       "since" : "",
1343       "see" : "",
1344       "params" : [
1345         {
1346           "name" : "index",
1347           "type" : "Number",
1348           "desc" : "The index at which the item was added.",
1349           "isOptional" : false
1350         },
1351         {
1352           "name" : "o",
1353           "type" : "Object",
1354           "desc" : "The item added.",
1355           "isOptional" : false
1356         },
1357         {
1358           "name" : "key",
1359           "type" : "String",
1360           "desc" : "The key associated with the added item.",
1361           "isOptional" : false
1362         }
1363       ],
1364       "returns" : []
1365     },
1366     {
1367       "name" : "replace",
1368       "type" : "function",
1369       "desc" : "Fires when an item is replaced in the collection.",
1370       "sig" : "function (key, old, new)\n{\n\n}",
1371       "memberOf" : "",
1372       "example" : "",
1373       "deprecated" : "",
1374       "since" : "",
1375       "see" : "",
1376       "params" : [
1377         {
1378           "name" : "key",
1379           "type" : "String",
1380           "desc" : "he key associated with the new added.",
1381           "isOptional" : false
1382         },
1383         {
1384           "name" : "old",
1385           "type" : "Object",
1386           "desc" : "The item being replaced.",
1387           "isOptional" : false
1388         },
1389         {
1390           "name" : "new",
1391           "type" : "Object",
1392           "desc" : "The new item.",
1393           "isOptional" : false
1394         }
1395       ],
1396       "returns" : []
1397     },
1398     {
1399       "name" : "clear",
1400       "type" : "function",
1401       "desc" : "Fires when the collection is cleared.",
1402       "sig" : "function ()\n{\n\n}",
1403       "memberOf" : "",
1404       "example" : "",
1405       "deprecated" : "",
1406       "since" : "",
1407       "see" : "",
1408       "params" : [],
1409       "returns" : []
1410     }
1411   ]
1412 }