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

   1 {
   2   "name" : "Roo.form.Form",
   3   "augments" : [
   4     "Roo.form.BasicForm",
   5     "Roo.util.Observable"
   6   ],
   7   "childClasses" : {  },
   8   "tree_children" : [
   9     "Roo.form.Column",
  10     "Roo.form.FieldSet",
  11     "Roo.form.Row",
  12     "Roo.form.Field",
  13     "Roo.form.Checkbox",
  14     "Roo.form.ComboBox",
  15     "Roo.form.ComboBoxArray",
  16     "Roo.form.ComboCheck",
  17     "Roo.form.ComboNested",
  18     "Roo.form.DateField",
  19     "Roo.form.DayPicker",
  20     "Roo.form.DisplayField",
  21     "Roo.form.FCKeditor",
  22     "Roo.form.GridField",
  23     "Roo.form.Hidden",
  24     "Roo.form.HtmlEditor",
  25     "Roo.form.MonthField",
  26     "Roo.form.NumberField",
  27     "Roo.form.Radio",
  28     "Roo.form.Select",
  29     "Roo.form.Signature",
  30     "Roo.form.TextArea",
  31     "Roo.form.TextField",
  32     "Roo.form.TriggerField",
  33     "Roo.Button",
  34     "Roo.SplitButton",
  35     "Roo.Toolbar.Button",
  36     "Roo.Toolbar.SplitButton",
  37     "Roo.form.TextItem"
  38   ],
  39   "tree_parent" : [],
  40   "desc" : "Adds the ability to dynamically render forms with JavaScript to {@link Roo.form.BasicForm}.",
  41   "isSingleton" : false,
  42   "isStatic" : false,
  43   "isBuiltin" : false,
  44   "isAbstract" : false,
  45   "isBuilderTop" : false,
  46   "memberOf" : "Form",
  47   "example" : "",
  48   "deprecated" : "",
  49   "since" : "",
  50   "see" : "",
  51   "params" : [
  52     {
  53       "name" : "config",
  54       "type" : "Object",
  55       "desc" : "Configuration options",
  56       "isOptional" : false
  57     }
  58   ],
  59   "returns" : [],
  60   "throws" : "",
  61   "requires" : "",
  62   "config" : [
  63     {
  64       "name" : "labelAlign",
  65       "type" : "String",
  66       "desc" : "t) Valid values are \"left,\" \"top\" and \"right\" (defaults to \"left\").\nThis property cascades to child containers if not se",
  67       "memberOf" : "",
  68       "isOptional" : false,
  69       "optvals" : [
  70         "left",
  71         "top",
  72         "right"
  73       ]
  74     },
  75     {
  76       "name" : "(left|center|right)",
  77       "type" : "String",
  78       "desc" : "buttonAlign Valid values are \"left,\" \"center\" and \"right\" (defaults to \"center\")",
  79       "memberOf" : "",
  80       "isOptional" : false,
  81       "optvals" : []
  82     },
  83     {
  84       "name" : "listeners",
  85       "type" : "Object",
  86       "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>",
  87       "memberOf" : "Roo.util.Observable",
  88       "isOptional" : false,
  89       "optvals" : []
  90     },
  91     {
  92       "name" : "formData",
  93       "type" : "boolean|FormData",
  94       "desc" : "- true to use new 'FormData' post, or set to a new FormData({dom form}) Object, if\nsending a formdata with extra parameters - eg uploaded elements.",
  95       "memberOf" : "",
  96       "isOptional" : false,
  97       "optvals" : []
  98     },
  99     {
 100       "name" : "monitorValid",
 101       "type" : "Boolean",
 102       "desc" : "If true the form monitors its valid state <b>client-side</b> and\nfires a looping event with that state. This is required to bind buttons to the valid\nstate using the config value formBind:true on the button.",
 103       "memberOf" : "",
 104       "isOptional" : false,
 105       "optvals" : []
 106     },
 107     {
 108       "name" : "fileUpload",
 109       "type" : "Boolean",
 110       "desc" : "Set to true if this form is a file upload.",
 111       "memberOf" : "Roo.form.BasicForm",
 112       "isOptional" : false,
 113       "optvals" : []
 114     },
 115     {
 116       "name" : "progressUrl",
 117       "type" : "String",
 118       "desc" : "- Url to return progress data",
 119       "memberOf" : "",
 120       "isOptional" : false,
 121       "optvals" : []
 122     },
 123     {
 124       "name" : "buttons[]",
 125       "type" : "Roo.Button",
 126       "desc" : "buttons at bottom of form",
 127       "memberOf" : "",
 128       "isOptional" : false,
 129       "optvals" : []
 130     },
 131     {
 132       "name" : "minButtonWidth",
 133       "type" : "Number",
 134       "desc" : "Minimum width of all buttons in pixels (defaults to 75)",
 135       "memberOf" : "",
 136       "isOptional" : false,
 137       "optvals" : []
 138     },
 139     {
 140       "name" : "method",
 141       "type" : "String",
 142       "desc" : "The request method to use (GET or POST) for form actions if one isn't supplied in the action options.",
 143       "memberOf" : "Roo.form.BasicForm",
 144       "isOptional" : false,
 145       "optvals" : []
 146     },
 147     {
 148       "name" : "errorMask",
 149       "type" : "Boolean",
 150       "desc" : "e) default fal",
 151       "memberOf" : "Roo.form.BasicForm",
 152       "isOptional" : false,
 153       "optvals" : [
 154         "true",
 155         "false"
 156       ]
 157     },
 158     {
 159       "name" : "itemCls",
 160       "type" : "String",
 161       "desc" : "A css class to apply to the x-form-item of fields. This property cascades to child containers.",
 162       "memberOf" : "",
 163       "isOptional" : false,
 164       "optvals" : []
 165     },
 166     {
 167       "name" : "labelWidth",
 168       "type" : "Number",
 169       "desc" : "The width of labels. This property cascades to child containers.",
 170       "memberOf" : "",
 171       "isOptional" : false,
 172       "optvals" : []
 173     },
 174     {
 175       "name" : "timeout",
 176       "type" : "Number",
 177       "desc" : "Timeout for form actions in seconds (default is 30 seconds).",
 178       "memberOf" : "Roo.form.BasicForm",
 179       "isOptional" : false,
 180       "optvals" : []
 181     },
 182     {
 183       "name" : "monitorPoll",
 184       "type" : "Number",
 185       "desc" : "The milliseconds to poll valid state, ignored if monitorValid is not true (defaults to 200)",
 186       "memberOf" : "",
 187       "isOptional" : false,
 188       "optvals" : []
 189     },
 190     {
 191       "name" : "baseParams",
 192       "type" : "Object",
 193       "desc" : "Parameters to pass with all requests. e.g. baseParams: {id: '123', foo: 'bar'}.",
 194       "memberOf" : "Roo.form.BasicForm",
 195       "isOptional" : false,
 196       "optvals" : []
 197     },
 198     {
 199       "name" : "trackResetOnLoad",
 200       "type" : "Boolean",
 201       "desc" : "If set to true, form.reset() resets to the last loaded\nor setValues() data instead of when the form was first created.",
 202       "memberOf" : "Roo.form.BasicForm",
 203       "isOptional" : false,
 204       "optvals" : []
 205     },
 206     {
 207       "name" : "reader",
 208       "type" : "DataReader",
 209       "desc" : "An Roo.data.DataReader (e.g. {@link Roo.data.XmlReader}) to be used to read data when executing \"load\" actions.\nThis is optional as there is built-in support for processing JSON.",
 210       "memberOf" : "Roo.form.BasicForm",
 211       "isOptional" : false,
 212       "optvals" : []
 213     },
 214     {
 215       "name" : "errorReader",
 216       "type" : "DataReader",
 217       "desc" : "An Roo.data.DataReader (e.g. {@link Roo.data.XmlReader}) to be used to read data when reading validation errors on \"submit\" actions.\nThis is completely optional as there is built-in support for processing JSON.",
 218       "memberOf" : "Roo.form.BasicForm",
 219       "isOptional" : false,
 220       "optvals" : []
 221     },
 222     {
 223       "name" : "url",
 224       "type" : "String",
 225       "desc" : "The URL to use for form actions if one isn't supplied in the action options.",
 226       "memberOf" : "Roo.form.BasicForm",
 227       "isOptional" : false,
 228       "optvals" : []
 229     },
 230     {
 231       "name" : "maskOffset",
 232       "type" : "Number",
 233       "desc" : "Default 100",
 234       "memberOf" : "Roo.form.BasicForm",
 235       "isOptional" : false,
 236       "optvals" : []
 237     }
 238   ],
 239   "methods" : [
 240     {
 241       "name" : "addxtype",
 242       "type" : "function",
 243       "desc" : "Adds a series of form elements (using the xtype property as the factory method.\nValid xtypes are:  TextField, TextArea .... Button, Layout, FieldSet, Column, (and 'end' to close a block)",
 244       "sig" : "(config)",
 245       "static" : false,
 246       "memberOf" : "",
 247       "isStatic" : false,
 248       "isConstructor" : false,
 249       "isPrivate" : false,
 250       "example" : "",
 251       "deprecated" : "",
 252       "since" : "",
 253       "see" : "",
 254       "exceptions" : "",
 255       "requires" : "",
 256       "params" : [
 257         {
 258           "name" : "config",
 259           "type" : "Object",
 260           "desc" : "",
 261           "isOptional" : false
 262         }
 263       ],
 264       "returns" : []
 265     },
 266     {
 267       "name" : "fieldset",
 268       "type" : "function",
 269       "desc" : "Opens a new {@link Roo.form.FieldSet} container in the layout stack. If fields are passed after the config, the\nfields are added and the fieldset is closed. If no fields are passed the fieldset remains open\nuntil end() is called.",
 270       "sig" : "(config, field1, field2, etc)",
 271       "static" : false,
 272       "memberOf" : "",
 273       "isStatic" : false,
 274       "isConstructor" : false,
 275       "isPrivate" : false,
 276       "example" : "",
 277       "deprecated" : "",
 278       "since" : "",
 279       "see" : "",
 280       "exceptions" : "",
 281       "requires" : "",
 282       "params" : [
 283         {
 284           "name" : "config",
 285           "type" : "Object",
 286           "desc" : "The config to pass to the fieldset",
 287           "isOptional" : false
 288         },
 289         {
 290           "name" : "field1",
 291           "type" : "Field",
 292           "desc" : "(optional)",
 293           "isOptional" : false
 294         },
 295         {
 296           "name" : "field2",
 297           "type" : "Field",
 298           "desc" : "(optional)",
 299           "isOptional" : false
 300         },
 301         {
 302           "name" : "etc",
 303           "type" : "Field",
 304           "desc" : "(optional)",
 305           "isOptional" : false
 306         }
 307       ],
 308       "returns" : [
 309         {
 310           "name" : "",
 311           "type" : "",
 312           "desc" : "FieldSet The fieldset container object"
 313         }
 314       ]
 315     },
 316     {
 317       "name" : "start",
 318       "type" : "function",
 319       "desc" : "Opens the passed container in the layout stack. The container can be any {@link Roo.form.Layout} or subclass.",
 320       "sig" : "(container)",
 321       "static" : false,
 322       "memberOf" : "",
 323       "isStatic" : false,
 324       "isConstructor" : false,
 325       "isPrivate" : false,
 326       "example" : "",
 327       "deprecated" : "",
 328       "since" : "",
 329       "see" : "",
 330       "exceptions" : "",
 331       "requires" : "",
 332       "params" : [
 333         {
 334           "name" : "container",
 335           "type" : "Object",
 336           "desc" : "A Roo.form.Layout or subclass of Layout",
 337           "isOptional" : false
 338         }
 339       ],
 340       "returns" : [
 341         {
 342           "name" : "",
 343           "type" : "Form",
 344           "desc" : "this"
 345         }
 346       ]
 347     },
 348     {
 349       "name" : "container",
 350       "type" : "function",
 351       "desc" : "Opens a new {@link Roo.form.Layout} container in the layout stack. If fields are passed after the config, the\nfields are added and the container is closed. If no fields are passed the container remains open\nuntil end() is called.",
 352       "sig" : "(config, field1, field2, etc)",
 353       "static" : false,
 354       "memberOf" : "",
 355       "isStatic" : false,
 356       "isConstructor" : false,
 357       "isPrivate" : false,
 358       "example" : "",
 359       "deprecated" : "",
 360       "since" : "",
 361       "see" : "",
 362       "exceptions" : "",
 363       "requires" : "",
 364       "params" : [
 365         {
 366           "name" : "config",
 367           "type" : "Object",
 368           "desc" : "The config to pass to the Layout",
 369           "isOptional" : false
 370         },
 371         {
 372           "name" : "field1",
 373           "type" : "Field",
 374           "desc" : "(optional)",
 375           "isOptional" : false
 376         },
 377         {
 378           "name" : "field2",
 379           "type" : "Field",
 380           "desc" : "(optional)",
 381           "isOptional" : false
 382         },
 383         {
 384           "name" : "etc",
 385           "type" : "Field",
 386           "desc" : "(optional)",
 387           "isOptional" : false
 388         }
 389       ],
 390       "returns" : [
 391         {
 392           "name" : "",
 393           "type" : "",
 394           "desc" : "Layout The container object"
 395         }
 396       ]
 397     },
 398     {
 399       "name" : "render",
 400       "type" : "function",
 401       "desc" : "Render this form into the passed container. This should only be called once!",
 402       "sig" : "(container)",
 403       "static" : false,
 404       "memberOf" : "",
 405       "isStatic" : false,
 406       "isConstructor" : false,
 407       "isPrivate" : false,
 408       "example" : "",
 409       "deprecated" : "",
 410       "since" : "",
 411       "see" : "",
 412       "exceptions" : "",
 413       "requires" : "",
 414       "params" : [
 415         {
 416           "name" : "container",
 417           "type" : "String/HTMLElement/Element",
 418           "desc" : "The element this component should be rendered into",
 419           "isOptional" : false
 420         }
 421       ],
 422       "returns" : [
 423         {
 424           "name" : "",
 425           "type" : "Form",
 426           "desc" : "this"
 427         }
 428       ]
 429     },
 430     {
 431       "name" : "startMonitoring",
 432       "type" : "function",
 433       "desc" : "Starts monitoring of the valid state of this form. Usually this is done by passing the config\noption \"monitorValid\"",
 434       "sig" : "()\n{\n\n}",
 435       "static" : false,
 436       "memberOf" : "",
 437       "isStatic" : false,
 438       "isConstructor" : false,
 439       "isPrivate" : false,
 440       "example" : "",
 441       "deprecated" : "",
 442       "since" : "",
 443       "see" : "",
 444       "exceptions" : "",
 445       "requires" : "",
 446       "params" : [],
 447       "returns" : []
 448     },
 449     {
 450       "name" : "addButton",
 451       "type" : "function",
 452       "desc" : "Adds a button to the footer of the form - this <b>must</b> be called before the form is rendered.",
 453       "sig" : "(config, handler, scope)",
 454       "static" : false,
 455       "memberOf" : "",
 456       "isStatic" : false,
 457       "isConstructor" : false,
 458       "isPrivate" : false,
 459       "example" : "",
 460       "deprecated" : "",
 461       "since" : "",
 462       "see" : "",
 463       "exceptions" : "",
 464       "requires" : "",
 465       "params" : [
 466         {
 467           "name" : "config",
 468           "type" : "String/Object",
 469           "desc" : "A string becomes the button text, an object can either be a Button config\nobject or a valid Roo.DomHelper element config",
 470           "isOptional" : false
 471         },
 472         {
 473           "name" : "handler",
 474           "type" : "Function",
 475           "desc" : "The function called when the button is clicked",
 476           "isOptional" : false
 477         },
 478         {
 479           "name" : "scope",
 480           "type" : "Object",
 481           "desc" : "(optional) The scope of the handler function",
 482           "isOptional" : false
 483         }
 484       ],
 485       "returns" : [
 486         {
 487           "name" : "",
 488           "type" : "Roo.Button",
 489           "desc" : ""
 490         }
 491       ]
 492     },
 493     {
 494       "name" : "stopMonitoring",
 495       "type" : "function",
 496       "desc" : "Stops monitoring of the valid state of this form",
 497       "sig" : "()\n{\n\n}",
 498       "static" : false,
 499       "memberOf" : "",
 500       "isStatic" : false,
 501       "isConstructor" : false,
 502       "isPrivate" : false,
 503       "example" : "",
 504       "deprecated" : "",
 505       "since" : "",
 506       "see" : "",
 507       "exceptions" : "",
 508       "requires" : "",
 509       "params" : [],
 510       "returns" : []
 511     },
 512     {
 513       "name" : "add",
 514       "type" : "function",
 515       "desc" : "Add Roo.form components to the current open container (e.g. column, fieldset, etc.).  Fields added via this method\ncan also be passed with an additional property of fieldLabel, which if supplied, will provide the text to display\nas the label of the field.",
 516       "sig" : "(field1, field2)",
 517       "static" : false,
 518       "memberOf" : "",
 519       "isStatic" : false,
 520       "isConstructor" : false,
 521       "isPrivate" : false,
 522       "example" : "",
 523       "deprecated" : "",
 524       "since" : "",
 525       "see" : "",
 526       "exceptions" : "",
 527       "requires" : "",
 528       "params" : [
 529         {
 530           "name" : "field1",
 531           "type" : "Field",
 532           "desc" : "",
 533           "isOptional" : false
 534         },
 535         {
 536           "name" : "field2",
 537           "type" : "Field",
 538           "desc" : "(optional)",
 539           "isOptional" : false
 540         }
 541       ],
 542       "returns" : [
 543         {
 544           "name" : "",
 545           "type" : "Form",
 546           "desc" : "this"
 547         }
 548       ]
 549     },
 550     {
 551       "name" : "findbyId",
 552       "type" : "function",
 553       "desc" : "Find any element that has been added to a form, using it's ID or name\nThis can include framesets, columns etc. along with regular fields..",
 554       "sig" : "(id)",
 555       "static" : false,
 556       "memberOf" : "",
 557       "isStatic" : false,
 558       "isConstructor" : false,
 559       "isPrivate" : false,
 560       "example" : "",
 561       "deprecated" : "",
 562       "since" : "",
 563       "see" : "",
 564       "exceptions" : "",
 565       "requires" : "",
 566       "params" : [
 567         {
 568           "name" : "id",
 569           "type" : "String",
 570           "desc" : "- id or name to find.",
 571           "isOptional" : false
 572         }
 573       ],
 574       "returns" : [
 575         {
 576           "name" : "",
 577           "type" : "Element",
 578           "desc" : "e - or false if nothing found."
 579         }
 580       ]
 581     },
 582     {
 583       "name" : "column",
 584       "type" : "function",
 585       "desc" : "Opens a new {@link Roo.form.Column} container in the layout stack. If fields are passed after the config, the\nfields are added and the column is closed. If no fields are passed the column remains open\nuntil end() is called.",
 586       "sig" : "(config, field1, field2, etc)",
 587       "static" : false,
 588       "memberOf" : "",
 589       "isStatic" : false,
 590       "isConstructor" : false,
 591       "isPrivate" : false,
 592       "example" : "",
 593       "deprecated" : "",
 594       "since" : "",
 595       "see" : "",
 596       "exceptions" : "",
 597       "requires" : "",
 598       "params" : [
 599         {
 600           "name" : "config",
 601           "type" : "Object",
 602           "desc" : "The config to pass to the column",
 603           "isOptional" : false
 604         },
 605         {
 606           "name" : "field1",
 607           "type" : "Field",
 608           "desc" : "(optional)",
 609           "isOptional" : false
 610         },
 611         {
 612           "name" : "field2",
 613           "type" : "Field",
 614           "desc" : "(optional)",
 615           "isOptional" : false
 616         },
 617         {
 618           "name" : "etc",
 619           "type" : "Field",
 620           "desc" : "(optional)",
 621           "isOptional" : false
 622         }
 623       ],
 624       "returns" : [
 625         {
 626           "name" : "",
 627           "type" : "",
 628           "desc" : "Column The column container object"
 629         }
 630       ]
 631     },
 632     {
 633       "name" : "end",
 634       "type" : "function",
 635       "desc" : "Closes the current open container",
 636       "sig" : "()\n{\n\n}",
 637       "static" : false,
 638       "memberOf" : "",
 639       "isStatic" : false,
 640       "isConstructor" : false,
 641       "isPrivate" : false,
 642       "example" : "",
 643       "deprecated" : "",
 644       "since" : "",
 645       "see" : "",
 646       "exceptions" : "",
 647       "requires" : "",
 648       "params" : [],
 649       "returns" : [
 650         {
 651           "name" : "",
 652           "type" : "Form",
 653           "desc" : "this"
 654         }
 655       ]
 656     },
 657     {
 658       "name" : "remove",
 659       "type" : "function",
 660       "desc" : "Removes a field from the items collection (does NOT remove its markup).",
 661       "sig" : "(field)",
 662       "static" : false,
 663       "memberOf" : "Roo.form.BasicForm",
 664       "isStatic" : false,
 665       "isConstructor" : false,
 666       "isPrivate" : false,
 667       "example" : "",
 668       "deprecated" : "",
 669       "since" : "",
 670       "see" : "",
 671       "exceptions" : "",
 672       "requires" : "",
 673       "params" : [
 674         {
 675           "name" : "field",
 676           "type" : "Field",
 677           "desc" : "",
 678           "isOptional" : false
 679         }
 680       ],
 681       "returns" : [
 682         {
 683           "name" : "",
 684           "type" : "BasicForm",
 685           "desc" : "this"
 686         }
 687       ]
 688     },
 689     {
 690       "name" : "loadRecord",
 691       "type" : "function",
 692       "desc" : "Loads an Roo.data.Record into this form.",
 693       "sig" : "(record)",
 694       "static" : false,
 695       "memberOf" : "Roo.form.BasicForm",
 696       "isStatic" : false,
 697       "isConstructor" : false,
 698       "isPrivate" : false,
 699       "example" : "",
 700       "deprecated" : "",
 701       "since" : "",
 702       "see" : "",
 703       "exceptions" : "",
 704       "requires" : "",
 705       "params" : [
 706         {
 707           "name" : "record",
 708           "type" : "Record",
 709           "desc" : "The record to load",
 710           "isOptional" : false
 711         }
 712       ],
 713       "returns" : [
 714         {
 715           "name" : "",
 716           "type" : "BasicForm",
 717           "desc" : "this"
 718         }
 719       ]
 720     },
 721     {
 722       "name" : "load",
 723       "type" : "function",
 724       "desc" : "Shortcut to do a load action.",
 725       "sig" : "(options)",
 726       "static" : false,
 727       "memberOf" : "Roo.form.BasicForm",
 728       "isStatic" : false,
 729       "isConstructor" : false,
 730       "isPrivate" : false,
 731       "example" : "",
 732       "deprecated" : "",
 733       "since" : "",
 734       "see" : "",
 735       "exceptions" : "",
 736       "requires" : "",
 737       "params" : [
 738         {
 739           "name" : "options",
 740           "type" : "Object",
 741           "desc" : "The options to pass to the action (see {@link #doAction} for details)",
 742           "isOptional" : false
 743         }
 744       ],
 745       "returns" : [
 746         {
 747           "name" : "",
 748           "type" : "BasicForm",
 749           "desc" : "this"
 750         }
 751       ]
 752     },
 753     {
 754       "name" : "doAction",
 755       "type" : "function",
 756       "desc" : "Performs a predefined action (submit or load) or custom actions you define on this form.",
 757       "sig" : "(actionName, options)",
 758       "static" : false,
 759       "memberOf" : "Roo.form.BasicForm",
 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" : "actionName",
 772           "type" : "String",
 773           "desc" : "The name of the action type",
 774           "isOptional" : false
 775         },
 776         {
 777           "name" : "options",
 778           "type" : "Object",
 779           "desc" : "(optional) The options to pass to the action.  All of the config options listed\nbelow are supported by both the submit and load actions unless otherwise noted (custom actions could also\naccept other config options):\n<pre>\nProperty          Type             Description\n----------------  ---------------  ----------------------------------------------------------------------------------\nurl               String           The url for the action (defaults to the form's url)\nmethod            String           The form method to use (defaults to the form's method, or POST if not defined)\nparams            String/Object    The params to pass (defaults to the form's baseParams, or none if not defined)\nclientValidation  Boolean          Applies to submit only.  Pass true to call form.isValid() prior to posting to\n                                   validate the form on the client (defaults to false)\n</pre>",
 780           "isOptional" : false
 781         }
 782       ],
 783       "returns" : [
 784         {
 785           "name" : "",
 786           "type" : "BasicForm",
 787           "desc" : "this"
 788         }
 789       ]
 790     },
 791     {
 792       "name" : "getValues",
 793       "type" : "function",
 794       "desc" : "Returns the fields in this form as an object with key/value pairs. If multiple fields exist with the same name\nthey are returned as an array.",
 795       "sig" : "(asString)",
 796       "static" : false,
 797       "memberOf" : "Roo.form.BasicForm",
 798       "isStatic" : false,
 799       "isConstructor" : false,
 800       "isPrivate" : false,
 801       "example" : "",
 802       "deprecated" : "",
 803       "since" : "",
 804       "see" : "",
 805       "exceptions" : "",
 806       "requires" : "",
 807       "params" : [
 808         {
 809           "name" : "asString",
 810           "type" : "Boolean",
 811           "desc" : "(def)",
 812           "isOptional" : false
 813         }
 814       ],
 815       "returns" : [
 816         {
 817           "name" : "",
 818           "type" : "Object",
 819           "desc" : ""
 820         }
 821       ]
 822     },
 823     {
 824       "name" : "resetHasChanged",
 825       "type" : "function",
 826       "desc" : "Resets all hasChanged to 'false' -\nThe old 'isDirty' used 'original value..' however this breaks reset() and a few other things.\nSo hasChanged storage is only to be used for this purpose",
 827       "sig" : "()\n{\n\n}",
 828       "static" : false,
 829       "memberOf" : "Roo.form.BasicForm",
 830       "isStatic" : false,
 831       "isConstructor" : false,
 832       "isPrivate" : false,
 833       "example" : "",
 834       "deprecated" : "",
 835       "since" : "",
 836       "see" : "",
 837       "exceptions" : "",
 838       "requires" : "",
 839       "params" : [],
 840       "returns" : [
 841         {
 842           "name" : "",
 843           "type" : "",
 844           "desc" : "Boolean"
 845         }
 846       ]
 847     },
 848     {
 849       "name" : "clearInvalid",
 850       "type" : "function",
 851       "desc" : "Clears all invalid messages in this form.",
 852       "sig" : "()\n{\n\n}",
 853       "static" : false,
 854       "memberOf" : "Roo.form.BasicForm",
 855       "isStatic" : false,
 856       "isConstructor" : false,
 857       "isPrivate" : false,
 858       "example" : "",
 859       "deprecated" : "",
 860       "since" : "",
 861       "see" : "",
 862       "exceptions" : "",
 863       "requires" : "",
 864       "params" : [],
 865       "returns" : [
 866         {
 867           "name" : "",
 868           "type" : "BasicForm",
 869           "desc" : "this"
 870         }
 871       ]
 872     },
 873     {
 874       "name" : "isDirty",
 875       "type" : "function",
 876       "desc" : "DEPRICATED Returns true if any fields in this form have changed since their original load.",
 877       "sig" : "()\n{\n\n}",
 878       "static" : false,
 879       "memberOf" : "Roo.form.BasicForm",
 880       "isStatic" : false,
 881       "isConstructor" : false,
 882       "isPrivate" : false,
 883       "example" : "",
 884       "deprecated" : "",
 885       "since" : "",
 886       "see" : "",
 887       "exceptions" : "",
 888       "requires" : "",
 889       "params" : [],
 890       "returns" : [
 891         {
 892           "name" : "",
 893           "type" : "",
 894           "desc" : "Boolean"
 895         }
 896       ]
 897     },
 898     {
 899       "name" : "updateRecord",
 900       "type" : "function",
 901       "desc" : "Persists the values in this form into the passed Roo.data.Record object in a beginEdit/endEdit block.",
 902       "sig" : "(record)",
 903       "static" : false,
 904       "memberOf" : "Roo.form.BasicForm",
 905       "isStatic" : false,
 906       "isConstructor" : false,
 907       "isPrivate" : false,
 908       "example" : "",
 909       "deprecated" : "",
 910       "since" : "",
 911       "see" : "",
 912       "exceptions" : "",
 913       "requires" : "",
 914       "params" : [
 915         {
 916           "name" : "record",
 917           "type" : "Record",
 918           "desc" : "The record to edit",
 919           "isOptional" : false
 920         }
 921       ],
 922       "returns" : [
 923         {
 924           "name" : "",
 925           "type" : "BasicForm",
 926           "desc" : "this"
 927         }
 928       ]
 929     },
 930     {
 931       "name" : "hasChanged",
 932       "type" : "function",
 933       "desc" : "Returns true if any fields in this form have changed since their original load. (New version)",
 934       "sig" : "()\n{\n\n}",
 935       "static" : false,
 936       "memberOf" : "Roo.form.BasicForm",
 937       "isStatic" : false,
 938       "isConstructor" : false,
 939       "isPrivate" : false,
 940       "example" : "",
 941       "deprecated" : "",
 942       "since" : "",
 943       "see" : "",
 944       "exceptions" : "",
 945       "requires" : "",
 946       "params" : [],
 947       "returns" : [
 948         {
 949           "name" : "",
 950           "type" : "",
 951           "desc" : "Boolean"
 952         }
 953       ]
 954     },
 955     {
 956       "name" : "applyToFields",
 957       "type" : "function",
 958       "desc" : "Calls {@link Ext#apply} for all fields in this form with the passed object.",
 959       "sig" : "(values)",
 960       "static" : false,
 961       "memberOf" : "Roo.form.BasicForm",
 962       "isStatic" : false,
 963       "isConstructor" : false,
 964       "isPrivate" : false,
 965       "example" : "",
 966       "deprecated" : "",
 967       "since" : "",
 968       "see" : "",
 969       "exceptions" : "",
 970       "requires" : "",
 971       "params" : [
 972         {
 973           "name" : "values",
 974           "type" : "Object",
 975           "desc" : "",
 976           "isOptional" : false
 977         }
 978       ],
 979       "returns" : [
 980         {
 981           "name" : "",
 982           "type" : "BasicForm",
 983           "desc" : "this"
 984         }
 985       ]
 986     },
 987     {
 988       "name" : "getFieldValues",
 989       "type" : "function",
 990       "desc" : "Returns the fields in this form as an object with key/value pairs. \nThis differs from getValues as it calls getValue on each child item, rather than using dom data.\nNormally this will not return readOnly data",
 991       "sig" : "(with_readonly)",
 992       "static" : false,
 993       "memberOf" : "Roo.form.BasicForm",
 994       "isStatic" : false,
 995       "isConstructor" : false,
 996       "isPrivate" : false,
 997       "example" : "",
 998       "deprecated" : "",
 999       "since" : "",
1000       "see" : "",
1001       "exceptions" : "",
1002       "requires" : "",
1003       "params" : [
1004         {
1005           "name" : "with_readonly",
1006           "type" : "Boolean",
1007           "desc" : "return readonly field data.",
1008           "isOptional" : false
1009         }
1010       ],
1011       "returns" : [
1012         {
1013           "name" : "",
1014           "type" : "Object",
1015           "desc" : ""
1016         }
1017       ]
1018     },
1019     {
1020       "name" : "submit",
1021       "type" : "function",
1022       "desc" : "Shortcut to do a submit action.",
1023       "sig" : "(options)",
1024       "static" : false,
1025       "memberOf" : "Roo.form.BasicForm",
1026       "isStatic" : false,
1027       "isConstructor" : false,
1028       "isPrivate" : false,
1029       "example" : "",
1030       "deprecated" : "",
1031       "since" : "",
1032       "see" : "",
1033       "exceptions" : "",
1034       "requires" : "",
1035       "params" : [
1036         {
1037           "name" : "options",
1038           "type" : "Object",
1039           "desc" : "The options to pass to the action (see {@link #doAction} for details)",
1040           "isOptional" : false
1041         }
1042       ],
1043       "returns" : [
1044         {
1045           "name" : "",
1046           "type" : "BasicForm",
1047           "desc" : "this"
1048         }
1049       ]
1050     },
1051     {
1052       "name" : "markInvalid",
1053       "type" : "function",
1054       "desc" : "Mark fields in this form invalid in bulk.",
1055       "sig" : "(errors)",
1056       "static" : false,
1057       "memberOf" : "Roo.form.BasicForm",
1058       "isStatic" : false,
1059       "isConstructor" : false,
1060       "isPrivate" : false,
1061       "example" : "",
1062       "deprecated" : "",
1063       "since" : "",
1064       "see" : "",
1065       "exceptions" : "",
1066       "requires" : "",
1067       "params" : [
1068         {
1069           "name" : "errors",
1070           "type" : "Array/Object",
1071           "desc" : "Either an array in the form [{id:'fieldId', msg:'The message'},...] or an object hash of {id: msg, id2: msg2}",
1072           "isOptional" : false
1073         }
1074       ],
1075       "returns" : [
1076         {
1077           "name" : "",
1078           "type" : "BasicForm",
1079           "desc" : "this"
1080         }
1081       ]
1082     },
1083     {
1084       "name" : "setValues",
1085       "type" : "function",
1086       "desc" : "Set values for fields in this form in bulk.",
1087       "sig" : "(values)",
1088       "static" : false,
1089       "memberOf" : "Roo.form.BasicForm",
1090       "isStatic" : false,
1091       "isConstructor" : false,
1092       "isPrivate" : false,
1093       "example" : "",
1094       "deprecated" : "",
1095       "since" : "",
1096       "see" : "",
1097       "exceptions" : "",
1098       "requires" : "",
1099       "params" : [
1100         {
1101           "name" : "values",
1102           "type" : "Array/Object",
1103           "desc" : "Either an array in the form [{id:'fieldId', value:'foo'},...] or an object hash of {id: value, id2: value2}",
1104           "isOptional" : false
1105         }
1106       ],
1107       "returns" : [
1108         {
1109           "name" : "",
1110           "type" : "BasicForm",
1111           "desc" : "this"
1112         }
1113       ]
1114     },
1115     {
1116       "name" : "isValid",
1117       "type" : "function",
1118       "desc" : "Returns true if client-side validation on the form is successful.",
1119       "sig" : "()\n{\n\n}",
1120       "static" : false,
1121       "memberOf" : "Roo.form.BasicForm",
1122       "isStatic" : false,
1123       "isConstructor" : false,
1124       "isPrivate" : false,
1125       "example" : "",
1126       "deprecated" : "",
1127       "since" : "",
1128       "see" : "",
1129       "exceptions" : "",
1130       "requires" : "",
1131       "params" : [],
1132       "returns" : [
1133         {
1134           "name" : "",
1135           "type" : "",
1136           "desc" : "Boolean"
1137         }
1138       ]
1139     },
1140     {
1141       "name" : "invalidFields",
1142       "type" : "function",
1143       "desc" : "Returns array of invalid form fields.",
1144       "sig" : "()\n{\n\n}",
1145       "static" : false,
1146       "memberOf" : "Roo.form.BasicForm",
1147       "isStatic" : false,
1148       "isConstructor" : false,
1149       "isPrivate" : false,
1150       "example" : "",
1151       "deprecated" : "",
1152       "since" : "",
1153       "see" : "",
1154       "exceptions" : "",
1155       "requires" : "",
1156       "params" : [],
1157       "returns" : [
1158         {
1159           "name" : "",
1160           "type" : "",
1161           "desc" : "Array"
1162         }
1163       ]
1164     },
1165     {
1166       "name" : "applyIfToFields",
1167       "type" : "function",
1168       "desc" : "Calls {@link Ext#applyIf} for all field in this form with the passed object.",
1169       "sig" : "(values)",
1170       "static" : false,
1171       "memberOf" : "Roo.form.BasicForm",
1172       "isStatic" : false,
1173       "isConstructor" : false,
1174       "isPrivate" : false,
1175       "example" : "",
1176       "deprecated" : "",
1177       "since" : "",
1178       "see" : "",
1179       "exceptions" : "",
1180       "requires" : "",
1181       "params" : [
1182         {
1183           "name" : "values",
1184           "type" : "Object",
1185           "desc" : "",
1186           "isOptional" : false
1187         }
1188       ],
1189       "returns" : [
1190         {
1191           "name" : "",
1192           "type" : "BasicForm",
1193           "desc" : "this"
1194         }
1195       ]
1196     },
1197     {
1198       "name" : "findField",
1199       "type" : "function",
1200       "desc" : "Find a Roo.form.Field in this form by id, dataIndex, name or hiddenName",
1201       "sig" : "(id)",
1202       "static" : false,
1203       "memberOf" : "Roo.form.BasicForm",
1204       "isStatic" : false,
1205       "isConstructor" : false,
1206       "isPrivate" : false,
1207       "example" : "",
1208       "deprecated" : "",
1209       "since" : "",
1210       "see" : "",
1211       "exceptions" : "",
1212       "requires" : "",
1213       "params" : [
1214         {
1215           "name" : "id",
1216           "type" : "String",
1217           "desc" : "The value to search for",
1218           "isOptional" : false
1219         }
1220       ],
1221       "returns" : [
1222         {
1223           "name" : "",
1224           "type" : "",
1225           "desc" : "Field"
1226         }
1227       ]
1228     },
1229     {
1230       "name" : "reset",
1231       "type" : "function",
1232       "desc" : "Resets this form.",
1233       "sig" : "()\n{\n\n}",
1234       "static" : false,
1235       "memberOf" : "Roo.form.BasicForm",
1236       "isStatic" : false,
1237       "isConstructor" : false,
1238       "isPrivate" : false,
1239       "example" : "",
1240       "deprecated" : "",
1241       "since" : "",
1242       "see" : "",
1243       "exceptions" : "",
1244       "requires" : "",
1245       "params" : [],
1246       "returns" : [
1247         {
1248           "name" : "",
1249           "type" : "BasicForm",
1250           "desc" : "this"
1251         }
1252       ]
1253     },
1254     {
1255       "name" : "addForm",
1256       "type" : "function",
1257       "desc" : "Add a secondary form to this one, \nUsed to provide tabbed forms. One form is primary, with hidden values \nwhich mirror the elements from the other forms.",
1258       "sig" : "(form)",
1259       "static" : false,
1260       "memberOf" : "Roo.form.BasicForm",
1261       "isStatic" : false,
1262       "isConstructor" : false,
1263       "isPrivate" : false,
1264       "example" : "",
1265       "deprecated" : "",
1266       "since" : "",
1267       "see" : "",
1268       "exceptions" : "",
1269       "requires" : "",
1270       "params" : [
1271         {
1272           "name" : "form",
1273           "type" : "Roo.form.Form",
1274           "desc" : "to add.",
1275           "isOptional" : false
1276         }
1277       ],
1278       "returns" : []
1279     },
1280     {
1281       "name" : "purgeListeners",
1282       "type" : "function",
1283       "desc" : "Removes all listeners for this object",
1284       "sig" : "()\n{\n\n}",
1285       "static" : false,
1286       "memberOf" : "Roo.util.Observable",
1287       "isStatic" : false,
1288       "isConstructor" : false,
1289       "isPrivate" : false,
1290       "example" : "",
1291       "deprecated" : "",
1292       "since" : "",
1293       "see" : "",
1294       "exceptions" : "",
1295       "requires" : "",
1296       "params" : [],
1297       "returns" : []
1298     },
1299     {
1300       "name" : "on",
1301       "type" : "function",
1302       "desc" : "Appends an event handler to this element (shorthand for addListener)",
1303       "sig" : "(eventName, handler, scope, options)",
1304       "static" : false,
1305       "memberOf" : "Roo.util.Observable",
1306       "isStatic" : false,
1307       "isConstructor" : false,
1308       "isPrivate" : false,
1309       "example" : "",
1310       "deprecated" : "",
1311       "since" : "",
1312       "see" : "",
1313       "exceptions" : "",
1314       "requires" : "",
1315       "params" : [
1316         {
1317           "name" : "eventName",
1318           "type" : "String",
1319           "desc" : "The type of event to listen for",
1320           "isOptional" : false
1321         },
1322         {
1323           "name" : "handler",
1324           "type" : "Function",
1325           "desc" : "The method the event invokes",
1326           "isOptional" : false
1327         },
1328         {
1329           "name" : "scope",
1330           "type" : "Object",
1331           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
1332           "isOptional" : false
1333         },
1334         {
1335           "name" : "options",
1336           "type" : "Object",
1337           "desc" : "(optional)",
1338           "isOptional" : false
1339         }
1340       ],
1341       "returns" : []
1342     },
1343     {
1344       "name" : "un",
1345       "type" : "function",
1346       "desc" : "Removes a listener (shorthand for removeListener)",
1347       "sig" : "(eventName, handler, scope)",
1348       "static" : false,
1349       "memberOf" : "Roo.util.Observable",
1350       "isStatic" : false,
1351       "isConstructor" : false,
1352       "isPrivate" : false,
1353       "example" : "",
1354       "deprecated" : "",
1355       "since" : "",
1356       "see" : "",
1357       "exceptions" : "",
1358       "requires" : "",
1359       "params" : [
1360         {
1361           "name" : "eventName",
1362           "type" : "String",
1363           "desc" : "The type of event to listen for",
1364           "isOptional" : false
1365         },
1366         {
1367           "name" : "handler",
1368           "type" : "Function",
1369           "desc" : "The handler to remove",
1370           "isOptional" : false
1371         },
1372         {
1373           "name" : "scope",
1374           "type" : "Object",
1375           "desc" : "(optional) The scope (this object) for the handler",
1376           "isOptional" : false
1377         }
1378       ],
1379       "returns" : []
1380     },
1381     {
1382       "name" : "addEvents",
1383       "type" : "function",
1384       "desc" : "Used to define events on this Observable",
1385       "sig" : "(object)",
1386       "static" : false,
1387       "memberOf" : "Roo.util.Observable",
1388       "isStatic" : false,
1389       "isConstructor" : false,
1390       "isPrivate" : false,
1391       "example" : "",
1392       "deprecated" : "",
1393       "since" : "",
1394       "see" : "",
1395       "exceptions" : "",
1396       "requires" : "",
1397       "params" : [
1398         {
1399           "name" : "object",
1400           "type" : "Object",
1401           "desc" : "The object with the events defined",
1402           "isOptional" : false
1403         }
1404       ],
1405       "returns" : []
1406     },
1407     {
1408       "name" : "releaseCapture",
1409       "type" : "function",
1410       "desc" : "Removes <b>all</b> added captures from the Observable.",
1411       "sig" : "(o)",
1412       "static" : true,
1413       "memberOf" : "Roo.util.Observable",
1414       "isStatic" : true,
1415       "isConstructor" : false,
1416       "isPrivate" : false,
1417       "example" : "",
1418       "deprecated" : "",
1419       "since" : "",
1420       "see" : "",
1421       "exceptions" : "",
1422       "requires" : "",
1423       "params" : [
1424         {
1425           "name" : "o",
1426           "type" : "Observable",
1427           "desc" : "The Observable to release",
1428           "isOptional" : false
1429         }
1430       ],
1431       "returns" : []
1432     },
1433     {
1434       "name" : "removeListener",
1435       "type" : "function",
1436       "desc" : "Removes a listener",
1437       "sig" : "(eventName, handler, scope)",
1438       "static" : false,
1439       "memberOf" : "Roo.util.Observable",
1440       "isStatic" : false,
1441       "isConstructor" : false,
1442       "isPrivate" : false,
1443       "example" : "",
1444       "deprecated" : "",
1445       "since" : "",
1446       "see" : "",
1447       "exceptions" : "",
1448       "requires" : "",
1449       "params" : [
1450         {
1451           "name" : "eventName",
1452           "type" : "String",
1453           "desc" : "The type of event to listen for",
1454           "isOptional" : false
1455         },
1456         {
1457           "name" : "handler",
1458           "type" : "Function",
1459           "desc" : "The handler to remove",
1460           "isOptional" : false
1461         },
1462         {
1463           "name" : "scope",
1464           "type" : "Object",
1465           "desc" : "(optional) The scope (this object) for the handler",
1466           "isOptional" : false
1467         }
1468       ],
1469       "returns" : []
1470     },
1471     {
1472       "name" : "fireEvent",
1473       "type" : "function",
1474       "desc" : "Fires the specified event with the passed parameters (minus the event name).",
1475       "sig" : "(eventName, args)",
1476       "static" : false,
1477       "memberOf" : "Roo.util.Observable",
1478       "isStatic" : false,
1479       "isConstructor" : false,
1480       "isPrivate" : false,
1481       "example" : "",
1482       "deprecated" : "",
1483       "since" : "",
1484       "see" : "",
1485       "exceptions" : "",
1486       "requires" : "",
1487       "params" : [
1488         {
1489           "name" : "eventName",
1490           "type" : "String",
1491           "desc" : "",
1492           "isOptional" : false
1493         },
1494         {
1495           "name" : "args",
1496           "type" : "Object...",
1497           "desc" : "Variable number of parameters are passed to handlers",
1498           "isOptional" : false
1499         }
1500       ],
1501       "returns" : [
1502         {
1503           "name" : "",
1504           "type" : "Boolean",
1505           "desc" : "returns false if any of the handlers return false otherwise it returns true"
1506         }
1507       ]
1508     },
1509     {
1510       "name" : "hasListener",
1511       "type" : "function",
1512       "desc" : "Checks to see if this object has any listeners for a specified event",
1513       "sig" : "(eventName)",
1514       "static" : false,
1515       "memberOf" : "Roo.util.Observable",
1516       "isStatic" : false,
1517       "isConstructor" : false,
1518       "isPrivate" : false,
1519       "example" : "",
1520       "deprecated" : "",
1521       "since" : "",
1522       "see" : "",
1523       "exceptions" : "",
1524       "requires" : "",
1525       "params" : [
1526         {
1527           "name" : "eventName",
1528           "type" : "String",
1529           "desc" : "The name of the event to check for",
1530           "isOptional" : false
1531         }
1532       ],
1533       "returns" : [
1534         {
1535           "name" : "",
1536           "type" : "Boolean",
1537           "desc" : "True if the event is being listened for, else false"
1538         }
1539       ]
1540     },
1541     {
1542       "name" : "capture",
1543       "type" : "function",
1544       "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.",
1545       "sig" : "(o, fn, scope)",
1546       "static" : true,
1547       "memberOf" : "Roo.util.Observable",
1548       "isStatic" : true,
1549       "isConstructor" : false,
1550       "isPrivate" : false,
1551       "example" : "",
1552       "deprecated" : "",
1553       "since" : "",
1554       "see" : "",
1555       "exceptions" : "",
1556       "requires" : "",
1557       "params" : [
1558         {
1559           "name" : "o",
1560           "type" : "Observable",
1561           "desc" : "The Observable to capture",
1562           "isOptional" : false
1563         },
1564         {
1565           "name" : "fn",
1566           "type" : "Function",
1567           "desc" : "The function to call",
1568           "isOptional" : false
1569         },
1570         {
1571           "name" : "scope",
1572           "type" : "Object",
1573           "desc" : "(optional) The scope (this object) for the fn",
1574           "isOptional" : false
1575         }
1576       ],
1577       "returns" : []
1578     },
1579     {
1580       "name" : "addListener",
1581       "type" : "function",
1582       "desc" : "Appends an event handler to this component",
1583       "sig" : "(eventName, handler, scope, options)",
1584       "static" : false,
1585       "memberOf" : "Roo.util.Observable",
1586       "isStatic" : false,
1587       "isConstructor" : false,
1588       "isPrivate" : false,
1589       "example" : "",
1590       "deprecated" : "",
1591       "since" : "",
1592       "see" : "",
1593       "exceptions" : "",
1594       "requires" : "",
1595       "params" : [
1596         {
1597           "name" : "eventName",
1598           "type" : "String",
1599           "desc" : "The type of event to listen for",
1600           "isOptional" : false
1601         },
1602         {
1603           "name" : "handler",
1604           "type" : "Function",
1605           "desc" : "The method the event invokes",
1606           "isOptional" : false
1607         },
1608         {
1609           "name" : "scope",
1610           "type" : "Object",
1611           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
1612           "isOptional" : false
1613         },
1614         {
1615           "name" : "options",
1616           "type" : "Object",
1617           "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>",
1618           "isOptional" : false
1619         }
1620       ],
1621       "returns" : []
1622     }
1623   ],
1624   "events" : [
1625     {
1626       "name" : "rendered",
1627       "type" : "function",
1628       "desc" : "Fires when the form is rendered",
1629       "sig" : "function (form)\n{\n\n}",
1630       "memberOf" : "",
1631       "example" : "",
1632       "deprecated" : "",
1633       "since" : "",
1634       "see" : "",
1635       "params" : [
1636         {
1637           "name" : "form",
1638           "type" : "Roo.form.Form",
1639           "desc" : "",
1640           "isOptional" : false
1641         }
1642       ],
1643       "returns" : []
1644     },
1645     {
1646       "name" : "clientvalidation",
1647       "type" : "function",
1648       "desc" : "If the monitorValid config option is true, this event fires repetitively to notify of valid state",
1649       "sig" : "function (_self, valid)\n{\n\n}",
1650       "memberOf" : "",
1651       "example" : "",
1652       "deprecated" : "",
1653       "since" : "",
1654       "see" : "",
1655       "params" : [
1656         {
1657           "name" : "this",
1658           "type" : "Form",
1659           "desc" : "",
1660           "isOptional" : false
1661         },
1662         {
1663           "name" : "valid",
1664           "type" : "Boolean",
1665           "desc" : "true if the form has passed client-side validation",
1666           "isOptional" : false
1667         }
1668       ],
1669       "returns" : []
1670     },
1671     {
1672       "name" : "beforeaction",
1673       "type" : "function",
1674       "desc" : "Fires before any action is performed. Return false to cancel the action.",
1675       "sig" : "function (_self, action)\n{\n\n}",
1676       "memberOf" : "Roo.form.BasicForm",
1677       "example" : "",
1678       "deprecated" : "",
1679       "since" : "",
1680       "see" : "",
1681       "params" : [
1682         {
1683           "name" : "this",
1684           "type" : "Form",
1685           "desc" : "",
1686           "isOptional" : false
1687         },
1688         {
1689           "name" : "action",
1690           "type" : "Action",
1691           "desc" : "The action to be performed",
1692           "isOptional" : false
1693         }
1694       ],
1695       "returns" : []
1696     },
1697     {
1698       "name" : "actioncomplete",
1699       "type" : "function",
1700       "desc" : "Fires when an action is completed.",
1701       "sig" : "function (_self, action)\n{\n\n}",
1702       "memberOf" : "Roo.form.BasicForm",
1703       "example" : "",
1704       "deprecated" : "",
1705       "since" : "",
1706       "see" : "",
1707       "params" : [
1708         {
1709           "name" : "this",
1710           "type" : "Form",
1711           "desc" : "",
1712           "isOptional" : false
1713         },
1714         {
1715           "name" : "action",
1716           "type" : "Action",
1717           "desc" : "The action that completed",
1718           "isOptional" : false
1719         }
1720       ],
1721       "returns" : []
1722     },
1723     {
1724       "name" : "actionfailed",
1725       "type" : "function",
1726       "desc" : "Fires when an action fails.",
1727       "sig" : "function (_self, action)\n{\n\n}",
1728       "memberOf" : "Roo.form.BasicForm",
1729       "example" : "",
1730       "deprecated" : "",
1731       "since" : "",
1732       "see" : "",
1733       "params" : [
1734         {
1735           "name" : "this",
1736           "type" : "Form",
1737           "desc" : "",
1738           "isOptional" : false
1739         },
1740         {
1741           "name" : "action",
1742           "type" : "Action",
1743           "desc" : "The action that failed",
1744           "isOptional" : false
1745         }
1746       ],
1747       "returns" : []
1748     }
1749   ]
1750 }