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

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