webgui/www/extras/extjs/docs/output/Ext.form.FieldSet.html

985 lines
No EOL
56 KiB
HTML

<!doctype html public "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>Ext.form.FieldSet</title>
<link rel="stylesheet" type="text/css" href="../resources/reset.css"/>
<link rel="stylesheet" type="text/css" href="../resources/style.css" media="screen"/>
<link rel="stylesheet" type="text/css" href="../resources/print.css" media="print">
<!-- GC -->
</head>
<body>
<div class="body-wrap">
<div class="top-tools">
<img src="../resources/print.gif" width="16" height="16" align="absmiddle">&nbsp;<a href="Ext.form.FieldSet.html" target="_blank">Print Friendly</a><br/>
</div>
<h1>Class Ext.form.FieldSet</h1>
<table cellspacing="0">
<tr><td class="label">Package:</td><td>Ext.form</td></tr>
<tr><td class="label">Class:</td><td>FieldSet</td></tr>
<tr><td class="label">Extends:</td><td><a href="Ext.form.Layout.html">Layout</a></td></tr>
<tr><td class="label">Defined In:</td><td><a href="Layout.jss.html">Layout.js</a></td></tr>
</table>
<div class="description">
Creates a fieldset container for layout and rendering of fields in an <a href="Ext.form.Form.html">Ext.form.Form</a>. </div>
<br />
<a href="#properties">Properties</a>
&nbsp;&nbsp;-&nbsp;&nbsp;<a href="#methods">Methods</a>
&nbsp;&nbsp;-&nbsp;&nbsp;<a href="#events">Events</a>
&nbsp;&nbsp;-&nbsp;&nbsp;<a href="#configs">Config Options</a>
<hr />
<a name="properties"></a>
<h2>Public Properties</h2>
<table cellspacing="0" class="member-table">
<tr>
<th class="sig-header" colspan="2">Property</th>
<th class="msource-header">Defined By</th>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#disabled">disabled</a> : Object</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#disabled">Component</a></td>
</tr>
<tr>
<td class="mdesc">true if this component is disabled. Read-only.</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#disabledClass">disabledClass</a> : Object</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#disabledClass">Component</a></td>
</tr>
<tr class="alt">
<td class="mdesc">CSS class added to the component when it is disabled.</td>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#hidden">hidden</a> : Object</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#hidden">Component</a></td>
</tr>
<tr>
<td class="mdesc">true if this component is hidden. Read-only.</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#rendered">rendered</a> : Object</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#rendered">Component</a></td>
</tr>
<tr class="alt">
<td class="mdesc">true if this component has been rendered. Read-only.</td>
</tr>
</table>
<a name="methods"></a>
<h2>Public Methods</h2>
<table cellspacing="0" class="member-table">
<tr>
<th class="sig-header" colspan="2">Method</th>
<th class="msource-header">Defined By</th>
</tr>
<tr>
<td class="micon" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#FieldSet">FieldSet</a>(<code>Object config</code>)</td>
<td class="msource" rowspan="2">FieldSet</td>
</tr>
<tr>
<td class="mdesc"></td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#addEvents">addEvents</a>(<code>Object object</code>) : void</td>
<td class="msource" rowspan="2"><a href="Ext.util.Observable.html#addEvents">Observable</a></td>
</tr>
<tr class="alt">
<td class="mdesc">Copies any events from the passed object onto this object if they do not already exist. The passed object
must also ...</td>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#addListener">addListener</a>(<code>String eventName</code>, <code>Function handler</code>, <span class="optional" title="Optional">[<code>Object scope</code>]</span>, <span class="optional" title="Optional">[<code>Object options</code>]</span>) : void</td>
<td class="msource" rowspan="2"><a href="Ext.util.Observable.html#addListener">Observable</a></td>
</tr>
<tr>
<td class="mdesc">Appends an event handler to this component</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#disable">disable</a>() : void</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#disable">Component</a></td>
</tr>
<tr class="alt">
<td class="mdesc">Disable this component</td>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#enable">enable</a>() : void</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#enable">Component</a></td>
</tr>
<tr>
<td class="mdesc">Enable this component</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#fireEvent">fireEvent</a>(<code>String eventName</code>, <code>Object... args</code>) : Boolean</td>
<td class="msource" rowspan="2"><a href="Ext.util.Observable.html#fireEvent">Observable</a></td>
</tr>
<tr class="alt">
<td class="mdesc">Fires the specified event with the passed parameters (minus the event name).</td>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#focus">focus</a>(<code>Boolean selectText</code>) : void</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#focus">Component</a></td>
</tr>
<tr>
<td class="mdesc">Try to focus this component</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#getEl">getEl</a>() : Ext.Element</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#getEl">Component</a></td>
</tr>
<tr class="alt">
<td class="mdesc">Returns the underlying <a href="Ext.Element.html">Ext.Element</a></td>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#getId">getId</a>() : String</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#getId">Component</a></td>
</tr>
<tr>
<td class="mdesc">Returns the id of this component</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#hasListener">hasListener</a>(<code>String eventName</code>) : Boolean</td>
<td class="msource" rowspan="2"><a href="Ext.util.Observable.html#hasListener">Observable</a></td>
</tr>
<tr class="alt">
<td class="mdesc">Checks to see if this object is currently listening for a specified event</td>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#hide">hide</a>() : void</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#hide">Component</a></td>
</tr>
<tr>
<td class="mdesc">Hide this component</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#isVisible">isVisible</a>() : void</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#isVisible">Component</a></td>
</tr>
<tr class="alt">
<td class="mdesc">Returns true if this component is visible</td>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#on">on</a>(<code>String eventName</code>, <code>Function handler</code>, <span class="optional" title="Optional">[<code>Object options</code>]</span>) : void</td>
<td class="msource" rowspan="2"><a href="Ext.util.Observable.html#on">Observable</a></td>
</tr>
<tr>
<td class="mdesc">Appends an event handler to this element (shorthand for addListener)</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#purgeListeners">purgeListeners</a>() : void</td>
<td class="msource" rowspan="2"><a href="Ext.util.Observable.html#purgeListeners">Observable</a></td>
</tr>
<tr class="alt">
<td class="mdesc">Removes all listeners for this object</td>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#removeListener">removeListener</a>(<code>String eventName</code>, <code>Function handler</code>, <span class="optional" title="Optional">[<code>Object scope</code>]</span>) : void</td>
<td class="msource" rowspan="2"><a href="Ext.util.Observable.html#removeListener">Observable</a></td>
</tr>
<tr>
<td class="mdesc">Removes a listener</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#render">render</a>(<span class="optional" title="Optional">[<code>String/HTMLElement/Element container</code>]</span>) : void</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#render">Component</a></td>
</tr>
<tr class="alt">
<td class="mdesc">If this is a lazy rendering component, render it to its container element</td>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#setDisabled">setDisabled</a>(<code>Boolean disabled</code>) : void</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#setDisabled">Component</a></td>
</tr>
<tr>
<td class="mdesc">Convenience function for setting disabled/enabled by boolean</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#setVisible">setVisible</a>(<code>Boolean visible</code>) : void</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#setVisible">Component</a></td>
</tr>
<tr class="alt">
<td class="mdesc">Convenience function to hide or show this component by boolean</td>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#show">show</a>() : void</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#show">Component</a></td>
</tr>
<tr>
<td class="mdesc">Show this component</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#un">un</a>(<code>String eventName</code>, <code>Function handler</code>, <span class="optional" title="Optional">[<code>Object scope</code>]</span>) : void</td>
<td class="msource" rowspan="2"><a href="Ext.util.Observable.html#un">Observable</a></td>
</tr>
<tr class="alt">
<td class="mdesc">Removes a listener (shorthand for removeListener)</td>
</tr>
</table>
<a name="events"></a>
<h2>Public Events</h2>
<table cellspacing="0" class="member-table">
<tr>
<th class="sig-header" colspan="2">Event</th>
<th class="msource-header">Defined By</th>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#event-beforedestroy">beforedestroy</a> : (<code>Ext.Component this</code>)</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#event-beforedestroy">Component</a></td>
</tr>
<tr>
<td class="mdesc">Fires before the component is destroyed</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#event-beforehide">beforehide</a> : (<code>Ext.Component this</code>)</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#event-beforehide">Component</a></td>
</tr>
<tr class="alt">
<td class="mdesc">Fires before the component is hidden</td>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#event-beforerender">beforerender</a> : (<code>Ext.Component this</code>)</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#event-beforerender">Component</a></td>
</tr>
<tr>
<td class="mdesc">Fires before the component is rendered</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#event-beforeshow">beforeshow</a> : (<code>Ext.Component this</code>)</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#event-beforeshow">Component</a></td>
</tr>
<tr class="alt">
<td class="mdesc">Fires before the component is shown</td>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#event-destroy">destroy</a> : (<code>Ext.Component this</code>)</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#event-destroy">Component</a></td>
</tr>
<tr>
<td class="mdesc">Fires after the component is destroyed</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#event-disable">disable</a> : (<code>Ext.Component this</code>)</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#event-disable">Component</a></td>
</tr>
<tr class="alt">
<td class="mdesc">Fires after the component is disabled</td>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#event-enable">enable</a> : (<code>Ext.Component this</code>)</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#event-enable">Component</a></td>
</tr>
<tr>
<td class="mdesc">Fires after the component is enabled</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#event-hide">hide</a> : (<code>Ext.Component this</code>)</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#event-hide">Component</a></td>
</tr>
<tr class="alt">
<td class="mdesc">Fires after the component is hidden</td>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#event-render">render</a> : (<code>Ext.Component this</code>)</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#event-render">Component</a></td>
</tr>
<tr>
<td class="mdesc">Fires after the component is rendered</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#event-show">show</a> : (<code>Ext.Component this</code>)</td>
<td class="msource" rowspan="2"><a href="Ext.Component.html#event-show">Component</a></td>
</tr>
<tr class="alt">
<td class="mdesc">Fires after the component is shown</td>
</tr>
</table>
<a name="configs"></a>
<h2>Config Options</h2>
<table cellspacing="0" class="member-table">
<tr>
<th class="sig-header" colspan="2">Config Options</th>
<th class="msource-header">Defined By</th>
</tr>
<tr>
<td class="micon" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#config-autoCreate">autoCreate</a> : String/Object</td>
<td class="msource" rowspan="2">FieldSet</td>
</tr>
<tr>
<td class="mdesc">A DomHelper element spec used to autocreate the fieldset (defaults to {tag: 'fieldset', cn: {tag:'legend'}})</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#config-clear">clear</a> : Boolean</td>
<td class="msource" rowspan="2"><a href="Ext.form.Layout.html#clear">Layout</a></td>
</tr>
<tr class="alt">
<td class="mdesc">True to add a clearing element at the end of this layout, equivalent to CSS clear: both (defaults to true)</td>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#config-hideLabels">hideLabels</a> : Boolean</td>
<td class="msource" rowspan="2"><a href="Ext.form.Layout.html#hideLabels">Layout</a></td>
</tr>
<tr>
<td class="mdesc">True to suppress the display of field labels in this layout (defaults to false)</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#config-labelAlign">labelAlign</a> : String</td>
<td class="msource" rowspan="2"><a href="Ext.form.Layout.html#labelAlign">Layout</a></td>
</tr>
<tr class="alt">
<td class="mdesc">Valid values are "left," "top" and "right" (defaults to "left")</td>
</tr>
<tr>
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#config-labelSeparator">labelSeparator</a> : String</td>
<td class="msource" rowspan="2"><a href="Ext.form.Layout.html#labelSeparator">Layout</a></td>
</tr>
<tr>
<td class="mdesc">The separator to use after field labels (defaults to ':')</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#config-labelWidth">labelWidth</a> : Number</td>
<td class="msource" rowspan="2"><a href="Ext.form.Layout.html#labelWidth">Layout</a></td>
</tr>
<tr class="alt">
<td class="mdesc">Fixed width in pixels of all field labels (defaults to undefined)</td>
</tr>
<tr>
<td class="micon" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#config-legend">legend</a> : String</td>
<td class="msource" rowspan="2">FieldSet</td>
</tr>
<tr>
<td class="mdesc">The text to display as the legend for the FieldSet (defaults to '')</td>
</tr>
<tr class="alt">
<td class="micon inherited" title="Inherited" rowspan="2">&nbsp;</td>
<td class="sig"><a class="mlink" href="#config-style">style</a> : String/Object/Function</td>
<td class="msource" rowspan="2"><a href="Ext.form.Layout.html#style">Layout</a></td>
</tr>
<tr class="alt">
<td class="mdesc">A style specification string eg "width:100px", or object in the form {width:"100px"}, or a function which returns suc...</td>
</tr>
</table>
<h2 class="mdetail-head">Property Details</h2>
<div class="detail-wrap">
<a name="disabled"></a>
<div class="mdetail">
<h3>disabled</i></h3>
<code>public Object disabled</code>
<div class="mdetail-desc">
true if this component is disabled. Read-only. </div>
<div class="mdetail-def">This property is defined by <a href="Ext.Component.html#disabled">Component</a>.</div>
</div>
<a name="disabledClass"></a>
<div class="mdetail alt">
<h3>disabledClass</i></h3>
<code>public Object disabledClass</code>
<div class="mdetail-desc">
CSS class added to the component when it is disabled. </div>
<div class="mdetail-def">This property is defined by <a href="Ext.Component.html#disabledClass">Component</a>.</div>
</div>
<a name="hidden"></a>
<div class="mdetail">
<h3>hidden</i></h3>
<code>public Object hidden</code>
<div class="mdetail-desc">
true if this component is hidden. Read-only. </div>
<div class="mdetail-def">This property is defined by <a href="Ext.Component.html#hidden">Component</a>.</div>
</div>
<a name="rendered"></a>
<div class="mdetail alt">
<h3>rendered</i></h3>
<code>public Object rendered</code>
<div class="mdetail-desc">
true if this component has been rendered. Read-only. </div>
<div class="mdetail-def">This property is defined by <a href="Ext.Component.html#rendered">Component</a>.</div>
</div>
</div>
<a name="FieldSet"></a>
<h2 class="mdetail-head">Constructor Details</h2>
<div class="detail-wrap">
<div class="mdetail">
<h3>FieldSet</i></h3>
<code>public function FieldSet(<code>Object config</code>)</code>
<div class="mdetail-desc">
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li><code>config</code> : Object<div class="sub-desc">Configuration options</div></li> </ul>
</div>
</div>
</div>
</div>
<h2 class="mdetail-head">Method Details</h2>
<div class="detail-wrap">
<a name="addEvents"></a>
<div class="mdetail">
<h3>addEvents</i></h3>
<code>public function addEvents(<code>Object object</code>)</code>
<div class="mdetail-desc">
Copies any events from the passed object onto this object if they do not already exist. The passed object
must also inherit from Observable for this method to have any effect.
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li><code>object</code> : Object<div class="sub-desc">The object from which to copy events</div></li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>void</code></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.util.Observable.html#addEvents">Observable</a>.</div>
</div>
<a name="addListener"></a>
<div class="mdetail alt">
<h3>addListener</i></h3>
<code>public function addListener(<code>String eventName</code>, <code>Function handler</code>, <span class="optional" title="Optional">[<code>Object scope</code>]</span>, <span class="optional" title="Optional">[<code>Object options</code>]</span>)</code>
<div class="mdetail-desc">
Appends an event handler to this component
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li><code>eventName</code> : String<div class="sub-desc">The type of event to listen for</div></li><li><code>handler</code> : Function<div class="sub-desc">The method the event invokes</div></li><li><code>scope</code> : Object<div class="sub-desc">(optional) The scope in which to execute the handler function. The handler function's "this" context.</div></li><li><code>options</code> : Object<div class="sub-desc">(optional) An object containing handler configuration properties. This may contain any of the following properties:<ul> <li>scope {Object} The scope in which to execute the handler function. The handler function's "this" context.</li> <li>delegate {String} A simple selector to filter the target or look for a descendant of the target</li> <li>stopEvent {Boolean} True to stop the event. That is stop propagation, and prevent the default action.</li> <li>preventDefault {Boolean} True to prevent the default action</li> <li>stopPropagation {Boolean} True to prevent event propagation</li> <li>normalized {Boolean} False to pass a browser event to the handler function instead of an Ext.EventObject</li> <li>delay {Number} The number of milliseconds to delay the invocation of the handler after te event fires.</li> <li>single {Boolean} True to add a handler to handle just the next firing of the event, and then remove itself.</li> <li>buffer {Number} Causes the handler to be scheduled to run in an <a href="Ext.util.DelayedTask.html">Ext.util.DelayedTask</a> delayed by the specified number of milliseconds. If the event fires again within that time, the original handler is <em>not</em> invoked, but the new handler is scheduled in its place.</li> </ul> <p> <b>Combining Options</b><br> Using the options argument, it is possible to combine different types of listeners:<br> <br> A normalized, delayed, one-time listener that auto stops the event and passes a custom argument (forumId)<div style="margin: 5px 20px 20px;"> Code: <pre><code>el.on('click', this.onClick, this, { single: true, delay: 100, stopEvent : true, forumId: 4 });</pre> <p> The method also allows for a single argument to be passed which is a config object containing properties which specify multiple handlers. <p> <b>Attaching multiple handlers in 1 call</b><br> Code: <pre><code>el.on({ 'click' : { fn: this.onClick scope: this, delay: 100 }, 'mouseover' : { fn: this.onMouseOver scope: this }, 'mouseout' : { fn: this.onMouseOut scope: this } });</pre> <p> Or a shorthand syntax:<br> Code: <pre><code>el.on({ 'click' : this.onClick, 'mouseover' : this.onMouseOver, 'mouseout' : this.onMouseOut scope: this });</pre></div></li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>void</code></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.util.Observable.html#addListener">Observable</a>.</div>
</div>
<a name="disable"></a>
<div class="mdetail">
<h3>disable</i></h3>
<code>public function disable()</code>
<div class="mdetail-desc">
Disable this component
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li>None.</li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>void</code></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.Component.html#disable">Component</a>.</div>
</div>
<a name="enable"></a>
<div class="mdetail alt">
<h3>enable</i></h3>
<code>public function enable()</code>
<div class="mdetail-desc">
Enable this component
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li>None.</li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>void</code></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.Component.html#enable">Component</a>.</div>
</div>
<a name="fireEvent"></a>
<div class="mdetail">
<h3>fireEvent</i></h3>
<code>public function fireEvent(<code>String eventName</code>, <code>Object... args</code>)</code>
<div class="mdetail-desc">
Fires the specified event with the passed parameters (minus the event name).
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li><code>eventName</code> : String<div class="sub-desc"></div></li><li><code>args</code> : Object...<div class="sub-desc">Variable number of parameters are passed to handlers</div></li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>Boolean</code><div class="sub-desc">returns false if any of the handlers return false otherwise it returns true</div></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.util.Observable.html#fireEvent">Observable</a>.</div>
</div>
<a name="focus"></a>
<div class="mdetail alt">
<h3>focus</i></h3>
<code>public function focus(<code>Boolean selectText</code>)</code>
<div class="mdetail-desc">
Try to focus this component
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li><code>selectText</code> : Boolean<div class="sub-desc">True to also select the text in this component (if applicable)</div></li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>void</code></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.Component.html#focus">Component</a>.</div>
</div>
<a name="getEl"></a>
<div class="mdetail">
<h3>getEl</i></h3>
<code>public function getEl()</code>
<div class="mdetail-desc">
Returns the underlying <a href="Ext.Element.html">Ext.Element</a>
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li>None.</li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>Ext.Element</code><div class="sub-desc">The element</div></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.Component.html#getEl">Component</a>.</div>
</div>
<a name="getId"></a>
<div class="mdetail alt">
<h3>getId</i></h3>
<code>public function getId()</code>
<div class="mdetail-desc">
Returns the id of this component
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li>None.</li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>String</code></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.Component.html#getId">Component</a>.</div>
</div>
<a name="hasListener"></a>
<div class="mdetail">
<h3>hasListener</i></h3>
<code>public function hasListener(<code>String eventName</code>)</code>
<div class="mdetail-desc">
Checks to see if this object is currently listening for a specified event
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li><code>eventName</code> : String<div class="sub-desc">The name of the event to check for</div></li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>Boolean</code><div class="sub-desc">True if the event is being listened for, else false</div></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.util.Observable.html#hasListener">Observable</a>.</div>
</div>
<a name="hide"></a>
<div class="mdetail alt">
<h3>hide</i></h3>
<code>public function hide()</code>
<div class="mdetail-desc">
Hide this component
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li>None.</li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>void</code></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.Component.html#hide">Component</a>.</div>
</div>
<a name="isVisible"></a>
<div class="mdetail">
<h3>isVisible</i></h3>
<code>public function isVisible()</code>
<div class="mdetail-desc">
Returns true if this component is visible
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li>None.</li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>void</code></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.Component.html#isVisible">Component</a>.</div>
</div>
<a name="on"></a>
<div class="mdetail alt">
<h3>on</i></h3>
<code>public function on(<code>String eventName</code>, <code>Function handler</code>, <span class="optional" title="Optional">[<code>Object options</code>]</span>)</code>
<div class="mdetail-desc">
Appends an event handler to this element (shorthand for addListener)
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li><code>eventName</code> : String<div class="sub-desc">The type of event to listen for</div></li><li><code>handler</code> : Function<div class="sub-desc">The method the event invokes</div></li><li><code>options</code> : Object<div class="sub-desc">(optional)</div></li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>void</code></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.util.Observable.html#on">Observable</a>.</div>
</div>
<a name="purgeListeners"></a>
<div class="mdetail">
<h3>purgeListeners</i></h3>
<code>public function purgeListeners()</code>
<div class="mdetail-desc">
Removes all listeners for this object
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li>None.</li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>void</code></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.util.Observable.html#purgeListeners">Observable</a>.</div>
</div>
<a name="removeListener"></a>
<div class="mdetail alt">
<h3>removeListener</i></h3>
<code>public function removeListener(<code>String eventName</code>, <code>Function handler</code>, <span class="optional" title="Optional">[<code>Object scope</code>]</span>)</code>
<div class="mdetail-desc">
Removes a listener
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li><code>eventName</code> : String<div class="sub-desc">The type of event to listen for</div></li><li><code>handler</code> : Function<div class="sub-desc">The handler to remove</div></li><li><code>scope</code> : Object<div class="sub-desc">(optional) The scope (this object) for the handler</div></li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>void</code></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.util.Observable.html#removeListener">Observable</a>.</div>
</div>
<a name="render"></a>
<div class="mdetail">
<h3>render</i></h3>
<code>public function render(<span class="optional" title="Optional">[<code>String/HTMLElement/Element container</code>]</span>)</code>
<div class="mdetail-desc">
If this is a lazy rendering component, render it to its container element
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li><code>container</code> : String/HTMLElement/Element<div class="sub-desc">(optional) The element this component should be rendered into. If it is being applied to existing markup, this should be left off.</div></li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>void</code></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.Component.html#render">Component</a>.</div>
</div>
<a name="setDisabled"></a>
<div class="mdetail alt">
<h3>setDisabled</i></h3>
<code>public function setDisabled(<code>Boolean disabled</code>)</code>
<div class="mdetail-desc">
Convenience function for setting disabled/enabled by boolean
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li><code>disabled</code> : Boolean<div class="sub-desc"></div></li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>void</code></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.Component.html#setDisabled">Component</a>.</div>
</div>
<a name="setVisible"></a>
<div class="mdetail">
<h3>setVisible</i></h3>
<code>public function setVisible(<code>Boolean visible</code>)</code>
<div class="mdetail-desc">
Convenience function to hide or show this component by boolean
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li><code>visible</code> : Boolean<div class="sub-desc">True to show, false to hide</div></li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>void</code></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.Component.html#setVisible">Component</a>.</div>
</div>
<a name="show"></a>
<div class="mdetail alt">
<h3>show</i></h3>
<code>public function show()</code>
<div class="mdetail-desc">
Show this component
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li>None.</li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>void</code></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.Component.html#show">Component</a>.</div>
</div>
<a name="un"></a>
<div class="mdetail">
<h3>un</i></h3>
<code>public function un(<code>String eventName</code>, <code>Function handler</code>, <span class="optional" title="Optional">[<code>Object scope</code>]</span>)</code>
<div class="mdetail-desc">
Removes a listener (shorthand for removeListener)
<div class="mdetail-params">
<strong>Parameters:</strong>
<ul><li><code>eventName</code> : String<div class="sub-desc">The type of event to listen for</div></li><li><code>handler</code> : Function<div class="sub-desc">The handler to remove</div></li><li><code>scope</code> : Object<div class="sub-desc">(optional) The scope (this object) for the handler</div></li> </ul>
<strong>Returns:</strong>
<ul>
<li><code>void</code></li>
</ul>
</div>
</div>
<div class="mdetail-def">This method is defined by <a href="Ext.util.Observable.html#un">Observable</a>.</div>
</div>
</div>
<h2 class="mdetail-head">Event Details</h2>
<div class="detail-wrap">
<a name="event-beforedestroy"></a>
<div class="mdetail">
<h3>beforedestroy</i></h3>
<code>public event beforedestroy</code>
<div class="mdetail-desc">
Fires before the component is destroyed
<div class="mdetail-params">
<strong style="font-weight:normal;">Subscribers will be called with the following parameters:</strong>
<ul><li><code>this</code> : Ext.Component<div class="sub-desc"></div></li> </ul>
</div>
</div>
<div class="mdetail-def">This event is defined by <a href="Ext.Component.html#event-beforedestroy">Component</a>.</div>
</div>
<a name="event-beforehide"></a>
<div class="mdetail alt">
<h3>beforehide</i></h3>
<code>public event beforehide</code>
<div class="mdetail-desc">
Fires before the component is hidden
<div class="mdetail-params">
<strong style="font-weight:normal;">Subscribers will be called with the following parameters:</strong>
<ul><li><code>this</code> : Ext.Component<div class="sub-desc"></div></li> </ul>
</div>
</div>
<div class="mdetail-def">This event is defined by <a href="Ext.Component.html#event-beforehide">Component</a>.</div>
</div>
<a name="event-beforerender"></a>
<div class="mdetail">
<h3>beforerender</i></h3>
<code>public event beforerender</code>
<div class="mdetail-desc">
Fires before the component is rendered
<div class="mdetail-params">
<strong style="font-weight:normal;">Subscribers will be called with the following parameters:</strong>
<ul><li><code>this</code> : Ext.Component<div class="sub-desc"></div></li> </ul>
</div>
</div>
<div class="mdetail-def">This event is defined by <a href="Ext.Component.html#event-beforerender">Component</a>.</div>
</div>
<a name="event-beforeshow"></a>
<div class="mdetail alt">
<h3>beforeshow</i></h3>
<code>public event beforeshow</code>
<div class="mdetail-desc">
Fires before the component is shown
<div class="mdetail-params">
<strong style="font-weight:normal;">Subscribers will be called with the following parameters:</strong>
<ul><li><code>this</code> : Ext.Component<div class="sub-desc"></div></li> </ul>
</div>
</div>
<div class="mdetail-def">This event is defined by <a href="Ext.Component.html#event-beforeshow">Component</a>.</div>
</div>
<a name="event-destroy"></a>
<div class="mdetail">
<h3>destroy</i></h3>
<code>public event destroy</code>
<div class="mdetail-desc">
Fires after the component is destroyed
<div class="mdetail-params">
<strong style="font-weight:normal;">Subscribers will be called with the following parameters:</strong>
<ul><li><code>this</code> : Ext.Component<div class="sub-desc"></div></li> </ul>
</div>
</div>
<div class="mdetail-def">This event is defined by <a href="Ext.Component.html#event-destroy">Component</a>.</div>
</div>
<a name="event-disable"></a>
<div class="mdetail alt">
<h3>disable</i></h3>
<code>public event disable</code>
<div class="mdetail-desc">
Fires after the component is disabled
<div class="mdetail-params">
<strong style="font-weight:normal;">Subscribers will be called with the following parameters:</strong>
<ul><li><code>this</code> : Ext.Component<div class="sub-desc"></div></li> </ul>
</div>
</div>
<div class="mdetail-def">This event is defined by <a href="Ext.Component.html#event-disable">Component</a>.</div>
</div>
<a name="event-enable"></a>
<div class="mdetail">
<h3>enable</i></h3>
<code>public event enable</code>
<div class="mdetail-desc">
Fires after the component is enabled
<div class="mdetail-params">
<strong style="font-weight:normal;">Subscribers will be called with the following parameters:</strong>
<ul><li><code>this</code> : Ext.Component<div class="sub-desc"></div></li> </ul>
</div>
</div>
<div class="mdetail-def">This event is defined by <a href="Ext.Component.html#event-enable">Component</a>.</div>
</div>
<a name="event-hide"></a>
<div class="mdetail alt">
<h3>hide</i></h3>
<code>public event hide</code>
<div class="mdetail-desc">
Fires after the component is hidden
<div class="mdetail-params">
<strong style="font-weight:normal;">Subscribers will be called with the following parameters:</strong>
<ul><li><code>this</code> : Ext.Component<div class="sub-desc"></div></li> </ul>
</div>
</div>
<div class="mdetail-def">This event is defined by <a href="Ext.Component.html#event-hide">Component</a>.</div>
</div>
<a name="event-render"></a>
<div class="mdetail">
<h3>render</i></h3>
<code>public event render</code>
<div class="mdetail-desc">
Fires after the component is rendered
<div class="mdetail-params">
<strong style="font-weight:normal;">Subscribers will be called with the following parameters:</strong>
<ul><li><code>this</code> : Ext.Component<div class="sub-desc"></div></li> </ul>
</div>
</div>
<div class="mdetail-def">This event is defined by <a href="Ext.Component.html#event-render">Component</a>.</div>
</div>
<a name="event-show"></a>
<div class="mdetail alt">
<h3>show</i></h3>
<code>public event show</code>
<div class="mdetail-desc">
Fires after the component is shown
<div class="mdetail-params">
<strong style="font-weight:normal;">Subscribers will be called with the following parameters:</strong>
<ul><li><code>this</code> : Ext.Component<div class="sub-desc"></div></li> </ul>
</div>
</div>
<div class="mdetail-def">This event is defined by <a href="Ext.Component.html#event-show">Component</a>.</div>
</div>
</div>
<h2 class="mdetail-head">Config Details</h2>
<div class="detail-wrap">
<a name="config-autoCreate"></a>
<div class="mdetail">
<h3>autoCreate</i></h3>
<code>autoCreate : String/Object</code>
<div class="mdetail-desc">
A DomHelper element spec used to autocreate the fieldset (defaults to {tag: 'fieldset', cn: {tag:'legend'}}) </div>
<div class="mdetail-def">This config option is defined by FieldSet.</div>
</div>
<a name="config-clear"></a>
<div class="mdetail alt">
<h3>clear</i></h3>
<code>clear : Boolean</code>
<div class="mdetail-desc">
True to add a clearing element at the end of this layout, equivalent to CSS clear: both (defaults to true) </div>
<div class="mdetail-def">This config option is defined by <a href="Ext.form.Layout.html#clear">Layout</a>.</div>
</div>
<a name="config-hideLabels"></a>
<div class="mdetail">
<h3>hideLabels</i></h3>
<code>hideLabels : Boolean</code>
<div class="mdetail-desc">
True to suppress the display of field labels in this layout (defaults to false) </div>
<div class="mdetail-def">This config option is defined by <a href="Ext.form.Layout.html#hideLabels">Layout</a>.</div>
</div>
<a name="config-labelAlign"></a>
<div class="mdetail alt">
<h3>labelAlign</i></h3>
<code>labelAlign : String</code>
<div class="mdetail-desc">
Valid values are "left," "top" and "right" (defaults to "left") </div>
<div class="mdetail-def">This config option is defined by <a href="Ext.form.Layout.html#labelAlign">Layout</a>.</div>
</div>
<a name="config-labelSeparator"></a>
<div class="mdetail">
<h3>labelSeparator</i></h3>
<code>labelSeparator : String</code>
<div class="mdetail-desc">
The separator to use after field labels (defaults to ':') </div>
<div class="mdetail-def">This config option is defined by <a href="Ext.form.Layout.html#labelSeparator">Layout</a>.</div>
</div>
<a name="config-labelWidth"></a>
<div class="mdetail alt">
<h3>labelWidth</i></h3>
<code>labelWidth : Number</code>
<div class="mdetail-desc">
Fixed width in pixels of all field labels (defaults to undefined) </div>
<div class="mdetail-def">This config option is defined by <a href="Ext.form.Layout.html#labelWidth">Layout</a>.</div>
</div>
<a name="config-legend"></a>
<div class="mdetail">
<h3>legend</i></h3>
<code>legend : String</code>
<div class="mdetail-desc">
The text to display as the legend for the FieldSet (defaults to '') </div>
<div class="mdetail-def">This config option is defined by FieldSet.</div>
</div>
<a name="config-style"></a>
<div class="mdetail alt">
<h3>style</i></h3>
<code>style : String/Object/Function</code>
<div class="mdetail-desc">
A style specification string eg "width:100px", or object in the form {width:"100px"}, or a function which returns such a specification. </div>
<div class="mdetail-def">This config option is defined by <a href="Ext.form.Layout.html#style">Layout</a>.</div>
</div>
</div>
</div>
<hr>
<div style="font-size:10px;text-align:center;color:gray;">Ext - Copyright &copy; 2006-2007 Ext JS, LLC<br />All rights reserved.</div>
</body>
</html>