git.roojs.org Git - roojs1/blob - docs/symbols/Roo.util.MixedCollection.json

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