Upgrade to ExtJS 4.0.0 - Released 04/26/2011
[extjs.git] / docs / api / Ext.form.field.ComboBox.html
1 <!DOCTYPE html><html><head><title>Ext.form.field.ComboBox | Ext JS 4.0 Documentation</title><script type="text/javascript" src="../ext-all.js"></script><link rel="stylesheet" href="../reset.css" type="text/css"><link rel="stylesheet" href="../scrollbars.css" type="text/css"><link rel="stylesheet" href="../docs.css" type="text/css"><link id="styleCss" rel="stylesheet" href="../style.css" type="text/css"><script type="text/javascript" src="../prettify.js"></script><link rel="stylesheet" href="../prettify.css" type="text/css"><!-- link(rel: 'stylesheet', href: req.baseURL + '/css/ext4.css', type: 'text/css')--><link rel="shortcut icon" type="image/ico" href="../favicon.ico"><!--[if IE]>
2 <style type="text/css">.head-band { display: none; }
3 .header { border: 0; top: 0; left: 0px; background: url(../header.gif) repeat-x; }
4 .doc-tab .members .member a.more { background-color: #efefef; }
5 </style><link rel="stylesheet" href="/new/css/ie.css" type="text/css"><![endif]-->
6 </head><body id="ext-body" class="iScroll"><div id="notice" class="notice">For up to date documentation and features, visit 
7 <a href="http://docs.sencha.com/ext-js/4-0">http://docs.sencha.com/ext-js/4-0</a></div><div class="wrapper"><div class="head-band"></div><div class="header"><h2><a href="../index.html">Sencha Documentation</a></h2></div><div id="search"><form><input type="text" placeholder="Search" id="search-field" autocomplete="off" name="q"></form><div id="search-box"></div></div><div id="treePanel"></div><div id="container"><script type="text/javascript">
8
9     req = {
10         liveURL: '.',
11         standAloneMode: true,
12         origDocClass: 'Ext.form.field.ComboBox',
13         docClass: 'Ext.form.field.ComboBox',
14         docReq: 'Ext.form.field.ComboBox',
15         version: '4.0',
16         baseURL: '.',
17         baseDocURL: '.',
18         baseProdURL: '.'
19     };
20
21     clsInfo = {};
22
23
24
25 </script>
26
27 <script type="text/javascript" src="../search.js"></script>
28 <!--script type="text/javascript" src="/new/javascripts/app/examples.js"></script-->
29 <script type="text/javascript" src="../class_tree.js"></script>
30 <script type="text/javascript" src="../class_doc.js"></script>
31 <script type="text/javascript">
32     req.source = 'ComboBox.html#Ext-form.field.ComboBox';
33     clsInfo = {"methods":["ComboBox","addClass","addCls","addClsWithUI","addEvents","addListener","addManagedListener","addStateEvents","afterComponentLayout","alignTo","animate","applyState","autoSize","batchChanges","beforeComponentLayout","bubble","capture","center","checkChange","checkDirty","clearInvalid","clearListeners","clearManagedListeners","clearValue","cloneConfig","collapse","destroy","disable","doAutoRender","doComponentLayout","doConstrain","doQuery","enable","enableBubble","expand","extractFileInput","findLayoutController","findParentBy","findParentByType","fireEvent","focus","getActiveAnimation","getActiveError","getActiveErrors","getBox","getBubbleTarget","getEl","getErrors","getFieldLabel","getHeight","getId","getInputId","getInsertPosition","getLoader","getModelData","getName","getPicker","getPlugin","getPosition","getRawValue","getSize","getState","getStateId","getSubmitData","getSubmitValue","getTriggerWidth","getValue","getWidth","getXType","getXTypes","hasActiveError","hasListener","hasUICls","hide","initField","initLabelable","is","isDescendantOf","isDirty","isDisabled","isDraggable","isDroppable","isEqual","isFileUpload","isFloating","isHidden","isValid","isVisible","isXType","markInvalid","nextNode","nextSibling","observe","on","onTriggerClick","previousNode","previousSibling","processRawValue","rawToValue","relayEvents","releaseCapture","removeCls","removeClsWithUI","removeListener","removeManagedListener","reset","resetOriginalValue","resumeEvents","select","selectText","sequenceFx","setActive","setActiveError","setActiveErrors","setAutoScroll","setDisabled","setDocked","setEditable","setFieldDefaults","setFieldStyle","setHeight","setLoading","setPagePosition","setPosition","setRawValue","setReadOnly","setSize","setUI","setValue","setVisible","setWidth","show","stopAnimation","suspendEvents","syncFx","toBack","toFront","un","unsetActiveError","up","update","updateBox","validate","validateValue","valueToRaw"],"cfgs":["activeError","activeErrorsTpl","allQuery","allowBlank","autoEl","autoFitErrors","autoRender","autoScroll","autoSelect","autoShow","baseBodyCls","baseCls","blankText","border","checkChangeBuffer","checkChangeEvents","clearCls","cls","componentCls","componentLayout","contentEl","data","defaultListConfig","delimiter","dirtyCls","disableKeyFilter","disabled","disabledCls","displayField","draggable","editable","emptyCls","emptyText","enableKeyEvents","enforceMaxLength","errorMsgCls","fieldBodyCls","fieldCls","fieldLabel","fieldStyle","floating","focusCls","focusOnToFront","forceSelection","formItemCls","frame","grow","growAppend","growMax","growMin","height","hidden","hideEmptyLabel","hideLabel","hideMode","hideTrigger","html","id","inputId","inputType","invalidCls","invalidText","itemId","labelAlign","labelCls","labelPad","labelSeparator","labelStyle","labelWidth","labelableRenderTpl","listConfig","listeners","loader","maintainFlex","margin","maskRe","matchFieldWidth","maxHeight","maxLength","maxLengthText","maxWidth","minChars","minHeight","minLength","minLengthText","minWidth","msgTarget","multiSelect","name","openCls","overCls","padding","pageSize","pickerAlign","pickerOffset","plugins","preventMark","queryDelay","queryMode","queryParam","readOnly","readOnlyCls","regex","regexText","renderSelectors","renderTo","renderTpl","repeatTriggerClick","resizable","resizeHandles","saveBuffer","selectOnFocus","selectOnTab","shadow","size","stateEvents","stateId","stateful","store","stripCharsRe","style","styleHtmlCls","styleHtmlContent","submitValue","tabIndex","toFrontOnShow","tpl","tplWriteMode","transform","triggerAction","triggerBaseCls","triggerCls","triggerWrapCls","typeAhead","typeAheadDelay","ui","validateOnBlur","validateOnChange","validator","value","valueField","valueNotFoundText","vtype","vtypeText","width"],"properties":["bodyEl","clearInvalid","createPicker","draggable","errorEl","floatParent","frameSize","hasActiveFx","inputEl","isExpanded","isFieldLabelable","isFormField","labelEl","lastQuery","markInvalid","maskOnDisable","originalValue","ownerCt","rendered","stopFx","triggerEl","triggerWrap","zIndexManager"],"events":["activate","added","afterrender","autosize","beforeactivate","beforedeactivate","beforedestroy","beforehide","beforequery","beforerender","beforeshow","beforestaterestore","beforestatesave","blur","change","collapse","deactivate","destroy","dirtychange","disable","enable","errorchange","expand","focus","hide","keydown","keypress","keyup","move","removed","render","resize","select","show","specialkey","staterestore","statesave","validitychange"],"subclasses":[]};
34     Ext.onReady(function() {
35         Ext.create('Docs.classPanel');
36     });
37 </script><div id="top-block" class="top-block"><h1 id="clsTitle" class="comp"><a href="../source/ComboBox.html#Ext-form.field.ComboBox" target="_blank">Ext.form.field.ComboBox</a><span>xtype: combo</span></h1></div><div id="docContent"><div id="doc-overview-content"><div class="lft"><pre class="subclasses"><h4>Hierarchy</h4><div class="subclass f"><a href="Ext.AbstractComponent.html" rel="Ext.AbstractComponent" class="cls docClass">Ext.AbstractComponent</a><div class="subclass"><a href="Ext.Component.html" rel="Ext.Component" class="cls docClass">Ext.Component</a><div class="subclass"><a href="Ext.form.field.Base.html" rel="Ext.form.field.Base" class="cls docClass">Ext.form.field.Base</a><div class="subclass"><a href="Ext.form.field.Text.html" rel="Ext.form.field.Text" class="cls docClass">Ext.form.field.Text</a><div class="subclass"><a href="Ext.form.field.Trigger.html" rel="Ext.form.field.Trigger" class="cls docClass">Ext.form.field.Trigger</a><div class="subclass"><a href="Ext.form.field.Picker.html" rel="Ext.form.field.Picker" class="cls docClass">Ext.form.field.Picker</a><div class="subclass"><strong>Ext.form.field.ComboBox</strong></div></div></div></div></div></div></div><h4>Mixins</h4><div class="mixin"><a href="Ext.util.Observable.html" rel="Ext.util.Observable" class="cls docClass">Ext.util.Observable</a></div><div class="mixin"><a href="Ext.util.Animate.html" rel="Ext.util.Animate" class="cls docClass">Ext.util.Animate</a></div><div class="mixin"><a href="Ext.state.Stateful.html" rel="Ext.state.Stateful" class="cls docClass">Ext.state.Stateful</a></div><div class="mixin"><a href="Ext.util.Floating.html" rel="Ext.util.Floating" class="cls docClass">Ext.util.Floating</a></div><div class="mixin"><a href="Ext.form.Labelable.html" rel="Ext.form.Labelable" class="cls docClass">Ext.form.Labelable</a></div><div class="mixin"><a href="Ext.form.field.Field.html" rel="Ext.form.field.Field" class="cls docClass">Ext.form.field.Field</a></div></pre><p>A combobox control with support for autocomplete, remote loading, and many other features.</p>
38
39 <p>A ComboBox is like a combination of a traditional HTML text <code>&amp;lt;input&amp;gt;</code> field and a <code>&amp;lt;select&amp;gt;</code>
40 field; the user is able to type freely into the field, and/or pick values from a dropdown selection
41 list. The user can input any value by default, even if it does not appear in the selection list;
42 to prevent free-form values and restrict them to items in the list, set <a href="Ext.form.field.ComboBox.html#forceSelection" rel="Ext.form.field.ComboBox#forceSelection" class="docClass">forceSelection</a> to <code>true</code>.</p>
43
44 <p>The selection list's options are populated from any <a href="Ext.data.Store.html" rel="Ext.data.Store" class="docClass">Ext.data.Store</a>, including remote
45 stores. The data items in the store are mapped to each option's displayed text and backing value via
46 the <a href="Ext.form.field.ComboBox.html#valueField" rel="Ext.form.field.ComboBox#valueField" class="docClass">valueField</a> and <a href="Ext.form.field.ComboBox.html#displayField" rel="Ext.form.field.ComboBox#displayField" class="docClass">displayField</a> configurations, respectively.</p>
47
48 <p>If your store is not remote, i.e. it depends only on local data and is loaded up front, you should be
49 sure to set the <a href="Ext.form.field.ComboBox.html#queryMode" rel="Ext.form.field.ComboBox#queryMode" class="docClass">queryMode</a> to <code>'local'</code>, as this will improve responsiveness for the user.</p>
50
51 <p><img class="screenshot" src="../Ext.form.ComboBox.png" alt="Ext.form.ComboBox component" /></p>
52
53 <h2>Example usage:</h2>
54
55 <pre class="prettyprint"><code>// The data store containing the list of states
56 var states = Ext.create('Ext.data.Store', {
57     fields: ['abbr', 'name'],
58     data : [
59         {"abbr":"AL", "name":"Alabama"},
60         {"abbr":"AK", "name":"Alaska"},
61         {"abbr":"AZ", "name":"Arizona"}
62         //...
63     ]
64 });
65
66 // Create the combo box, attached to the states data store
67 Ext.create('Ext.form.ComboBox', {
68     fieldLabel: 'Choose State',
69     store: states,
70     queryMode: 'local',
71     displayField: 'name',
72     valueField: 'abbr',
73     renderTo: Ext.getBody()
74 });
75 </code></pre>
76
77 <h2>Events</h2>
78
79 <p>To do something when something in ComboBox is selected, configure the select event:</p>
80
81 <pre class="prettyprint"><code>var cb = Ext.create('Ext.form.ComboBox', {
82     // all of your config options
83     listeners:{
84          scope: yourScope,
85          'select': yourFunction
86     }
87 });
88
89 // Alternatively, you can assign events after the object is created:
90 var cb = new Ext.form.field.ComboBox(yourOptions);
91 cb.on('select', yourFunction, yourScope);
92 </code></pre>
93
94 <h2>Multiple Selection</h2>
95
96 <p>ComboBox also allows selection of multiple items from the list; to enable multi-selection set the
97 <a href="Ext.form.field.ComboBox.html#multiSelect" rel="Ext.form.field.ComboBox#multiSelect" class="docClass">multiSelect</a> config to <code>true</code>.</p>
98 <div class="members"><div class="m-cfgs"><div class="definedBy">Defined By</div><a name="configs"></a><h3 class="cfg p">Config Options</h3><h4 class="cfgGroup">CSS Class configs</h4><div id="config-baseBodyCls" class="member f inherited"><a href="Ext.form.field.ComboBox.html#config-baseBodyCls" rel="config-baseBodyCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-baseBodyCls" class="viewSource">view source</a></div><a name="baseBodyCls"></a><a name="config-baseBodyCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-baseBodyCls" class="cls expand">baseBodyCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to be applied to the body content element. Defaults to 'x-form-item-body'.</p>
99 </div><div class="long"><p>The CSS class to be applied to the body content element. Defaults to 'x-form-item-body'.</p>
100 </div></div></div><div id="config-baseCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-baseCls" rel="config-baseCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-baseCls" class="viewSource">view source</a></div><a name="baseCls"></a><a name="config-baseCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-baseCls" class="cls expand">baseCls</a><span> : String</span></div><div class="description"><div class="short">The base CSS class to apply to this components's element. This will also be prepended to
101 elements within this compone...</div><div class="long"><p>The base CSS class to apply to this components's element. This will also be prepended to
102 elements within this component like Panel's body will get a class x-panel-body. This means
103 that if you create a subclass of Panel, and you want it to get all the Panels styling for the
104 element and the body, you leave the baseCls x-panel and use componentCls to add specific styling for this
105 component.</p>
106 </div></div></div><div id="config-clearCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-clearCls" rel="config-clearCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-clearCls" class="viewSource">view source</a></div><a name="clearCls"></a><a name="config-clearCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-clearCls" class="cls expand">clearCls</a><span> : String</span></div><div class="description"><div class="short">The CSS class to be applied to the special clearing div rendered directly after the field
107 contents wrapper to provide...</div><div class="long"><p>The CSS class to be applied to the special clearing div rendered directly after the field
108 contents wrapper to provide field clearing (defaults to <tt>'x-clear'</tt>).</p>
109 </div></div></div><div id="config-cls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-cls" rel="config-cls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-cls" class="viewSource">view source</a></div><a name="cls"></a><a name="config-cls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-cls" class="cls expand">cls</a><span> : String</span></div><div class="description"><div class="short">An optional extra CSS class that will be added to this component's Element (defaults to '').  This can be
110 useful for ...</div><div class="long"><p>An optional extra CSS class that will be added to this component's Element (defaults to '').  This can be
111 useful for adding customized styles to the component or any of its children using standard CSS rules.</p>
112 </div></div></div><div id="config-componentCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-componentCls" rel="config-componentCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-componentCls" class="viewSource">view source</a></div><a name="componentCls"></a><a name="config-componentCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-componentCls" class="cls expand">componentCls</a><span> : String</span></div><div class="description"><div class="short"><p>CSS Class to be added to a components root level element to give distinction to it
113 via styling.</p>
114 </div><div class="long"><p>CSS Class to be added to a components root level element to give distinction to it
115 via styling.</p>
116 </div></div></div><div id="config-dirtyCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-dirtyCls" rel="config-dirtyCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-dirtyCls" class="viewSource">view source</a></div><a name="dirtyCls"></a><a name="config-dirtyCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-dirtyCls" class="cls expand">dirtyCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to use when the field value <a href="Ext.form.field.ComboBox.html#isDirty" rel="Ext.form.field.ComboBox#isDirty" class="docClass">is dirty</a>.</p>
117 </div><div class="long"><p>The CSS class to use when the field value <a href="Ext.form.field.ComboBox.html#isDirty" rel="Ext.form.field.ComboBox#isDirty" class="docClass">is dirty</a>.</p>
118 </div></div></div><div id="config-disabledCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-disabledCls" rel="config-disabledCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-disabledCls" class="viewSource">view source</a></div><a name="disabledCls"></a><a name="config-disabledCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-disabledCls" class="cls expand">disabledCls</a><span> : String</span></div><div class="description"><div class="short"><p>CSS class to add when the Component is disabled. Defaults to 'x-item-disabled'.</p>
119 </div><div class="long"><p>CSS class to add when the Component is disabled. Defaults to 'x-item-disabled'.</p>
120 </div></div></div><div id="config-emptyCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-emptyCls" rel="config-emptyCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-emptyCls" class="viewSource">view source</a></div><a name="emptyCls"></a><a name="config-emptyCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-emptyCls" class="cls expand">emptyCls</a><span> : String</span></div><div class="description"><div class="short">The CSS class to apply to an empty field to style the emptyText
121 (defaults to 'x-form-empty-field').  This class is au...</div><div class="long"><p>The CSS class to apply to an empty field to style the <b><tt><a href="Ext.form.field.ComboBox.html#emptyText" rel="Ext.form.field.ComboBox#emptyText" class="docClass">emptyText</a></tt></b>
122 (defaults to <tt>'x-form-empty-field'</tt>).  This class is automatically added and removed as needed
123 depending on the current field value.</p>
124 </div></div></div><div id="config-errorMsgCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-errorMsgCls" rel="config-errorMsgCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-errorMsgCls" class="viewSource">view source</a></div><a name="errorMsgCls"></a><a name="config-errorMsgCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-errorMsgCls" class="cls expand">errorMsgCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to be applied to the error message element. Defaults to 'x-form-error-msg'.</p>
125 </div><div class="long"><p>The CSS class to be applied to the error message element. Defaults to 'x-form-error-msg'.</p>
126 </div></div></div><div id="config-fieldBodyCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-fieldBodyCls" rel="config-fieldBodyCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-fieldBodyCls" class="viewSource">view source</a></div><a name="fieldBodyCls"></a><a name="config-fieldBodyCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-fieldBodyCls" class="cls expand">fieldBodyCls</a><span> : String</span></div><div class="description"><div class="short"><p>An extra CSS class to be applied to the body content element in addition to <a href="Ext.form.field.ComboBox.html#fieldBodyCls" rel="Ext.form.field.ComboBox#fieldBodyCls" class="docClass">fieldBodyCls</a>.
127 Defaults to empty.</p>
128 </div><div class="long"><p>An extra CSS class to be applied to the body content element in addition to <a href="Ext.form.field.ComboBox.html#fieldBodyCls" rel="Ext.form.field.ComboBox#fieldBodyCls" class="docClass">fieldBodyCls</a>.
129 Defaults to empty.</p>
130 </div></div></div><div id="config-fieldCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-fieldCls" rel="config-fieldCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-fieldCls" class="viewSource">view source</a></div><a name="fieldCls"></a><a name="config-fieldCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-fieldCls" class="cls expand">fieldCls</a><span> : String</span></div><div class="description"><div class="short"><p>The default CSS class for the field input (defaults to 'x-form-field')</p>
131 </div><div class="long"><p>The default CSS class for the field input (defaults to 'x-form-field')</p>
132 </div></div></div><div id="config-focusCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-focusCls" rel="config-focusCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-focusCls" class="viewSource">view source</a></div><a name="focusCls"></a><a name="config-focusCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-focusCls" class="cls expand">focusCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to use when the field receives focus (defaults to 'x-form-focus')</p>
133 </div><div class="long"><p>The CSS class to use when the field receives focus (defaults to 'x-form-focus')</p>
134 </div></div></div><div id="config-formItemCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-formItemCls" rel="config-formItemCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-formItemCls" class="viewSource">view source</a></div><a name="formItemCls"></a><a name="config-formItemCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-formItemCls" class="cls expand">formItemCls</a><span> : String</span></div><div class="description"><div class="short">A CSS class to be applied to the outermost element to denote that it is participating in the form
135 field layout. Defau...</div><div class="long"><p>A CSS class to be applied to the outermost element to denote that it is participating in the form
136 field layout. Defaults to 'x-form-item'.</p>
137 </div></div></div><div id="config-invalidCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-invalidCls" rel="config-invalidCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-invalidCls" class="viewSource">view source</a></div><a name="invalidCls"></a><a name="config-invalidCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-invalidCls" class="cls expand">invalidCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to use when marking the component invalid (defaults to 'x-form-invalid')</p>
138 </div><div class="long"><p>The CSS class to use when marking the component invalid (defaults to 'x-form-invalid')</p>
139 </div></div></div><div id="config-labelCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-labelCls" rel="config-labelCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-labelCls" class="viewSource">view source</a></div><a name="labelCls"></a><a name="config-labelCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-labelCls" class="cls expand">labelCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to be applied to the label element. Defaults to 'x-form-item-label'.</p>
140 </div><div class="long"><p>The CSS class to be applied to the label element. Defaults to 'x-form-item-label'.</p>
141 </div></div></div><div id="config-openCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-openCls" rel="config-openCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Picker.html" class="definedIn docClass">Ext.form.field.Picker</a><br/><a href="../source/Picker.html#Ext-form.field.Picker-cfg-openCls" class="viewSource">view source</a></div><a name="openCls"></a><a name="config-openCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-openCls" class="cls expand">openCls</a><span> : String</span></div><div class="description"><div class="short"><p>A class to be added to the field's <a href="Ext.form.field.ComboBox.html#bodyEl" rel="Ext.form.field.ComboBox#bodyEl" class="docClass">bodyEl</a> element when the picker is opened. Defaults
142 to 'x-pickerfield-open'.</p>
143 </div><div class="long"><p>A class to be added to the field's <a href="Ext.form.field.ComboBox.html#bodyEl" rel="Ext.form.field.ComboBox#bodyEl" class="docClass">bodyEl</a> element when the picker is opened. Defaults
144 to 'x-pickerfield-open'.</p>
145 </div></div></div><div id="config-overCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-overCls" rel="config-overCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-overCls" class="viewSource">view source</a></div><a name="overCls"></a><a name="config-overCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-overCls" class="cls expand">overCls</a><span> : String</span></div><div class="description"><div class="short">An optional extra CSS class that will be added to this component's Element when the mouse moves
146 over the Element, and...</div><div class="long"><p>An optional extra CSS class that will be added to this component's Element when the mouse moves
147 over the Element, and removed when the mouse moves out. (defaults to '').  This can be
148 useful for adding customized 'active' or 'hover' styles to the component or any of its children using standard CSS rules.</p>
149 </div></div></div><div id="config-readOnlyCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-readOnlyCls" rel="config-readOnlyCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-readOnlyCls" class="viewSource">view source</a></div><a name="readOnlyCls"></a><a name="config-readOnlyCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-readOnlyCls" class="cls expand">readOnlyCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class applied to the component's main element when it is <a href="Ext.form.field.ComboBox.html#readOnly" rel="Ext.form.field.ComboBox#readOnly" class="docClass">readOnly</a>.</p>
150 </div><div class="long"><p>The CSS class applied to the component's main element when it is <a href="Ext.form.field.ComboBox.html#readOnly" rel="Ext.form.field.ComboBox#readOnly" class="docClass">readOnly</a>.</p>
151 </div></div></div><div id="config-styleHtmlCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-styleHtmlCls" rel="config-styleHtmlCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-styleHtmlCls" class="viewSource">view source</a></div><a name="styleHtmlCls"></a><a name="config-styleHtmlCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-styleHtmlCls" class="cls expand">styleHtmlCls</a><span> : String</span></div><div class="description"><div class="short"><p>The class that is added to the content target when you set styleHtmlContent to true.
152 Defaults to 'x-html'</p>
153 </div><div class="long"><p>The class that is added to the content target when you set styleHtmlContent to true.
154 Defaults to 'x-html'</p>
155 </div></div></div><div id="config-triggerBaseCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-triggerBaseCls" rel="config-triggerBaseCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Trigger.html" class="definedIn docClass">Ext.form.field.Trigger</a><br/><a href="../source/Trigger.html#Ext-form.field.Trigger-cfg-triggerBaseCls" class="viewSource">view source</a></div><a name="triggerBaseCls"></a><a name="config-triggerBaseCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-triggerBaseCls" class="cls expand">triggerBaseCls</a><span> : String</span></div><div class="description"><div class="short">The base CSS class that is always added to the trigger button. The triggerCls will be
156 appended in addition to this cl...</div><div class="long"><p>The base CSS class that is always added to the trigger button. The <a href="Ext.form.field.ComboBox.html#triggerCls" rel="Ext.form.field.ComboBox#triggerCls" class="docClass">triggerCls</a> will be
157 appended in addition to this class.</p>
158 </div></div></div><div id="config-triggerCls" class="member ni"><a href="Ext.form.field.ComboBox.html#config-triggerCls" rel="config-triggerCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-triggerCls" class="viewSource">view source</a></div><a name="triggerCls"></a><a name="config-triggerCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-triggerCls" class="cls expand">triggerCls</a><span> : String</span></div><div class="description"><div class="short">An additional CSS class used to style the trigger button. The trigger will always get the
159 triggerBaseCls by default a...</div><div class="long"><p>An additional CSS class used to style the trigger button. The trigger will always get the
160 <a href="Ext.form.field.ComboBox.html#triggerBaseCls" rel="Ext.form.field.ComboBox#triggerBaseCls" class="docClass">triggerBaseCls</a> by default and <tt>triggerCls</tt> will be <b>appended</b> if specified.
161 Defaults to 'x-form-arrow-trigger' for ComboBox.</p>
162 </div></div></div><div id="config-triggerWrapCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-triggerWrapCls" rel="config-triggerWrapCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Trigger.html" class="definedIn docClass">Ext.form.field.Trigger</a><br/><a href="../source/Trigger.html#Ext-form.field.Trigger-cfg-triggerWrapCls" class="viewSource">view source</a></div><a name="triggerWrapCls"></a><a name="config-triggerWrapCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-triggerWrapCls" class="cls expand">triggerWrapCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class that is added to the div wrapping the trigger button(s).</p>
163 </div><div class="long"><p>The CSS class that is added to the div wrapping the trigger button(s).</p>
164 </div></div></div><h4 class="cfgGroup">Other Configs</h4><div id="config-activeError" class="member f inherited"><a href="Ext.form.field.ComboBox.html#config-activeError" rel="config-activeError" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-activeError" class="viewSource">view source</a></div><a name="activeError"></a><a name="config-activeError"></a><a href="Ext.form.field.ComboBox.html#" rel="config-activeError" class="cls expand">activeError</a><span> : String</span></div><div class="description"><div class="short">If specified, then the component will be displayed with this value as its active error when
165 first rendered. Defaults ...</div><div class="long"><p>If specified, then the component will be displayed with this value as its active error when
166 first rendered. Defaults to undefined. Use <a href="Ext.form.field.ComboBox.html#setActiveError" rel="Ext.form.field.ComboBox#setActiveError" class="docClass">setActiveError</a> or <a href="Ext.form.field.ComboBox.html#unsetActiveError" rel="Ext.form.field.ComboBox#unsetActiveError" class="docClass">unsetActiveError</a> to
167 change it after component creation.</p>
168 </div></div></div><div id="config-activeErrorsTpl" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-activeErrorsTpl" rel="config-activeErrorsTpl" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-activeErrorsTpl" class="viewSource">view source</a></div><a name="activeErrorsTpl"></a><a name="config-activeErrorsTpl"></a><a href="Ext.form.field.ComboBox.html#" rel="config-activeErrorsTpl" class="cls expand">activeErrorsTpl</a><span> : Ext.XTemplate</span></div><div class="description"><div class="short">The template used to format the Array of error messages passed to setActiveErrors
169 into a single HTML string. By defau...</div><div class="long"><p>The template used to format the Array of error messages passed to <a href="Ext.form.field.ComboBox.html#setActiveErrors" rel="Ext.form.field.ComboBox#setActiveErrors" class="docClass">setActiveErrors</a>
170 into a single HTML string. By default this renders each message as an item in an unordered list.</p>
171 </div></div></div><div id="config-allQuery" class="member ni"><a href="Ext.form.field.ComboBox.html#config-allQuery" rel="config-allQuery" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-allQuery" class="viewSource">view source</a></div><a name="allQuery"></a><a name="config-allQuery"></a><a href="Ext.form.field.ComboBox.html#" rel="config-allQuery" class="cls expand">allQuery</a><span> : String</span></div><div class="description"><div class="short"><p>The text query to send to the server to return all records for the list
172 with no filtering (defaults to '')</p>
173 </div><div class="long"><p>The text query to send to the server to return all records for the list
174 with no filtering (defaults to '')</p>
175 </div></div></div><div id="config-allowBlank" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-allowBlank" rel="config-allowBlank" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-allowBlank" class="viewSource">view source</a></div><a name="allowBlank"></a><a name="config-allowBlank"></a><a href="Ext.form.field.ComboBox.html#" rel="config-allowBlank" class="cls expand">allowBlank</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Specify <tt>false</tt> to validate that the value's length is > 0 (defaults to
176 <tt>true</tt>)</p>
177 </div><div class="long"><p>Specify <tt>false</tt> to validate that the value's length is > 0 (defaults to
178 <tt>true</tt>)</p>
179 </div></div></div><div id="config-autoEl" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-autoEl" rel="config-autoEl" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-autoEl" class="viewSource">view source</a></div><a name="autoEl"></a><a name="config-autoEl"></a><a href="Ext.form.field.ComboBox.html#" rel="config-autoEl" class="cls expand">autoEl</a><span> : Mixed</span></div><div class="description"><div class="short">A tag name or DomHelper spec used to create the Element which will
180 encapsulate this Component.
181
182
183 You do not normally ...</div><div class="long"><p>A tag name or <a href="Ext.core.DomHelper.html" rel="Ext.core.DomHelper" class="docClass">DomHelper</a> spec used to create the <a href="Ext.form.field.ComboBox.html#getEl" rel="Ext.form.field.ComboBox#getEl" class="docClass">Element</a> which will
184 encapsulate this Component.</p>
185
186
187 <p>You do not normally need to specify this. For the base classes <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a> and <a href="Ext.container.Container.html" rel="Ext.container.Container" class="docClass">Ext.container.Container</a>,
188 this defaults to <b><tt>'div'</tt></b>. The more complex Sencha classes use a more complex
189 DOM structure specified by their own <a href="Ext.form.field.ComboBox.html#renderTpl" rel="Ext.form.field.ComboBox#renderTpl" class="docClass">renderTpl</a>s.</p>
190
191
192 <p>This is intended to allow the developer to create application-specific utility Components encapsulated by
193 different DOM elements. Example usage:</p>
194
195
196 <pre><code>{
197     xtype: 'component',
198     autoEl: {
199         tag: 'img',
200         src: 'http://www.example.com/example.jpg'
201     }
202 }, {
203     xtype: 'component',
204     autoEl: {
205         tag: 'blockquote',
206         html: 'autoEl is cool!'
207     }
208 }, {
209     xtype: 'container',
210     autoEl: 'ul',
211     cls: 'ux-unordered-list',
212     items: {
213         xtype: 'component',
214         autoEl: 'li',
215         html: 'First list item'
216     }
217 }
218 </code></pre>
219
220 </div></div></div><div id="config-autoFitErrors" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-autoFitErrors" rel="config-autoFitErrors" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-autoFitErrors" class="viewSource">view source</a></div><a name="autoFitErrors"></a><a name="config-autoFitErrors"></a><a href="Ext.form.field.ComboBox.html#" rel="config-autoFitErrors" class="cls expand">autoFitErrors</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Whether to adjust the component's body area to make room for 'side' or 'under'
221 <a href="Ext.form.field.ComboBox.html#msgTarget" rel="Ext.form.field.ComboBox#msgTarget" class="docClass">error messages</a>. Defaults to <tt>true</tt>.</p>
222 </div><div class="long"><p>Whether to adjust the component's body area to make room for 'side' or 'under'
223 <a href="Ext.form.field.ComboBox.html#msgTarget" rel="Ext.form.field.ComboBox#msgTarget" class="docClass">error messages</a>. Defaults to <tt>true</tt>.</p>
224 </div></div></div><div id="config-autoRender" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-autoRender" rel="config-autoRender" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-autoRender" class="viewSource">view source</a></div><a name="autoRender"></a><a name="config-autoRender"></a><a href="Ext.form.field.ComboBox.html#" rel="config-autoRender" class="cls expand">autoRender</a><span> : Mixed</span></div><div class="description"><div class="short">This config is intended mainly for floating Components which may or may not be shown. Instead
225 of using renderTo in th...</div><div class="long"><p>This config is intended mainly for <a href="Ext.form.field.ComboBox.html#floating" rel="Ext.form.field.ComboBox#floating" class="docClass">floating</a> Components which may or may not be shown. Instead
226 of using <a href="Ext.form.field.ComboBox.html#renderTo" rel="Ext.form.field.ComboBox#renderTo" class="docClass">renderTo</a> in the configuration, and rendering upon construction, this allows a Component
227 to render itself upon first <i><a href="Ext.form.field.ComboBox.html#show" rel="Ext.form.field.ComboBox#show" class="docClass">show</a></i>.</p>
228
229
230 <p>Specify as <code>true</code> to have this Component render to the document body upon first show.</p>
231
232
233 <p>Specify as an element, or the ID of an element to have this Component render to a specific element upon first show.</p>
234
235
236 <p><b>This defaults to <code>true</code> for the <a href="Ext.window.Window.html" rel="Ext.window.Window" class="docClass">Window</a> class.</b></p>
237
238 </div></div></div><div id="config-autoScroll" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-autoScroll" rel="config-autoScroll" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-cfg-autoScroll" class="viewSource">view source</a></div><a name="autoScroll"></a><a name="config-autoScroll"></a><a href="Ext.form.field.ComboBox.html#" rel="config-autoScroll" class="cls expand">autoScroll</a><span> : Boolean</span></div><div class="description"><div class="short">true to use overflow:'auto' on the components layout element and show scroll bars automatically when
239 necessary, false...</div><div class="long"><p><code>true</code> to use overflow:'auto' on the components layout element and show scroll bars automatically when
240 necessary, <code>false</code> to clip any overflowing content (defaults to <code>false</code>).</p>
241 </div></div></div><div id="config-autoSelect" class="member ni"><a href="Ext.form.field.ComboBox.html#config-autoSelect" rel="config-autoSelect" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-autoSelect" class="viewSource">view source</a></div><a name="autoSelect"></a><a name="config-autoSelect"></a><a href="Ext.form.field.ComboBox.html#" rel="config-autoSelect" class="cls expand">autoSelect</a><span> : Boolean</span></div><div class="description"><div class="short">true to select the first result gathered by the data store (defaults
242 to true).  A false value would require a manual ...</div><div class="long"><p><tt>true</tt> to select the first result gathered by the data store (defaults
243 to <tt>true</tt>).  A false value would require a manual selection from the dropdown list to set the components value
244 unless the value of (<a href="Ext.form.field.ComboBox.html#typeAhead" rel="Ext.form.field.ComboBox#typeAhead" class="docClass">typeAhead</a>) were true.</p>
245 </div></div></div><div id="config-autoShow" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-autoShow" rel="config-autoShow" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-autoShow" class="viewSource">view source</a></div><a name="autoShow"></a><a name="config-autoShow"></a><a href="Ext.form.field.ComboBox.html#" rel="config-autoShow" class="cls expand">autoShow</a><span> : Boolean</span></div><div class="description"><div class="short">True to automatically show the component upon creation.
246 This config option may only be used for floating components o...</div><div class="long"><p>True to automatically show the component upon creation.
247 This config option may only be used for <a href="Ext.form.field.ComboBox.html#floating" rel="Ext.form.field.ComboBox#floating" class="docClass">floating</a> components or components
248 that use <a href="Ext.form.field.ComboBox.html#autoRender" rel="Ext.form.field.ComboBox#autoRender" class="docClass">autoRender</a>. Defaults to <tt>false</tt>.</p>
249 </div></div></div><div id="config-baseBodyCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-baseBodyCls" rel="config-baseBodyCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-baseBodyCls" class="viewSource">view source</a></div><a name="baseBodyCls"></a><a name="config-baseBodyCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-baseBodyCls" class="cls expand">baseBodyCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to be applied to the body content element. Defaults to 'x-form-item-body'.</p>
250 </div><div class="long"><p>The CSS class to be applied to the body content element. Defaults to 'x-form-item-body'.</p>
251 </div></div></div><div id="config-baseCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-baseCls" rel="config-baseCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-baseCls" class="viewSource">view source</a></div><a name="baseCls"></a><a name="config-baseCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-baseCls" class="cls expand">baseCls</a><span> : String</span></div><div class="description"><div class="short">The base CSS class to apply to this components's element. This will also be prepended to
252 elements within this compone...</div><div class="long"><p>The base CSS class to apply to this components's element. This will also be prepended to
253 elements within this component like Panel's body will get a class x-panel-body. This means
254 that if you create a subclass of Panel, and you want it to get all the Panels styling for the
255 element and the body, you leave the baseCls x-panel and use componentCls to add specific styling for this
256 component.</p>
257 </div></div></div><div id="config-blankText" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-blankText" rel="config-blankText" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-blankText" class="viewSource">view source</a></div><a name="blankText"></a><a name="config-blankText"></a><a href="Ext.form.field.ComboBox.html#" rel="config-blankText" class="cls expand">blankText</a><span> : String</span></div><div class="description"><div class="short"><p>The error text to display if the <b><tt><a href="Ext.form.field.ComboBox.html#allowBlank" rel="Ext.form.field.ComboBox#allowBlank" class="docClass">allowBlank</a></tt></b> validation
258 fails (defaults to <tt>'This field is required'</tt>)</p>
259 </div><div class="long"><p>The error text to display if the <b><tt><a href="Ext.form.field.ComboBox.html#allowBlank" rel="Ext.form.field.ComboBox#allowBlank" class="docClass">allowBlank</a></tt></b> validation
260 fails (defaults to <tt>'This field is required'</tt>)</p>
261 </div></div></div><div id="config-border" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-border" rel="config-border" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-border" class="viewSource">view source</a></div><a name="border"></a><a name="config-border"></a><a href="Ext.form.field.ComboBox.html#" rel="config-border" class="cls expand">border</a><span> : Number/String</span></div><div class="description"><div class="short">Specifies the border for this component. The border can be a single numeric value to apply to all sides or
262 it can be ...</div><div class="long"><p>Specifies the border for this component. The border can be a single numeric value to apply to all sides or
263 it can be a CSS style specification for each style, for example: '10 5 3 10'.</p>
264 </div></div></div><div id="config-checkChangeBuffer" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-checkChangeBuffer" rel="config-checkChangeBuffer" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-checkChangeBuffer" class="viewSource">view source</a></div><a name="checkChangeBuffer"></a><a name="config-checkChangeBuffer"></a><a href="Ext.form.field.ComboBox.html#" rel="config-checkChangeBuffer" class="cls expand">checkChangeBuffer</a><span> : Number</span></div><div class="description"><div class="short">Defines a timeout in milliseconds for buffering checkChangeEvents that fire in rapid succession.
265 Defaults to 50 milli...</div><div class="long"><p>Defines a timeout in milliseconds for buffering <a href="Ext.form.field.ComboBox.html#checkChangeEvents" rel="Ext.form.field.ComboBox#checkChangeEvents" class="docClass">checkChangeEvents</a> that fire in rapid succession.
266 Defaults to 50 milliseconds.</p>
267 </div></div></div><div id="config-checkChangeEvents" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-checkChangeEvents" rel="config-checkChangeEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-checkChangeEvents" class="viewSource">view source</a></div><a name="checkChangeEvents"></a><a name="config-checkChangeEvents"></a><a href="Ext.form.field.ComboBox.html#" rel="config-checkChangeEvents" class="cls expand">checkChangeEvents</a><span> : Array</span></div><div class="description"><div class="short">A list of event names that will be listened for on the field's input element, which
268 will cause the field's value to b...</div><div class="long"><p>A list of event names that will be listened for on the field's <a href="Ext.form.field.ComboBox.html#inputEl" rel="Ext.form.field.ComboBox#inputEl" class="docClass">input element</a>, which
269 will cause the field's value to be checked for changes. If a change is detected, the
270 <a href="Ext.form.field.ComboBox.html#change" rel="Ext.form.field.ComboBox#change" class="docClass">change event</a> will be fired, followed by validation if the <a href="Ext.form.field.ComboBox.html#validateOnChange" rel="Ext.form.field.ComboBox#validateOnChange" class="docClass">validateOnChange</a>
271 option is enabled.</p>
272
273
274 <p>Defaults to <tt>['change', 'propertychange']</tt> in Internet Explorer, and <tt>['change', 'input',
275 'textInput', 'keyup', 'dragdrop']</tt> in other browsers. This catches all the ways that field values
276 can be changed in most supported browsers; the only known exceptions at the time of writing are:</p>
277
278
279 <ul>
280 <li>Safari 3.2 and older: cut/paste in textareas via the context menu, and dragging text into textareas</li>
281 <li>Opera 10 and 11: dragging text into text fields and textareas, and cut via the context menu in text
282 fields and textareas</li>
283 <li>Opera 9: Same as Opera 10 and 11, plus paste from context menu in text fields and textareas</li>
284 </ul>
285
286
287 <p>If you need to guarantee on-the-fly change notifications including these edge cases, you can call the
288 <a href="Ext.form.field.ComboBox.html#checkChange" rel="Ext.form.field.ComboBox#checkChange" class="docClass">checkChange</a> method on a repeating interval, e.g. using <a href="Ext.TaskManager.html" rel="Ext.TaskManager" class="docClass">Ext.TaskManager</a>, or if the field is
289 within a <a href="Ext.form.Panel.html" rel="Ext.form.Panel" class="docClass">Ext.form.Panel</a>, you can use the FormPanel's <a href="Ext.form.Panel.html#pollForChanges" rel="Ext.form.Panel#pollForChanges" class="docClass">Ext.form.Panel.pollForChanges</a>
290 configuration to set up such a task automatically.</p>
291
292 </div></div></div><div id="config-clearCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-clearCls" rel="config-clearCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-clearCls" class="viewSource">view source</a></div><a name="clearCls"></a><a name="config-clearCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-clearCls" class="cls expand">clearCls</a><span> : String</span></div><div class="description"><div class="short">The CSS class to be applied to the special clearing div rendered directly after the field
293 contents wrapper to provide...</div><div class="long"><p>The CSS class to be applied to the special clearing div rendered directly after the field
294 contents wrapper to provide field clearing (defaults to <tt>'x-clear'</tt>).</p>
295 </div></div></div><div id="config-cls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-cls" rel="config-cls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-cls" class="viewSource">view source</a></div><a name="cls"></a><a name="config-cls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-cls" class="cls expand">cls</a><span> : String</span></div><div class="description"><div class="short">An optional extra CSS class that will be added to this component's Element (defaults to '').  This can be
296 useful for ...</div><div class="long"><p>An optional extra CSS class that will be added to this component's Element (defaults to '').  This can be
297 useful for adding customized styles to the component or any of its children using standard CSS rules.</p>
298 </div></div></div><div id="config-componentCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-componentCls" rel="config-componentCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-componentCls" class="viewSource">view source</a></div><a name="componentCls"></a><a name="config-componentCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-componentCls" class="cls expand">componentCls</a><span> : String</span></div><div class="description"><div class="short"><p>CSS Class to be added to a components root level element to give distinction to it
299 via styling.</p>
300 </div><div class="long"><p>CSS Class to be added to a components root level element to give distinction to it
301 via styling.</p>
302 </div></div></div><div id="config-componentLayout" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-componentLayout" rel="config-componentLayout" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-componentLayout" class="viewSource">view source</a></div><a name="componentLayout"></a><a name="config-componentLayout"></a><a href="Ext.form.field.ComboBox.html#" rel="config-componentLayout" class="cls expand">componentLayout</a><span> : String/Object</span></div><div class="description"><div class="short">The sizing and positioning of a Component's internal Elements is the responsibility of
303 the Component's layout manager...</div><div class="long"><p>The sizing and positioning of a Component's internal Elements is the responsibility of
304 the Component's layout manager which sizes a Component's internal structure in response to the Component being sized.</p>
305
306
307 <p>Generally, developers will not use this configuration as all provided Components which need their internal
308 elements sizing (Such as <a href="Ext.form.field.Base.html" rel="Ext.form.field.Base" class="docClass">input fields</a>) come with their own componentLayout managers.</p>
309
310
311 <p>The <a href="Ext.layout.container.Auto.html" rel="Ext.layout.container.Auto" class="docClass">default layout manager</a> will be used on instances of the base <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a> class
312 which simply sizes the Component's encapsulating element to the height and width specified in the <a href="Ext.form.field.ComboBox.html#setSize" rel="Ext.form.field.ComboBox#setSize" class="docClass">setSize</a> method.</p>
313
314 </div></div></div><div id="config-contentEl" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-contentEl" rel="config-contentEl" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-contentEl" class="viewSource">view source</a></div><a name="contentEl"></a><a name="config-contentEl"></a><a href="Ext.form.field.ComboBox.html#" rel="config-contentEl" class="cls expand">contentEl</a><span> : String</span></div><div class="description"><div class="short">Optional. Specify an existing HTML element, or the id of an existing HTML element to use as the content
315 for this comp...</div><div class="long"><p>Optional. Specify an existing HTML element, or the <code>id</code> of an existing HTML element to use as the content
316 for this component.</p>
317
318
319 <ul>
320 <li><b>Description</b> :
321 <div class="sub-desc">This config option is used to take an existing HTML element and place it in the layout element
322 of a new component (it simply moves the specified DOM element <i>after the Component is rendered</i> to use as the content.</div></li>
323 <li><b>Notes</b> :
324 <div class="sub-desc">The specified HTML element is appended to the layout element of the component <i>after any configured
325 <a href="Ext.form.field.ComboBox.html#html" rel="Ext.form.field.ComboBox#html" class="docClass">HTML</a> has been inserted</i>, and so the document will not contain this element at the time the <a href="Ext.form.field.ComboBox.html#render" rel="Ext.form.field.ComboBox#render" class="docClass">render</a> event is fired.</div>
326 <div class="sub-desc">The specified HTML element used will not participate in any <code><b><a href="Ext.container.Container.html#layout" rel="Ext.container.Container#layout" class="docClass">layout</a></b></code>
327 scheme that the Component may use. It is just HTML. Layouts operate on child <code><b><a href="Ext.container.Container.html#items" rel="Ext.container.Container#items" class="docClass">items</a></b></code>.</div>
328 <div class="sub-desc">Add either the <code>x-hidden</code> or the <code>x-hide-display</code> CSS class to
329 prevent a brief flicker of the content before it is rendered to the panel.</div></li>
330 </ul>
331
332 </div></div></div><div id="config-data" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-data" rel="config-data" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-data" class="viewSource">view source</a></div><a name="data"></a><a name="config-data"></a><a href="Ext.form.field.ComboBox.html#" rel="config-data" class="cls expand">data</a><span> : Mixed</span></div><div class="description"><div class="short"><p>The initial set of data to apply to the <code><a href="Ext.form.field.ComboBox.html#tpl" rel="Ext.form.field.ComboBox#tpl" class="docClass">tpl</a></code> to
333 update the content area of the Component.</p>
334 </div><div class="long"><p>The initial set of data to apply to the <code><a href="Ext.form.field.ComboBox.html#tpl" rel="Ext.form.field.ComboBox#tpl" class="docClass">tpl</a></code> to
335 update the content area of the Component.</p>
336 </div></div></div><div id="config-defaultListConfig" class="member ni"><a href="Ext.form.field.ComboBox.html#config-defaultListConfig" rel="config-defaultListConfig" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-defaultListConfig" class="viewSource">view source</a></div><a name="defaultListConfig"></a><a name="config-defaultListConfig"></a><a href="Ext.form.field.ComboBox.html#" rel="config-defaultListConfig" class="cls expand">defaultListConfig</a><span> : Object</span></div><div class="description"><div class="short"><p>Set of options that will be used as defaults for the user-configured <a href="Ext.form.field.ComboBox.html#listConfig" rel="Ext.form.field.ComboBox#listConfig" class="docClass">listConfig</a> object.</p>
337 </div><div class="long"><p>Set of options that will be used as defaults for the user-configured <a href="Ext.form.field.ComboBox.html#listConfig" rel="Ext.form.field.ComboBox#listConfig" class="docClass">listConfig</a> object.</p>
338 </div></div></div><div id="config-delimiter" class="member ni"><a href="Ext.form.field.ComboBox.html#config-delimiter" rel="config-delimiter" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-delimiter" class="viewSource">view source</a></div><a name="delimiter"></a><a name="config-delimiter"></a><a href="Ext.form.field.ComboBox.html#" rel="config-delimiter" class="cls expand">delimiter</a><span> : String</span></div><div class="description"><div class="short">The character(s) used to separate the display values of multiple selected items
339 when multiSelect = true. Defaults to ...</div><div class="long"><p>The character(s) used to separate the <a href="Ext.form.field.ComboBox.html#displayField" rel="Ext.form.field.ComboBox#displayField" class="docClass">display values</a> of multiple selected items
340 when <tt><a href="Ext.form.field.ComboBox.html#multiSelect" rel="Ext.form.field.ComboBox#multiSelect" class="docClass">multiSelect</a> = true</tt>. Defaults to <tt>', '</tt>.</p>
341 </div></div></div><div id="config-dirtyCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-dirtyCls" rel="config-dirtyCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-dirtyCls" class="viewSource">view source</a></div><a name="dirtyCls"></a><a name="config-dirtyCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-dirtyCls" class="cls expand">dirtyCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to use when the field value <a href="Ext.form.field.ComboBox.html#isDirty" rel="Ext.form.field.ComboBox#isDirty" class="docClass">is dirty</a>.</p>
342 </div><div class="long"><p>The CSS class to use when the field value <a href="Ext.form.field.ComboBox.html#isDirty" rel="Ext.form.field.ComboBox#isDirty" class="docClass">is dirty</a>.</p>
343 </div></div></div><div id="config-disableKeyFilter" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-disableKeyFilter" rel="config-disableKeyFilter" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-disableKeyFilter" class="viewSource">view source</a></div><a name="disableKeyFilter"></a><a name="config-disableKeyFilter"></a><a href="Ext.form.field.ComboBox.html#" rel="config-disableKeyFilter" class="cls expand">disableKeyFilter</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Specify <tt>true</tt> to disable input keystroke filtering (defaults
344 to <tt>false</tt>)</p>
345 </div><div class="long"><p>Specify <tt>true</tt> to disable input keystroke filtering (defaults
346 to <tt>false</tt>)</p>
347 </div></div></div><div id="config-disabled" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-disabled" rel="config-disabled" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-cfg-disabled" class="viewSource">view source</a></div><a name="disabled"></a><a name="config-disabled"></a><a href="Ext.form.field.ComboBox.html#" rel="config-disabled" class="cls expand">disabled</a><span> : Boolean</span></div><div class="description"><div class="short"><p>True to disable the field (defaults to false). Disabled Fields will not be
348 <a href="Ext.form.Basic.html#submit" rel="Ext.form.Basic#submit" class="docClass">submitted</a>.</p></p>
349 </div><div class="long"><p>True to disable the field (defaults to false). Disabled Fields will not be
350 <a href="Ext.form.Basic.html#submit" rel="Ext.form.Basic#submit" class="docClass">submitted</a>.</p></p>
351 </div></div></div><div id="config-disabledCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-disabledCls" rel="config-disabledCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-disabledCls" class="viewSource">view source</a></div><a name="disabledCls"></a><a name="config-disabledCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-disabledCls" class="cls expand">disabledCls</a><span> : String</span></div><div class="description"><div class="short"><p>CSS class to add when the Component is disabled. Defaults to 'x-item-disabled'.</p>
352 </div><div class="long"><p>CSS class to add when the Component is disabled. Defaults to 'x-item-disabled'.</p>
353 </div></div></div><div id="config-displayField" class="member ni"><a href="Ext.form.field.ComboBox.html#config-displayField" rel="config-displayField" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-displayField" class="viewSource">view source</a></div><a name="displayField"></a><a name="config-displayField"></a><a href="Ext.form.field.ComboBox.html#" rel="config-displayField" class="cls expand">displayField</a><span> : String</span></div><div class="description"><div class="short"><p>The underlying <a href="Ext.data.Field.html#name" rel="Ext.data.Field#name" class="docClass">data field name</a> to bind to this
354 ComboBox (defaults to 'text').</p>
355
356 <p>See also <tt><a href="Ext.form.field.ComboBox.html#valueField" rel="Ext.form.field.ComboBox#valueField" class="docClass">valueField</a></tt>.</p>
357
358 </div><div class="long"><p>The underlying <a href="Ext.data.Field.html#name" rel="Ext.data.Field#name" class="docClass">data field name</a> to bind to this
359 ComboBox (defaults to 'text').</p>
360
361 <p>See also <tt><a href="Ext.form.field.ComboBox.html#valueField" rel="Ext.form.field.ComboBox#valueField" class="docClass">valueField</a></tt>.</p>
362
363 </div></div></div><div id="config-draggable" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-draggable" rel="config-draggable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-cfg-draggable" class="viewSource">view source</a></div><a name="draggable"></a><a name="config-draggable"></a><a href="Ext.form.field.ComboBox.html#" rel="config-draggable" class="cls expand">draggable</a><span> : Mixed</span></div><div class="description"><div class="short">Specify as true to make a floating Component draggable using the Component's encapsulating element as the drag handle...</div><div class="long"><p>Specify as true to make a <a href="Ext.form.field.ComboBox.html#floating" rel="Ext.form.field.ComboBox#floating" class="docClass">floating</a> Component draggable using the Component's encapsulating element as the drag handle.</p>
364
365
366 <p>This may also be specified as a config object for the <a href="Ext.util.ComponentDragger.html" rel="Ext.util.ComponentDragger" class="docClass">ComponentDragger</a> which is instantiated to perform dragging.</p>
367
368
369 <p>For example to create a Component which may only be dragged around using a certain internal element as the drag handle,
370 use the delegate option:</p>
371
372
373 <p><code></p>
374
375 <pre>new Ext.Component({
376     constrain: true,
377     floating:true,
378     style: {
379         backgroundColor: '#fff',
380         border: '1px solid black'
381     },
382     html: '&lt;h1 style="cursor:move"&gt;The title&lt;/h1&gt;&lt;p&gt;The content&lt;/p&gt;',
383     draggable: {
384         delegate: 'h1'
385     }
386 }).show();
387 </pre>
388
389
390 <p></code></p>
391 </div></div></div><div id="config-editable" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-editable" rel="config-editable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Picker.html" class="definedIn docClass">Ext.form.field.Picker</a><br/><a href="../source/Picker.html#Ext-form.field.Picker-cfg-editable" class="viewSource">view source</a></div><a name="editable"></a><a name="config-editable"></a><a href="Ext.form.field.ComboBox.html#" rel="config-editable" class="cls expand">editable</a><span> : Boolean</span></div><div class="description"><div class="short">false to prevent the user from typing text directly into the field;
392 the field can only have its value set via selecti...</div><div class="long"><p><tt>false</tt> to prevent the user from typing text directly into the field;
393 the field can only have its value set via selecting a value from the picker. In this state, the picker
394 can also be opened by clicking directly on the input field itself.
395 (defaults to <tt>true</tt>).</p>
396 </div></div></div><div id="config-emptyCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-emptyCls" rel="config-emptyCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-emptyCls" class="viewSource">view source</a></div><a name="emptyCls"></a><a name="config-emptyCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-emptyCls" class="cls expand">emptyCls</a><span> : String</span></div><div class="description"><div class="short">The CSS class to apply to an empty field to style the emptyText
397 (defaults to 'x-form-empty-field').  This class is au...</div><div class="long"><p>The CSS class to apply to an empty field to style the <b><tt><a href="Ext.form.field.ComboBox.html#emptyText" rel="Ext.form.field.ComboBox#emptyText" class="docClass">emptyText</a></tt></b>
398 (defaults to <tt>'x-form-empty-field'</tt>).  This class is automatically added and removed as needed
399 depending on the current field value.</p>
400 </div></div></div><div id="config-emptyText" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-emptyText" rel="config-emptyText" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-emptyText" class="viewSource">view source</a></div><a name="emptyText"></a><a name="config-emptyText"></a><a href="Ext.form.field.ComboBox.html#" rel="config-emptyText" class="cls expand">emptyText</a><span> : String</span></div><div class="description"><div class="short">The default text to place into an empty field (defaults to undefined).
401
402
403 Note that normally this value will be submit...</div><div class="long"><p>The default text to place into an empty field (defaults to <tt>undefined</tt>).</p>
404
405
406 <p>Note that normally this value will be submitted to the server if this field is enabled; to prevent this
407 you can set the <a href="Ext.form.action.Action.html#submitEmptyText" rel="Ext.form.action.Action#submitEmptyText" class="docClass">submitEmptyText</a> option of
408 <a href="Ext.form.Basic.html#submit" rel="Ext.form.Basic#submit" class="docClass">Ext.form.Basic.submit</a> to <tt>false</tt>.</p>
409
410
411 <p>Also note that if you use <tt><a href="Ext.form.field.ComboBox.html#inputType" rel="Ext.form.field.ComboBox#inputType" class="docClass">inputType</a>:'file'</tt>, <a href="Ext.form.field.ComboBox.html#emptyText" rel="Ext.form.field.ComboBox#emptyText" class="docClass">emptyText</a> is not
412 supported and should be avoided.</p>
413
414 </div></div></div><div id="config-enableKeyEvents" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-enableKeyEvents" rel="config-enableKeyEvents" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-enableKeyEvents" class="viewSource">view source</a></div><a name="enableKeyEvents"></a><a name="config-enableKeyEvents"></a><a href="Ext.form.field.ComboBox.html#" rel="config-enableKeyEvents" class="cls expand">enableKeyEvents</a><span> : Boolean</span></div><div class="description"><div class="short"><p><tt>true</tt> to enable the proxying of key events for the HTML input field (defaults to <tt>false</tt>)</p>
415 </div><div class="long"><p><tt>true</tt> to enable the proxying of key events for the HTML input field (defaults to <tt>false</tt>)</p>
416 </div></div></div><div id="config-enforceMaxLength" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-enforceMaxLength" rel="config-enforceMaxLength" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-enforceMaxLength" class="viewSource">view source</a></div><a name="enforceMaxLength"></a><a name="config-enforceMaxLength"></a><a href="Ext.form.field.ComboBox.html#" rel="config-enforceMaxLength" class="cls expand">enforceMaxLength</a><span> : Boolean</span></div><div class="description"><div class="short"><p>True to set the maxLength property on the underlying input field. Defaults to <tt>false</tt></p>
417 </div><div class="long"><p>True to set the maxLength property on the underlying input field. Defaults to <tt>false</tt></p>
418 </div></div></div><div id="config-errorMsgCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-errorMsgCls" rel="config-errorMsgCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-errorMsgCls" class="viewSource">view source</a></div><a name="errorMsgCls"></a><a name="config-errorMsgCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-errorMsgCls" class="cls expand">errorMsgCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to be applied to the error message element. Defaults to 'x-form-error-msg'.</p>
419 </div><div class="long"><p>The CSS class to be applied to the error message element. Defaults to 'x-form-error-msg'.</p>
420 </div></div></div><div id="config-fieldBodyCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-fieldBodyCls" rel="config-fieldBodyCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-fieldBodyCls" class="viewSource">view source</a></div><a name="fieldBodyCls"></a><a name="config-fieldBodyCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-fieldBodyCls" class="cls expand">fieldBodyCls</a><span> : String</span></div><div class="description"><div class="short"><p>An extra CSS class to be applied to the body content element in addition to <a href="Ext.form.field.ComboBox.html#fieldBodyCls" rel="Ext.form.field.ComboBox#fieldBodyCls" class="docClass">fieldBodyCls</a>.
421 Defaults to empty.</p>
422 </div><div class="long"><p>An extra CSS class to be applied to the body content element in addition to <a href="Ext.form.field.ComboBox.html#fieldBodyCls" rel="Ext.form.field.ComboBox#fieldBodyCls" class="docClass">fieldBodyCls</a>.
423 Defaults to empty.</p>
424 </div></div></div><div id="config-fieldCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-fieldCls" rel="config-fieldCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-fieldCls" class="viewSource">view source</a></div><a name="fieldCls"></a><a name="config-fieldCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-fieldCls" class="cls expand">fieldCls</a><span> : String</span></div><div class="description"><div class="short"><p>The default CSS class for the field input (defaults to 'x-form-field')</p>
425 </div><div class="long"><p>The default CSS class for the field input (defaults to 'x-form-field')</p>
426 </div></div></div><div id="config-fieldLabel" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-fieldLabel" rel="config-fieldLabel" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-fieldLabel" class="viewSource">view source</a></div><a name="fieldLabel"></a><a name="config-fieldLabel"></a><a href="Ext.form.field.ComboBox.html#" rel="config-fieldLabel" class="cls expand">fieldLabel</a><span> : String</span></div><div class="description"><div class="short">The label for the field. It gets appended with the labelSeparator, and its position
427 and sizing is determined by the l...</div><div class="long"><p>The label for the field. It gets appended with the <a href="Ext.form.field.ComboBox.html#labelSeparator" rel="Ext.form.field.ComboBox#labelSeparator" class="docClass">labelSeparator</a>, and its position
428 and sizing is determined by the <a href="Ext.form.field.ComboBox.html#labelAlign" rel="Ext.form.field.ComboBox#labelAlign" class="docClass">labelAlign</a>, <a href="Ext.form.field.ComboBox.html#labelWidth" rel="Ext.form.field.ComboBox#labelWidth" class="docClass">labelWidth</a>, and <a href="Ext.form.field.ComboBox.html#labelPad" rel="Ext.form.field.ComboBox#labelPad" class="docClass">labelPad</a>
429 configs. Defaults to undefined.</p>
430 </div></div></div><div id="config-fieldStyle" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-fieldStyle" rel="config-fieldStyle" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-fieldStyle" class="viewSource">view source</a></div><a name="fieldStyle"></a><a name="config-fieldStyle"></a><a href="Ext.form.field.ComboBox.html#" rel="config-fieldStyle" class="cls expand">fieldStyle</a><span> : String</span></div><div class="description"><div class="short">Optional CSS style(s) to be applied to the field input element.
431 Should be a valid argument to Ext.core.Element.applyS...</div><div class="long"><p>Optional CSS style(s) to be applied to the <a href="Ext.form.field.ComboBox.html#inputEl" rel="Ext.form.field.ComboBox#inputEl" class="docClass">field input element</a>.
432 Should be a valid argument to <a href="Ext.core.Element.html#applyStyles" rel="Ext.core.Element#applyStyles" class="docClass">Ext.core.Element.applyStyles</a>. Defaults to undefined. See also the
433 <a href="Ext.form.field.ComboBox.html#setFieldStyle" rel="Ext.form.field.ComboBox#setFieldStyle" class="docClass">setFieldStyle</a> method for changing the style after initialization.</p>
434 </div></div></div><div id="config-floating" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-floating" rel="config-floating" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-cfg-floating" class="viewSource">view source</a></div><a name="floating"></a><a name="config-floating"></a><a href="Ext.form.field.ComboBox.html#" rel="config-floating" class="cls expand">floating</a><span> : Boolean</span></div><div class="description"><div class="short">Specify as true to float the Component outside of the document flow using CSS absolute positioning.
435
436
437 Components such...</div><div class="long"><p>Specify as true to float the Component outside of the document flow using CSS absolute positioning.</p>
438
439
440 <p>Components such as <a href="Ext.window.Window.html" rel="Ext.window.Window" class="docClass">Window</a>s and <a href="Ext.menu.Menu.html" rel="Ext.menu.Menu" class="docClass">Menu</a>s are floating
441 by default.</p>
442
443
444 <p>Floating Components that are programatically <a href="Ext.Component.html#render" rel="Ext.Component#render" class="docClass">rendered</a> will register themselves with the global
445 <a href="Ext.WindowManager.html" rel="Ext.WindowManager" class="docClass">ZIndexManager</a></p>
446
447
448 <h3 class="pa">Floating Components as child items of a Container</h3>
449
450
451 <p>A floating Component may be used as a child item of a Container. This just allows the floating Component to seek a ZIndexManager by
452 examining the ownerCt chain.</p>
453
454
455 <p>When configured as floating, Components acquire, at render time, a <a href="Ext.ZIndexManager.html" rel="Ext.ZIndexManager" class="docClass">ZIndexManager</a> which manages a stack
456 of related floating Components. The ZIndexManager brings a single floating Component to the top of its stack when
457 the Component's <a href="Ext.form.field.ComboBox.html#toFront" rel="Ext.form.field.ComboBox#toFront" class="docClass">toFront</a> method is called.</p>
458
459
460 <p>The ZIndexManager is found by traversing up the <a href="Ext.form.field.ComboBox.html#ownerCt" rel="Ext.form.field.ComboBox#ownerCt" class="docClass">ownerCt</a> chain to find an ancestor which itself is floating. This is so that
461 descendant floating Components of floating <i>Containers</i> (Such as a ComboBox dropdown within a Window) can have its zIndex managed relative
462 to any siblings, but always <b>above</b> that floating ancestor Container.</p>
463
464
465 <p>If no floating ancestor is found, a floating Component registers itself with the default <a href="Ext.WindowManager.html" rel="Ext.WindowManager" class="docClass">ZIndexManager</a>.</p>
466
467
468 <p>Floating components <i>do not participate in the Container's layout</i>. Because of this, they are not rendered until you explicitly
469 <a href="Ext.form.field.ComboBox.html#show" rel="Ext.form.field.ComboBox#show" class="docClass">show</a> them.</p>
470
471
472 <p>After rendering, the ownerCt reference is deleted, and the <a href="Ext.form.field.ComboBox.html#floatParent" rel="Ext.form.field.ComboBox#floatParent" class="docClass">floatParent</a> property is set to the found floating ancestor Container.
473 If no floating ancestor Container was found the <a href="Ext.form.field.ComboBox.html#floatParent" rel="Ext.form.field.ComboBox#floatParent" class="docClass">floatParent</a> property will not be set.</p>
474
475 </div></div></div><div id="config-focusCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-focusCls" rel="config-focusCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-focusCls" class="viewSource">view source</a></div><a name="focusCls"></a><a name="config-focusCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-focusCls" class="cls expand">focusCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to use when the field receives focus (defaults to 'x-form-focus')</p>
476 </div><div class="long"><p>The CSS class to use when the field receives focus (defaults to 'x-form-focus')</p>
477 </div></div></div><div id="config-focusOnToFront" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-focusOnToFront" rel="config-focusOnToFront" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Floating.html" class="definedIn docClass">Ext.util.Floating</a><br/><a href="../source/Floating.html#Ext-util.Floating-cfg-focusOnToFront" class="viewSource">view source</a></div><a name="focusOnToFront"></a><a name="config-focusOnToFront"></a><a href="Ext.form.field.ComboBox.html#" rel="config-focusOnToFront" class="cls expand">focusOnToFront</a><span> : Boolean</span></div><div class="description"><div class="short">Specifies whether the floated component should be automatically focused when it is
478 brought to the front. Defaults to ...</div><div class="long"><p>Specifies whether the floated component should be automatically <a href="Ext.form.field.ComboBox.html#focus" rel="Ext.form.field.ComboBox#focus" class="docClass">focused</a> when it is
479 <a href="Ext.form.field.ComboBox.html#toFront" rel="Ext.form.field.ComboBox#toFront" class="docClass">brought to the front</a>. Defaults to true.</p>
480 </div></div></div><div id="config-forceSelection" class="member ni"><a href="Ext.form.field.ComboBox.html#config-forceSelection" rel="config-forceSelection" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-forceSelection" class="viewSource">view source</a></div><a name="forceSelection"></a><a name="config-forceSelection"></a><a href="Ext.form.field.ComboBox.html#" rel="config-forceSelection" class="cls expand">forceSelection</a><span> : Boolean</span></div><div class="description"><div class="short">true to restrict the selected value to one of the values in the list,
481 false to allow the user to set arbitrary text i...</div><div class="long"><p><tt>true</tt> to restrict the selected value to one of the values in the list,
482 <tt>false</tt> to allow the user to set arbitrary text into the field (defaults to <tt>false</tt>)</p>
483 </div></div></div><div id="config-formItemCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-formItemCls" rel="config-formItemCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-formItemCls" class="viewSource">view source</a></div><a name="formItemCls"></a><a name="config-formItemCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-formItemCls" class="cls expand">formItemCls</a><span> : String</span></div><div class="description"><div class="short">A CSS class to be applied to the outermost element to denote that it is participating in the form
484 field layout. Defau...</div><div class="long"><p>A CSS class to be applied to the outermost element to denote that it is participating in the form
485 field layout. Defaults to 'x-form-item'.</p>
486 </div></div></div><div id="config-frame" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-frame" rel="config-frame" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-frame" class="viewSource">view source</a></div><a name="frame"></a><a name="config-frame"></a><a href="Ext.form.field.ComboBox.html#" rel="config-frame" class="cls expand">frame</a><span> : Boolean</span></div><div class="description"><div class="short">Specify as true to have the Component inject framing elements within the Component at render time to
487 provide a graphi...</div><div class="long"><p>Specify as <code>true</code> to have the Component inject framing elements within the Component at render time to
488 provide a graphical rounded frame around the Component content.</p>
489
490
491 <p>This is only necessary when running on outdated, or non standard-compliant browsers such as Microsoft's Internet Explorer
492 prior to version 9 which do not support rounded corners natively.</p>
493
494
495 <p>The extra space taken up by this framing is available from the read only property <a href="Ext.form.field.ComboBox.html#frameSize" rel="Ext.form.field.ComboBox#frameSize" class="docClass">frameSize</a>.</p>
496
497 </div></div></div><div id="config-grow" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-grow" rel="config-grow" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-grow" class="viewSource">view source</a></div><a name="grow"></a><a name="config-grow"></a><a href="Ext.form.field.ComboBox.html#" rel="config-grow" class="cls expand">grow</a><span> : Boolean</span></div><div class="description"><div class="short"><p><tt>true</tt> if this field should automatically grow and shrink to its content
498 (defaults to <tt>false</tt>)</p>
499 </div><div class="long"><p><tt>true</tt> if this field should automatically grow and shrink to its content
500 (defaults to <tt>false</tt>)</p>
501 </div></div></div><div id="config-growAppend" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-growAppend" rel="config-growAppend" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-growAppend" class="viewSource">view source</a></div><a name="growAppend"></a><a name="config-growAppend"></a><a href="Ext.form.field.ComboBox.html#" rel="config-growAppend" class="cls expand">growAppend</a><span> : String</span></div><div class="description"><div class="short">A string that will be appended to the field's current value for the purposes of calculating the target
502 field size. On...</div><div class="long"><p>A string that will be appended to the field's current value for the purposes of calculating the target
503 field size. Only used when the <a href="Ext.form.field.ComboBox.html#grow" rel="Ext.form.field.ComboBox#grow" class="docClass">grow</a> config is <tt>true</tt>. Defaults to a single capital "W"
504 (the widest character in common fonts) to leave enough space for the next typed character and avoid the
505 field value shifting before the width is adjusted.</p>
506 </div></div></div><div id="config-growMax" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-growMax" rel="config-growMax" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-growMax" class="viewSource">view source</a></div><a name="growMax"></a><a name="config-growMax"></a><a href="Ext.form.field.ComboBox.html#" rel="config-growMax" class="cls expand">growMax</a><span> : Number</span></div><div class="description"><div class="short"><p>The maximum width to allow when <code><b><a href="Ext.form.field.ComboBox.html#grow" rel="Ext.form.field.ComboBox#grow" class="docClass">grow</a></b> = true</code> (defaults
507 to <tt>800</tt>)</p>
508 </div><div class="long"><p>The maximum width to allow when <code><b><a href="Ext.form.field.ComboBox.html#grow" rel="Ext.form.field.ComboBox#grow" class="docClass">grow</a></b> = true</code> (defaults
509 to <tt>800</tt>)</p>
510 </div></div></div><div id="config-growMin" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-growMin" rel="config-growMin" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-growMin" class="viewSource">view source</a></div><a name="growMin"></a><a name="config-growMin"></a><a href="Ext.form.field.ComboBox.html#" rel="config-growMin" class="cls expand">growMin</a><span> : Number</span></div><div class="description"><div class="short"><p>The minimum width to allow when <code><b><a href="Ext.form.field.ComboBox.html#grow" rel="Ext.form.field.ComboBox#grow" class="docClass">grow</a></b> = true</code> (defaults
511 to <tt>30</tt>)</p>
512 </div><div class="long"><p>The minimum width to allow when <code><b><a href="Ext.form.field.ComboBox.html#grow" rel="Ext.form.field.ComboBox#grow" class="docClass">grow</a></b> = true</code> (defaults
513 to <tt>30</tt>)</p>
514 </div></div></div><div id="config-height" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-height" rel="config-height" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-height" class="viewSource">view source</a></div><a name="height"></a><a name="config-height"></a><a href="Ext.form.field.ComboBox.html#" rel="config-height" class="cls expand">height</a><span> : Number</span></div><div class="description"><div class="short"><p>The height of this component in pixels.</p>
515 </div><div class="long"><p>The height of this component in pixels.</p>
516 </div></div></div><div id="config-hidden" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-hidden" rel="config-hidden" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-hidden" class="viewSource">view source</a></div><a name="hidden"></a><a name="config-hidden"></a><a href="Ext.form.field.ComboBox.html#" rel="config-hidden" class="cls expand">hidden</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Defaults to false.</p>
517 </div><div class="long"><p>Defaults to false.</p>
518 </div></div></div><div id="config-hideEmptyLabel" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-hideEmptyLabel" rel="config-hideEmptyLabel" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-hideEmptyLabel" class="viewSource">view source</a></div><a name="hideEmptyLabel"></a><a name="config-hideEmptyLabel"></a><a href="Ext.form.field.ComboBox.html#" rel="config-hideEmptyLabel" class="cls expand">hideEmptyLabel</a><span> : Boolean</span></div><div class="description"><div class="short">When set to true, the label element (fieldLabel and labelSeparator) will be
519 automatically hidden if the fieldLabel is...</div><div class="long"><p>When set to <tt>true</tt>, the label element (<a href="Ext.form.field.ComboBox.html#fieldLabel" rel="Ext.form.field.ComboBox#fieldLabel" class="docClass">fieldLabel</a> and <a href="Ext.form.field.ComboBox.html#labelSeparator" rel="Ext.form.field.ComboBox#labelSeparator" class="docClass">labelSeparator</a>) will be
520 automatically hidden if the <a href="Ext.form.field.ComboBox.html#fieldLabel" rel="Ext.form.field.ComboBox#fieldLabel" class="docClass">fieldLabel</a> is empty. Setting this to <tt>false</tt> will cause the empty
521 label element to be rendered and space to be reserved for it; this is useful if you want a field without a label
522 to line up with other labeled fields in the same form. Defaults to <tt>true</tt>.</p>
523
524
525 <p>If you wish to unconditionall hide the label even if a non-empty fieldLabel is configured, then set
526 the <a href="Ext.form.field.ComboBox.html#hideLabel" rel="Ext.form.field.ComboBox#hideLabel" class="docClass">hideLabel</a> config to <tt>true</tt>.</p>
527
528 </div></div></div><div id="config-hideLabel" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-hideLabel" rel="config-hideLabel" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-hideLabel" class="viewSource">view source</a></div><a name="hideLabel"></a><a name="config-hideLabel"></a><a href="Ext.form.field.ComboBox.html#" rel="config-hideLabel" class="cls expand">hideLabel</a><span> : Boolean</span></div><div class="description"><div class="short">Set to true to completely hide the label element (fieldLabel and labelSeparator).
529 Defaults to false.
530
531
532 Also see hideE...</div><div class="long"><p>Set to <tt>true</tt> to completely hide the label element (<a href="Ext.form.field.ComboBox.html#fieldLabel" rel="Ext.form.field.ComboBox#fieldLabel" class="docClass">fieldLabel</a> and <a href="Ext.form.field.ComboBox.html#labelSeparator" rel="Ext.form.field.ComboBox#labelSeparator" class="docClass">labelSeparator</a>).
533 Defaults to <tt>false</tt>.</p>
534
535
536 <p>Also see <a href="Ext.form.field.ComboBox.html#hideEmptyLabel" rel="Ext.form.field.ComboBox#hideEmptyLabel" class="docClass">hideEmptyLabel</a>, which controls whether space will be reserved for an empty fieldLabel.</p>
537
538 </div></div></div><div id="config-hideMode" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-hideMode" rel="config-hideMode" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-hideMode" class="viewSource">view source</a></div><a name="hideMode"></a><a name="config-hideMode"></a><a href="Ext.form.field.ComboBox.html#" rel="config-hideMode" class="cls expand">hideMode</a><span> : String</span></div><div class="description"><div class="short">A String which specifies how this Component's encapsulating DOM element will be hidden.
539 Values may be
540 'display' : The...</div><div class="long"><p>A String which specifies how this Component's encapsulating DOM element will be hidden.
541 Values may be<div class="mdetail-params"><ul>
542 <li><code>'display'</code> : The Component will be hidden using the <code>display: none</code> style.</li>
543 <li><code>'visibility'</code> : The Component will be hidden using the <code>visibility: hidden</code> style.</li>
544 <li><code>'offsets'</code> : The Component will be hidden by absolutely positioning it out of the visible area of the document. This
545 is useful when a hidden Component must maintain measurable dimensions. Hiding using <code>display</code> results
546 in a Component having zero dimensions.</li></ul></div>
547 Defaults to <code>'display'</code>.</p>
548 </div></div></div><div id="config-hideTrigger" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-hideTrigger" rel="config-hideTrigger" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Trigger.html" class="definedIn docClass">Ext.form.field.Trigger</a><br/><a href="../source/Trigger.html#Ext-form.field.Trigger-cfg-hideTrigger" class="viewSource">view source</a></div><a name="hideTrigger"></a><a name="config-hideTrigger"></a><a href="Ext.form.field.ComboBox.html#" rel="config-hideTrigger" class="cls expand">hideTrigger</a><span> : Boolean</span></div><div class="description"><div class="short"><p><tt>true</tt> to hide the trigger element and display only the base
549 text field (defaults to <tt>false</tt>)</p>
550 </div><div class="long"><p><tt>true</tt> to hide the trigger element and display only the base
551 text field (defaults to <tt>false</tt>)</p>
552 </div></div></div><div id="config-html" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-html" rel="config-html" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-html" class="viewSource">view source</a></div><a name="html"></a><a name="config-html"></a><a href="Ext.form.field.ComboBox.html#" rel="config-html" class="cls expand">html</a><span> : String/Object</span></div><div class="description"><div class="short">An HTML fragment, or a DomHelper specification to use as the layout element
553 content (defaults to ''). The HTML conten...</div><div class="long"><p>An HTML fragment, or a <a href="Ext.core.DomHelper.html" rel="Ext.core.DomHelper" class="docClass">DomHelper</a> specification to use as the layout element
554 content (defaults to ''). The HTML content is added after the component is rendered,
555 so the document will not contain this HTML at the time the <a href="Ext.form.field.ComboBox.html#render" rel="Ext.form.field.ComboBox#render" class="docClass">render</a> event is fired.
556 This content is inserted into the body <i>before</i> any configured <a href="Ext.form.field.ComboBox.html#contentEl" rel="Ext.form.field.ComboBox#contentEl" class="docClass">contentEl</a> is appended.</p>
557 </div></div></div><div id="config-id" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-id" rel="config-id" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-id" class="viewSource">view source</a></div><a name="id"></a><a name="config-id"></a><a href="Ext.form.field.ComboBox.html#" rel="config-id" class="cls expand">id</a><span> : String</span></div><div class="description"><div class="short">The unique id of this component instance (defaults to an auto-assigned id).
558
559
560 It should not be necessary to use this ...</div><div class="long"><p>The <b><u>unique id of this component instance</u></b> (defaults to an <a href="Ext.form.field.ComboBox.html#getId" rel="Ext.form.field.ComboBox#getId" class="docClass">auto-assigned id</a>).</p>
561
562
563 <p>It should not be necessary to use this configuration except for singleton objects in your application.
564 Components created with an id may be accessed globally using <a href="Ext.html#getCmp" rel="Ext#getCmp" class="docClass">Ext.getCmp</a>.</p>
565
566
567 <p>Instead of using assigned ids, use the <a href="Ext.form.field.ComboBox.html#itemId" rel="Ext.form.field.ComboBox#itemId" class="docClass">itemId</a> config, and <a href="Ext.ComponentQuery.html" rel="Ext.ComponentQuery" class="docClass">ComponentQuery</a> which
568 provides selector-based searching for Sencha Components analogous to DOM querying. The <a href="Ext.container.Container.html" rel="Ext.container.Container" class="docClass">Container</a>
569 class contains <a href="Ext.container.Container.html#down" rel="Ext.container.Container#down" class="docClass">shortcut methods</a> to query its descendant Components by selector.</p>
570
571
572 <p>Note that this id will also be used as the element id for the containing HTML element
573 that is rendered to the page for this component. This allows you to write id-based CSS
574 rules to style the specific instance of this component uniquely, and also to select
575 sub-elements using this component's id as the parent.</p>
576
577
578 <p><b>Note</b>: to avoid complications imposed by a unique <tt>id</tt> also see <code><a href="Ext.form.field.ComboBox.html#itemId" rel="Ext.form.field.ComboBox#itemId" class="docClass">itemId</a></code>.</p>
579
580
581 <p><b>Note</b>: to access the container of a Component see <code><a href="Ext.form.field.ComboBox.html#ownerCt" rel="Ext.form.field.ComboBox#ownerCt" class="docClass">ownerCt</a></code>.</p>
582
583 </div></div></div><div id="config-inputId" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-inputId" rel="config-inputId" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-inputId" class="viewSource">view source</a></div><a name="inputId"></a><a name="config-inputId"></a><a href="Ext.form.field.ComboBox.html#" rel="config-inputId" class="cls expand">inputId</a><span> : String</span></div><div class="description"><div class="short">The id that will be given to the generated input DOM element. Defaults to an automatically generated id.
584 If you confi...</div><div class="long"><p>The id that will be given to the generated input DOM element. Defaults to an automatically generated id.
585 If you configure this manually, you must make sure it is unique in the document.</p>
586 </div></div></div><div id="config-inputType" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-inputType" rel="config-inputType" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-inputType" class="viewSource">view source</a></div><a name="inputType"></a><a name="config-inputType"></a><a href="Ext.form.field.ComboBox.html#" rel="config-inputType" class="cls expand">inputType</a><span> : String</span></div><div class="description"><div class="short">The type attribute for input fields -- e.g. radio, text, password, file (defaults to 'text').
587 The extended types supp...</div><div class="long"><p>The type attribute for input fields -- e.g. radio, text, password, file (defaults to <tt>'text'</tt>).
588 The extended types supported by HTML5 inputs (url, email, etc.) may also be used, though using them
589 will cause older browsers to fall back to 'text'.</p>
590
591
592 <p>The type 'password' must be used to render that field type currently -- there is no separate <a href="Ext.html" rel="Ext" class="docClass">Ext</a>
593 component for that. You can use <a href="Ext.form.field.File.html" rel="Ext.form.field.File" class="docClass">Ext.form.field.File</a> which creates a custom-rendered file upload
594 field, but if you want a plain unstyled file input you can use a BaseField with inputType:'file'.</p>
595
596 </div></div></div><div id="config-invalidCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-invalidCls" rel="config-invalidCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-invalidCls" class="viewSource">view source</a></div><a name="invalidCls"></a><a name="config-invalidCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-invalidCls" class="cls expand">invalidCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to use when marking the component invalid (defaults to 'x-form-invalid')</p>
597 </div><div class="long"><p>The CSS class to use when marking the component invalid (defaults to 'x-form-invalid')</p>
598 </div></div></div><div id="config-invalidText" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-invalidText" rel="config-invalidText" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-invalidText" class="viewSource">view source</a></div><a name="invalidText"></a><a name="config-invalidText"></a><a href="Ext.form.field.ComboBox.html#" rel="config-invalidText" class="cls expand">invalidText</a><span> : String</span></div><div class="description"><div class="short">The error text to use when marking a field invalid and no message is provided
599 (defaults to 'The value in this field i...</div><div class="long"><p>The error text to use when marking a field invalid and no message is provided
600 (defaults to 'The value in this field is invalid')</p>
601 </div></div></div><div id="config-itemId" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-itemId" rel="config-itemId" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-itemId" class="viewSource">view source</a></div><a name="itemId"></a><a name="config-itemId"></a><a href="Ext.form.field.ComboBox.html#" rel="config-itemId" class="cls expand">itemId</a><span> : String</span></div><div class="description"><div class="short">An itemId can be used as an alternative way to get a reference to a component
602 when no object reference is available. ...</div><div class="long"><p>An <tt>itemId</tt> can be used as an alternative way to get a reference to a component
603 when no object reference is available.  Instead of using an <code><a href="Ext.form.field.ComboBox.html#id" rel="Ext.form.field.ComboBox#id" class="docClass">id</a></code> with
604 <a href="Ext.html" rel="Ext" class="docClass">Ext</a>.<a href="Ext.html#getCmp" rel="Ext#getCmp" class="docClass">getCmp</a>, use <code>itemId</code> with
605 <a href="Ext.container.Container.html" rel="Ext.container.Container" class="docClass">Ext.container.Container</a>.<a href="Ext.container.Container.html#getComponent" rel="Ext.container.Container#getComponent" class="docClass">getComponent</a> which will retrieve
606 <code>itemId</code>'s or <tt><a href="Ext.form.field.ComboBox.html#id" rel="Ext.form.field.ComboBox#id" class="docClass">id</a></tt>'s. Since <code>itemId</code>'s are an index to the
607 container's internal MixedCollection, the <code>itemId</code> is scoped locally to the container --
608 avoiding potential conflicts with <a href="Ext.ComponentManager.html" rel="Ext.ComponentManager" class="docClass">Ext.ComponentManager</a> which requires a <b>unique</b>
609 <code><a href="Ext.form.field.ComboBox.html#id" rel="Ext.form.field.ComboBox#id" class="docClass">id</a></code>.</p>
610
611
612 <pre><code>var c = new Ext.panel.Panel({ //
613     <a href="Ext.Component.html#height" rel="Ext.Component#height" class="docClass">height</a>: 300,
614     <a href="Ext.form.field.ComboBox.html#renderTo" rel="Ext.form.field.ComboBox#renderTo" class="docClass">renderTo</a>: document.body,
615     <a href="Ext.container.Container.html#layout" rel="Ext.container.Container#layout" class="docClass">layout</a>: 'auto',
616     <a href="Ext.container.Container.html#items" rel="Ext.container.Container#items" class="docClass">items</a>: [
617         {
618             itemId: 'p1',
619             <a href="Ext.panel.Panel.html#title" rel="Ext.panel.Panel#title" class="docClass">title</a>: 'Panel 1',
620             <a href="Ext.Component.html#height" rel="Ext.Component#height" class="docClass">height</a>: 150
621         },
622         {
623             itemId: 'p2',
624             <a href="Ext.panel.Panel.html#title" rel="Ext.panel.Panel#title" class="docClass">title</a>: 'Panel 2',
625             <a href="Ext.Component.html#height" rel="Ext.Component#height" class="docClass">height</a>: 150
626         }
627     ]
628 })
629 p1 = c.<a href="Ext.container.Container.html#getComponent" rel="Ext.container.Container#getComponent" class="docClass">getComponent</a>('p1'); // not the same as <a href="Ext.html#getCmp" rel="Ext#getCmp" class="docClass">Ext.getCmp()</a>
630 p2 = p1.<a href="Ext.form.field.ComboBox.html#ownerCt" rel="Ext.form.field.ComboBox#ownerCt" class="docClass">ownerCt</a>.<a href="Ext.container.Container.html#getComponent" rel="Ext.container.Container#getComponent" class="docClass">getComponent</a>('p2'); // reference via a sibling
631 </code></pre>
632
633
634 <p>Also see <tt><a href="Ext.form.field.ComboBox.html#id" rel="Ext.form.field.ComboBox#id" class="docClass">id</a></tt>, <code><a href="Ext.form.field.ComboBox.html#query" rel="Ext.form.field.ComboBox#query" class="docClass">query</a></code>, <code><a href="Ext.form.field.ComboBox.html#down" rel="Ext.form.field.ComboBox#down" class="docClass">down</a></code> and <code><a href="Ext.form.field.ComboBox.html#child" rel="Ext.form.field.ComboBox#child" class="docClass">child</a></code>.</p>
635
636
637 <p><b>Note</b>: to access the container of an item see <tt><a href="Ext.form.field.ComboBox.html#ownerCt" rel="Ext.form.field.ComboBox#ownerCt" class="docClass">ownerCt</a></tt>.</p>
638
639 </div></div></div><div id="config-labelAlign" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-labelAlign" rel="config-labelAlign" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-labelAlign" class="viewSource">view source</a></div><a name="labelAlign"></a><a name="config-labelAlign"></a><a href="Ext.form.field.ComboBox.html#" rel="config-labelAlign" class="cls expand">labelAlign</a><span> : String</span></div><div class="description"><div class="short">Controls the position and alignment of the fieldLabel. Valid values are:
640
641
642
643 "left" (the default) - The label is posit...</div><div class="long"><p>Controls the position and alignment of the <a href="Ext.form.field.ComboBox.html#fieldLabel" rel="Ext.form.field.ComboBox#fieldLabel" class="docClass">fieldLabel</a>. Valid values are:</p>
644
645
646 <ul>
647 <li><tt>"left"</tt> (the default) - The label is positioned to the left of the field, with its text
648 aligned to the left. Its width is determined by the <a href="Ext.form.field.ComboBox.html#labelWidth" rel="Ext.form.field.ComboBox#labelWidth" class="docClass">labelWidth</a> config.</li>
649 <li><tt>"top"</tt> - The label is positioned above the field.</li>
650 <li><tt>"right"</tt> - The label is positioned to the left of the field, with its text aligned
651 to the right. Its width is determined by the <a href="Ext.form.field.ComboBox.html#labelWidth" rel="Ext.form.field.ComboBox#labelWidth" class="docClass">labelWidth</a> config.</li>
652 </ul>
653
654 </div></div></div><div id="config-labelCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-labelCls" rel="config-labelCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-labelCls" class="viewSource">view source</a></div><a name="labelCls"></a><a name="config-labelCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-labelCls" class="cls expand">labelCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to be applied to the label element. Defaults to 'x-form-item-label'.</p>
655 </div><div class="long"><p>The CSS class to be applied to the label element. Defaults to 'x-form-item-label'.</p>
656 </div></div></div><div id="config-labelPad" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-labelPad" rel="config-labelPad" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-labelPad" class="viewSource">view source</a></div><a name="labelPad"></a><a name="config-labelPad"></a><a href="Ext.form.field.ComboBox.html#" rel="config-labelPad" class="cls expand">labelPad</a><span> : Number</span></div><div class="description"><div class="short"><p>The amount of space in pixels between the <a href="Ext.form.field.ComboBox.html#fieldLabel" rel="Ext.form.field.ComboBox#fieldLabel" class="docClass">fieldLabel</a> and the input field. Defaults to <tt>5</tt>.</p>
657 </div><div class="long"><p>The amount of space in pixels between the <a href="Ext.form.field.ComboBox.html#fieldLabel" rel="Ext.form.field.ComboBox#fieldLabel" class="docClass">fieldLabel</a> and the input field. Defaults to <tt>5</tt>.</p>
658 </div></div></div><div id="config-labelSeparator" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-labelSeparator" rel="config-labelSeparator" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-labelSeparator" class="viewSource">view source</a></div><a name="labelSeparator"></a><a name="config-labelSeparator"></a><a href="Ext.form.field.ComboBox.html#" rel="config-labelSeparator" class="cls expand">labelSeparator</a><span> : String</span></div><div class="description"><div class="short"><p>Character(s) to be inserted at the end of the <a href="Ext.form.field.ComboBox.html#fieldLabel" rel="Ext.form.field.ComboBox#fieldLabel" class="docClass">label text</a>.</p>
659 </div><div class="long"><p>Character(s) to be inserted at the end of the <a href="Ext.form.field.ComboBox.html#fieldLabel" rel="Ext.form.field.ComboBox#fieldLabel" class="docClass">label text</a>.</p>
660 </div></div></div><div id="config-labelStyle" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-labelStyle" rel="config-labelStyle" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-labelStyle" class="viewSource">view source</a></div><a name="labelStyle"></a><a name="config-labelStyle"></a><a href="Ext.form.field.ComboBox.html#" rel="config-labelStyle" class="cls expand">labelStyle</a><span> : String</span></div><div class="description"><div class="short"><p>A CSS style specification string to apply directly to this field's label. Defaults to undefined.</p>
661
662 </div><div class="long"><p>A CSS style specification string to apply directly to this field's label. Defaults to undefined.</p>
663
664 </div></div></div><div id="config-labelWidth" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-labelWidth" rel="config-labelWidth" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-labelWidth" class="viewSource">view source</a></div><a name="labelWidth"></a><a name="config-labelWidth"></a><a href="Ext.form.field.ComboBox.html#" rel="config-labelWidth" class="cls expand">labelWidth</a><span> : Number</span></div><div class="description"><div class="short"><p>The width of the <a href="Ext.form.field.ComboBox.html#fieldLabel" rel="Ext.form.field.ComboBox#fieldLabel" class="docClass">fieldLabel</a> in pixels. Only applicable if the <a href="Ext.form.field.ComboBox.html#labelAlign" rel="Ext.form.field.ComboBox#labelAlign" class="docClass">labelAlign</a> is set
665 to "left" or "right". Defaults to <tt>100</tt>.</p>
666 </div><div class="long"><p>The width of the <a href="Ext.form.field.ComboBox.html#fieldLabel" rel="Ext.form.field.ComboBox#fieldLabel" class="docClass">fieldLabel</a> in pixels. Only applicable if the <a href="Ext.form.field.ComboBox.html#labelAlign" rel="Ext.form.field.ComboBox#labelAlign" class="docClass">labelAlign</a> is set
667 to "left" or "right". Defaults to <tt>100</tt>.</p>
668 </div></div></div><div id="config-labelableRenderTpl" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-labelableRenderTpl" rel="config-labelableRenderTpl" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-labelableRenderTpl" class="viewSource">view source</a></div><a name="labelableRenderTpl"></a><a name="config-labelableRenderTpl"></a><a href="Ext.form.field.ComboBox.html#" rel="config-labelableRenderTpl" class="cls expand">labelableRenderTpl</a><span> : Array/String/Ext.XTemplate</span></div><div class="description"><div class="short">The rendering template for the field decorations. Component classes using this mixin should include
669 logic to use this...</div><div class="long"><p>The rendering template for the field decorations. Component classes using this mixin should include
670 logic to use this as their <a href="Ext.AbstractComponent.html#renderTpl" rel="Ext.AbstractComponent#renderTpl" class="docClass">renderTpl</a>, and implement the
671 <a href="Ext.form.field.ComboBox.html#getSubTplMarkup" rel="Ext.form.field.ComboBox#getSubTplMarkup" class="docClass">getSubTplMarkup</a> method to generate the field body content.</p>
672 </div></div></div><div id="config-listConfig" class="member ni"><a href="Ext.form.field.ComboBox.html#config-listConfig" rel="config-listConfig" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-listConfig" class="viewSource">view source</a></div><a name="listConfig"></a><a name="config-listConfig"></a><a href="Ext.form.field.ComboBox.html#" rel="config-listConfig" class="cls expand">listConfig</a><span> : Object</span></div><div class="description"><div class="short">An optional set of configuration properties that will be passed to the Ext.view.BoundList's
673 constructor. Any configur...</div><div class="long"><p>An optional set of configuration properties that will be passed to the <a href="Ext.view.BoundList.html" rel="Ext.view.BoundList" class="docClass">Ext.view.BoundList</a>'s
674 constructor. Any configuration that is valid for BoundList can be included. Some of the more useful
675 ones are:</p>
676
677
678 <ul>
679     <li><a href="Ext.view.BoundList.html#cls" rel="Ext.view.BoundList#cls" class="docClass">Ext.view.BoundList.cls</a> - defaults to empty</li>
680     <li><a href="Ext.view.BoundList.html#emptyText" rel="Ext.view.BoundList#emptyText" class="docClass">Ext.view.BoundList.emptyText</a> - defaults to empty string</li>
681     <li><a href="Ext.view.BoundList.html#getInnerTpl" rel="Ext.view.BoundList#getInnerTpl" class="docClass">Ext.view.BoundList.getInnerTpl</a> - defaults to the template defined in BoundList</li>
682     <li><a href="Ext.view.BoundList.html#itemSelector" rel="Ext.view.BoundList#itemSelector" class="docClass">Ext.view.BoundList.itemSelector</a> - defaults to the value defined in BoundList</li>
683     <li><a href="Ext.view.BoundList.html#loadingText" rel="Ext.view.BoundList#loadingText" class="docClass">Ext.view.BoundList.loadingText</a> - defaults to <tt>'Loading...'</tt></li>
684     <li><a href="Ext.view.BoundList.html#minWidth" rel="Ext.view.BoundList#minWidth" class="docClass">Ext.view.BoundList.minWidth</a> - defaults to <tt>70</tt></li>
685     <li><a href="Ext.view.BoundList.html#maxWidth" rel="Ext.view.BoundList#maxWidth" class="docClass">Ext.view.BoundList.maxWidth</a> - defaults to <tt>undefined</tt></li>
686     <li><a href="Ext.view.BoundList.html#maxHeight" rel="Ext.view.BoundList#maxHeight" class="docClass">Ext.view.BoundList.maxHeight</a> - defaults to <tt>300</tt></li>
687     <li><a href="Ext.view.BoundList.html#resizable" rel="Ext.view.BoundList#resizable" class="docClass">Ext.view.BoundList.resizable</a> - defaults to <tt>false</tt></li>
688     <li><a href="Ext.view.BoundList.html#shadow" rel="Ext.view.BoundList#shadow" class="docClass">Ext.view.BoundList.shadow</a> - defaults to <tt>'sides'</tt></li>
689     <li><a href="Ext.view.BoundList.html#width" rel="Ext.view.BoundList#width" class="docClass">Ext.view.BoundList.width</a> - defaults to <tt>undefined</tt> (automatically set to the width
690         of the ComboBox field if <a href="Ext.form.field.ComboBox.html#matchFieldWidth" rel="Ext.form.field.ComboBox#matchFieldWidth" class="docClass">matchFieldWidth</a> is true)</li>
691 </ul>
692
693 </div></div></div><div id="config-listeners" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-listeners" rel="config-listeners" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-cfg-listeners" class="viewSource">view source</a></div><a name="listeners"></a><a name="config-listeners"></a><a href="Ext.form.field.ComboBox.html#" rel="config-listeners" class="cls expand">listeners</a><span> : Object</span></div><div class="description"><div class="short">(optional) A config object containing one or more event handlers to be added to this
694 object during initialization.  T...</div><div class="long"><p>(optional) <p>A config object containing one or more event handlers to be added to this
695 object during initialization.  This should be a valid listeners config object as specified in the
696 <a href="Ext.form.field.ComboBox.html#addListener" rel="Ext.form.field.ComboBox#addListener" class="docClass">addListener</a> example for attaching multiple handlers at once.</p></p>
697
698 <br><p><b><u>DOM events from ExtJs <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Components</a></u></b></p>
699
700
701 <br><p>While <i>some</i> ExtJs Component classes export selected DOM events (e.g. "click", "mouseover" etc), this
702
703
704 <p>is usually only done when extra value can be added. For example the <a href="Ext.view.View.html" rel="Ext.view.View" class="docClass">DataView</a>'s
705 <b><code><a href="Ext.view.View.html#click" rel="Ext.view.View#click" class="docClass">click</a></code></b> event passing the node clicked on. To access DOM
706 events directly from a child element of a Component, we need to specify the <code>element</code> option to
707 identify the Component property to add a DOM listener to:</p>
708
709 <pre><code>new Ext.panel.Panel({
710     width: 400,
711     height: 200,
712     dockedItems: [{
713         xtype: 'toolbar'
714     }],
715     listeners: {
716         click: {
717             element: 'el', //bind to the underlying el property on the panel
718             fn: function(){ console.log('click el'); }
719         },
720         dblclick: {
721             element: 'body', //bind to the underlying body property on the panel
722             fn: function(){ console.log('dblclick body'); }
723         }
724     }
725 });
726 </code></pre>
727
728
729 <p></p></p>
730 </div></div></div><div id="config-loader" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-loader" rel="config-loader" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-loader" class="viewSource">view source</a></div><a name="loader"></a><a name="config-loader"></a><a href="Ext.form.field.ComboBox.html#" rel="config-loader" class="cls expand">loader</a><span> : Ext.ComponentLoader/Object</span></div><div class="description"><div class="short"><p>A configuration object or an instance of a <a href="Ext.ComponentLoader.html" rel="Ext.ComponentLoader" class="docClass">Ext.ComponentLoader</a> to load remote
731 content for this Component.</p>
732 </div><div class="long"><p>A configuration object or an instance of a <a href="Ext.ComponentLoader.html" rel="Ext.ComponentLoader" class="docClass">Ext.ComponentLoader</a> to load remote
733 content for this Component.</p>
734 </div></div></div><div id="config-maintainFlex" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-maintainFlex" rel="config-maintainFlex" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-cfg-maintainFlex" class="viewSource">view source</a></div><a name="maintainFlex"></a><a name="config-maintainFlex"></a><a href="Ext.form.field.ComboBox.html#" rel="config-maintainFlex" class="cls expand">maintainFlex</a><span> : Boolean</span></div><div class="description"><div class="short">Only valid when a sibling element of a Splitter within a VBox or
735 HBox layout.
736
737
738 Specifies that if an immediate siblin...</div><div class="long"><p><b>Only valid when a sibling element of a <a href="Ext.resizer.Splitter.html" rel="Ext.resizer.Splitter" class="docClass">Splitter</a> within a <a href="Ext.layout.container.VBox.html" rel="Ext.layout.container.VBox" class="docClass">VBox</a> or
739 <a href="Ext.layout.container.HBox.html" rel="Ext.layout.container.HBox" class="docClass">HBox</a> layout.</b></p>
740
741
742 <p>Specifies that if an immediate sibling Splitter is moved, the Component on the <i>other</i> side is resized, and this
743 Component maintains its configured <a href="Ext.layout.container.Box.html#flex" rel="Ext.layout.container.Box#flex" class="docClass">flex</a> value.</p>
744
745 </div></div></div><div id="config-margin" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-margin" rel="config-margin" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-margin" class="viewSource">view source</a></div><a name="margin"></a><a name="config-margin"></a><a href="Ext.form.field.ComboBox.html#" rel="config-margin" class="cls expand">margin</a><span> : Number/String</span></div><div class="description"><div class="short">Specifies the margin for this component. The margin can be a single numeric value to apply to all sides or
746 it can be ...</div><div class="long"><p>Specifies the margin for this component. The margin can be a single numeric value to apply to all sides or
747 it can be a CSS style specification for each style, for example: '10 5 3 10'.</p>
748 </div></div></div><div id="config-maskRe" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-maskRe" rel="config-maskRe" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-maskRe" class="viewSource">view source</a></div><a name="maskRe"></a><a name="config-maskRe"></a><a href="Ext.form.field.ComboBox.html#" rel="config-maskRe" class="cls expand">maskRe</a><span> : RegExp</span></div><div class="description"><div class="short"><p>An input mask regular expression that will be used to filter keystrokes that do
749 not match (defaults to <tt>undefined</tt>)</p>
750 </div><div class="long"><p>An input mask regular expression that will be used to filter keystrokes that do
751 not match (defaults to <tt>undefined</tt>)</p>
752 </div></div></div><div id="config-matchFieldWidth" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-matchFieldWidth" rel="config-matchFieldWidth" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Picker.html" class="definedIn docClass">Ext.form.field.Picker</a><br/><a href="../source/Picker.html#Ext-form.field.Picker-cfg-matchFieldWidth" class="viewSource">view source</a></div><a name="matchFieldWidth"></a><a name="config-matchFieldWidth"></a><a href="Ext.form.field.ComboBox.html#" rel="config-matchFieldWidth" class="cls expand">matchFieldWidth</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Whether the picker dropdown's width should be explicitly set to match the width of the field.
753 Defaults to <tt>true</tt>.</p>
754 </div><div class="long"><p>Whether the picker dropdown's width should be explicitly set to match the width of the field.
755 Defaults to <tt>true</tt>.</p>
756 </div></div></div><div id="config-maxHeight" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-maxHeight" rel="config-maxHeight" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-maxHeight" class="viewSource">view source</a></div><a name="maxHeight"></a><a name="config-maxHeight"></a><a href="Ext.form.field.ComboBox.html#" rel="config-maxHeight" class="cls expand">maxHeight</a><span> : Number</span></div><div class="description"><div class="short">The maximum value in pixels which this Component will set its height to.
757
758
759 Warning: This will override any size manag...</div><div class="long"><p>The maximum value in pixels which this Component will set its height to.</p>
760
761
762 <p><b>Warning:</b> This will override any size management applied by layout managers.</p>
763
764 </div></div></div><div id="config-maxLength" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-maxLength" rel="config-maxLength" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-maxLength" class="viewSource">view source</a></div><a name="maxLength"></a><a name="config-maxLength"></a><a href="Ext.form.field.ComboBox.html#" rel="config-maxLength" class="cls expand">maxLength</a><span> : Number</span></div><div class="description"><div class="short">Maximum input field length allowed by validation (defaults to Number.MAX_VALUE).
765 This behavior is intended to provide...</div><div class="long"><p>Maximum input field length allowed by validation (defaults to Number.MAX_VALUE).
766 This behavior is intended to provide instant feedback to the user by improving usability to allow pasting
767 and editing or overtyping and back tracking. To restrict the maximum number of characters that can be
768 entered into the field use the <tt><b><a href="Ext.form.field.Text.html#enforceMaxLength" rel="Ext.form.field.Text#enforceMaxLength" class="docClass">enforceMaxLength</a></b></tt> option.</p>
769 </div></div></div><div id="config-maxLengthText" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-maxLengthText" rel="config-maxLengthText" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-maxLengthText" class="viewSource">view source</a></div><a name="maxLengthText"></a><a name="config-maxLengthText"></a><a href="Ext.form.field.ComboBox.html#" rel="config-maxLengthText" class="cls expand">maxLengthText</a><span> : String</span></div><div class="description"><div class="short">Error text to display if the maximum length
770 validation fails (defaults to 'The maximum length for this field is {maxL...</div><div class="long"><p>Error text to display if the <b><tt><a href="Ext.form.field.ComboBox.html#maxLength" rel="Ext.form.field.ComboBox#maxLength" class="docClass">maximum length</a></tt></b>
771 validation fails (defaults to <tt>'The maximum length for this field is {maxLength}'</tt>)</p>
772 </div></div></div><div id="config-maxWidth" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-maxWidth" rel="config-maxWidth" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-maxWidth" class="viewSource">view source</a></div><a name="maxWidth"></a><a name="config-maxWidth"></a><a href="Ext.form.field.ComboBox.html#" rel="config-maxWidth" class="cls expand">maxWidth</a><span> : Number</span></div><div class="description"><div class="short">The maximum value in pixels which this Component will set its width to.
773
774
775 Warning: This will override any size manage...</div><div class="long"><p>The maximum value in pixels which this Component will set its width to.</p>
776
777
778 <p><b>Warning:</b> This will override any size management applied by layout managers.</p>
779
780 </div></div></div><div id="config-minChars" class="member ni"><a href="Ext.form.field.ComboBox.html#config-minChars" rel="config-minChars" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-minChars" class="viewSource">view source</a></div><a name="minChars"></a><a name="config-minChars"></a><a href="Ext.form.field.ComboBox.html#" rel="config-minChars" class="cls expand">minChars</a><span> : Number</span></div><div class="description"><div class="short">The minimum number of characters the user must type before autocomplete and
781 typeAhead activate (defaults to 4 if quer...</div><div class="long"><p>The minimum number of characters the user must type before autocomplete and
782 <a href="Ext.form.field.ComboBox.html#typeAhead" rel="Ext.form.field.ComboBox#typeAhead" class="docClass">typeAhead</a> activate (defaults to <tt>4</tt> if <tt><a href="Ext.form.field.ComboBox.html#queryMode" rel="Ext.form.field.ComboBox#queryMode" class="docClass">queryMode</a> = 'remote'</tt> or <tt>0</tt> if
783 <tt><a href="Ext.form.field.ComboBox.html#queryMode" rel="Ext.form.field.ComboBox#queryMode" class="docClass">queryMode</a> = 'local'</tt>, does not apply if <tt><a href="Ext.form.field.Trigger.html#editable" rel="Ext.form.field.Trigger#editable" class="docClass">editable</a> = false</tt>).</p>
784 </div></div></div><div id="config-minHeight" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-minHeight" rel="config-minHeight" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-minHeight" class="viewSource">view source</a></div><a name="minHeight"></a><a name="config-minHeight"></a><a href="Ext.form.field.ComboBox.html#" rel="config-minHeight" class="cls expand">minHeight</a><span> : Number</span></div><div class="description"><div class="short">The minimum value in pixels which this Component will set its height to.
785
786
787 Warning: This will override any size manag...</div><div class="long"><p>The minimum value in pixels which this Component will set its height to.</p>
788
789
790 <p><b>Warning:</b> This will override any size management applied by layout managers.</p>
791
792 </div></div></div><div id="config-minLength" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-minLength" rel="config-minLength" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-minLength" class="viewSource">view source</a></div><a name="minLength"></a><a name="config-minLength"></a><a href="Ext.form.field.ComboBox.html#" rel="config-minLength" class="cls expand">minLength</a><span> : Number</span></div><div class="description"><div class="short"><p>Minimum input field length required (defaults to <tt>0</tt>)</p>
793 </div><div class="long"><p>Minimum input field length required (defaults to <tt>0</tt>)</p>
794 </div></div></div><div id="config-minLengthText" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-minLengthText" rel="config-minLengthText" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-minLengthText" class="viewSource">view source</a></div><a name="minLengthText"></a><a name="config-minLengthText"></a><a href="Ext.form.field.ComboBox.html#" rel="config-minLengthText" class="cls expand">minLengthText</a><span> : String</span></div><div class="description"><div class="short">Error text to display if the minimum length
795 validation fails (defaults to 'The minimum length for this field is {minL...</div><div class="long"><p>Error text to display if the <b><tt><a href="Ext.form.field.ComboBox.html#minLength" rel="Ext.form.field.ComboBox#minLength" class="docClass">minimum length</a></tt></b>
796 validation fails (defaults to <tt>'The minimum length for this field is {minLength}'</tt>)</p>
797 </div></div></div><div id="config-minWidth" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-minWidth" rel="config-minWidth" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-minWidth" class="viewSource">view source</a></div><a name="minWidth"></a><a name="config-minWidth"></a><a href="Ext.form.field.ComboBox.html#" rel="config-minWidth" class="cls expand">minWidth</a><span> : Number</span></div><div class="description"><div class="short">The minimum value in pixels which this Component will set its width to.
798
799
800 Warning: This will override any size manage...</div><div class="long"><p>The minimum value in pixels which this Component will set its width to.</p>
801
802
803 <p><b>Warning:</b> This will override any size management applied by layout managers.</p>
804
805 </div></div></div><div id="config-msgTarget" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-msgTarget" rel="config-msgTarget" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-msgTarget" class="viewSource">view source</a></div><a name="msgTarget"></a><a name="config-msgTarget"></a><a href="Ext.form.field.ComboBox.html#" rel="config-msgTarget" class="cls expand">msgTarget</a><span> : String</span></div><div class="description"><div class="short">The location where the error message text should display.
806 Must be one of the following values:
807
808
809
810 qtip Display a quic...</div><div class="long"><p>The location where the error message text should display.
811 Must be one of the following values:</p>
812
813
814 <div class="mdetail-params"><ul>
815 <li><code>qtip</code> Display a quick tip containing the message when the user hovers over the field. This is the default.
816 <div class="subdesc"><b><a href="Ext.tip.QuickTipManager.html#init" rel="Ext.tip.QuickTipManager#init" class="docClass">Ext.tip.QuickTipManager.init</a> must have been called for this setting to work.</b></div></li>
817 <li><code>title</code> Display the message in a default browser title attribute popup.</li>
818 <li><code>under</code> Add a block div beneath the field containing the error message.</li>
819 <li><code>side</code> Add an error icon to the right of the field, displaying the message in a popup on hover.</li>
820 <li><code>none</code> Don't display any error message. This might be useful if you are implementing custom error display.</li>
821 <li><code>[element id]</code> Add the error message directly to the innerHTML of the specified element.</li>
822 </ul></div>
823
824 </div></div></div><div id="config-multiSelect" class="member ni"><a href="Ext.form.field.ComboBox.html#config-multiSelect" rel="config-multiSelect" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-multiSelect" class="viewSource">view source</a></div><a name="multiSelect"></a><a name="config-multiSelect"></a><a href="Ext.form.field.ComboBox.html#" rel="config-multiSelect" class="cls expand">multiSelect</a><span> : Boolean</span></div><div class="description"><div class="short">If set to true, allows the combo field to hold more than one value at a time, and allows selecting
825 multiple items fro...</div><div class="long"><p>If set to <tt>true</tt>, allows the combo field to hold more than one value at a time, and allows selecting
826 multiple items from the dropdown list. The combo's text field will show all selected values separated by
827 the <a href="Ext.form.field.ComboBox.html#delimiter" rel="Ext.form.field.ComboBox#delimiter" class="docClass">delimiter</a>. (Defaults to <tt>false</tt>.)</p>
828 </div></div></div><div id="config-name" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-name" rel="config-name" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-cfg-name" class="viewSource">view source</a></div><a name="name"></a><a name="config-name"></a><a href="Ext.form.field.ComboBox.html#" rel="config-name" class="cls expand">name</a><span> : String</span></div><div class="description"><div class="short">The name of the field (defaults to undefined). By default this is used as the parameter
829 name when including the field...</div><div class="long"><p>The name of the field (defaults to undefined). By default this is used as the parameter
830 name when including the <a href="Ext.form.field.ComboBox.html#getSubmitData" rel="Ext.form.field.ComboBox#getSubmitData" class="docClass">field value</a> in a <a href="Ext.form.Basic.html#submit" rel="Ext.form.Basic#submit" class="docClass">form submit()</a>.
831 To prevent the field from being included in the form submit, set <a href="Ext.form.field.ComboBox.html#submitValue" rel="Ext.form.field.ComboBox#submitValue" class="docClass">submitValue</a> to <tt>false</tt>.</p>
832 </div></div></div><div id="config-openCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-openCls" rel="config-openCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Picker.html" class="definedIn docClass">Ext.form.field.Picker</a><br/><a href="../source/Picker.html#Ext-form.field.Picker-cfg-openCls" class="viewSource">view source</a></div><a name="openCls"></a><a name="config-openCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-openCls" class="cls expand">openCls</a><span> : String</span></div><div class="description"><div class="short"><p>A class to be added to the field's <a href="Ext.form.field.ComboBox.html#bodyEl" rel="Ext.form.field.ComboBox#bodyEl" class="docClass">bodyEl</a> element when the picker is opened. Defaults
833 to 'x-pickerfield-open'.</p>
834 </div><div class="long"><p>A class to be added to the field's <a href="Ext.form.field.ComboBox.html#bodyEl" rel="Ext.form.field.ComboBox#bodyEl" class="docClass">bodyEl</a> element when the picker is opened. Defaults
835 to 'x-pickerfield-open'.</p>
836 </div></div></div><div id="config-overCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-overCls" rel="config-overCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-overCls" class="viewSource">view source</a></div><a name="overCls"></a><a name="config-overCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-overCls" class="cls expand">overCls</a><span> : String</span></div><div class="description"><div class="short">An optional extra CSS class that will be added to this component's Element when the mouse moves
837 over the Element, and...</div><div class="long"><p>An optional extra CSS class that will be added to this component's Element when the mouse moves
838 over the Element, and removed when the mouse moves out. (defaults to '').  This can be
839 useful for adding customized 'active' or 'hover' styles to the component or any of its children using standard CSS rules.</p>
840 </div></div></div><div id="config-padding" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-padding" rel="config-padding" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-padding" class="viewSource">view source</a></div><a name="padding"></a><a name="config-padding"></a><a href="Ext.form.field.ComboBox.html#" rel="config-padding" class="cls expand">padding</a><span> : Number/String</span></div><div class="description"><div class="short">Specifies the padding for this component. The padding can be a single numeric value to apply to all sides or
841 it can b...</div><div class="long"><p>Specifies the padding for this component. The padding can be a single numeric value to apply to all sides or
842 it can be a CSS style specification for each style, for example: '10 5 3 10'.</p>
843 </div></div></div><div id="config-pageSize" class="member ni"><a href="Ext.form.field.ComboBox.html#config-pageSize" rel="config-pageSize" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-pageSize" class="viewSource">view source</a></div><a name="pageSize"></a><a name="config-pageSize"></a><a href="Ext.form.field.ComboBox.html#" rel="config-pageSize" class="cls expand">pageSize</a><span> : Number</span></div><div class="description"><div class="short">If greater than 0, a Ext.toolbar.Paging is displayed in the
844 footer of the dropdown list and the filter queries will e...</div><div class="long"><p>If greater than <tt>0</tt>, a <a href="Ext.toolbar.Paging.html" rel="Ext.toolbar.Paging" class="docClass">Ext.toolbar.Paging</a> is displayed in the
845 footer of the dropdown list and the <a href="Ext.form.field.ComboBox.html#doQuery" rel="Ext.form.field.ComboBox#doQuery" class="docClass">filter queries</a> will execute with page start and
846 <a href="Ext.toolbar.Paging.html#pageSize" rel="Ext.toolbar.Paging#pageSize" class="docClass">limit</a> parameters. Only applies when <tt><a href="Ext.form.field.ComboBox.html#queryMode" rel="Ext.form.field.ComboBox#queryMode" class="docClass">queryMode</a> = 'remote'</tt>
847 (defaults to <tt>0</tt>).</p>
848 </div></div></div><div id="config-pickerAlign" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-pickerAlign" rel="config-pickerAlign" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Picker.html" class="definedIn docClass">Ext.form.field.Picker</a><br/><a href="../source/Picker.html#Ext-form.field.Picker-cfg-pickerAlign" class="viewSource">view source</a></div><a name="pickerAlign"></a><a name="config-pickerAlign"></a><a href="Ext.form.field.ComboBox.html#" rel="config-pickerAlign" class="cls expand">pickerAlign</a><span> : String</span></div><div class="description"><div class="short"><p>The <a href="Ext.core.Element.html#alignTo" rel="Ext.core.Element#alignTo" class="docClass">alignment position</a> with which to align the picker. Defaults
849 to <tt>"tl-bl?"</tt></p>
850 </div><div class="long"><p>The <a href="Ext.core.Element.html#alignTo" rel="Ext.core.Element#alignTo" class="docClass">alignment position</a> with which to align the picker. Defaults
851 to <tt>"tl-bl?"</tt></p>
852 </div></div></div><div id="config-pickerOffset" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-pickerOffset" rel="config-pickerOffset" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Picker.html" class="definedIn docClass">Ext.form.field.Picker</a><br/><a href="../source/Picker.html#Ext-form.field.Picker-cfg-pickerOffset" class="viewSource">view source</a></div><a name="pickerOffset"></a><a name="config-pickerOffset"></a><a href="Ext.form.field.ComboBox.html#" rel="config-pickerOffset" class="cls expand">pickerOffset</a><span> : Array</span></div><div class="description"><div class="short"><p>An offset [x,y] to use in addition to the <a href="Ext.form.field.ComboBox.html#pickerAlign" rel="Ext.form.field.ComboBox#pickerAlign" class="docClass">pickerAlign</a> when positioning the picker.
853 Defaults to undefined.</p>
854 </div><div class="long"><p>An offset [x,y] to use in addition to the <a href="Ext.form.field.ComboBox.html#pickerAlign" rel="Ext.form.field.ComboBox#pickerAlign" class="docClass">pickerAlign</a> when positioning the picker.
855 Defaults to undefined.</p>
856 </div></div></div><div id="config-plugins" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-plugins" rel="config-plugins" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-plugins" class="viewSource">view source</a></div><a name="plugins"></a><a name="config-plugins"></a><a href="Ext.form.field.ComboBox.html#" rel="config-plugins" class="cls expand">plugins</a><span> : Object/Array</span></div><div class="description"><div class="short">An object or array of objects that will provide custom functionality for this component.  The only
857 requirement for a ...</div><div class="long"><p>An object or array of objects that will provide custom functionality for this component.  The only
858 requirement for a valid plugin is that it contain an init method that accepts a reference of type <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a>.
859 When a component is created, if any plugins are available, the component will call the init method on each
860 plugin, passing a reference to itself.  Each plugin can then call methods or respond to events on the
861 component as needed to provide its functionality.</p>
862 </div></div></div><div id="config-preventMark" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-preventMark" rel="config-preventMark" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-preventMark" class="viewSource">view source</a></div><a name="preventMark"></a><a name="config-preventMark"></a><a href="Ext.form.field.ComboBox.html#" rel="config-preventMark" class="cls expand">preventMark</a><span> : Boolean</span></div><div class="description"><div class="short"><p><tt>true</tt> to disable displaying any <a href="Ext.form.field.ComboBox.html#setActiveError" rel="Ext.form.field.ComboBox#setActiveError" class="docClass">error message</a> set on this object.
863 Defaults to <tt>false</tt>.</p>
864 </div><div class="long"><p><tt>true</tt> to disable displaying any <a href="Ext.form.field.ComboBox.html#setActiveError" rel="Ext.form.field.ComboBox#setActiveError" class="docClass">error message</a> set on this object.
865 Defaults to <tt>false</tt>.</p>
866 </div></div></div><div id="config-queryDelay" class="member ni"><a href="Ext.form.field.ComboBox.html#config-queryDelay" rel="config-queryDelay" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-queryDelay" class="viewSource">view source</a></div><a name="queryDelay"></a><a name="config-queryDelay"></a><a href="Ext.form.field.ComboBox.html#" rel="config-queryDelay" class="cls expand">queryDelay</a><span> : Number</span></div><div class="description"><div class="short">The length of time in milliseconds to delay between the start of typing and
867 sending the query to filter the dropdown ...</div><div class="long"><p>The length of time in milliseconds to delay between the start of typing and
868 sending the query to filter the dropdown list (defaults to <tt>500</tt> if <tt><a href="Ext.form.field.ComboBox.html#queryMode" rel="Ext.form.field.ComboBox#queryMode" class="docClass">queryMode</a> = 'remote'</tt>
869 or <tt>10</tt> if <tt><a href="Ext.form.field.ComboBox.html#queryMode" rel="Ext.form.field.ComboBox#queryMode" class="docClass">queryMode</a> = 'local'</tt>)</p>
870 </div></div></div><div id="config-queryMode" class="member ni"><a href="Ext.form.field.ComboBox.html#config-queryMode" rel="config-queryMode" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-queryMode" class="viewSource">view source</a></div><a name="queryMode"></a><a name="config-queryMode"></a><a href="Ext.form.field.ComboBox.html#" rel="config-queryMode" class="cls expand">queryMode</a><span> : String</span></div><div class="description"><div class="short">The mode for queries. Acceptable values are:
871
872
873 'remote' : Default
874 Automatically loads the store the first time the tr...</div><div class="long"><p>The mode for queries. Acceptable values are:</p>
875
876 <div class="mdetail-params"><ul>
877 <li><b><tt>'remote'</tt></b> : <b>Default</b>
878 <p class="sub-desc">Automatically loads the <tt><a href="Ext.form.field.ComboBox.html#store" rel="Ext.form.field.ComboBox#store" class="docClass">store</a></tt> the <b>first</b> time the trigger
879 is clicked. If you do not want the store to be automatically loaded the first time the trigger is
880 clicked, set to <tt>'local'</tt> and manually load the store.  To force a requery of the store
881 <b>every</b> time the trigger is clicked see <tt><a href="Ext.form.field.ComboBox.html#lastQuery" rel="Ext.form.field.ComboBox#lastQuery" class="docClass">lastQuery</a></tt>.</p></li>
882 <li><b><tt>'local'</tt></b> :
883 <p class="sub-desc">ComboBox loads local data</p>
884 <pre><code>var combo = new Ext.form.field.ComboBox({
885     renderTo: document.body,
886     queryMode: 'local',
887     store: new Ext.data.ArrayStore({
888         id: 0,
889         fields: [
890             'myId',  // numeric value is the key
891             'displayText'
892         ],
893         data: [[1, 'item1'], [2, 'item2']]  // data is local
894     }),
895     valueField: 'myId',
896     displayField: 'displayText',
897     triggerAction: 'all'
898 });
899 </code></pre></li>
900 </ul></div>
901
902 </div></div></div><div id="config-queryParam" class="member ni"><a href="Ext.form.field.ComboBox.html#config-queryParam" rel="config-queryParam" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-queryParam" class="viewSource">view source</a></div><a name="queryParam"></a><a name="config-queryParam"></a><a href="Ext.form.field.ComboBox.html#" rel="config-queryParam" class="cls expand">queryParam</a><span> : String</span></div><div class="description"><div class="short"><p>Name of the query (<a href="Ext.data.Store.html#baseParam" rel="Ext.data.Store#baseParam" class="docClass">baseParam</a> name for the store)
903 as it will be passed on the querystring (defaults to <tt>'query'</tt>)</p>
904 </div><div class="long"><p>Name of the query (<a href="Ext.data.Store.html#baseParam" rel="Ext.data.Store#baseParam" class="docClass">baseParam</a> name for the store)
905 as it will be passed on the querystring (defaults to <tt>'query'</tt>)</p>
906 </div></div></div><div id="config-readOnly" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-readOnly" rel="config-readOnly" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Trigger.html" class="definedIn docClass">Ext.form.field.Trigger</a><br/><a href="../source/Trigger.html#Ext-form.field.Trigger-cfg-readOnly" class="viewSource">view source</a></div><a name="readOnly"></a><a name="config-readOnly"></a><a href="Ext.form.field.ComboBox.html#" rel="config-readOnly" class="cls expand">readOnly</a><span> : Boolean</span></div><div class="description"><div class="short">true to prevent the user from changing the field, and
907 hides the trigger.  Supercedes the editable and hideTrigger opt...</div><div class="long"><p><tt>true</tt> to prevent the user from changing the field, and
908 hides the trigger.  Supercedes the editable and hideTrigger options if the value is true.
909 (defaults to <tt>false</tt>)</p>
910 </div></div></div><div id="config-readOnlyCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-readOnlyCls" rel="config-readOnlyCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-readOnlyCls" class="viewSource">view source</a></div><a name="readOnlyCls"></a><a name="config-readOnlyCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-readOnlyCls" class="cls expand">readOnlyCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class applied to the component's main element when it is <a href="Ext.form.field.ComboBox.html#readOnly" rel="Ext.form.field.ComboBox#readOnly" class="docClass">readOnly</a>.</p>
911 </div><div class="long"><p>The CSS class applied to the component's main element when it is <a href="Ext.form.field.ComboBox.html#readOnly" rel="Ext.form.field.ComboBox#readOnly" class="docClass">readOnly</a>.</p>
912 </div></div></div><div id="config-regex" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-regex" rel="config-regex" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-regex" class="viewSource">view source</a></div><a name="regex"></a><a name="config-regex"></a><a href="Ext.form.field.ComboBox.html#" rel="config-regex" class="cls expand">regex</a><span> : RegExp</span></div><div class="description"><div class="short">A JavaScript RegExp object to be tested against the field value during validation
913 (defaults to undefined). If the tes...</div><div class="long"><p>A JavaScript RegExp object to be tested against the field value during validation
914 (defaults to <tt>undefined</tt>). If the test fails, the field will be marked invalid using
915 <b><tt><a href="Ext.form.field.ComboBox.html#regexText" rel="Ext.form.field.ComboBox#regexText" class="docClass">regexText</a></tt></b>.</p>
916 </div></div></div><div id="config-regexText" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-regexText" rel="config-regexText" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-regexText" class="viewSource">view source</a></div><a name="regexText"></a><a name="config-regexText"></a><a href="Ext.form.field.ComboBox.html#" rel="config-regexText" class="cls expand">regexText</a><span> : String</span></div><div class="description"><div class="short"><p>The error text to display if <b><tt><a href="Ext.form.field.ComboBox.html#regex" rel="Ext.form.field.ComboBox#regex" class="docClass">regex</a></tt></b> is used and the
917 test fails during validation (defaults to <tt>''</tt>)</p>
918 </div><div class="long"><p>The error text to display if <b><tt><a href="Ext.form.field.ComboBox.html#regex" rel="Ext.form.field.ComboBox#regex" class="docClass">regex</a></tt></b> is used and the
919 test fails during validation (defaults to <tt>''</tt>)</p>
920 </div></div></div><div id="config-renderSelectors" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-renderSelectors" rel="config-renderSelectors" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-renderSelectors" class="viewSource">view source</a></div><a name="renderSelectors"></a><a name="config-renderSelectors"></a><a href="Ext.form.field.ComboBox.html#" rel="config-renderSelectors" class="cls expand">renderSelectors</a><span> : Object</span></div><div class="description"><div class="short">An object containing properties specifying DomQuery selectors which identify child elements
921 created by the render pro...</div><div class="long"><p>An object containing properties specifying <a href="Ext.DomQuery.html" rel="Ext.DomQuery" class="docClass">DomQuery</a> selectors which identify child elements
922 created by the render process.</p>
923
924 <p>After the Component's internal structure is rendered according to the <a href="Ext.form.field.ComboBox.html#renderTpl" rel="Ext.form.field.ComboBox#renderTpl" class="docClass">renderTpl</a>, this object is iterated through,
925 and the found Elements are added as properties to the Component using the <code>renderSelector</code> property name.</p>
926
927 <p>For example, a Component which rendered an image, and description into its element might use the following properties
928 coded into its prototype:</p>
929
930 <pre><code>renderTpl: '&amp;lt;img src="{imageUrl}" class="x-image-component-img"&gt;&amp;lt;div class="x-image-component-desc"&gt;{description}&amp;gt;/div&amp;lt;',
931
932 renderSelectors: {
933     image: 'img.x-image-component-img',
934     descEl: 'div.x-image-component-desc'
935 }
936 </code></pre>
937
938 <p>After rendering, the Component would have a property <code>image</code> referencing its child <code>img</code> Element,
939 and a property <code>descEl</code> referencing the <code>div</code> Element which contains the description.</p>
940 </div></div></div><div id="config-renderTo" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-renderTo" rel="config-renderTo" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-renderTo" class="viewSource">view source</a></div><a name="renderTo"></a><a name="config-renderTo"></a><a href="Ext.form.field.ComboBox.html#" rel="config-renderTo" class="cls expand">renderTo</a><span> : Mixed</span></div><div class="description"><div class="short">Specify the id of the element, a DOM element or an existing Element that this component
941 will be rendered into.
942
943
944
945 Not...</div><div class="long"><p>Specify the id of the element, a DOM element or an existing Element that this component
946 will be rendered into.</p>
947
948
949 <div><ul>
950 <li><b>Notes</b> : <ul>
951 <div class="sub-desc">Do <u>not</u> use this option if the Component is to be a child item of
952 a <a href="Ext.container.Container.html" rel="Ext.container.Container" class="docClass">Container</a>. It is the responsibility of the
953 <a href="Ext.container.Container.html" rel="Ext.container.Container" class="docClass">Container</a>'s <a href="Ext.container.Container.html#layout" rel="Ext.container.Container#layout" class="docClass">layout manager</a>
954 to render and manage its child items.</div>
955 <div class="sub-desc">When using this config, a call to render() is not required.</div>
956 </ul></li>
957 </ul></div>
958
959
960 <p>See <code><a href="Ext.form.field.ComboBox.html#render" rel="Ext.form.field.ComboBox#render" class="docClass">render</a></code> also.</p>
961
962 </div></div></div><div id="config-renderTpl" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-renderTpl" rel="config-renderTpl" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-renderTpl" class="viewSource">view source</a></div><a name="renderTpl"></a><a name="config-renderTpl"></a><a href="Ext.form.field.ComboBox.html#" rel="config-renderTpl" class="cls expand">renderTpl</a><span> : Mixed</span></div><div class="description"><div class="short">An XTemplate used to create the internal structure inside this Component's
963 encapsulating Element.
964
965
966 You do not normal...</div><div class="long"><p>An <a href="Ext.XTemplate.html" rel="Ext.XTemplate" class="docClass">XTemplate</a> used to create the internal structure inside this Component's
967 encapsulating <a href="Ext.form.field.ComboBox.html#getEl" rel="Ext.form.field.ComboBox#getEl" class="docClass">Element</a>.</p>
968
969
970 <p>You do not normally need to specify this. For the base classes <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a>
971 and <a href="Ext.container.Container.html" rel="Ext.container.Container" class="docClass">Ext.container.Container</a>, this defaults to <b><code>null</code></b> which means that they will be initially rendered
972 with no internal structure; they render their <a href="Ext.form.field.ComboBox.html#getEl" rel="Ext.form.field.ComboBox#getEl" class="docClass">Element</a> empty. The more specialized ExtJS and Touch classes
973 which use a more complex DOM structure, provide their own template definitions.</p>
974
975
976 <p>This is intended to allow the developer to create application-specific utility Components with customized
977 internal structure.</p>
978
979
980 <p>Upon rendering, any created child elements may be automatically imported into object properties using the
981 <a href="Ext.form.field.ComboBox.html#renderSelectors" rel="Ext.form.field.ComboBox#renderSelectors" class="docClass">renderSelectors</a> option.</p>
982
983 </div></div></div><div id="config-repeatTriggerClick" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-repeatTriggerClick" rel="config-repeatTriggerClick" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Trigger.html" class="definedIn docClass">Ext.form.field.Trigger</a><br/><a href="../source/Trigger.html#Ext-form.field.Trigger-cfg-repeatTriggerClick" class="viewSource">view source</a></div><a name="repeatTriggerClick"></a><a name="config-repeatTriggerClick"></a><a href="Ext.form.field.ComboBox.html#" rel="config-repeatTriggerClick" class="cls expand">repeatTriggerClick</a><span> : Boolean</span></div><div class="description"><div class="short"><p><tt>true</tt> to attach a <a href="Ext.util.ClickRepeater.html" rel="Ext.util.ClickRepeater" class="docClass">click repeater</a>
984 to the trigger. Defaults to <tt>false</tt>.</p>
985 </div><div class="long"><p><tt>true</tt> to attach a <a href="Ext.util.ClickRepeater.html" rel="Ext.util.ClickRepeater" class="docClass">click repeater</a>
986 to the trigger. Defaults to <tt>false</tt>.</p>
987 </div></div></div><div id="config-resizable" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-resizable" rel="config-resizable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-cfg-resizable" class="viewSource">view source</a></div><a name="resizable"></a><a name="config-resizable"></a><a href="Ext.form.field.ComboBox.html#" rel="config-resizable" class="cls expand">resizable</a><span> : Mixed</span></div><div class="description"><div class="short">Specify as true to apply a Resizer to this Component
988 after rendering.
989
990
991 May also be specified as a config object to b...</div><div class="long"><p>Specify as <code>true</code> to apply a <a href="Ext.resizer.Resizer.html" rel="Ext.resizer.Resizer" class="docClass">Resizer</a> to this Component
992 after rendering.</p>
993
994
995 <p>May also be specified as a config object to be passed to the constructor of <a href="Ext.resizer.Resizer.html" rel="Ext.resizer.Resizer" class="docClass">Resizer</a>
996 to override any defaults. By default the Component passes its minimum and maximum size, and uses
997 <code><a href="Ext.resizer.Resizer.html#dynamic" rel="Ext.resizer.Resizer#dynamic" class="docClass">Ext.resizer.Resizer.dynamic</a>: false</code></p>
998
999 </div></div></div><div id="config-resizeHandles" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-resizeHandles" rel="config-resizeHandles" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-cfg-resizeHandles" class="viewSource">view source</a></div><a name="resizeHandles"></a><a name="config-resizeHandles"></a><a href="Ext.form.field.ComboBox.html#" rel="config-resizeHandles" class="cls expand">resizeHandles</a><span> : String</span></div><div class="description"><div class="short"><p>A valid <a href="Ext.resizer.Resizer.html" rel="Ext.resizer.Resizer" class="docClass">Ext.resizer.Resizer</a> handles config string (defaults to 'all').  Only applies when resizable = true.</p>
1000 </div><div class="long"><p>A valid <a href="Ext.resizer.Resizer.html" rel="Ext.resizer.Resizer" class="docClass">Ext.resizer.Resizer</a> handles config string (defaults to 'all').  Only applies when resizable = true.</p>
1001 </div></div></div><div id="config-saveBuffer" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-saveBuffer" rel="config-saveBuffer" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-cfg-saveBuffer" class="viewSource">view source</a></div><a name="saveBuffer"></a><a name="config-saveBuffer"></a><a href="Ext.form.field.ComboBox.html#" rel="config-saveBuffer" class="cls expand">saveBuffer</a><span> : Number</span></div><div class="description"><div class="short"><p>A buffer to be applied if many state events are fired within
1002 a short period. Defaults to 100.</p>
1003 </div><div class="long"><p>A buffer to be applied if many state events are fired within
1004 a short period. Defaults to 100.</p>
1005 </div></div></div><div id="config-selectOnFocus" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-selectOnFocus" rel="config-selectOnFocus" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Trigger.html" class="definedIn docClass">Ext.form.field.Trigger</a><br/><a href="../source/Trigger.html#Ext-form.field.Trigger-cfg-selectOnFocus" class="viewSource">view source</a></div><a name="selectOnFocus"></a><a name="config-selectOnFocus"></a><a href="Ext.form.field.ComboBox.html#" rel="config-selectOnFocus" class="cls expand">selectOnFocus</a><span> : Boolean</span></div><div class="description"><div class="short">true to select any existing text in the field immediately on focus.
1006 Only applies when editable = true (defaults to fa...</div><div class="long"><p><tt>true</tt> to select any existing text in the field immediately on focus.
1007 Only applies when <tt><a href="Ext.form.field.ComboBox.html#editable" rel="Ext.form.field.ComboBox#editable" class="docClass">editable</a> = true</tt> (defaults to <tt>false</tt>).</p>
1008 </div></div></div><div id="config-selectOnTab" class="member ni"><a href="Ext.form.field.ComboBox.html#config-selectOnTab" rel="config-selectOnTab" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-selectOnTab" class="viewSource">view source</a></div><a name="selectOnTab"></a><a name="config-selectOnTab"></a><a href="Ext.form.field.ComboBox.html#" rel="config-selectOnTab" class="cls expand">selectOnTab</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Whether the Tab key should select the currently highlighted item. Defaults to <tt>true</tt>.</p>
1009 </div><div class="long"><p>Whether the Tab key should select the currently highlighted item. Defaults to <tt>true</tt>.</p>
1010 </div></div></div><div id="config-shadow" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-shadow" rel="config-shadow" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Floating.html" class="definedIn docClass">Ext.util.Floating</a><br/><a href="../source/Floating.html#Ext-util.Floating-cfg-shadow" class="viewSource">view source</a></div><a name="shadow"></a><a name="config-shadow"></a><a href="Ext.form.field.ComboBox.html#" rel="config-shadow" class="cls expand">shadow</a><span> : String/Boolean</span></div><div class="description"><div class="short">Specifies whether the floating component should be given a shadow. Set to
1011 true to automatically create an Ext.Shadow,...</div><div class="long"><p>Specifies whether the floating component should be given a shadow. Set to
1012 <tt>true</tt> to automatically create an <a href="Ext.Shadow.html" rel="Ext.Shadow" class="docClass">Ext.Shadow</a>, or a string indicating the
1013 shadow's display <a href="Ext.Shadow.html#mode" rel="Ext.Shadow#mode" class="docClass">Ext.Shadow.mode</a>. Set to <tt>false</tt> to disable the shadow.
1014 (Defaults to <tt>'sides'</tt>.)</p>
1015 </div></div></div><div id="config-size" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-size" rel="config-size" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-size" class="viewSource">view source</a></div><a name="size"></a><a name="config-size"></a><a href="Ext.form.field.ComboBox.html#" rel="config-size" class="cls expand">size</a><span> : Number</span></div><div class="description"><div class="short">An initial value for the 'size' attribute on the text input element. This is only
1016 used if the field has no configured...</div><div class="long"><p>An initial value for the 'size' attribute on the text input element. This is only
1017 used if the field has no configured <a href="Ext.form.field.ComboBox.html#width" rel="Ext.form.field.ComboBox#width" class="docClass">width</a> and is not given a width by its container's layout.
1018 Defaults to <tt>20</tt>.</p>
1019 </div></div></div><div id="config-stateEvents" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-stateEvents" rel="config-stateEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-cfg-stateEvents" class="viewSource">view source</a></div><a name="stateEvents"></a><a name="config-stateEvents"></a><a href="Ext.form.field.ComboBox.html#" rel="config-stateEvents" class="cls expand">stateEvents</a><span> : Array</span></div><div class="description"><div class="short">An array of events that, when fired, should trigger this object to
1020 save its state (defaults to none). stateEvents may...</div><div class="long"><p>An array of events that, when fired, should trigger this object to
1021 save its state (defaults to none). <code>stateEvents</code> may be any type
1022 of event supported by this object, including browser or custom events
1023 (e.g., <tt>['click', 'customerchange']</tt>).</p>
1024
1025
1026 <p>See <code><a href="Ext.form.field.ComboBox.html#stateful" rel="Ext.form.field.ComboBox#stateful" class="docClass">stateful</a></code> for an explanation of saving and
1027 restoring object state.</p>
1028
1029 </div></div></div><div id="config-stateId" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-stateId" rel="config-stateId" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-cfg-stateId" class="viewSource">view source</a></div><a name="stateId"></a><a name="config-stateId"></a><a href="Ext.form.field.ComboBox.html#" rel="config-stateId" class="cls expand">stateId</a><span> : String</span></div><div class="description"><div class="short">The unique id for this object to use for state management purposes.
1030
1031 See stateful for an explanation of saving and re...</div><div class="long"><p>The unique id for this object to use for state management purposes.</p>
1032
1033 <p>See <a href="Ext.form.field.ComboBox.html#stateful" rel="Ext.form.field.ComboBox#stateful" class="docClass">stateful</a> for an explanation of saving and restoring state.</p>
1034
1035 </div></div></div><div id="config-stateful" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-stateful" rel="config-stateful" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-cfg-stateful" class="viewSource">view source</a></div><a name="stateful"></a><a name="config-stateful"></a><a href="Ext.form.field.ComboBox.html#" rel="config-stateful" class="cls expand">stateful</a><span> : Boolean</span></div><div class="description"><div class="short">A flag which causes the object to attempt to restore the state of
1036 internal properties from a saved state on startup. ...</div><div class="long"><p>A flag which causes the object to attempt to restore the state of
1037 internal properties from a saved state on startup. The object must have
1038 a <code><a href="Ext.form.field.ComboBox.html#stateId" rel="Ext.form.field.ComboBox#stateId" class="docClass">stateId</a></code> for state to be managed. 
1039 Auto-generated ids are not guaranteed to be stable across page loads and 
1040 cannot be relied upon to save and restore the same state for a object.<p>
1041 <p>For state saving to work, the state manager's provider must have been
1042 set to an implementation of <a href="Ext.state.Provider.html" rel="Ext.state.Provider" class="docClass">Ext.state.Provider</a> which overrides the
1043 <a href="Ext.state.Provider.html#set" rel="Ext.state.Provider#set" class="docClass">set</a> and <a href="Ext.state.Provider.html#get" rel="Ext.state.Provider#get" class="docClass">get</a>
1044 methods to save and recall name/value pairs. A built-in implementation,
1045 <a href="Ext.state.CookieProvider.html" rel="Ext.state.CookieProvider" class="docClass">Ext.state.CookieProvider</a> is available.</p>
1046 <p>To set the state provider for the current page:</p>
1047 <pre><code>Ext.state.Manager.setProvider(new Ext.state.CookieProvider({
1048     expires: new Date(new Date().getTime()+(1000*60*60*24*7)), //7 days from now
1049 }));
1050 </code></pre>
1051 <p>A stateful object attempts to save state when one of the events
1052 listed in the <code><a href="Ext.form.field.ComboBox.html#stateEvents" rel="Ext.form.field.ComboBox#stateEvents" class="docClass">stateEvents</a></code> configuration fires.</p>
1053 <p>To save state, a stateful object first serializes its state by
1054 calling <b><code><a href="Ext.form.field.ComboBox.html#getState" rel="Ext.form.field.ComboBox#getState" class="docClass">getState</a></code></b>. By default, this function does
1055 nothing. The developer must provide an implementation which returns an
1056 object hash which represents the restorable state of the object.</p>
1057 <p>The value yielded by getState is passed to <a href="Ext.state.Manager.html#set" rel="Ext.state.Manager#set" class="docClass">Ext.state.Manager.set</a>
1058 which uses the configured <a href="Ext.state.Provider.html" rel="Ext.state.Provider" class="docClass">Ext.state.Provider</a> to save the object
1059 keyed by the <code><a href="stateId.html" rel="stateId" class="docClass">stateId</a></code></p>.
1060 <p>During construction, a stateful object attempts to <i>restore</i>
1061 its state by calling <a href="Ext.state.Manager.html#get" rel="Ext.state.Manager#get" class="docClass">Ext.state.Manager.get</a> passing the
1062 <code><a href="Ext.form.field.ComboBox.html#stateId" rel="Ext.form.field.ComboBox#stateId" class="docClass">stateId</a></code></p>
1063 <p>The resulting object is passed to <b><code><a href="Ext.form.field.ComboBox.html#applyState" rel="Ext.form.field.ComboBox#applyState" class="docClass">applyState</a></code></b>.
1064 The default implementation of <code><a href="Ext.form.field.ComboBox.html#applyState" rel="Ext.form.field.ComboBox#applyState" class="docClass">applyState</a></code> simply copies
1065 properties into the object, but a developer may override this to support
1066 more behaviour.</p>
1067 <p>You can perform extra processing on state save and restore by attaching
1068 handlers to the <a href="Ext.form.field.ComboBox.html#beforestaterestore" rel="Ext.form.field.ComboBox#beforestaterestore" class="docClass">beforestaterestore</a>, <a href="Ext.form.field.ComboBox.html#staterestore" rel="Ext.form.field.ComboBox#staterestore" class="docClass">staterestore</a>,
1069 <a href="Ext.form.field.ComboBox.html#beforestatesave" rel="Ext.form.field.ComboBox#beforestatesave" class="docClass">beforestatesave</a> and <a href="Ext.form.field.ComboBox.html#statesave" rel="Ext.form.field.ComboBox#statesave" class="docClass">statesave</a> events.</p>
1070
1071 </div></div></div><div id="config-store" class="member ni"><a href="Ext.form.field.ComboBox.html#config-store" rel="config-store" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-store" class="viewSource">view source</a></div><a name="store"></a><a name="config-store"></a><a href="Ext.form.field.ComboBox.html#" rel="config-store" class="cls expand">store</a><span> : Ext.data.Store/Array</span></div><div class="description"><div class="short">The data source to which this combo is bound (defaults to undefined).
1072 Acceptable values for this property are:
1073
1074
1075 any ...</div><div class="long"><p>The data source to which this combo is bound (defaults to <tt>undefined</tt>).
1076 Acceptable values for this property are:</p>
1077
1078 <div class="mdetail-params"><ul>
1079 <li><b>any <a href="Ext.data.Store.html" rel="Ext.data.Store" class="docClass">Store</a> subclass</b></li>
1080 <li><b>an Array</b> : Arrays will be converted to a <a href="Ext.data.Store.html" rel="Ext.data.Store" class="docClass">Ext.data.Store</a> internally,
1081 automatically generating <a href="Ext.data.Field.html#name" rel="Ext.data.Field#name" class="docClass">field names</a> to work with all data components.
1082 <div class="mdetail-params"><ul>
1083 <li><b>1-dimensional array</b> : (e.g., <tt>['Foo','Bar']</tt>)<div class="sub-desc">
1084 A 1-dimensional array will automatically be expanded (each array item will be used for both the combo
1085 <a href="Ext.form.field.ComboBox.html#valueField" rel="Ext.form.field.ComboBox#valueField" class="docClass">valueField</a> and <a href="Ext.form.field.ComboBox.html#displayField" rel="Ext.form.field.ComboBox#displayField" class="docClass">displayField</a>)</div></li>
1086 <li><b>2-dimensional array</b> : (e.g., <tt>[['f','Foo'],['b','Bar']]</tt>)<div class="sub-desc">
1087 For a multi-dimensional array, the value in index 0 of each item will be assumed to be the combo
1088 <a href="Ext.form.field.ComboBox.html#valueField" rel="Ext.form.field.ComboBox#valueField" class="docClass">valueField</a>, while the value at index 1 is assumed to be the combo <a href="Ext.form.field.ComboBox.html#displayField" rel="Ext.form.field.ComboBox#displayField" class="docClass">displayField</a>.
1089 </div></li></ul></div></li></ul></div>
1090
1091
1092 <p>See also <tt><a href="Ext.form.field.ComboBox.html#queryMode" rel="Ext.form.field.ComboBox#queryMode" class="docClass">queryMode</a></tt>.</p>
1093
1094 </div></div></div><div id="config-stripCharsRe" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-stripCharsRe" rel="config-stripCharsRe" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-stripCharsRe" class="viewSource">view source</a></div><a name="stripCharsRe"></a><a name="config-stripCharsRe"></a><a href="Ext.form.field.ComboBox.html#" rel="config-stripCharsRe" class="cls expand">stripCharsRe</a><span> : RegExp</span></div><div class="description"><div class="short"><p>A JavaScript RegExp object used to strip unwanted content from the value
1095 before validation (defaults to <tt>undefined</tt>).</p>
1096 </div><div class="long"><p>A JavaScript RegExp object used to strip unwanted content from the value
1097 before validation (defaults to <tt>undefined</tt>).</p>
1098 </div></div></div><div id="config-style" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-style" rel="config-style" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-style" class="viewSource">view source</a></div><a name="style"></a><a name="config-style"></a><a href="Ext.form.field.ComboBox.html#" rel="config-style" class="cls expand">style</a><span> : String</span></div><div class="description"><div class="short">A custom style specification to be applied to this component's Element.  Should be a valid argument to
1099 Ext.core.Eleme...</div><div class="long"><p>A custom style specification to be applied to this component's Element.  Should be a valid argument to
1100 <a href="Ext.core.Element.html#applyStyles" rel="Ext.core.Element#applyStyles" class="docClass">Ext.core.Element.applyStyles</a>.</p>
1101
1102 <pre><code>        new Ext.panel.Panel({
1103             title: 'Some Title',
1104             renderTo: Ext.getBody(),
1105             width: 400, height: 300,
1106             layout: 'form',
1107             items: [{
1108                 xtype: 'textarea',
1109                 style: {
1110                     width: '95%',
1111                     marginBottom: '10px'
1112                 }
1113             },
1114             new Ext.button.Button({
1115                 text: 'Send',
1116                 minWidth: '100',
1117                 style: {
1118                     marginBottom: '10px'
1119                 }
1120             })
1121             ]
1122         });
1123      </code></pre>
1124
1125 </div></div></div><div id="config-styleHtmlCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-styleHtmlCls" rel="config-styleHtmlCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-styleHtmlCls" class="viewSource">view source</a></div><a name="styleHtmlCls"></a><a name="config-styleHtmlCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-styleHtmlCls" class="cls expand">styleHtmlCls</a><span> : String</span></div><div class="description"><div class="short"><p>The class that is added to the content target when you set styleHtmlContent to true.
1126 Defaults to 'x-html'</p>
1127 </div><div class="long"><p>The class that is added to the content target when you set styleHtmlContent to true.
1128 Defaults to 'x-html'</p>
1129 </div></div></div><div id="config-styleHtmlContent" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-styleHtmlContent" rel="config-styleHtmlContent" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-styleHtmlContent" class="viewSource">view source</a></div><a name="styleHtmlContent"></a><a name="config-styleHtmlContent"></a><a href="Ext.form.field.ComboBox.html#" rel="config-styleHtmlContent" class="cls expand">styleHtmlContent</a><span> : String</span></div><div class="description"><div class="short"><p>True to automatically style the html inside the content target of this component (body for panels).
1130 Defaults to false.</p>
1131 </div><div class="long"><p>True to automatically style the html inside the content target of this component (body for panels).
1132 Defaults to false.</p>
1133 </div></div></div><div id="config-submitValue" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-submitValue" rel="config-submitValue" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-cfg-submitValue" class="viewSource">view source</a></div><a name="submitValue"></a><a name="config-submitValue"></a><a href="Ext.form.field.ComboBox.html#" rel="config-submitValue" class="cls expand">submitValue</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Setting this to <tt>false</tt> will prevent the field from being
1134 <a href="Ext.form.Basic.html#submit" rel="Ext.form.Basic#submit" class="docClass">submitted</a> even when it is not disabled. Defaults to <tt>true</tt>.</p>
1135 </div><div class="long"><p>Setting this to <tt>false</tt> will prevent the field from being
1136 <a href="Ext.form.Basic.html#submit" rel="Ext.form.Basic#submit" class="docClass">submitted</a> even when it is not disabled. Defaults to <tt>true</tt>.</p>
1137 </div></div></div><div id="config-tabIndex" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-tabIndex" rel="config-tabIndex" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-tabIndex" class="viewSource">view source</a></div><a name="tabIndex"></a><a name="config-tabIndex"></a><a href="Ext.form.field.ComboBox.html#" rel="config-tabIndex" class="cls expand">tabIndex</a><span> : Number</span></div><div class="description"><div class="short">The tabIndex for this field. Note this only applies to fields that are rendered,
1138 not those which are built via applyT...</div><div class="long"><p>The tabIndex for this field. Note this only applies to fields that are rendered,
1139 not those which are built via applyTo (defaults to undefined).</p>
1140 </div></div></div><div id="config-toFrontOnShow" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-toFrontOnShow" rel="config-toFrontOnShow" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-cfg-toFrontOnShow" class="viewSource">view source</a></div><a name="toFrontOnShow"></a><a name="config-toFrontOnShow"></a><a href="Ext.form.field.ComboBox.html#" rel="config-toFrontOnShow" class="cls expand">toFrontOnShow</a><span> : Boolean</span></div><div class="description"><div class="short">True to automatically call toFront when the show method is called
1141 on an already visible, floating component (default ...</div><div class="long"><p>True to automatically call <a href="Ext.form.field.ComboBox.html#toFront" rel="Ext.form.field.ComboBox#toFront" class="docClass">toFront</a> when the <a href="Ext.form.field.ComboBox.html#show" rel="Ext.form.field.ComboBox#show" class="docClass">show</a> method is called
1142 on an already visible, floating component (default is <code>true</code>).</p>
1143
1144 </div></div></div><div id="config-tpl" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-tpl" rel="config-tpl" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-tpl" class="viewSource">view source</a></div><a name="tpl"></a><a name="config-tpl"></a><a href="Ext.form.field.ComboBox.html#" rel="config-tpl" class="cls expand">tpl</a><span> : Mixed</span></div><div class="description"><div class="short">An Ext.Template, Ext.XTemplate
1145 or an array of strings to form an Ext.XTemplate.
1146 Used in conjunction with the data and...</div><div class="long"><p>An <bold><a href="Ext.Template.html" rel="Ext.Template" class="docClass">Ext.Template</a></bold>, <bold><a href="Ext.XTemplate.html" rel="Ext.XTemplate" class="docClass">Ext.XTemplate</a></bold>
1147 or an array of strings to form an <a href="Ext.XTemplate.html" rel="Ext.XTemplate" class="docClass">Ext.XTemplate</a>.
1148 Used in conjunction with the <code><a href="Ext.form.field.ComboBox.html#data" rel="Ext.form.field.ComboBox#data" class="docClass">data</a></code> and
1149 <code><a href="Ext.form.field.ComboBox.html#tplWriteMode" rel="Ext.form.field.ComboBox#tplWriteMode" class="docClass">tplWriteMode</a></code> configurations.</p>
1150 </div></div></div><div id="config-tplWriteMode" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-tplWriteMode" rel="config-tplWriteMode" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-tplWriteMode" class="viewSource">view source</a></div><a name="tplWriteMode"></a><a name="config-tplWriteMode"></a><a href="Ext.form.field.ComboBox.html#" rel="config-tplWriteMode" class="cls expand">tplWriteMode</a><span> : String</span></div><div class="description"><div class="short">The Ext.(X)Template method to use when
1151 updating the content area of the Component. Defaults to 'overwrite'
1152 (see Ext.X...</div><div class="long"><p>The Ext.(X)Template method to use when
1153 updating the content area of the Component. Defaults to <code>'overwrite'</code>
1154 (see <code><a href="Ext.XTemplate.html#overwrite" rel="Ext.XTemplate#overwrite" class="docClass">Ext.XTemplate.overwrite</a></code>).</p>
1155 </div></div></div><div id="config-transform" class="member ni"><a href="Ext.form.field.ComboBox.html#config-transform" rel="config-transform" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-transform" class="viewSource">view source</a></div><a name="transform"></a><a name="config-transform"></a><a href="Ext.form.field.ComboBox.html#" rel="config-transform" class="cls expand">transform</a><span> : Mixed</span></div><div class="description"><div class="short">The id, DOM node or Ext.core.Element of an existing HTML &lt;select&gt; element to
1156 convert into a ComboBox. The targe...</div><div class="long"><p>The id, DOM node or <a href="Ext.core.Element.html" rel="Ext.core.Element" class="docClass">Ext.core.Element</a> of an existing HTML <tt>&lt;select&gt;</tt> element to
1157 convert into a ComboBox. The target select's options will be used to build the options in the ComboBox
1158 dropdown; a configured <a href="Ext.form.field.ComboBox.html#store" rel="Ext.form.field.ComboBox#store" class="docClass">store</a> will take precedence over this.</p>
1159 </div></div></div><div id="config-triggerAction" class="member ni"><a href="Ext.form.field.ComboBox.html#config-triggerAction" rel="config-triggerAction" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-triggerAction" class="viewSource">view source</a></div><a name="triggerAction"></a><a name="config-triggerAction"></a><a href="Ext.form.field.ComboBox.html#" rel="config-triggerAction" class="cls expand">triggerAction</a><span> : String</span></div><div class="description"><div class="short">The action to execute when the trigger is clicked.
1160
1161
1162 'all' : Default
1163 run the query specified by the allQuery config o...</div><div class="long"><p>The action to execute when the trigger is clicked.</p>
1164
1165 <div class="mdetail-params"><ul>
1166 <li><b><tt>'all'</tt></b> : <b>Default</b>
1167 <p class="sub-desc"><a href="Ext.form.field.ComboBox.html#doQuery" rel="Ext.form.field.ComboBox#doQuery" class="docClass">run the query</a> specified by the <tt><a href="Ext.form.field.ComboBox.html#allQuery" rel="Ext.form.field.ComboBox#allQuery" class="docClass">allQuery</a></tt> config option</p></li>
1168 <li><b><tt>'query'</tt></b> :
1169 <p class="sub-desc"><a href="Ext.form.field.ComboBox.html#doQuery" rel="Ext.form.field.ComboBox#doQuery" class="docClass">run the query</a> using the <a href="Ext.form.field.Base.html#getRawValue" rel="Ext.form.field.Base#getRawValue" class="docClass">raw value</a>.</p></li>
1170 </ul></div>
1171
1172
1173 <p>See also <code><a href="Ext.form.field.ComboBox.html#queryParam" rel="Ext.form.field.ComboBox#queryParam" class="docClass">queryParam</a></code>.</p>
1174
1175 </div></div></div><div id="config-triggerBaseCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-triggerBaseCls" rel="config-triggerBaseCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Trigger.html" class="definedIn docClass">Ext.form.field.Trigger</a><br/><a href="../source/Trigger.html#Ext-form.field.Trigger-cfg-triggerBaseCls" class="viewSource">view source</a></div><a name="triggerBaseCls"></a><a name="config-triggerBaseCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-triggerBaseCls" class="cls expand">triggerBaseCls</a><span> : String</span></div><div class="description"><div class="short">The base CSS class that is always added to the trigger button. The triggerCls will be
1176 appended in addition to this cl...</div><div class="long"><p>The base CSS class that is always added to the trigger button. The <a href="Ext.form.field.ComboBox.html#triggerCls" rel="Ext.form.field.ComboBox#triggerCls" class="docClass">triggerCls</a> will be
1177 appended in addition to this class.</p>
1178 </div></div></div><div id="config-triggerCls" class="member ni"><a href="Ext.form.field.ComboBox.html#config-triggerCls" rel="config-triggerCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-triggerCls" class="viewSource">view source</a></div><a name="triggerCls"></a><a name="config-triggerCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-triggerCls" class="cls expand">triggerCls</a><span> : String</span></div><div class="description"><div class="short">An additional CSS class used to style the trigger button. The trigger will always get the
1179 triggerBaseCls by default a...</div><div class="long"><p>An additional CSS class used to style the trigger button. The trigger will always get the
1180 <a href="Ext.form.field.ComboBox.html#triggerBaseCls" rel="Ext.form.field.ComboBox#triggerBaseCls" class="docClass">triggerBaseCls</a> by default and <tt>triggerCls</tt> will be <b>appended</b> if specified.
1181 Defaults to 'x-form-arrow-trigger' for ComboBox.</p>
1182 </div></div></div><div id="config-triggerWrapCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-triggerWrapCls" rel="config-triggerWrapCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Trigger.html" class="definedIn docClass">Ext.form.field.Trigger</a><br/><a href="../source/Trigger.html#Ext-form.field.Trigger-cfg-triggerWrapCls" class="viewSource">view source</a></div><a name="triggerWrapCls"></a><a name="config-triggerWrapCls"></a><a href="Ext.form.field.ComboBox.html#" rel="config-triggerWrapCls" class="cls expand">triggerWrapCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class that is added to the div wrapping the trigger button(s).</p>
1183 </div><div class="long"><p>The CSS class that is added to the div wrapping the trigger button(s).</p>
1184 </div></div></div><div id="config-typeAhead" class="member ni"><a href="Ext.form.field.ComboBox.html#config-typeAhead" rel="config-typeAhead" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-typeAhead" class="viewSource">view source</a></div><a name="typeAhead"></a><a name="config-typeAhead"></a><a href="Ext.form.field.ComboBox.html#" rel="config-typeAhead" class="cls expand">typeAhead</a><span> : Boolean</span></div><div class="description"><div class="short">true to populate and autoselect the remainder of the text being
1185 typed after a configurable delay (typeAheadDelay) if ...</div><div class="long"><p><tt>true</tt> to populate and autoselect the remainder of the text being
1186 typed after a configurable delay (<a href="Ext.form.field.ComboBox.html#typeAheadDelay" rel="Ext.form.field.ComboBox#typeAheadDelay" class="docClass">typeAheadDelay</a>) if it matches a known value (defaults
1187 to <tt>false</tt>)</p>
1188 </div></div></div><div id="config-typeAheadDelay" class="member ni"><a href="Ext.form.field.ComboBox.html#config-typeAheadDelay" rel="config-typeAheadDelay" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-typeAheadDelay" class="viewSource">view source</a></div><a name="typeAheadDelay"></a><a name="config-typeAheadDelay"></a><a href="Ext.form.field.ComboBox.html#" rel="config-typeAheadDelay" class="cls expand">typeAheadDelay</a><span> : Number</span></div><div class="description"><div class="short"><p>The length of time in milliseconds to wait until the typeahead text is displayed
1189 if <tt><a href="Ext.form.field.ComboBox.html#typeAhead" rel="Ext.form.field.ComboBox#typeAhead" class="docClass">typeAhead</a> = true</tt> (defaults to <tt>250</tt>)</p>
1190 </div><div class="long"><p>The length of time in milliseconds to wait until the typeahead text is displayed
1191 if <tt><a href="Ext.form.field.ComboBox.html#typeAhead" rel="Ext.form.field.ComboBox#typeAhead" class="docClass">typeAhead</a> = true</tt> (defaults to <tt>250</tt>)</p>
1192 </div></div></div><div id="config-ui" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-ui" rel="config-ui" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-ui" class="viewSource">view source</a></div><a name="ui"></a><a name="config-ui"></a><a href="Ext.form.field.ComboBox.html#" rel="config-ui" class="cls expand">ui</a><span> : String/Array</span></div><div class="description"><div class="short"><p>A set style for a component. Can be a string or an Array of multiple strings (UIs)</p>
1193 </div><div class="long"><p>A set style for a component. Can be a string or an Array of multiple strings (UIs)</p>
1194 </div></div></div><div id="config-validateOnBlur" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-validateOnBlur" rel="config-validateOnBlur" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-validateOnBlur" class="viewSource">view source</a></div><a name="validateOnBlur"></a><a name="config-validateOnBlur"></a><a href="Ext.form.field.ComboBox.html#" rel="config-validateOnBlur" class="cls expand">validateOnBlur</a><span> : Boolean</span></div><div class="description"><div class="short">Whether the field should validate when it loses focus (defaults to true). This will cause fields
1195 to be validated as t...</div><div class="long"><p>Whether the field should validate when it loses focus (defaults to <tt>true</tt>). This will cause fields
1196 to be validated as the user steps through the fields in the form regardless of whether they are making
1197 changes to those fields along the way. See also <a href="Ext.form.field.ComboBox.html#validateOnChange" rel="Ext.form.field.ComboBox#validateOnChange" class="docClass">validateOnChange</a>.</p>
1198 </div></div></div><div id="config-validateOnChange" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-validateOnChange" rel="config-validateOnChange" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-cfg-validateOnChange" class="viewSource">view source</a></div><a name="validateOnChange"></a><a name="config-validateOnChange"></a><a href="Ext.form.field.ComboBox.html#" rel="config-validateOnChange" class="cls expand">validateOnChange</a><span> : Boolean</span></div><div class="description"><div class="short">Specifies whether this field should be validated immediately whenever a change in its value is detected.
1199 Defaults to ...</div><div class="long"><p>Specifies whether this field should be validated immediately whenever a change in its value is detected.
1200 Defaults to <tt>true</tt>. If the validation results in a change in the field's validity, a
1201 <a href="Ext.form.field.ComboBox.html#validitychange" rel="Ext.form.field.ComboBox#validitychange" class="docClass">validitychange</a> event will be fired. This allows the field to show feedback about the
1202 validity of its contents immediately as the user is typing.</p>
1203
1204
1205 <p>When set to <tt>false</tt>, feedback will not be immediate. However the form will still be validated
1206 before submitting if the <tt>clientValidation</tt> option to <a href="Ext.form.Basic.html#doAction" rel="Ext.form.Basic#doAction" class="docClass">Ext.form.Basic.doAction</a> is
1207 enabled, or if the field or form are validated manually.</p>
1208
1209
1210 <p>See also <a href="Ext.form.field.Base.html#checkChangeEvents" rel="Ext.form.field.Base#checkChangeEvents" class="docClass">Ext.form.field.Base.checkChangeEvents</a>for controlling how changes to the field's value are detected.</p>
1211
1212 </div></div></div><div id="config-validator" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-validator" rel="config-validator" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-validator" class="viewSource">view source</a></div><a name="validator"></a><a name="config-validator"></a><a href="Ext.form.field.ComboBox.html#" rel="config-validator" class="cls expand">validator</a><span> : Function</span></div><div class="description"><div class="short">A custom validation function to be called during field validation (getErrors)
1213 (defaults to undefined). If specified, ...</div><div class="long"><p>A custom validation function to be called during field validation (<a href="Ext.form.field.ComboBox.html#getErrors" rel="Ext.form.field.ComboBox#getErrors" class="docClass">getErrors</a>)
1214 (defaults to <tt>undefined</tt>). If specified, this function will be called first, allowing the
1215 developer to override the default validation process.</p>
1216
1217
1218 <br><p>This function will be passed the following Parameters:</p>
1219
1220
1221 <div class="mdetail-params"><ul>
1222 <li><code>value</code>: <i>Mixed</i>
1223 <div class="sub-desc">The current field value</div></li>
1224 </ul></div>
1225
1226
1227 <br><p>This function is to Return:</p>
1228
1229
1230 <div class="mdetail-params"><ul>
1231 <li><code>true</code>: <i>Boolean</i>
1232 <div class="sub-desc"><code>true</code> if the value is valid</div></li>
1233 <li><code>msg</code>: <i>String</i>
1234 <div class="sub-desc">An error message if the value is invalid</div></li>
1235 </ul></div>
1236
1237 </div></div></div><div id="config-value" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-value" rel="config-value" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-cfg-value" class="viewSource">view source</a></div><a name="value"></a><a name="config-value"></a><a href="Ext.form.field.ComboBox.html#" rel="config-value" class="cls expand">value</a><span> : Mixed</span></div><div class="description"><div class="short"><p>A value to initialize this field with (defaults to undefined).</p>
1238 </div><div class="long"><p>A value to initialize this field with (defaults to undefined).</p>
1239 </div></div></div><div id="config-valueField" class="member ni"><a href="Ext.form.field.ComboBox.html#config-valueField" rel="config-valueField" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-valueField" class="viewSource">view source</a></div><a name="valueField"></a><a name="config-valueField"></a><a href="Ext.form.field.ComboBox.html#" rel="config-valueField" class="cls expand">valueField</a><span> : String</span></div><div class="description"><div class="short">@required
1240 The underlying data value name to bind to this ComboBox (defaults to match
1241 the value of the displayField co...</div><div class="long"><p>@required
1242 The underlying <a href="Ext.data.Field.html#name" rel="Ext.data.Field#name" class="docClass">data value name</a> to bind to this ComboBox (defaults to match
1243 the value of the <a href="Ext.form.field.ComboBox.html#displayField" rel="Ext.form.field.ComboBox#displayField" class="docClass">displayField</a> config).</p>
1244
1245 <p><b>Note</b>: use of a <tt>valueField</tt> requires the user to make a selection in order for a value to be
1246 mapped. See also <tt><a href="Ext.form.field.ComboBox.html#displayField" rel="Ext.form.field.ComboBox#displayField" class="docClass">displayField</a></tt>.</p>
1247
1248 </div></div></div><div id="config-valueNotFoundText" class="member ni"><a href="Ext.form.field.ComboBox.html#config-valueNotFoundText" rel="config-valueNotFoundText" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-cfg-valueNotFoundText" class="viewSource">view source</a></div><a name="valueNotFoundText"></a><a name="config-valueNotFoundText"></a><a href="Ext.form.field.ComboBox.html#" rel="config-valueNotFoundText" class="cls expand">valueNotFoundText</a><span> : String</span></div><div class="description"><div class="short">When using a name/value combo, if the value passed to setValue is not found in
1249 the store, valueNotFoundText will be d...</div><div class="long"><p>When using a name/value combo, if the value passed to setValue is not found in
1250 the store, valueNotFoundText will be displayed as the field text if defined (defaults to undefined). If this
1251 default text is used, it means there is no value set and no validation will occur on this field.</p>
1252 </div></div></div><div id="config-vtype" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-vtype" rel="config-vtype" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-vtype" class="viewSource">view source</a></div><a name="vtype"></a><a name="config-vtype"></a><a href="Ext.form.field.ComboBox.html#" rel="config-vtype" class="cls expand">vtype</a><span> : String</span></div><div class="description"><div class="short"><p>A validation type name as defined in <a href="Ext.form.field.VTypes.html" rel="Ext.form.field.VTypes" class="docClass">Ext.form.field.VTypes</a> (defaults to <tt>undefined</tt>)</p>
1253 </div><div class="long"><p>A validation type name as defined in <a href="Ext.form.field.VTypes.html" rel="Ext.form.field.VTypes" class="docClass">Ext.form.field.VTypes</a> (defaults to <tt>undefined</tt>)</p>
1254 </div></div></div><div id="config-vtypeText" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-vtypeText" rel="config-vtypeText" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-vtypeText" class="viewSource">view source</a></div><a name="vtypeText"></a><a name="config-vtypeText"></a><a href="Ext.form.field.ComboBox.html#" rel="config-vtypeText" class="cls expand">vtypeText</a><span> : String</span></div><div class="description"><div class="short">A custom error message to display in place of the default message provided
1255 for the vtype currently set for this field...</div><div class="long"><p>A custom error message to display in place of the default message provided
1256 for the <b><code><a href="Ext.form.field.ComboBox.html#vtype" rel="Ext.form.field.ComboBox#vtype" class="docClass">vtype</a></code></b> currently set for this field (defaults to <tt>undefined</tt>).
1257 <b>Note</b>: only applies if <b><code><a href="Ext.form.field.ComboBox.html#vtype" rel="Ext.form.field.ComboBox#vtype" class="docClass">vtype</a></code></b> is set, else ignored.</p>
1258 </div></div></div><div id="config-width" class="member inherited"><a href="Ext.form.field.ComboBox.html#config-width" rel="config-width" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-width" class="viewSource">view source</a></div><a name="width"></a><a name="config-width"></a><a href="Ext.form.field.ComboBox.html#" rel="config-width" class="cls expand">width</a><span> : Number</span></div><div class="description"><div class="short"><p>The width of this component in pixels.</p>
1259 </div><div class="long"><p>The width of this component in pixels.</p>
1260 </div></div></div></div><div class="m-properties"><a name="properties"></a><div class="definedBy">Defined By</div><h3 class="prp p">Properties</h3><div id="property-bodyEl" class="member f inherited"><a href="Ext.form.field.ComboBox.html#property-bodyEl" rel="property-bodyEl" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-property-bodyEl" class="viewSource">view source</a></div><a name="bodyEl"></a><a name="property-bodyEl"></a><a href="Ext.form.field.ComboBox.html#" rel="property-bodyEl" class="cls expand">bodyEl</a><span> : Ext.core.Element</span></div><div class="description"><div class="short"><p>The div Element wrapping the component's contents. Only available after the component has been rendered.</p>
1261 </div><div class="long"><p>The div Element wrapping the component's contents. Only available after the component has been rendered.</p>
1262 </div></div></div><div id="property-clearInvalid" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-clearInvalid" rel="property-clearInvalid" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-property-clearInvalid" class="viewSource">view source</a></div><a name="clearInvalid"></a><a name="property-clearInvalid"></a><a href="Ext.form.field.ComboBox.html#" rel="property-clearInvalid" class="cls expand">clearInvalid</a><span> : Object</span></div><div class="description"><div class="short">Clear any invalid styles/messages for this field. Components using this mixin should implement
1263 this method to update ...</div><div class="long"><p>Clear any invalid styles/messages for this field. Components using this mixin should implement
1264 this method to update the components rendering to clear any existing messages.</p>
1265
1266
1267 <p><b>Note</b>: this method does not cause the Field's <a href="Ext.form.field.ComboBox.html#validate" rel="Ext.form.field.ComboBox#validate" class="docClass">validate</a> or <a href="Ext.form.field.ComboBox.html#isValid" rel="Ext.form.field.ComboBox#isValid" class="docClass">isValid</a> methods to
1268 return <code>true</code> if the value does not <i>pass</i> validation. So simply clearing a field's errors
1269 will not necessarily allow submission of forms submitted with the <a href="Ext.form.action.Submit.html#clientValidation" rel="Ext.form.action.Submit#clientValidation" class="docClass">Ext.form.action.Submit.clientValidation</a>
1270 option set.</p>
1271
1272 </div></div></div><div id="property-createPicker" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-createPicker" rel="property-createPicker" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Picker.html" class="definedIn docClass">Ext.form.field.Picker</a><br/><a href="../source/Picker.html#Ext-form.field.Picker-property-createPicker" class="viewSource">view source</a></div><a name="createPicker"></a><a name="property-createPicker"></a><a href="Ext.form.field.ComboBox.html#" rel="property-createPicker" class="cls expand">createPicker</a><span> : Object</span></div><div class="description"><div class="short"><p>Create and return the component to be used as this field's picker. Must be implemented
1273 by subclasses of Picker.</p>
1274 </div><div class="long"><p>Create and return the component to be used as this field's picker. Must be implemented
1275 by subclasses of Picker.</p>
1276 </div></div></div><div id="property-draggable" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-draggable" rel="property-draggable" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-property-draggable" class="viewSource">view source</a></div><a name="draggable"></a><a name="property-draggable"></a><a href="Ext.form.field.ComboBox.html#" rel="property-draggable" class="cls expand">draggable</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Read-only property indicating whether or not the component can be dragged</p>
1277 </div><div class="long"><p>Read-only property indicating whether or not the component can be dragged</p>
1278 </div></div></div><div id="property-errorEl" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-errorEl" rel="property-errorEl" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-property-errorEl" class="viewSource">view source</a></div><a name="errorEl"></a><a name="property-errorEl"></a><a href="Ext.form.field.ComboBox.html#" rel="property-errorEl" class="cls expand">errorEl</a><span> : Ext.core.Element</span></div><div class="description"><div class="short">The div Element that will contain the component's error message(s). Note that depending on the
1279 configured msgTarget, ...</div><div class="long"><p>The div Element that will contain the component's error message(s). Note that depending on the
1280 configured <a href="Ext.form.field.ComboBox.html#msgTarget" rel="Ext.form.field.ComboBox#msgTarget" class="docClass">msgTarget</a>, this element may be hidden in favor of some other form of
1281 presentation, but will always be present in the DOM for use by assistive technologies.</p>
1282 </div></div></div><div id="property-floatParent" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-floatParent" rel="property-floatParent" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-property-floatParent" class="viewSource">view source</a></div><a name="floatParent"></a><a name="property-floatParent"></a><a href="Ext.form.field.ComboBox.html#" rel="property-floatParent" class="cls expand">floatParent</a><span> : Ext.Container</span></div><div class="description"><div class="short">Optional. Only present for floating Components which were inserted as descendant items of floating Containers.
1283
1284
1285 Floa...</div><div class="long"><p>Optional. Only present for <a href="Ext.form.field.ComboBox.html#floating" rel="Ext.form.field.ComboBox#floating" class="docClass">floating</a> Components which were inserted as descendant items of floating Containers.</p>
1286
1287
1288 <p>Floating Components that are programatically <a href="Ext.Component.html#render" rel="Ext.Component#render" class="docClass">rendered</a> will not have a <code>floatParent</code> property.</p>
1289
1290
1291 <p>For <a href="Ext.form.field.ComboBox.html#floating" rel="Ext.form.field.ComboBox#floating" class="docClass">floating</a> Components which are child items of a Container, the floatParent will be the floating ancestor Container which is
1292 responsible for the base z-index value of all its floating descendants. It provides a <a href="Ext.ZIndexManager.html" rel="Ext.ZIndexManager" class="docClass">ZIndexManager</a> which provides
1293 z-indexing services for all its descendant floating Components.</p>
1294
1295
1296 <p>For example, the dropdown <a href="Ext.view.BoundList.html" rel="Ext.view.BoundList" class="docClass">BoundList</a> of a ComboBox which is in a Window will have the Window as its
1297 <code>floatParent</code></p>
1298
1299
1300 <p>See <a href="Ext.form.field.ComboBox.html#floating" rel="Ext.form.field.ComboBox#floating" class="docClass">floating</a> and <a href="Ext.form.field.ComboBox.html#zIndexManager" rel="Ext.form.field.ComboBox#zIndexManager" class="docClass">zIndexManager</a></p>
1301
1302 </div></div></div><div id="property-frameSize" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-frameSize" rel="property-frameSize" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-property-frameSize" class="viewSource">view source</a></div><a name="frameSize"></a><a name="property-frameSize"></a><a href="Ext.form.field.ComboBox.html#" rel="property-frameSize" class="cls expand">frameSize</a><span> : Object</span></div><div class="description"><div class="short">Read-only property indicating the width of any framing elements which were added within the encapsulating element
1303 to ...</div><div class="long"><p>Read-only property indicating the width of any framing elements which were added within the encapsulating element
1304 to provide graphical, rounded borders. See the <a href="Ext.form.field.ComboBox.html#frame" rel="Ext.form.field.ComboBox#frame" class="docClass">frame</a> config.</p>
1305
1306
1307 <p> This is an object containing the frame width in pixels for all four sides of the Component containing
1308 the following properties:</p>
1309
1310
1311 <div class="mdetail-params"><ul>
1312 <li><code>top</code> The width of the top framing element in pixels.</li>
1313 <li><code>right</code> The width of the right framing element in pixels.</li>
1314 <li><code>bottom</code> The width of the bottom framing element in pixels.</li>
1315 <li><code>left</code> The width of the left framing element in pixels.</li>
1316 </ul></div>
1317
1318 </div></div></div><div id="property-hasActiveFx" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-hasActiveFx" rel="property-hasActiveFx" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Animate.html" class="definedIn docClass">Ext.util.Animate</a><br/><a href="../source/Animate.html#Ext-util.Animate-property-hasActiveFx" class="viewSource">view source</a></div><a name="hasActiveFx"></a><a name="property-hasActiveFx"></a><a href="Ext.form.field.ComboBox.html#" rel="property-hasActiveFx" class="cls expand">hasActiveFx</a><span> : Object</span></div><div class="description"><div class="short">@deprecated 4.0 Replaced by getActiveAnimation
1319 Returns thq current animation if this object has any effects actively ...</div><div class="long"><p>@deprecated 4.0 Replaced by <a href="Ext.form.field.ComboBox.html#getActiveAnimation" rel="Ext.form.field.ComboBox#getActiveAnimation" class="docClass">getActiveAnimation</a>
1320 Returns thq current animation if this object has any effects actively running or queued, else returns false.</p>
1321 </div></div></div><div id="property-inputEl" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-inputEl" rel="property-inputEl" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-property-inputEl" class="viewSource">view source</a></div><a name="inputEl"></a><a name="property-inputEl"></a><a href="Ext.form.field.ComboBox.html#" rel="property-inputEl" class="cls expand">inputEl</a><span> : Ext.core.Element</span></div><div class="description"><div class="short"><p>The input Element for this Field. Only available after the field has been rendered.</p>
1322 </div><div class="long"><p>The input Element for this Field. Only available after the field has been rendered.</p>
1323 </div></div></div><div id="property-isExpanded" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-isExpanded" rel="property-isExpanded" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Picker.html" class="definedIn docClass">Ext.form.field.Picker</a><br/><a href="../source/Picker.html#Ext-form.field.Picker-property-isExpanded" class="viewSource">view source</a></div><a name="isExpanded"></a><a name="property-isExpanded"></a><a href="Ext.form.field.ComboBox.html#" rel="property-isExpanded" class="cls expand">isExpanded</a><span> : Boolean</span></div><div class="description"><div class="short"><p>True if the picker is currently expanded, false if not.</p>
1324 </div><div class="long"><p>True if the picker is currently expanded, false if not.</p>
1325 </div></div></div><div id="property-isFieldLabelable" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-isFieldLabelable" rel="property-isFieldLabelable" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-property-isFieldLabelable" class="viewSource">view source</a></div><a name="isFieldLabelable"></a><a name="property-isFieldLabelable"></a><a href="Ext.form.field.ComboBox.html#" rel="property-isFieldLabelable" class="cls expand">isFieldLabelable</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Flag denoting that this object is labelable as a field. Always true.</p>
1326 </div><div class="long"><p>Flag denoting that this object is labelable as a field. Always true.</p>
1327 </div></div></div><div id="property-isFormField" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-isFormField" rel="property-isFormField" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-property-isFormField" class="viewSource">view source</a></div><a name="isFormField"></a><a name="property-isFormField"></a><a href="Ext.form.field.ComboBox.html#" rel="property-isFormField" class="cls expand">isFormField</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Flag denoting that this component is a Field. Always true.</p>
1328 </div><div class="long"><p>Flag denoting that this component is a Field. Always true.</p>
1329 </div></div></div><div id="property-labelEl" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-labelEl" rel="property-labelEl" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-property-labelEl" class="viewSource">view source</a></div><a name="labelEl"></a><a name="property-labelEl"></a><a href="Ext.form.field.ComboBox.html#" rel="property-labelEl" class="cls expand">labelEl</a><span> : Ext.core.Element</span></div><div class="description"><div class="short"><p>The label Element for this component. Only available after the component has been rendered.</p>
1330 </div><div class="long"><p>The label Element for this component. Only available after the component has been rendered.</p>
1331 </div></div></div><div id="property-lastQuery" class="member ni"><a href="Ext.form.field.ComboBox.html#property-lastQuery" rel="property-lastQuery" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-property-lastQuery" class="viewSource">view source</a></div><a name="lastQuery"></a><a name="property-lastQuery"></a><a href="Ext.form.field.ComboBox.html#" rel="property-lastQuery" class="cls expand">lastQuery</a><span> : String</span></div><div class="description"><div class="short">The value of the match string used to filter the store. Delete this property to force a requery.
1332 Example use:
1333
1334 var co...</div><div class="long"><p>The value of the match string used to filter the store. Delete this property to force a requery.
1335 Example use:</p>
1336
1337 <pre><code>var combo = new Ext.form.field.ComboBox({
1338     ...
1339     queryMode: 'remote',
1340     listeners: {
1341         // delete the previous query in the beforequery event or set
1342         // combo.lastQuery = null (this will reload the store the next time it expands)
1343         beforequery: function(qe){
1344             delete qe.combo.lastQuery;
1345         }
1346     }
1347 });
1348 </code></pre>
1349
1350
1351 <p>To make sure the filter in the store is not cleared the first time the ComboBox trigger is used
1352 configure the combo with <tt>lastQuery=''</tt>. Example use:</p>
1353
1354 <pre><code>var combo = new Ext.form.field.ComboBox({
1355     ...
1356     queryMode: 'local',
1357     triggerAction: 'all',
1358     lastQuery: ''
1359 });
1360 </code></pre>
1361
1362 </div></div></div><div id="property-markInvalid" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-markInvalid" rel="property-markInvalid" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-property-markInvalid" class="viewSource">view source</a></div><a name="markInvalid"></a><a name="property-markInvalid"></a><a href="Ext.form.field.ComboBox.html#" rel="property-markInvalid" class="cls expand">markInvalid</a><span> : Object</span></div><div class="description"><div class="short">Associate one or more error messages with this field. Components using this mixin should implement
1363 this method to upd...</div><div class="long"><p>Associate one or more error messages with this field. Components using this mixin should implement
1364 this method to update the component's rendering to display the messages.</p>
1365
1366
1367 <p><b>Note</b>: this method does not cause the Field's <a href="Ext.form.field.ComboBox.html#validate" rel="Ext.form.field.ComboBox#validate" class="docClass">validate</a> or <a href="Ext.form.field.ComboBox.html#isValid" rel="Ext.form.field.ComboBox#isValid" class="docClass">isValid</a> methods to
1368 return <code>false</code> if the value does <i>pass</i> validation. So simply marking a Field as invalid
1369 will not prevent submission of forms submitted with the <a href="Ext.form.action.Submit.html#clientValidation" rel="Ext.form.action.Submit#clientValidation" class="docClass">Ext.form.action.Submit.clientValidation</a>
1370 option set.</p>
1371
1372 </div></div></div><div id="property-maskOnDisable" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-maskOnDisable" rel="property-maskOnDisable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-property-maskOnDisable" class="viewSource">view source</a></div><a name="maskOnDisable"></a><a name="property-maskOnDisable"></a><a href="Ext.form.field.ComboBox.html#" rel="property-maskOnDisable" class="cls expand">maskOnDisable</a><span> : Boolean</span></div><div class="description"><div class="short">This is an internal flag that you use when creating custom components.
1373 By default this is set to true which means tha...</div><div class="long"><p>This is an internal flag that you use when creating custom components.
1374 By default this is set to true which means that every component gets a mask when its disabled.
1375 Components like FieldContainer, FieldSet, Field, Button, Tab override this property to false
1376 since they want to implement custom disable logic.</p>
1377 </div></div></div><div id="property-originalValue" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-originalValue" rel="property-originalValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-property-originalValue" class="viewSource">view source</a></div><a name="originalValue"></a><a name="property-originalValue"></a><a href="Ext.form.field.ComboBox.html#" rel="property-originalValue" class="cls expand">originalValue</a><span> : Mixed</span></div><div class="description"><div class="short">The original value of the field as configured in the value configuration, or as loaded by
1378 the last form load operatio...</div><div class="long"><p>The original value of the field as configured in the <a href="Ext.form.field.ComboBox.html#value" rel="Ext.form.field.ComboBox#value" class="docClass">value</a> configuration, or as loaded by
1379 the last form load operation if the form's <a href="Ext.form.Basic.html#trackResetOnLoad" rel="Ext.form.Basic#trackResetOnLoad" class="docClass">trackResetOnLoad</a>
1380 setting is <code>true</code>.</p>
1381 </div></div></div><div id="property-ownerCt" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-ownerCt" rel="property-ownerCt" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-property-ownerCt" class="viewSource">view source</a></div><a name="ownerCt"></a><a name="property-ownerCt"></a><a href="Ext.form.field.ComboBox.html#" rel="property-ownerCt" class="cls expand">ownerCt</a><span> : Ext.Container</span></div><div class="description"><div class="short">This Component's owner Container (defaults to undefined, and is set automatically when
1382 this Component is added to a C...</div><div class="long"><p>This Component's owner <a href="Ext.container.Container.html" rel="Ext.container.Container" class="docClass">Container</a> (defaults to undefined, and is set automatically when
1383 this Component is added to a Container).  Read-only.</p>
1384
1385 <p><b>Note</b>: to access items within the Container see <tt><a href="Ext.form.field.ComboBox.html#itemId" rel="Ext.form.field.ComboBox#itemId" class="docClass">itemId</a></tt>.</p>
1386
1387 </div></div></div><div id="property-rendered" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-rendered" rel="property-rendered" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-property-rendered" class="viewSource">view source</a></div><a name="rendered"></a><a name="property-rendered"></a><a href="Ext.form.field.ComboBox.html#" rel="property-rendered" class="cls expand">rendered</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Read-only property indicating whether or not the component has been rendered.</p>
1388 </div><div class="long"><p>Read-only property indicating whether or not the component has been rendered.</p>
1389 </div></div></div><div id="property-stopFx" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-stopFx" rel="property-stopFx" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Animate.html" class="definedIn docClass">Ext.util.Animate</a><br/><a href="../source/Animate.html#Ext-util.Animate-property-stopFx" class="viewSource">view source</a></div><a name="stopFx"></a><a name="property-stopFx"></a><a href="Ext.form.field.ComboBox.html#" rel="property-stopFx" class="cls expand">stopFx</a><span> : Object</span></div><div class="description"><div class="short">Stops any running effects and clears this object's internal effects queue if it contains
1390 any additional effects that ...</div><div class="long"><p>Stops any running effects and clears this object's internal effects queue if it contains
1391 any additional effects that haven't started yet.</p>
1392 </div></div></div><div id="property-triggerEl" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-triggerEl" rel="property-triggerEl" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Trigger.html" class="definedIn docClass">Ext.form.field.Trigger</a><br/><a href="../source/Trigger.html#Ext-form.field.Trigger-property-triggerEl" class="viewSource">view source</a></div><a name="triggerEl"></a><a name="property-triggerEl"></a><a href="Ext.form.field.ComboBox.html#" rel="property-triggerEl" class="cls expand">triggerEl</a><span> : Ext.CompositeElement</span></div><div class="description"><div class="short"><p>A composite of all the trigger button elements. Only set after the field has been rendered.</p>
1393 </div><div class="long"><p>A composite of all the trigger button elements. Only set after the field has been rendered.</p>
1394 </div></div></div><div id="property-triggerWrap" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-triggerWrap" rel="property-triggerWrap" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Trigger.html" class="definedIn docClass">Ext.form.field.Trigger</a><br/><a href="../source/Trigger.html#Ext-form.field.Trigger-property-triggerWrap" class="viewSource">view source</a></div><a name="triggerWrap"></a><a name="property-triggerWrap"></a><a href="Ext.form.field.ComboBox.html#" rel="property-triggerWrap" class="cls expand">triggerWrap</a><span> : Ext.core.Element</span></div><div class="description"><div class="short"><p>A reference to the div element wrapping the trigger button(s). Only set after the field has been rendered.</p>
1395 </div><div class="long"><p>A reference to the div element wrapping the trigger button(s). Only set after the field has been rendered.</p>
1396 </div></div></div><div id="property-zIndexManager" class="member inherited"><a href="Ext.form.field.ComboBox.html#property-zIndexManager" rel="property-zIndexManager" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-property-zIndexManager" class="viewSource">view source</a></div><a name="zIndexManager"></a><a name="property-zIndexManager"></a><a href="Ext.form.field.ComboBox.html#" rel="property-zIndexManager" class="cls expand">zIndexManager</a><span> : Ext.ZIndexManager</span></div><div class="description"><div class="short">Optional. Only present for floating Components after they have been rendered.
1397
1398
1399 A reference to the ZIndexManager whic...</div><div class="long"><p>Optional. Only present for <a href="Ext.form.field.ComboBox.html#floating" rel="Ext.form.field.ComboBox#floating" class="docClass">floating</a> Components after they have been rendered.</p>
1400
1401
1402 <p>A reference to the ZIndexManager which is managing this Component's z-index.</p>
1403
1404
1405 <p>The <a href="Ext.ZIndexManager.html" rel="Ext.ZIndexManager" class="docClass">ZIndexManager</a> maintains a stack of floating Component z-indices, and also provides a single modal
1406 mask which is insert just beneath the topmost visible modal floating Component.</p>
1407
1408
1409 <p>Floating Components may be <a href="Ext.form.field.ComboBox.html#toFront" rel="Ext.form.field.ComboBox#toFront" class="docClass">brought to the front</a> or <a href="Ext.form.field.ComboBox.html#toBack" rel="Ext.form.field.ComboBox#toBack" class="docClass">sent to the back</a> of the z-index stack.</p>
1410
1411
1412 <p>This defaults to the global <a href="Ext.WindowManager.html" rel="Ext.WindowManager" class="docClass">ZIndexManager</a> for floating Components that are programatically
1413 <a href="Ext.Component.html#render" rel="Ext.Component#render" class="docClass">rendered</a>.</p>
1414
1415
1416 <p>For <a href="Ext.form.field.ComboBox.html#floating" rel="Ext.form.field.ComboBox#floating" class="docClass">floating</a> Components which are added to a Container, the ZIndexManager is acquired from the first ancestor Container found
1417 which is floating, or if not found the global <a href="Ext.WindowManager.html" rel="Ext.WindowManager" class="docClass">ZIndexManager</a> is used.</p>
1418
1419
1420 <p>See <a href="Ext.form.field.ComboBox.html#floating" rel="Ext.form.field.ComboBox#floating" class="docClass">floating</a> and <a href="Ext.form.field.ComboBox.html#floatParent" rel="Ext.form.field.ComboBox#floatParent" class="docClass">floatParent</a></p>
1421
1422 </div></div></div></div><div class="m-methods"><a name="methods"></a><div class="definedBy">Defined By</div><h3 class="mth p">Methods</h3><div id="method-ComboBox" class="member f ni"><a href="Ext.form.field.ComboBox.html#method-ComboBox" rel="method-ComboBox" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-method-constructor" class="viewSource">view source</a></div><a name="ComboBox"></a><a name="method-ComboBox"></a><a href="Ext.form.field.ComboBox.html#" rel="method-ComboBox" class="cls expand">ComboBox</a>(
1423 <span class="pre">Object config</span>)
1424  : void</div><div class="description"><div class="short"><p>Create a new ComboBox.</p>
1425 </div><div class="long"><p>Create a new ComboBox.</p>
1426 <h3 class="pa">Parameters</h3><ul><li><span class="pre">config</span> : Object<div class="sub-desc"><p>Configuration options</p>
1427 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1428 </li></ul></div></div></div><div id="method-addClass" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-addClass" rel="method-addClass" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-addClass" class="viewSource">view source</a></div><a name="addClass"></a><a name="method-addClass"></a><a href="Ext.form.field.ComboBox.html#" rel="method-addClass" class="cls expand">addClass</a>(
1429 <span class="pre">String cls</span>)
1430  : Ext.Component</div><div class="description"><div class="short"><p>@deprecated 4.0 Replaced by {link:#addCls}
1431 Adds a CSS class to the top level element representing this component.</p>
1432 </div><div class="long"><p>@deprecated 4.0 Replaced by {link:#addCls}
1433 Adds a CSS class to the top level element representing this component.</p>
1434 <h3 class="pa">Parameters</h3><ul><li><span class="pre">cls</span> : String<div class="sub-desc"><p>The CSS class name to add</p>
1435 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>Returns the Component to allow method chaining.</p>
1436 </li></ul></div></div></div><div id="method-addCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-addCls" rel="method-addCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-addCls" class="viewSource">view source</a></div><a name="addCls"></a><a name="method-addCls"></a><a href="Ext.form.field.ComboBox.html#" rel="method-addCls" class="cls expand">addCls</a>(
1437 <span class="pre">String cls</span>)
1438  : Ext.Component</div><div class="description"><div class="short"><p>Adds a CSS class to the top level element representing this component.</p>
1439 </div><div class="long"><p>Adds a CSS class to the top level element representing this component.</p>
1440 <h3 class="pa">Parameters</h3><ul><li><span class="pre">cls</span> : String<div class="sub-desc"><p>The CSS class name to add</p>
1441 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>Returns the Component to allow method chaining.</p>
1442 </li></ul></div></div></div><div id="method-addClsWithUI" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-addClsWithUI" rel="method-addClsWithUI" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-addClsWithUI" class="viewSource">view source</a></div><a name="addClsWithUI"></a><a name="method-addClsWithUI"></a><a href="Ext.form.field.ComboBox.html#" rel="method-addClsWithUI" class="cls expand">addClsWithUI</a>(
1443 <span class="pre">String/Array cls</span>)
1444  : void</div><div class="description"><div class="short"><p>Adds a cls to the uiCls array, which will also call <a href="Ext.form.field.ComboBox.html#addUIClsToElement" rel="Ext.form.field.ComboBox#addUIClsToElement" class="docClass">addUIClsToElement</a> and adds
1445 to all elements of this component.</p>
1446 </div><div class="long"><p>Adds a cls to the uiCls array, which will also call <a href="Ext.form.field.ComboBox.html#addUIClsToElement" rel="Ext.form.field.ComboBox#addUIClsToElement" class="docClass">addUIClsToElement</a> and adds
1447 to all elements of this component.</p>
1448 <h3 class="pa">Parameters</h3><ul><li><span class="pre">cls</span> : String/Array<div class="sub-desc"><p>A string or an array of strings to add to the uiCls</p>
1449 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1450 </li></ul></div></div></div><div id="method-addEvents" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-addEvents" rel="method-addEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-addEvents" class="viewSource">view source</a></div><a name="addEvents"></a><a name="method-addEvents"></a><a href="Ext.form.field.ComboBox.html#" rel="method-addEvents" class="cls expand">addEvents</a>(
1451 <span class="pre">Object/String o, String </span>)
1452  : void</div><div class="description"><div class="short"><p>Adds the specified events to the list of events which this Observable may fire.</p>
1453 </div><div class="long"><p>Adds the specified events to the list of events which this Observable may fire.</p>
1454 <h3 class="pa">Parameters</h3><ul><li><span class="pre">o</span> : Object/String<div class="sub-desc"><p>Either an object with event names as properties with a value of <code>true</code>
1455 or the first event name string if multiple event names are being passed as separate parameters.</p>
1456 </div></li><li><span class="pre"></span> : String<div class="sub-desc"><p>[additional] Optional additional event names if multiple event names are being passed as separate parameters.
1457 Usage:</p>
1458
1459 <pre><code>this.addEvents('storeloaded', 'storecleared');
1460 </code></pre>
1461
1462 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1463 </li></ul></div></div></div><div id="method-addListener" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-addListener" rel="method-addListener" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-addListener" class="viewSource">view source</a></div><a name="addListener"></a><a name="method-addListener"></a><a href="Ext.form.field.ComboBox.html#" rel="method-addListener" class="cls expand">addListener</a>(
1464 <span class="pre">String eventName, Function handler, [Object scope], [Object options]</span>)
1465  : void</div><div class="description"><div class="short"><p>Appends an event handler to this object.</p>
1466 </div><div class="long"><p>Appends an event handler to this object.</p>
1467 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The name of the event to listen for. May also be an object who's property names are event names. See</p>
1468 </div></li><li><span class="pre">handler</span> : Function<div class="sub-desc"><p>The method the event invokes.</p>
1469 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope (<code><b>this</b></code> reference) in which the handler function is executed.
1470 <b>If omitted, defaults to the object which fired the event.</b></p>
1471 </div></li><li><span class="pre">options</span> : Object<div class="sub-desc"><p>(optional) An object containing handler configuration.
1472 properties. This may contain any of the following properties:<ul>
1473 <li><b>scope</b> : Object<div class="sub-desc">The scope (<code><b>this</b></code> reference) in which the handler function is executed.
1474 <b>If omitted, defaults to the object which fired the event.</b></div></li>
1475 <li><b>delay</b> : Number<div class="sub-desc">The number of milliseconds to delay the invocation of the handler after the event fires.</div></li>
1476 <li><b>single</b> : Boolean<div class="sub-desc">True to add a handler to handle just the next firing of the event, and then remove itself.</div></li>
1477 <li><b>buffer</b> : Number<div class="sub-desc">Causes the handler to be scheduled to run in an <a href="Ext.util.DelayedTask.html" rel="Ext.util.DelayedTask" class="docClass">Ext.util.DelayedTask</a> delayed
1478 by the specified number of milliseconds. If the event fires again within that time, the original
1479 handler is <em>not</em> invoked, but the new handler is scheduled in its place.</div></li>
1480 <li><b>target</b> : Observable<div class="sub-desc">Only call the handler if the event was fired on the target Observable, <i>not</i>
1481 if the event was bubbled up from a child Observable.</div></li>
1482 <li><b>element</b> : String<div class="sub-desc"><b>This option is only valid for listeners bound to <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Components</a>.</b>
1483 The name of a Component property which references an element to add a listener to.</p>
1484
1485 <p>This option is useful during Component construction to add DOM event listeners to elements of <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Components</a> which
1486 will exist only after the Component is rendered. For example, to add a click listener to a Panel's body:
1487 <pre><code>new Ext.panel.Panel({
1488     title: 'The title',
1489     listeners: {
1490         click: this.handlePanelClick,
1491         element: 'body'
1492     }
1493 });
1494 </code></pre></p>
1495
1496
1497 <p>When added in this way, the options available are the options applicable to <a href="Ext.core.Element.html#addListener" rel="Ext.core.Element#addListener" class="docClass">Ext.core.Element.addListener</a></p>
1498
1499
1500 <p></div></li>
1501 </ul><br></p>
1502
1503 <p>
1504 <b>Combining Options</b><br>
1505 Using the options argument, it is possible to combine different types of listeners:<br>
1506 <br>
1507 A delayed, one-time listener.
1508 <pre><code>myPanel.on('hide', this.handleClick, this, {
1509 single: true,
1510 delay: 100
1511 });</code></pre>
1512 <p>
1513 <b>Attaching multiple handlers in 1 call</b><br>
1514 The method also allows for a single argument to be passed which is a config object containing properties
1515 which specify multiple events. For example:
1516 <pre><code>myGridPanel.on({
1517     cellClick: this.onCellClick,
1518     mouseover: this.onMouseOver,
1519     mouseout: this.onMouseOut,
1520     scope: this // Important. Ensure "this" is correct during handler execution
1521 });
1522 </code></pre>.
1523 <p>
1524
1525 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1526 </li></ul></div></div></div><div id="method-addManagedListener" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-addManagedListener" rel="method-addManagedListener" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-addManagedListener" class="viewSource">view source</a></div><a name="addManagedListener"></a><a name="method-addManagedListener"></a><a href="Ext.form.field.ComboBox.html#" rel="method-addManagedListener" class="cls expand">addManagedListener</a>(
1527 <span class="pre">Observable/Element item, Object/String ename, Function fn, Object scope, Object opt</span>)
1528  : void</div><div class="description"><div class="short"><p>Adds listeners to any Observable object (or Element) which are automatically removed when this Component
1529 is destroyed.
1530
1531 </div><div class="long"><p>Adds listeners to any Observable object (or Element) which are automatically removed when this Component
1532 is destroyed.
1533
1534 <h3 class="pa">Parameters</h3><ul><li><span class="pre">item</span> : Observable/Element<div class="sub-desc"><p>The item to which to add a listener/listeners.</p>
1535 </div></li><li><span class="pre">ename</span> : Object/String<div class="sub-desc"><p>The event name, or an object containing event name properties.</p>
1536 </div></li><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>Optional. If the <code>ename</code> parameter was an event name, this
1537 is the handler function.</p>
1538 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>Optional. If the <code>ename</code> parameter was an event name, this
1539 is the scope (<code>this</code> reference) in which the handler function is executed.</p>
1540 </div></li><li><span class="pre">opt</span> : Object<div class="sub-desc"><p>Optional. If the <code>ename</code> parameter was an event name, this
1541 is the <a href="Ext.util.Observable.html#addListener" rel="Ext.util.Observable#addListener" class="docClass">addListener</a> options.</p>
1542 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1543 </li></ul></div></div></div><div id="method-addStateEvents" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-addStateEvents" rel="method-addStateEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-method-addStateEvents" class="viewSource">view source</a></div><a name="addStateEvents"></a><a name="method-addStateEvents"></a><a href="Ext.form.field.ComboBox.html#" rel="method-addStateEvents" class="cls expand">addStateEvents</a>(
1544 <span class="pre">String/Array events</span>)
1545  : void</div><div class="description"><div class="short"><p>Add events that will trigger the state to be saved.</p>
1546 </div><div class="long"><p>Add events that will trigger the state to be saved.</p>
1547 <h3 class="pa">Parameters</h3><ul><li><span class="pre">events</span> : String/Array<div class="sub-desc"><p>The event name or an array of event names.</p>
1548 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1549 </li></ul></div></div></div><div id="method-afterComponentLayout" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-afterComponentLayout" rel="method-afterComponentLayout" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-afterComponentLayout" class="viewSource">view source</a></div><a name="afterComponentLayout"></a><a name="method-afterComponentLayout"></a><a href="Ext.form.field.ComboBox.html#" rel="method-afterComponentLayout" class="cls expand">afterComponentLayout</a>(
1550 <span class="pre">Number adjWidth, Number adjHeight, Boolean isSetSize, Ext.Component layoutOwner</span>)
1551  : void</div><div class="description"><div class="short"><p>&nbsp;</p></div><div class="long">
1552 <h3 class="pa">Parameters</h3><ul><li><span class="pre">adjWidth</span> : Number<div class="sub-desc"><p>The box-adjusted width that was set</p>
1553 </div></li><li><span class="pre">adjHeight</span> : Number<div class="sub-desc"><p>The box-adjusted height that was set</p>
1554 </div></li><li><span class="pre">isSetSize</span> : Boolean<div class="sub-desc"><p>Whether or not the height/width are stored on the component permanently</p>
1555 </div></li><li><span class="pre">layoutOwner</span> : Ext.Component<div class="sub-desc"><p>Component which sent the layout. Only used when isSetSize is false.</p>
1556 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1557 </li></ul></div></div></div><div id="method-alignTo" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-alignTo" rel="method-alignTo" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Floating.html" class="definedIn docClass">Ext.util.Floating</a><br/><a href="../source/Floating.html#Ext-util.Floating-method-alignTo" class="viewSource">view source</a></div><a name="alignTo"></a><a name="method-alignTo"></a><a href="Ext.form.field.ComboBox.html#" rel="method-alignTo" class="cls expand">alignTo</a>(
1558 <span class="pre">Mixed element, String position, [Array offsets]</span>)
1559  : Component</div><div class="description"><div class="short"><p>Aligns this floating Component to the specified element</p>
1560 </div><div class="long"><p>Aligns this floating Component to the specified element</p>
1561 <h3 class="pa">Parameters</h3><ul><li><span class="pre">element</span> : Mixed<div class="sub-desc"><p>The element or <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a> to align to. If passing a component, it must
1562 be a omponent instance. If a string id is passed, it will be used as an element id.</p>
1563 </div></li><li><span class="pre">position</span> : String<div class="sub-desc"><p>(optional, defaults to "tl-bl?") The position to align to (see <a href="Ext.core.Element.html#alignTo" rel="Ext.core.Element#alignTo" class="docClass">Ext.core.Element.alignTo</a> for more details).</p>
1564 </div></li><li><span class="pre">offsets</span> : Array<div class="sub-desc"><p>(optional) Offset the positioning by [x, y]</p>
1565 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Component</span>&nbsp; &nbsp;<p>this</p>
1566 </li></ul></div></div></div><div id="method-animate" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-animate" rel="method-animate" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Animate.html" class="definedIn docClass">Ext.util.Animate</a><br/><a href="../source/Animate.html#Ext-util.Animate-method-animate" class="viewSource">view source</a></div><a name="animate"></a><a name="method-animate"></a><a href="Ext.form.field.ComboBox.html#" rel="method-animate" class="cls expand">animate</a>(
1567 <span class="pre">Object config</span>)
1568  : Object</div><div class="description"><div class="short">Perform custom animation on this object.
1569 This method is applicable to both the the Component class and the Element cl...</div><div class="long"><p>Perform custom animation on this object.<p>
1570 <p>This method is applicable to both the the <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Component</a> class and the <a href="Ext.core.Element.html" rel="Ext.core.Element" class="docClass">Element</a> class.
1571 It performs animated transitions of certain properties of this object over a specified timeline.</p>
1572 <p>The sole parameter is an object which specifies start property values, end property values, and properties which
1573 describe the timeline. Of the properties listed below, only <b><code>to</code></b> is mandatory.</p>
1574 <p>Properties include<ul>
1575 <li><code>from</code> <div class="sub-desc">An object which specifies start values for the properties being animated.
1576 If not supplied, properties are animated from current settings. The actual properties which may be animated depend upon
1577 ths object being animated. See the sections below on Element and Component animation.<div></li>
1578 <li><code>to</code> <div class="sub-desc">An object which specifies end values for the properties being animated.</div></li>
1579 <li><code>duration</code><div class="sub-desc">The duration <b>in milliseconds</b> for which the animation will run.</div></li>
1580 <li><code>easing</code> <div class="sub-desc">A string value describing an easing type to modify the rate of change from the default linear to non-linear. Values may be one of:<code><ul>
1581 <li>ease</li>
1582 <li>easeIn</li>
1583 <li>easeOut</li>
1584 <li>easeInOut</li>
1585 <li>backIn</li>
1586 <li>backOut</li>
1587 <li>elasticIn</li>
1588 <li>elasticOut</li>
1589 <li>bounceIn</li>
1590 <li>bounceOut</li>
1591 </ul></code></div></li>
1592 <li><code>keyframes</code> <div class="sub-desc">This is an object which describes the state of animated properties at certain points along the timeline.
1593 it is an object containing properties who's names are the percentage along the timeline being described and who's values specify the animation state at that point.</div></li>
1594 <li><code>listeners</code> <div class="sub-desc">This is a standard <a href="Ext.util.Observable.html#listeners" rel="Ext.util.Observable#listeners" class="docClass">listeners</a> configuration object which may be used
1595 to inject behaviour at either the <code>beforeanimate</code> event or the <code>afteranimate</code> event.</div></li>
1596 </ul></p>
1597 <h3>Animating an <a href="Ext.core.Element.html" rel="Ext.core.Element" class="docClass">Element</a></h3>
1598 When animating an Element, the following properties may be specified in <code>from</code>, <code>to</code>, and <code>keyframe</code> objects:<ul>
1599 <li><code>x</code> <div class="sub-desc">The page X position in pixels.</div></li>
1600 <li><code>y</code> <div class="sub-desc">The page Y position in pixels</div></li>
1601 <li><code>left</code> <div class="sub-desc">The element's CSS <code>left</code> value. Units must be supplied.</div></li>
1602 <li><code>top</code> <div class="sub-desc">The element's CSS <code>top</code> value. Units must be supplied.</div></li>
1603 <li><code>width</code> <div class="sub-desc">The element's CSS <code>width</code> value. Units must be supplied.</div></li>
1604 <li><code>height</code> <div class="sub-desc">The element's CSS <code>height</code> value. Units must be supplied.</div></li>
1605 <li><code>scrollLeft</code> <div class="sub-desc">The element's <code>scrollLeft</code> value.</div></li>
1606 <li><code>scrollTop</code> <div class="sub-desc">The element's <code>scrollLeft</code> value.</div></li>
1607 <li><code>opacity</code> <div class="sub-desc">The element's <code>opacity</code> value. This must be a value between <code>0</code> and <code>1</code>.</div></li>
1608 </ul>
1609 <p><b>Be aware than animating an Element which is being used by an <a href="Ext.html" rel="Ext" class="docClass">Ext</a> Component without in some way informing the Component about the changed element state
1610 will result in incorrect Component behaviour. This is because the Component will be using the old state of the element. To avoid this problem, it is now possible to
1611 directly animate certain properties of Components.</b></p>
1612 <h3>Animating a <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Component</a></h3>
1613 When animating an Element, the following properties may be specified in <code>from</code>, <code>to</code>, and <code>keyframe</code> objects:<ul>
1614 <li><code>x</code> <div class="sub-desc">The Component's page X position in pixels.</div></li>
1615 <li><code>y</code> <div class="sub-desc">The Component's page Y position in pixels</div></li>
1616 <li><code>left</code> <div class="sub-desc">The Component's <code>left</code> value in pixels.</div></li>
1617 <li><code>top</code> <div class="sub-desc">The Component's <code>top</code> value in pixels.</div></li>
1618 <li><code>width</code> <div class="sub-desc">The Component's <code>width</code> value in pixels.</div></li>
1619 <li><code>width</code> <div class="sub-desc">The Component's <code>width</code> value in pixels.</div></li>
1620 <li><code>dynamic</code> <div class="sub-desc">Specify as true to update the Component's layout (if it is a Container) at every frame
1621 of the animation. <i>Use sparingly as laying out on every intermediate size change is an expensive operation</i>.</div></li>
1622 </ul>
1623 <p>For example, to animate a Window to a new size, ensuring that its internal layout, and any shadow is correct:</p>
1624 <pre><code>myWindow = Ext.create('Ext.window.Window', {
1625     title: 'Test Component animation',
1626     width: 500,
1627     height: 300,
1628     layout: {
1629         type: 'hbox',
1630         align: 'stretch'
1631     },
1632     items: [{
1633         title: 'Left: 33%',
1634         margins: '5 0 5 5',
1635         flex: 1
1636     }, {
1637         title: 'Left: 66%',
1638         margins: '5 5 5 5',
1639         flex: 2
1640     }]
1641 });
1642 myWindow.show();
1643 myWindow.header.el.on('click', function() {
1644     myWindow.animate({
1645         to: {
1646             width: (myWindow.getWidth() == 500) ? 700 : 500,
1647             height: (myWindow.getHeight() == 300) ? 400 : 300,
1648         }
1649     });
1650 });
1651 </code></pre>
1652 <p>For performance reasons, by default, the internal layout is only updated when the Window reaches its final <code>"to"</code> size. If dynamic updating of the Window's child
1653 Components is required, then configure the animation with <code>dynamic: true</code> and the two child items will maintain their proportions during the animation.</p>
1654
1655 <h3 class="pa">Parameters</h3><ul><li><span class="pre">config</span> : Object<div class="sub-desc"><p>An object containing properties which describe the animation's start and end states, and the timeline of the animation.</p>
1656 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>this</p>
1657 </li></ul></div></div></div><div id="method-applyState" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-applyState" rel="method-applyState" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-method-applyState" class="viewSource">view source</a></div><a name="applyState"></a><a name="method-applyState"></a><a href="Ext.form.field.ComboBox.html#" rel="method-applyState" class="cls expand">applyState</a>(
1658 <span class="pre">Object state</span>)
1659  : void</div><div class="description"><div class="short">Applies the state to the object. This should be overridden in subclasses to do
1660 more complex state operations. By defa...</div><div class="long"><p>Applies the state to the object. This should be overridden in subclasses to do
1661 more complex state operations. By default it applies the state properties onto
1662 the current object.</p>
1663 <h3 class="pa">Parameters</h3><ul><li><span class="pre">state</span> : Object<div class="sub-desc"><p>The state</p>
1664 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1665 </li></ul></div></div></div><div id="method-autoSize" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-autoSize" rel="method-autoSize" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-method-autoSize" class="viewSource">view source</a></div><a name="autoSize"></a><a name="method-autoSize"></a><a href="Ext.form.field.ComboBox.html#" rel="method-autoSize" class="cls expand">autoSize</a> : void</div><div class="description"><div class="short">Automatically grows the field to accomodate the width of the text up to the maximum field width allowed.
1666 This only ta...</div><div class="long"><p>Automatically grows the field to accomodate the width of the text up to the maximum field width allowed.
1667 This only takes effect if <tt><a href="Ext.form.field.ComboBox.html#grow" rel="Ext.form.field.ComboBox#grow" class="docClass">grow</a> = true</tt>, and fires the <a href="Ext.form.field.ComboBox.html#autosize" rel="Ext.form.field.ComboBox#autosize" class="docClass">autosize</a> event if the
1668 width changes.</p>
1669 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1670 </li></ul></div></div></div><div id="method-batchChanges" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-batchChanges" rel="method-batchChanges" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-batchChanges" class="viewSource">view source</a></div><a name="batchChanges"></a><a name="method-batchChanges"></a><a href="Ext.form.field.ComboBox.html#" rel="method-batchChanges" class="cls expand">batchChanges</a>(
1671 <span class="pre">Object fn</span>)
1672  : void</div><div class="description"><div class="short">A utility for grouping a set of modifications which may trigger value changes into a single
1673 transaction, to prevent e...</div><div class="long"><p>A utility for grouping a set of modifications which may trigger value changes into a single
1674 transaction, to prevent excessive firing of <a href="Ext.form.field.ComboBox.html#change" rel="Ext.form.field.ComboBox#change" class="docClass">change</a> events. This is useful for instance
1675 if the field has sub-fields which are being updated as a group; you don't want the container
1676 field to check its own changed state for each subfield change.</p>
1677 <h3 class="pa">Parameters</h3><ul><li><span class="pre">fn</span> : Object<div class="sub-desc"><p>A function containing the transaction code</p>
1678 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1679 </li></ul></div></div></div><div id="method-beforeComponentLayout" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-beforeComponentLayout" rel="method-beforeComponentLayout" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-beforeComponentLayout" class="viewSource">view source</a></div><a name="beforeComponentLayout"></a><a name="method-beforeComponentLayout"></a><a href="Ext.form.field.ComboBox.html#" rel="method-beforeComponentLayout" class="cls expand">beforeComponentLayout</a>(
1680 <span class="pre">Number adjWidth, Number adjHeight, Boolean isSetSize, Ext.Component layoutOwner</span>)
1681  : void</div><div class="description"><div class="short">Occurs before componentLayout is run. Returning false from this method will prevent the componentLayout
1682 from being ex...</div><div class="long"><p>Occurs before componentLayout is run. Returning false from this method will prevent the componentLayout
1683 from being executed.</p>
1684 <h3 class="pa">Parameters</h3><ul><li><span class="pre">adjWidth</span> : Number<div class="sub-desc"><p>The box-adjusted width that was set</p>
1685 </div></li><li><span class="pre">adjHeight</span> : Number<div class="sub-desc"><p>The box-adjusted height that was set</p>
1686 </div></li><li><span class="pre">isSetSize</span> : Boolean<div class="sub-desc"><p>Whether or not the height/width are stored on the component permanently</p>
1687 </div></li><li><span class="pre">layoutOwner</span> : Ext.Component<div class="sub-desc"><p>Component which sent the layout. Only used when isSetSize is false.</p>
1688 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1689 </li></ul></div></div></div><div id="method-bubble" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-bubble" rel="method-bubble" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-bubble" class="viewSource">view source</a></div><a name="bubble"></a><a name="method-bubble"></a><a href="Ext.form.field.ComboBox.html#" rel="method-bubble" class="cls expand">bubble</a>(
1690 <span class="pre">Function fn, [Object scope], [Array args]</span>)
1691  : Ext.Component</div><div class="description"><div class="short">Bubbles up the component/container heirarchy, calling the specified function with each component. The scope (this) of...</div><div class="long"><p>Bubbles up the component/container heirarchy, calling the specified function with each component. The scope (<i>this</i>) of
1692 function call will be the scope provided or the current component. The arguments to the function
1693 will be the args provided or the current component. If the function returns false at any point,
1694 the bubble is stopped.</p>
1695 <h3 class="pa">Parameters</h3><ul><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>The function to call</p>
1696 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope of the function (defaults to current node)</p>
1697 </div></li><li><span class="pre">args</span> : Array<div class="sub-desc"><p>(optional) The args to call the function with (default to passing the current component)</p>
1698 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
1699 </li></ul></div></div></div><div id="method-capture" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-capture" rel="method-capture" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-capture" class="viewSource">view source</a></div><a name="capture"></a><a name="method-capture"></a><a href="Ext.form.field.ComboBox.html#" rel="method-capture" class="cls expand">capture</a>(
1700 <span class="pre">Observable o, Function fn, [Object scope]</span>)
1701  : void</div><div class="description"><div class="short">Starts capture on the specified Observable. All events will be passed
1702 to the supplied function with the event name + ...</div><div class="long"><p>Starts capture on the specified Observable. All events will be passed
1703 to the supplied function with the event name + standard signature of the event
1704 <b>before</b> the event is fired. If the supplied function returns false,
1705 the event will not fire.</p>
1706 <h3 class="pa">Parameters</h3><ul><li><span class="pre">o</span> : Observable<div class="sub-desc"><p>The Observable to capture events from.</p>
1707 </div></li><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>The function to call when an event is fired.</p>
1708 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope (<code>this</code> reference) in which the function is executed. Defaults to the Observable firing the event.</p>
1709 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1710 </li></ul></div></div></div><div id="method-center" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-center" rel="method-center" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Floating.html" class="definedIn docClass">Ext.util.Floating</a><br/><a href="../source/Floating.html#Ext-util.Floating-method-center" class="viewSource">view source</a></div><a name="center"></a><a name="method-center"></a><a href="Ext.form.field.ComboBox.html#" rel="method-center" class="cls expand">center</a> : Component</div><div class="description"><div class="short"><p>Center this Component in its container.</p>
1711 </div><div class="long"><p>Center this Component in its container.</p>
1712 <h3 class="pa">Returns</h3><ul><li><span class="pre">Component</span>&nbsp; &nbsp;<p>this</p>
1713 </li></ul></div></div></div><div id="method-checkChange" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-checkChange" rel="method-checkChange" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-checkChange" class="viewSource">view source</a></div><a name="checkChange"></a><a name="method-checkChange"></a><a href="Ext.form.field.ComboBox.html#" rel="method-checkChange" class="cls expand">checkChange</a> : void</div><div class="description"><div class="short">Checks whether the value of the field has changed since the last time it was checked. If the value
1714 has changed, it:
1715
1716 ...</div><div class="long"><p>Checks whether the value of the field has changed since the last time it was checked. If the value
1717 has changed, it:</p>
1718
1719
1720 <ol>
1721 <li>Fires the <a href="Ext.form.field.ComboBox.html#change" rel="Ext.form.field.ComboBox#change" class="docClass">change event</a>,</li>
1722 <li>Performs validation if the <a href="Ext.form.field.ComboBox.html#validateOnChange" rel="Ext.form.field.ComboBox#validateOnChange" class="docClass">validateOnChange</a> config is enabled, firing the
1723 <a href="Ext.form.field.ComboBox.html#validationchange" rel="Ext.form.field.ComboBox#validationchange" class="docClass">validationchange event</a> if the validity has changed, and</li>
1724 <li>Checks the <a href="Ext.form.field.ComboBox.html#isDirty" rel="Ext.form.field.ComboBox#isDirty" class="docClass">dirty state</a> of the field and fires the <a href="Ext.form.field.ComboBox.html#dirtychange" rel="Ext.form.field.ComboBox#dirtychange" class="docClass">dirtychange event</a>
1725 if it has changed.</li>
1726 </ol>
1727
1728 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1729 </li></ul></div></div></div><div id="method-checkDirty" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-checkDirty" rel="method-checkDirty" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-checkDirty" class="viewSource">view source</a></div><a name="checkDirty"></a><a name="method-checkDirty"></a><a href="Ext.form.field.ComboBox.html#" rel="method-checkDirty" class="cls expand">checkDirty</a> : void</div><div class="description"><div class="short">Checks the isDirty state of the field and if it has changed since the last time
1730 it was checked, fires the dirtychange...</div><div class="long"><p>Checks the <a href="Ext.form.field.ComboBox.html#isDirty" rel="Ext.form.field.ComboBox#isDirty" class="docClass">isDirty</a> state of the field and if it has changed since the last time
1731 it was checked, fires the <a href="Ext.form.field.ComboBox.html#dirtychange" rel="Ext.form.field.ComboBox#dirtychange" class="docClass">dirtychange</a> event.</p>
1732 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1733 </li></ul></div></div></div><div id="method-clearInvalid" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-clearInvalid" rel="method-clearInvalid" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-clearInvalid" class="viewSource">view source</a></div><a name="clearInvalid"></a><a name="method-clearInvalid"></a><a href="Ext.form.field.ComboBox.html#" rel="method-clearInvalid" class="cls expand">clearInvalid</a> : void</div><div class="description"><div class="short">Clear any invalid styles/messages for this field.
1734
1735
1736 Note: this method does not cause the Field's validate or isValid ...</div><div class="long"><p>Clear any invalid styles/messages for this field.</p>
1737
1738
1739 <p><b>Note</b>: this method does not cause the Field's <a href="Ext.form.field.ComboBox.html#validate" rel="Ext.form.field.ComboBox#validate" class="docClass">validate</a> or <a href="Ext.form.field.ComboBox.html#isValid" rel="Ext.form.field.ComboBox#isValid" class="docClass">isValid</a> methods to
1740 return <code>true</code> if the value does not <i>pass</i> validation. So simply clearing a field's errors
1741 will not necessarily allow submission of forms submitted with the <a href="Ext.form.action.Submit.html#clientValidation" rel="Ext.form.action.Submit#clientValidation" class="docClass">Ext.form.action.Submit.clientValidation</a>
1742 option set.</p>
1743
1744 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1745 </li></ul></div></div></div><div id="method-clearListeners" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-clearListeners" rel="method-clearListeners" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-clearListeners" class="viewSource">view source</a></div><a name="clearListeners"></a><a name="method-clearListeners"></a><a href="Ext.form.field.ComboBox.html#" rel="method-clearListeners" class="cls expand">clearListeners</a> : void</div><div class="description"><div class="short"><p>Removes all listeners for this object including the managed listeners</p>
1746 </div><div class="long"><p>Removes all listeners for this object including the managed listeners</p>
1747 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1748 </li></ul></div></div></div><div id="method-clearManagedListeners" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-clearManagedListeners" rel="method-clearManagedListeners" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-clearManagedListeners" class="viewSource">view source</a></div><a name="clearManagedListeners"></a><a name="method-clearManagedListeners"></a><a href="Ext.form.field.ComboBox.html#" rel="method-clearManagedListeners" class="cls expand">clearManagedListeners</a> : void</div><div class="description"><div class="short"><p>Removes all managed listeners for this object.</p>
1749 </div><div class="long"><p>Removes all managed listeners for this object.</p>
1750 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1751 </li></ul></div></div></div><div id="method-clearValue" class="member ni"><a href="Ext.form.field.ComboBox.html#method-clearValue" rel="method-clearValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-method-clearValue" class="viewSource">view source</a></div><a name="clearValue"></a><a name="method-clearValue"></a><a href="Ext.form.field.ComboBox.html#" rel="method-clearValue" class="cls expand">clearValue</a> : void</div><div class="description"><div class="short"><p>Clears any value currently set in the ComboBox.</p>
1752 </div><div class="long"><p>Clears any value currently set in the ComboBox.</p>
1753 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1754 </li></ul></div></div></div><div id="method-cloneConfig" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-cloneConfig" rel="method-cloneConfig" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-cloneConfig" class="viewSource">view source</a></div><a name="cloneConfig"></a><a name="method-cloneConfig"></a><a href="Ext.form.field.ComboBox.html#" rel="method-cloneConfig" class="cls expand">cloneConfig</a>(
1755 <span class="pre">Object overrides</span>)
1756  : Ext.Component</div><div class="description"><div class="short"><p>Clone the current component using the original config values passed into this instance by default.</p>
1757 </div><div class="long"><p>Clone the current component using the original config values passed into this instance by default.</p>
1758 <h3 class="pa">Parameters</h3><ul><li><span class="pre">overrides</span> : Object<div class="sub-desc"><p>A new config containing any properties to override in the cloned version.
1759 An id property can be passed on this object, otherwise one will be generated to avoid duplicates.</p>
1760 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>clone The cloned copy of this component</p>
1761 </li></ul></div></div></div><div id="method-collapse" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-collapse" rel="method-collapse" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Picker.html" class="definedIn docClass">Ext.form.field.Picker</a><br/><a href="../source/Picker.html#Ext-form.field.Picker-method-collapse" class="viewSource">view source</a></div><a name="collapse"></a><a name="method-collapse"></a><a href="Ext.form.field.ComboBox.html#" rel="method-collapse" class="cls expand">collapse</a> : void</div><div class="description"><div class="short"><p>Collapse this field's picker dropdown.</p>
1762 </div><div class="long"><p>Collapse this field's picker dropdown.</p>
1763 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1764 </li></ul></div></div></div><div id="method-destroy" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-destroy" rel="method-destroy" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-method-destroy" class="viewSource">view source</a></div><a name="destroy"></a><a name="method-destroy"></a><a href="Ext.form.field.ComboBox.html#" rel="method-destroy" class="cls expand">destroy</a> : void</div><div class="description"><div class="short"><p>Destroys this stateful object.</p>
1765 </div><div class="long"><p>Destroys this stateful object.</p>
1766 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1767 </li></ul></div></div></div><div id="method-disable" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-disable" rel="method-disable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-disable" class="viewSource">view source</a></div><a name="disable"></a><a name="method-disable"></a><a href="Ext.form.field.ComboBox.html#" rel="method-disable" class="cls expand">disable</a>(
1768 <span class="pre">Boolean silent</span>)
1769  : void</div><div class="description"><div class="short"><p>Disable the component.</p>
1770 </div><div class="long"><p>Disable the component.</p>
1771 <h3 class="pa">Parameters</h3><ul><li><span class="pre">silent</span> : Boolean<div class="sub-desc"><p>Passing true, will supress the 'disable' event from being fired.</p>
1772 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1773 </li></ul></div></div></div><div id="method-doAutoRender" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-doAutoRender" rel="method-doAutoRender" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-doAutoRender" class="viewSource">view source</a></div><a name="doAutoRender"></a><a name="method-doAutoRender"></a><a href="Ext.form.field.ComboBox.html#" rel="method-doAutoRender" class="cls expand">doAutoRender</a> : void</div><div class="description"><div class="short">Handles autoRender.
1774 Floating Components may have an ownerCt. If they are asking to be constrained, constrain them wit...</div><div class="long"><p>Handles autoRender.
1775 Floating Components may have an ownerCt. If they are asking to be constrained, constrain them within that
1776 ownerCt, and have their z-index managed locally. Floating Components are always rendered to document.body</p>
1777 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1778 </li></ul></div></div></div><div id="method-doComponentLayout" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-doComponentLayout" rel="method-doComponentLayout" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-doComponentLayout" class="viewSource">view source</a></div><a name="doComponentLayout"></a><a name="method-doComponentLayout"></a><a href="Ext.form.field.ComboBox.html#" rel="method-doComponentLayout" class="cls expand">doComponentLayout</a>(
1779 <span class="pre">Object width, Object height, Object isSetSize, Object ownerCt</span>)
1780  : Ext.container.Container</div><div class="description"><div class="short">This method needs to be called whenever you change something on this component that requires the Component's
1781 layout t...</div><div class="long"><p>This method needs to be called whenever you change something on this component that requires the Component's
1782 layout to be recalculated.</p>
1783 <h3 class="pa">Parameters</h3><ul><li><span class="pre">width</span> : Object<div class="sub-desc">
1784 </div></li><li><span class="pre">height</span> : Object<div class="sub-desc">
1785 </div></li><li><span class="pre">isSetSize</span> : Object<div class="sub-desc">
1786 </div></li><li><span class="pre">ownerCt</span> : Object<div class="sub-desc">
1787 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.container.Container</span>&nbsp; &nbsp;<p>this</p>
1788 </li></ul></div></div></div><div id="method-doConstrain" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-doConstrain" rel="method-doConstrain" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Floating.html" class="definedIn docClass">Ext.util.Floating</a><br/><a href="../source/Floating.html#Ext-util.Floating-method-doConstrain" class="viewSource">view source</a></div><a name="doConstrain"></a><a name="method-doConstrain"></a><a href="Ext.form.field.ComboBox.html#" rel="method-doConstrain" class="cls expand">doConstrain</a>(
1789 <span class="pre">Mixed constrainTo</span>)
1790  : void</div><div class="description"><div class="short">Moves this floating Component into a constrain region.
1791
1792
1793 By default, this Component is constrained to be within the c...</div><div class="long"><p>Moves this floating Component into a constrain region.</p>
1794
1795
1796 <p>By default, this Component is constrained to be within the container it was added to, or the element
1797 it was rendered to.</p>
1798
1799
1800 <p>An alternative constraint may be passed.</p>
1801
1802 <h3 class="pa">Parameters</h3><ul><li><span class="pre">constrainTo</span> : Mixed<div class="sub-desc"><p>Optional. The Element or <a href="Ext.util.Region.html" rel="Ext.util.Region" class="docClass">Region</a> into which this Component is to be constrained.</p>
1803 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1804 </li></ul></div></div></div><div id="method-doQuery" class="member ni"><a href="Ext.form.field.ComboBox.html#method-doQuery" rel="method-doQuery" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-method-doQuery" class="viewSource">view source</a></div><a name="doQuery"></a><a name="method-doQuery"></a><a href="Ext.form.field.ComboBox.html#" rel="method-doQuery" class="cls expand">doQuery</a>(
1805 <span class="pre">String queryString, Boolean forceAll</span>)
1806  : Boolean</div><div class="description"><div class="short">Executes a query to filter the dropdown list. Fires the beforequery event prior to performing the
1807 query allowing the ...</div><div class="long"><p>Executes a query to filter the dropdown list. Fires the <a href="Ext.form.field.ComboBox.html#beforequery" rel="Ext.form.field.ComboBox#beforequery" class="docClass">beforequery</a> event prior to performing the
1808 query allowing the query action to be canceled if needed.</p>
1809 <h3 class="pa">Parameters</h3><ul><li><span class="pre">queryString</span> : String<div class="sub-desc"><p>The SQL query to execute</p>
1810 </div></li><li><span class="pre">forceAll</span> : Boolean<div class="sub-desc"><p><tt>true</tt> to force the query to execute even if there are currently fewer
1811 characters in the field than the minimum specified by the <tt><a href="Ext.form.field.ComboBox.html#minChars" rel="Ext.form.field.ComboBox#minChars" class="docClass">minChars</a></tt> config option.  It
1812 also clears any filter previously saved in the current store (defaults to <tt>false</tt>)</p>
1813 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>true if the query was permitted to run, false if it was cancelled by a <a href="Ext.form.field.ComboBox.html#beforequery" rel="Ext.form.field.ComboBox#beforequery" class="docClass">beforequery</a> handler.</p>
1814 </li></ul></div></div></div><div id="method-enable" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-enable" rel="method-enable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-enable" class="viewSource">view source</a></div><a name="enable"></a><a name="method-enable"></a><a href="Ext.form.field.ComboBox.html#" rel="method-enable" class="cls expand">enable</a>(
1815 <span class="pre">Boolean silent</span>)
1816  : void</div><div class="description"><div class="short"><p>Enable the component</p>
1817 </div><div class="long"><p>Enable the component</p>
1818 <h3 class="pa">Parameters</h3><ul><li><span class="pre">silent</span> : Boolean<div class="sub-desc"><p>Passing false will supress the 'enable' event from being fired.</p>
1819 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1820 </li></ul></div></div></div><div id="method-enableBubble" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-enableBubble" rel="method-enableBubble" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-enableBubble" class="viewSource">view source</a></div><a name="enableBubble"></a><a name="method-enableBubble"></a><a href="Ext.form.field.ComboBox.html#" rel="method-enableBubble" class="cls expand">enableBubble</a>(
1821 <span class="pre">String/Array events</span>)
1822  : void</div><div class="description"><div class="short">Enables events fired by this Observable to bubble up an owner hierarchy by calling
1823 this.getBubbleTarget() if present....</div><div class="long"><p>Enables events fired by this Observable to bubble up an owner hierarchy by calling
1824 <code>this.getBubbleTarget()</code> if present. There is no implementation in the Observable base class.</p>
1825
1826
1827 <p>This is commonly used by Ext.Components to bubble events to owner Containers. See <a href="Ext.Component.html#getBubbleTarget" rel="Ext.Component#getBubbleTarget" class="docClass">Ext.Component.getBubbleTarget</a>. The default
1828 implementation in <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a> returns the Component's immediate owner. But if a known target is required, this can be overridden to
1829 access the required target more quickly.</p>
1830
1831
1832 <p>Example:</p>
1833
1834
1835 <pre><code>Ext.override(Ext.form.field.Base, {
1836 //  Add functionality to Field&#39;s initComponent to enable the change event to bubble
1837 initComponent : Ext.Function.createSequence(Ext.form.field.Base.prototype.initComponent, function() {
1838     this.enableBubble('change');
1839 }),
1840
1841 //  We know that we want Field&#39;s events to bubble directly to the FormPanel.
1842 getBubbleTarget : function() {
1843     if (!this.formPanel) {
1844         this.formPanel = this.findParentByType('form');
1845     }
1846     return this.formPanel;
1847 }
1848 });
1849
1850 var myForm = new Ext.formPanel({
1851 title: 'User Details',
1852 items: [{
1853     ...
1854 }],
1855 listeners: {
1856     change: function() {
1857         // Title goes red if form has been modified.
1858         myForm.header.setStyle('color', 'red');
1859     }
1860 }
1861 });
1862 </code></pre>
1863
1864 <h3 class="pa">Parameters</h3><ul><li><span class="pre">events</span> : String/Array<div class="sub-desc"><p>The event name to bubble, or an Array of event names.</p>
1865 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1866 </li></ul></div></div></div><div id="method-expand" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-expand" rel="method-expand" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Picker.html" class="definedIn docClass">Ext.form.field.Picker</a><br/><a href="../source/Picker.html#Ext-form.field.Picker-method-expand" class="viewSource">view source</a></div><a name="expand"></a><a name="method-expand"></a><a href="Ext.form.field.ComboBox.html#" rel="method-expand" class="cls expand">expand</a> : void</div><div class="description"><div class="short"><p>Expand this field's picker dropdown.</p>
1867 </div><div class="long"><p>Expand this field's picker dropdown.</p>
1868 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1869 </li></ul></div></div></div><div id="method-extractFileInput" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-extractFileInput" rel="method-extractFileInput" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-extractFileInput" class="viewSource">view source</a></div><a name="extractFileInput"></a><a name="method-extractFileInput"></a><a href="Ext.form.field.ComboBox.html#" rel="method-extractFileInput" class="cls expand">extractFileInput</a> : HTMLInputElement</div><div class="description"><div class="short">Only relevant if the instance's isFileUpload method returns true. Returns a reference
1870 to the file input DOM element h...</div><div class="long"><p>Only relevant if the instance's <a href="Ext.form.field.ComboBox.html#isFileUpload" rel="Ext.form.field.ComboBox#isFileUpload" class="docClass">isFileUpload</a> method returns true. Returns a reference
1871 to the file input DOM element holding the user's selected file. The input will be appended into
1872 the submission form and will not be returned, so this method should also create a replacement.</p>
1873 <h3 class="pa">Returns</h3><ul><li><span class="pre">HTMLInputElement</span>&nbsp; &nbsp;
1874 </li></ul></div></div></div><div id="method-findLayoutController" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-findLayoutController" rel="method-findLayoutController" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-findLayoutController" class="viewSource">view source</a></div><a name="findLayoutController"></a><a name="method-findLayoutController"></a><a href="Ext.form.field.ComboBox.html#" rel="method-findLayoutController" class="cls expand">findLayoutController</a> : void</div><div class="description"><div class="short">This method finds the topmost active layout who's processing will eventually determine the size and position of this
1875 ...</div><div class="long"><p>This method finds the topmost active layout who's processing will eventually determine the size and position of this
1876 Component.<p>
1877 <p>This method is useful when dynamically adding Components into Containers, and some processing must take place after the
1878 final sizing and positioning of the Component has been performed.</p>
1879
1880 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1881 </li></ul></div></div></div><div id="method-findParentBy" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-findParentBy" rel="method-findParentBy" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-findParentBy" class="viewSource">view source</a></div><a name="findParentBy"></a><a name="method-findParentBy"></a><a href="Ext.form.field.ComboBox.html#" rel="method-findParentBy" class="cls expand">findParentBy</a>(
1882 <span class="pre">Function fn</span>)
1883  : Ext.container.Container</div><div class="description"><div class="short">Find a container above this component at any level by a custom function. If the passed function returns
1884 true, the con...</div><div class="long"><p>Find a container above this component at any level by a custom function. If the passed function returns
1885 true, the container will be returned.</p>
1886 <h3 class="pa">Parameters</h3><ul><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>The custom function to call with the arguments (container, this component).</p>
1887 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.container.Container</span>&nbsp; &nbsp;<p>The first Container for which the custom function returns true</p>
1888 </li></ul></div></div></div><div id="method-findParentByType" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-findParentByType" rel="method-findParentByType" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-findParentByType" class="viewSource">view source</a></div><a name="findParentByType"></a><a name="method-findParentByType"></a><a href="Ext.form.field.ComboBox.html#" rel="method-findParentByType" class="cls expand">findParentByType</a>(
1889 <span class="pre">String/Class xtype</span>)
1890  : Ext.container.Container</div><div class="description"><div class="short"><p>Find a container above this component at any level by xtype or class</p>
1891
1892
1893 <p>See also the <a href="Ext.Component.html#up" rel="Ext.Component#up" class="docClass">up</a> method.</p>
1894
1895 </div><div class="long"><p>Find a container above this component at any level by xtype or class</p>
1896
1897
1898 <p>See also the <a href="Ext.Component.html#up" rel="Ext.Component#up" class="docClass">up</a> method.</p>
1899
1900 <h3 class="pa">Parameters</h3><ul><li><span class="pre">xtype</span> : String/Class<div class="sub-desc"><p>The xtype string for a component, or the class of the component directly</p>
1901 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.container.Container</span>&nbsp; &nbsp;<p>The first Container which matches the given xtype or class</p>
1902 </li></ul></div></div></div><div id="method-fireEvent" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-fireEvent" rel="method-fireEvent" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-fireEvent" class="viewSource">view source</a></div><a name="fireEvent"></a><a name="method-fireEvent"></a><a href="Ext.form.field.ComboBox.html#" rel="method-fireEvent" class="cls expand">fireEvent</a>(
1903 <span class="pre">String eventName, Object... args</span>)
1904  : Boolean</div><div class="description"><div class="short">Fires the specified event with the passed parameters (minus the event name).
1905
1906
1907 An event may be set to bubble up an Ob...</div><div class="long"><p>Fires the specified event with the passed parameters (minus the event name).</p>
1908
1909
1910 <p>An event may be set to bubble up an Observable parent hierarchy (See <a href="Ext.Component.html#getBubbleTarget" rel="Ext.Component#getBubbleTarget" class="docClass">Ext.Component.getBubbleTarget</a>)
1911 by calling <a href="Ext.form.field.ComboBox.html#enableBubble" rel="Ext.form.field.ComboBox#enableBubble" class="docClass">enableBubble</a>.</p>
1912
1913 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The name of the event to fire.</p>
1914 </div></li><li><span class="pre">args</span> : Object...<div class="sub-desc"><p>Variable number of parameters are passed to handlers.</p>
1915 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>returns false if any of the handlers return false otherwise it returns true.</p>
1916 </li></ul></div></div></div><div id="method-focus" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-focus" rel="method-focus" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-focus" class="viewSource">view source</a></div><a name="focus"></a><a name="method-focus"></a><a href="Ext.form.field.ComboBox.html#" rel="method-focus" class="cls expand">focus</a>(
1917 <span class="pre">[Boolean selectText], [Boolean/Number delay]</span>)
1918  : Ext.Component</div><div class="description"><div class="short"><p>Try to focus this component.</p>
1919 </div><div class="long"><p>Try to focus this component.</p>
1920 <h3 class="pa">Parameters</h3><ul><li><span class="pre">selectText</span> : Boolean<div class="sub-desc"><p>(optional) If applicable, true to also select the text in this component</p>
1921 </div></li><li><span class="pre">delay</span> : Boolean/Number<div class="sub-desc"><p>(optional) Delay the focus this number of milliseconds (true for 10 milliseconds).</p>
1922 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
1923 </li></ul></div></div></div><div id="method-getActiveAnimation" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getActiveAnimation" rel="method-getActiveAnimation" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Animate.html" class="definedIn docClass">Ext.util.Animate</a><br/><a href="../source/Animate.html#Ext-util.Animate-method-getActiveAnimation" class="viewSource">view source</a></div><a name="getActiveAnimation"></a><a name="method-getActiveAnimation"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getActiveAnimation" class="cls expand">getActiveAnimation</a> : Mixed</div><div class="description"><div class="short"><p>Returns thq current animation if this object has any effects actively running or queued, else returns false.</p>
1924 </div><div class="long"><p>Returns thq current animation if this object has any effects actively running or queued, else returns false.</p>
1925 <h3 class="pa">Returns</h3><ul><li><span class="pre">Mixed</span>&nbsp; &nbsp;<p>anim if element has active effects, else false</p>
1926 </li></ul></div></div></div><div id="method-getActiveError" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getActiveError" rel="method-getActiveError" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-getActiveError" class="viewSource">view source</a></div><a name="getActiveError"></a><a name="method-getActiveError"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getActiveError" class="cls expand">getActiveError</a> : String</div><div class="description"><div class="short">Gets the active error message for this component, if any. This does not trigger
1927 validation on its own, it merely retu...</div><div class="long"><p>Gets the active error message for this component, if any. This does not trigger
1928 validation on its own, it merely returns any message that the component may already hold.</p>
1929 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>The active error message on the component; if there is no error, an empty string is returned.</p>
1930 </li></ul></div></div></div><div id="method-getActiveErrors" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getActiveErrors" rel="method-getActiveErrors" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-getActiveErrors" class="viewSource">view source</a></div><a name="getActiveErrors"></a><a name="method-getActiveErrors"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getActiveErrors" class="cls expand">getActiveErrors</a> : Array</div><div class="description"><div class="short">Gets an Array of any active error messages currently applied to the field. This does not trigger
1931 validation on its ow...</div><div class="long"><p>Gets an Array of any active error messages currently applied to the field. This does not trigger
1932 validation on its own, it merely returns any messages that the component may already hold.</p>
1933 <h3 class="pa">Returns</h3><ul><li><span class="pre">Array</span>&nbsp; &nbsp;<p>The active error messages on the component; if there are no errors, an empty Array is returned.</p>
1934 </li></ul></div></div></div><div id="method-getBox" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getBox" rel="method-getBox" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-getBox" class="viewSource">view source</a></div><a name="getBox"></a><a name="method-getBox"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getBox" class="cls expand">getBox</a>(
1935 <span class="pre">[Boolean local]</span>)
1936  : Object</div><div class="description"><div class="short"><p>Gets the current box measurements of the component's underlying element.</p>
1937 </div><div class="long"><p>Gets the current box measurements of the component's underlying element.</p>
1938 <h3 class="pa">Parameters</h3><ul><li><span class="pre">local</span> : Boolean<div class="sub-desc"><p>(optional) If true the element's left and top are returned instead of page XY (defaults to false)</p>
1939 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>box An object in the format {x, y, width, height}</p>
1940 </li></ul></div></div></div><div id="method-getBubbleTarget" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getBubbleTarget" rel="method-getBubbleTarget" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getBubbleTarget" class="viewSource">view source</a></div><a name="getBubbleTarget"></a><a name="method-getBubbleTarget"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getBubbleTarget" class="cls expand">getBubbleTarget</a> : Ext.container.Container</div><div class="description"><div class="short"><p>Provides the link for Observable's fireEvent method to bubble up the ownership hierarchy.</p>
1941 </div><div class="long"><p>Provides the link for Observable's fireEvent method to bubble up the ownership hierarchy.</p>
1942 <h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.container.Container</span>&nbsp; &nbsp;<p>the Container which owns this Component.</p>
1943 </li></ul></div></div></div><div id="method-getEl" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getEl" rel="method-getEl" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getEl" class="viewSource">view source</a></div><a name="getEl"></a><a name="method-getEl"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getEl" class="cls expand">getEl</a> : void</div><div class="description"><div class="short"><p>Retrieves the top level element representing this component.</p>
1944 </div><div class="long"><p>Retrieves the top level element representing this component.</p>
1945 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1946 </li></ul></div></div></div><div id="method-getErrors" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getErrors" rel="method-getErrors" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-getErrors" class="viewSource">view source</a></div><a name="getErrors"></a><a name="method-getErrors"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getErrors" class="cls expand">getErrors</a>(
1947 <span class="pre">Mixed value</span>)
1948  : Array</div><div class="description"><div class="short">Runs this field's validators and returns an array of error messages for any validation failures.
1949 This is called inter...</div><div class="long"><p>Runs this field's validators and returns an array of error messages for any validation failures.
1950 This is called internally during validation and would not usually need to be used manually.</p>
1951
1952
1953 <p>Each subclass should override or augment the return value to provide their own errors.</p>
1954
1955 <h3 class="pa">Parameters</h3><ul><li><span class="pre">value</span> : Mixed<div class="sub-desc"><p>The value to get errors for (defaults to the current field value)</p>
1956 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Array</span>&nbsp; &nbsp;<p>All error messages for this field; an empty Array if none.</p>
1957 </li></ul></div></div></div><div id="method-getFieldLabel" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getFieldLabel" rel="method-getFieldLabel" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-getFieldLabel" class="viewSource">view source</a></div><a name="getFieldLabel"></a><a name="method-getFieldLabel"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getFieldLabel" class="cls expand">getFieldLabel</a> : String</div><div class="description"><div class="short"><p>Returns the label for the field. Defaults to simply returning the <a href="Ext.form.field.ComboBox.html#fieldLabel" rel="Ext.form.field.ComboBox#fieldLabel" class="docClass">fieldLabel</a> config. Can be
1958 overridden to provide</p>
1959 </div><div class="long"><p>Returns the label for the field. Defaults to simply returning the <a href="Ext.form.field.ComboBox.html#fieldLabel" rel="Ext.form.field.ComboBox#fieldLabel" class="docClass">fieldLabel</a> config. Can be
1960 overridden to provide</p>
1961 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>The configured field label, or empty string if not defined</p>
1962 </li></ul></div></div></div><div id="method-getHeight" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getHeight" rel="method-getHeight" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getHeight" class="viewSource">view source</a></div><a name="getHeight"></a><a name="method-getHeight"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getHeight" class="cls expand">getHeight</a> : Number</div><div class="description"><div class="short"><p>Gets the current height of the component's underlying element.</p>
1963 </div><div class="long"><p>Gets the current height of the component's underlying element.</p>
1964 <h3 class="pa">Returns</h3><ul><li><span class="pre">Number</span>&nbsp; &nbsp;
1965 </li></ul></div></div></div><div id="method-getId" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getId" rel="method-getId" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getId" class="viewSource">view source</a></div><a name="getId"></a><a name="method-getId"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getId" class="cls expand">getId</a> : void</div><div class="description"><div class="short"><p>Retrieves the id of this component.
1966 Will autogenerate an id if one has not already been set.</p>
1967 </div><div class="long"><p>Retrieves the id of this component.
1968 Will autogenerate an id if one has not already been set.</p>
1969 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1970 </li></ul></div></div></div><div id="method-getInputId" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getInputId" rel="method-getInputId" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-getInputId" class="viewSource">view source</a></div><a name="getInputId"></a><a name="method-getInputId"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getInputId" class="cls expand">getInputId</a> : String</div><div class="description"><div class="short">Get the input id, if any, for this component. This is used as the "for" attribute on the label element.
1971 Implementing ...</div><div class="long"><p>Get the input id, if any, for this component. This is used as the "for" attribute on the label element.
1972 Implementing subclasses may also use this as e.g. the id for their own <tt>input</tt> element.</p>
1973 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>The input id</p>
1974 </li></ul></div></div></div><div id="method-getInsertPosition" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getInsertPosition" rel="method-getInsertPosition" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getInsertPosition" class="viewSource">view source</a></div><a name="getInsertPosition"></a><a name="method-getInsertPosition"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getInsertPosition" class="cls expand">getInsertPosition</a>(
1975 <span class="pre">String/Number/Element/HTMLElement position</span>)
1976  : HTMLElement</div><div class="description"><div class="short">This function takes the position argument passed to onRender and returns a
1977 DOM element that you can use in the insert...</div><div class="long"><p>This function takes the position argument passed to onRender and returns a
1978 DOM element that you can use in the insertBefore.</p>
1979 <h3 class="pa">Parameters</h3><ul><li><span class="pre">position</span> : String/Number/Element/HTMLElement<div class="sub-desc"><p>Index, element id or element you want
1980 to put this component before.</p>
1981 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">HTMLElement</span>&nbsp; &nbsp;<p>DOM element that you can use in the insertBefore</p>
1982 </li></ul></div></div></div><div id="method-getLoader" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getLoader" rel="method-getLoader" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getLoader" class="viewSource">view source</a></div><a name="getLoader"></a><a name="method-getLoader"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getLoader" class="cls expand">getLoader</a> : Ext.ComponentLoader</div><div class="description"><div class="short"><p>Gets the <a href="Ext.ComponentLoader.html" rel="Ext.ComponentLoader" class="docClass">Ext.ComponentLoader</a> for this Component.</p>
1983 </div><div class="long"><p>Gets the <a href="Ext.ComponentLoader.html" rel="Ext.ComponentLoader" class="docClass">Ext.ComponentLoader</a> for this Component.</p>
1984 <h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.ComponentLoader</span>&nbsp; &nbsp;<p>The loader instance, null if it doesn't exist.</p>
1985 </li></ul></div></div></div><div id="method-getModelData" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getModelData" rel="method-getModelData" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-getModelData" class="viewSource">view source</a></div><a name="getModelData"></a><a name="method-getModelData"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getModelData" class="cls expand">getModelData</a> : Object</div><div class="description"><div class="short">Returns the value(s) that should be saved to the Ext.data.Model instance for this field, when
1986 Ext.form.Basic.updateRe...</div><div class="long"><p>Returns the value(s) that should be saved to the <a href="Ext.data.Model.html" rel="Ext.data.Model" class="docClass">Ext.data.Model</a> instance for this field, when
1987 <a href="Ext.form.Basic.html#updateRecord" rel="Ext.form.Basic#updateRecord" class="docClass">Ext.form.Basic.updateRecord</a> is called. Typically this will be an object with a single name-value
1988 pair, the name being this field's <a href="Ext.form.field.ComboBox.html#getName" rel="Ext.form.field.ComboBox#getName" class="docClass">name</a> and the value being its current data value. More
1989 advanced field implementations may return more than one name-value pair. The returned values will be
1990 saved to the corresponding field names in the Model.</p>
1991
1992
1993 <p>Note that the values returned from this method are not guaranteed to have been successfully
1994 <a href="Ext.form.field.ComboBox.html#validate" rel="Ext.form.field.ComboBox#validate" class="docClass">validated</a>.</p>
1995
1996 <h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>A mapping of submit parameter names to values; each value should be a string, or an array
1997 of strings if that particular name has multiple values. It can also return <tt>null</tt> if there are no
1998 parameters to be submitted.</p>
1999 </li></ul></div></div></div><div id="method-getName" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getName" rel="method-getName" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-getName" class="viewSource">view source</a></div><a name="getName"></a><a name="method-getName"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getName" class="cls expand">getName</a> : String</div><div class="description"><div class="short">Returns the name attribute of the field. This is used as the parameter
2000 name when including the field value in a form ...</div><div class="long"><p>Returns the <a href="Ext.form.field.Field.html#name" rel="Ext.form.field.Field#name" class="docClass">name</a> attribute of the field. This is used as the parameter
2001 name when including the field value in a <a href="Ext.form.Basic.html#submit" rel="Ext.form.Basic#submit" class="docClass">form submit()</a>.</p>
2002 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>name The field <a href="Ext.form.field.Field.html#name" rel="Ext.form.field.Field#name" class="docClass">name</a></p>
2003 </li></ul></div></div></div><div id="method-getPicker" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getPicker" rel="method-getPicker" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Picker.html" class="definedIn docClass">Ext.form.field.Picker</a><br/><a href="../source/Picker.html#Ext-form.field.Picker-method-getPicker" class="viewSource">view source</a></div><a name="getPicker"></a><a name="method-getPicker"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getPicker" class="cls expand">getPicker</a> : Ext.Component</div><div class="description"><div class="short"><p>Return a reference to the picker component for this field, creating it if necessary by
2004 calling <a href="Ext.form.field.ComboBox.html#createPicker" rel="Ext.form.field.ComboBox#createPicker" class="docClass">createPicker</a>.</p>
2005 </div><div class="long"><p>Return a reference to the picker component for this field, creating it if necessary by
2006 calling <a href="Ext.form.field.ComboBox.html#createPicker" rel="Ext.form.field.ComboBox#createPicker" class="docClass">createPicker</a>.</p>
2007 <h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>The picker component</p>
2008 </li></ul></div></div></div><div id="method-getPlugin" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getPlugin" rel="method-getPlugin" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getPlugin" class="viewSource">view source</a></div><a name="getPlugin"></a><a name="method-getPlugin"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getPlugin" class="cls expand">getPlugin</a>(
2009 <span class="pre">Object pluginId</span>)
2010  : Ext.AbstractPlugin</div><div class="description"><div class="short"><p>Retrieves a plugin by its pluginId which has been bound to this
2011 component.</p>
2012 </div><div class="long"><p>Retrieves a plugin by its pluginId which has been bound to this
2013 component.</p>
2014 <h3 class="pa">Parameters</h3><ul><li><span class="pre">pluginId</span> : Object<div class="sub-desc">
2015 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.AbstractPlugin</span>&nbsp; &nbsp;<p>pluginInstance</p>
2016 </li></ul></div></div></div><div id="method-getPosition" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getPosition" rel="method-getPosition" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-getPosition" class="viewSource">view source</a></div><a name="getPosition"></a><a name="method-getPosition"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getPosition" class="cls expand">getPosition</a>(
2017 <span class="pre">[Boolean local]</span>)
2018  : Array</div><div class="description"><div class="short"><p>Gets the current XY position of the component's underlying element.</p>
2019 </div><div class="long"><p>Gets the current XY position of the component's underlying element.</p>
2020 <h3 class="pa">Parameters</h3><ul><li><span class="pre">local</span> : Boolean<div class="sub-desc"><p>(optional) If true the element's left and top are returned instead of page XY (defaults to false)</p>
2021 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Array</span>&nbsp; &nbsp;<p>The XY position of the element (e.g., [100, 200])</p>
2022 </li></ul></div></div></div><div id="method-getRawValue" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getRawValue" rel="method-getRawValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-method-getRawValue" class="viewSource">view source</a></div><a name="getRawValue"></a><a name="method-getRawValue"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getRawValue" class="cls expand">getRawValue</a> : String</div><div class="description"><div class="short">Returns the raw String value of the field, without performing any normalization, conversion, or validation.
2023 Gets the ...</div><div class="long"><p>Returns the raw String value of the field, without performing any normalization, conversion, or validation.
2024 Gets the current value of the input element if the field has been rendered, ignoring the value if it is the
2025 <a href="Ext.form.field.ComboBox.html#emptyText" rel="Ext.form.field.ComboBox#emptyText" class="docClass">emptyText</a>. To get a normalized and converted value see <a href="Ext.form.field.ComboBox.html#getValue" rel="Ext.form.field.ComboBox#getValue" class="docClass">getValue</a>.</p>
2026 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>value The raw String value of the field</p>
2027 </li></ul></div></div></div><div id="method-getSize" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getSize" rel="method-getSize" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getSize" class="viewSource">view source</a></div><a name="getSize"></a><a name="method-getSize"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getSize" class="cls expand">getSize</a> : Object</div><div class="description"><div class="short"><p>Gets the current size of the component's underlying element.</p>
2028 </div><div class="long"><p>Gets the current size of the component's underlying element.</p>
2029 <h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>An object containing the element's size {width: (element width), height: (element height)}</p>
2030 </li></ul></div></div></div><div id="method-getState" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getState" rel="method-getState" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-method-getState" class="viewSource">view source</a></div><a name="getState"></a><a name="method-getState"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getState" class="cls expand">getState</a> : Object</div><div class="description"><div class="short">Gets the current state of the object. By default this function returns null,
2031 it should be overridden in subclasses to...</div><div class="long"><p>Gets the current state of the object. By default this function returns null,
2032 it should be overridden in subclasses to implement methods for getting the state.</p>
2033 <h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>The current state</p>
2034 </li></ul></div></div></div><div id="method-getStateId" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getStateId" rel="method-getStateId" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-method-getStateId" class="viewSource">view source</a></div><a name="getStateId"></a><a name="method-getStateId"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getStateId" class="cls expand">getStateId</a> : String</div><div class="description"><div class="short"><p>Gets the state id for this object.</p>
2035 </div><div class="long"><p>Gets the state id for this object.</p>
2036 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>The state id, null if not found.</p>
2037 </li></ul></div></div></div><div id="method-getSubmitData" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getSubmitData" rel="method-getSubmitData" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-getSubmitData" class="viewSource">view source</a></div><a name="getSubmitData"></a><a name="method-getSubmitData"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getSubmitData" class="cls expand">getSubmitData</a> : Object</div><div class="description"><div class="short">Returns the parameter(s) that would be included in a standard form submit for this field. Typically this
2038 will be an o...</div><div class="long"><p>Returns the parameter(s) that would be included in a standard form submit for this field. Typically this
2039 will be an object with a single name-value pair, the name being this field's <a href="Ext.form.field.ComboBox.html#getName" rel="Ext.form.field.ComboBox#getName" class="docClass">name</a> and the
2040 value being its current stringified value. More advanced field implementations may return more than one
2041 name-value pair.</p>
2042
2043
2044 <p>Note that the values returned from this method are not guaranteed to have been successfully
2045 <a href="Ext.form.field.ComboBox.html#validate" rel="Ext.form.field.ComboBox#validate" class="docClass">validated</a>.</p>
2046
2047 <h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>A mapping of submit parameter names to values; each value should be a string, or an array
2048 of strings if that particular name has multiple values. It can also return <tt>null</tt> if there are no
2049 parameters to be submitted.</p>
2050 </li></ul></div></div></div><div id="method-getSubmitValue" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getSubmitValue" rel="method-getSubmitValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-getSubmitValue" class="viewSource">view source</a></div><a name="getSubmitValue"></a><a name="method-getSubmitValue"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getSubmitValue" class="cls expand">getSubmitValue</a> : String</div><div class="description"><div class="short">Returns the value that would be included in a standard form submit for this field. This will be combined
2051 with the fie...</div><div class="long"><p>Returns the value that would be included in a standard form submit for this field. This will be combined
2052 with the field's name to form a <tt>name=value</tt> pair in the <a href="Ext.form.field.ComboBox.html#getSubmitData" rel="Ext.form.field.ComboBox#getSubmitData" class="docClass">submitted parameters</a>.
2053 If an empty string is returned then just the <tt>name=</tt> will be submitted; if <tt>null</tt> is returned
2054 then nothing will be submitted.</p>
2055
2056
2057 <p>Note that the value returned will have been <a href="Ext.form.field.ComboBox.html#processRawValue" rel="Ext.form.field.ComboBox#processRawValue" class="docClass">processed</a> but may or may not have
2058 been successfully <a href="Ext.form.field.ComboBox.html#validate" rel="Ext.form.field.ComboBox#validate" class="docClass">validated</a>.</p>
2059
2060 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>The value to be submitted, or <tt>null</tt>.</p>
2061 </li></ul></div></div></div><div id="method-getTriggerWidth" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getTriggerWidth" rel="method-getTriggerWidth" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Trigger.html" class="definedIn docClass">Ext.form.field.Trigger</a><br/><a href="../source/Trigger.html#Ext-form.field.Trigger-method-getTriggerWidth" class="viewSource">view source</a></div><a name="getTriggerWidth"></a><a name="method-getTriggerWidth"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getTriggerWidth" class="cls expand">getTriggerWidth</a> : Number</div><div class="description"><div class="short"><p>Get the total width of the trigger button area. Only useful after the field has been rendered.</p>
2062 </div><div class="long"><p>Get the total width of the trigger button area. Only useful after the field has been rendered.</p>
2063 <h3 class="pa">Returns</h3><ul><li><span class="pre">Number</span>&nbsp; &nbsp;<p>The trigger width</p>
2064 </li></ul></div></div></div><div id="method-getValue" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getValue" rel="method-getValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-getValue" class="viewSource">view source</a></div><a name="getValue"></a><a name="method-getValue"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getValue" class="cls expand">getValue</a> : Mixed</div><div class="description"><div class="short">Returns the current data value of the field. The type of value returned is particular to the type of the
2065 particular f...</div><div class="long"><p>Returns the current data value of the field. The type of value returned is particular to the type of the
2066 particular field (e.g. a Date object for <a href="Ext.form.field.Date.html" rel="Ext.form.field.Date" class="docClass">Ext.form.field.Date</a>).</p>
2067 <h3 class="pa">Returns</h3><ul><li><span class="pre">Mixed</span>&nbsp; &nbsp;<p>value The field value</p>
2068 </li></ul></div></div></div><div id="method-getWidth" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getWidth" rel="method-getWidth" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getWidth" class="viewSource">view source</a></div><a name="getWidth"></a><a name="method-getWidth"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getWidth" class="cls expand">getWidth</a> : Number</div><div class="description"><div class="short"><p>Gets the current width of the component's underlying element.</p>
2069 </div><div class="long"><p>Gets the current width of the component's underlying element.</p>
2070 <h3 class="pa">Returns</h3><ul><li><span class="pre">Number</span>&nbsp; &nbsp;
2071 </li></ul></div></div></div><div id="method-getXType" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getXType" rel="method-getXType" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-getXType" class="viewSource">view source</a></div><a name="getXType"></a><a name="method-getXType"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getXType" class="cls expand">getXType</a> : String</div><div class="description"><div class="short">Gets the xtype for this component as registered with Ext.ComponentManager. For a list of all
2072 available xtypes, see th...</div><div class="long"><p>Gets the xtype for this component as registered with <a href="Ext.ComponentManager.html" rel="Ext.ComponentManager" class="docClass">Ext.ComponentManager</a>. For a list of all
2073 available xtypes, see the <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a> header. Example usage:</p>
2074
2075 <pre><code>var t = new Ext.form.field.Text();
2076 alert(t.getXType());  // alerts 'textfield'
2077 </code></pre>
2078
2079 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>The xtype</p>
2080 </li></ul></div></div></div><div id="method-getXTypes" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-getXTypes" rel="method-getXTypes" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getXTypes" class="viewSource">view source</a></div><a name="getXTypes"></a><a name="method-getXTypes"></a><a href="Ext.form.field.ComboBox.html#" rel="method-getXTypes" class="cls expand">getXTypes</a> : String</div><div class="description"><div class="short">Returns this Component's xtype hierarchy as a slash-delimited string. For a list of all
2081 available xtypes, see the Ext...</div><div class="long"><p>Returns this Component's xtype hierarchy as a slash-delimited string. For a list of all
2082 available xtypes, see the <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a> header.</p>
2083
2084
2085 <p><b>If using your own subclasses, be aware that a Component must register its own xtype
2086 to participate in determination of inherited xtypes.</b></p>
2087
2088
2089 <p>Example usage:</p>
2090
2091
2092 <pre><code>var t = new Ext.form.field.Text();
2093 alert(t.getXTypes());  // alerts 'component/field/textfield'
2094 </code></pre>
2095
2096 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>The xtype hierarchy string</p>
2097 </li></ul></div></div></div><div id="method-hasActiveError" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-hasActiveError" rel="method-hasActiveError" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-hasActiveError" class="viewSource">view source</a></div><a name="hasActiveError"></a><a name="method-hasActiveError"></a><a href="Ext.form.field.ComboBox.html#" rel="method-hasActiveError" class="cls expand">hasActiveError</a> : Boolean</div><div class="description"><div class="short">Tells whether the field currently has an active error message. This does not trigger
2098 validation on its own, it merely...</div><div class="long"><p>Tells whether the field currently has an active error message. This does not trigger
2099 validation on its own, it merely looks for any message that the component may already hold.</p>
2100 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;
2101 </li></ul></div></div></div><div id="method-hasListener" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-hasListener" rel="method-hasListener" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-hasListener" class="viewSource">view source</a></div><a name="hasListener"></a><a name="method-hasListener"></a><a href="Ext.form.field.ComboBox.html#" rel="method-hasListener" class="cls expand">hasListener</a>(
2102 <span class="pre">String eventName</span>)
2103  : Boolean</div><div class="description"><div class="short"><p>Checks to see if this object has any listeners for a specified event</p>
2104 </div><div class="long"><p>Checks to see if this object has any listeners for a specified event</p>
2105 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The name of the event to check for</p>
2106 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if the event is being listened for, else false</p>
2107 </li></ul></div></div></div><div id="method-hasUICls" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-hasUICls" rel="method-hasUICls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-hasUICls" class="viewSource">view source</a></div><a name="hasUICls"></a><a name="method-hasUICls"></a><a href="Ext.form.field.ComboBox.html#" rel="method-hasUICls" class="cls expand">hasUICls</a>(
2108 <span class="pre">String cls</span>)
2109  : void</div><div class="description"><div class="short"><p>Checks if there is currently a specified uiCls</p>
2110 </div><div class="long"><p>Checks if there is currently a specified uiCls</p>
2111 <h3 class="pa">Parameters</h3><ul><li><span class="pre">cls</span> : String<div class="sub-desc"><p>The cls to check</p>
2112 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2113 </li></ul></div></div></div><div id="method-hide" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-hide" rel="method-hide" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-hide" class="viewSource">view source</a></div><a name="hide"></a><a name="method-hide"></a><a href="Ext.form.field.ComboBox.html#" rel="method-hide" class="cls expand">hide</a>(
2114 <span class="pre">String/Element/Component animateTarget, [Function callback], [Object scope]</span>)
2115  : Ext.Component</div><div class="description"><div class="short"><p>Hides this Component, setting it to invisible using the configured <a href="Ext.form.field.ComboBox.html#hideMode" rel="Ext.form.field.ComboBox#hideMode" class="docClass">hideMode</a>.</p>
2116 </div><div class="long"><p>Hides this Component, setting it to invisible using the configured <a href="Ext.form.field.ComboBox.html#hideMode" rel="Ext.form.field.ComboBox#hideMode" class="docClass">hideMode</a>.</p>
2117 <h3 class="pa">Parameters</h3><ul><li><span class="pre">animateTarget</span> : String/Element/Component<div class="sub-desc"><p>Optional, and <b>only valid for <a href="Ext.form.field.ComboBox.html#floating" rel="Ext.form.field.ComboBox#floating" class="docClass">floating</a> Components such as
2118 <a href="Ext.window.Window.html" rel="Ext.window.Window" class="docClass">Window</a>s or <a href="Ext.tip.ToolTip.html" rel="Ext.tip.ToolTip" class="docClass">ToolTip</a>s, or regular Components which have been configured
2119 with <code>floating: true</code>.</b>.
2120 The target to which the Component should animate while hiding (defaults to null with no animation)</p>
2121 </div></li><li><span class="pre">callback</span> : Function<div class="sub-desc"><p>(optional) A callback function to call after the Component is hidden.</p>
2122 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope (<code>this</code> reference) in which the callback is executed. Defaults to this Component.</p>
2123 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2124 </li></ul></div></div></div><div id="method-initField" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-initField" rel="method-initField" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-initField" class="viewSource">view source</a></div><a name="initField"></a><a name="method-initField"></a><a href="Ext.form.field.ComboBox.html#" rel="method-initField" class="cls expand">initField</a> : void</div><div class="description"><div class="short">Initializes this Field mixin on the current instance. Components using this mixin should call
2125 this method during thei...</div><div class="long"><p>Initializes this Field mixin on the current instance. Components using this mixin should call
2126 this method during their own initialization process.</p>
2127 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2128 </li></ul></div></div></div><div id="method-initLabelable" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-initLabelable" rel="method-initLabelable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-initLabelable" class="viewSource">view source</a></div><a name="initLabelable"></a><a name="method-initLabelable"></a><a href="Ext.form.field.ComboBox.html#" rel="method-initLabelable" class="cls expand">initLabelable</a> : void</div><div class="description"><div class="short">Performs initialization of this mixin. Component classes using this mixin should call this method
2129 during their own in...</div><div class="long"><p>Performs initialization of this mixin. Component classes using this mixin should call this method
2130 during their own initialization.</p>
2131 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2132 </li></ul></div></div></div><div id="method-is" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-is" rel="method-is" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-is" class="viewSource">view source</a></div><a name="is"></a><a name="method-is"></a><a href="Ext.form.field.ComboBox.html#" rel="method-is" class="cls expand">is</a>(
2133 <span class="pre">String selector</span>)
2134  : Boolean</div><div class="description"><div class="short"><p>Tests whether this Component matches the selector string.</p>
2135 </div><div class="long"><p>Tests whether this Component matches the selector string.</p>
2136 <h3 class="pa">Parameters</h3><ul><li><span class="pre">selector</span> : String<div class="sub-desc"><p>The selector string to test against.</p>
2137 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if this Component matches the selector.</p>
2138 </li></ul></div></div></div><div id="method-isDescendantOf" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-isDescendantOf" rel="method-isDescendantOf" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-isDescendantOf" class="viewSource">view source</a></div><a name="isDescendantOf"></a><a name="method-isDescendantOf"></a><a href="Ext.form.field.ComboBox.html#" rel="method-isDescendantOf" class="cls expand">isDescendantOf</a>(
2139 <span class="pre">Ext.Container container</span>)
2140  : Boolean</div><div class="description"><div class="short"><p>Determines whether this component is the descendant of a particular container.</p>
2141 </div><div class="long"><p>Determines whether this component is the descendant of a particular container.</p>
2142 <h3 class="pa">Parameters</h3><ul><li><span class="pre">container</span> : Ext.Container<div class="sub-desc">
2143 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>isDescendant</p>
2144 </li></ul></div></div></div><div id="method-isDirty" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-isDirty" rel="method-isDirty" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-isDirty" class="viewSource">view source</a></div><a name="isDirty"></a><a name="method-isDirty"></a><a href="Ext.form.field.ComboBox.html#" rel="method-isDirty" class="cls expand">isDirty</a> : Boolean</div><div class="description"><div class="short">Returns true if the value of this Field has been changed from its originalValue.
2145 Will always return false if the fiel...</div><div class="long"><p>Returns true if the value of this Field has been changed from its <a href="Ext.form.field.ComboBox.html#originalValue" rel="Ext.form.field.ComboBox#originalValue" class="docClass">originalValue</a>.
2146 Will always return false if the field is disabled.</p>
2147
2148
2149 <p>Note that if the owning <a href="Ext.form.Basic.html" rel="Ext.form.Basic" class="docClass">form</a> was configured with
2150 <a href="Ext.form.Basic.html#trackResetOnLoad" rel="Ext.form.Basic#trackResetOnLoad" class="docClass">trackResetOnLoad</a>
2151 then the <a href="Ext.form.field.ComboBox.html#originalValue" rel="Ext.form.field.ComboBox#originalValue" class="docClass">originalValue</a> is updated when the values are loaded by
2152 <a href="Ext.form.Basic.html" rel="Ext.form.Basic" class="docClass">Ext.form.Basic</a>.<a href="Ext.form.Basic.html#setValues" rel="Ext.form.Basic#setValues" class="docClass">setValues</a>.</p>
2153
2154 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if this field has been changed from its original value (and
2155 is not disabled), false otherwise.</p>
2156 </li></ul></div></div></div><div id="method-isDisabled" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-isDisabled" rel="method-isDisabled" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-isDisabled" class="viewSource">view source</a></div><a name="isDisabled"></a><a name="method-isDisabled"></a><a href="Ext.form.field.ComboBox.html#" rel="method-isDisabled" class="cls expand">isDisabled</a> : Boolean</div><div class="description"><div class="short"><p>Method to determine whether this Component is currently disabled.</p>
2157 </div><div class="long"><p>Method to determine whether this Component is currently disabled.</p>
2158 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>the disabled state of this Component.</p>
2159 </li></ul></div></div></div><div id="method-isDraggable" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-isDraggable" rel="method-isDraggable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-isDraggable" class="viewSource">view source</a></div><a name="isDraggable"></a><a name="method-isDraggable"></a><a href="Ext.form.field.ComboBox.html#" rel="method-isDraggable" class="cls expand">isDraggable</a> : Boolean</div><div class="description"><div class="short"><p>Method to determine whether this Component is draggable.</p>
2160 </div><div class="long"><p>Method to determine whether this Component is draggable.</p>
2161 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>the draggable state of this component.</p>
2162 </li></ul></div></div></div><div id="method-isDroppable" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-isDroppable" rel="method-isDroppable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-isDroppable" class="viewSource">view source</a></div><a name="isDroppable"></a><a name="method-isDroppable"></a><a href="Ext.form.field.ComboBox.html#" rel="method-isDroppable" class="cls expand">isDroppable</a> : Boolean</div><div class="description"><div class="short"><p>Method to determine whether this Component is droppable.</p>
2163 </div><div class="long"><p>Method to determine whether this Component is droppable.</p>
2164 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>the droppable state of this component.</p>
2165 </li></ul></div></div></div><div id="method-isEqual" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-isEqual" rel="method-isEqual" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-isEqual" class="viewSource">view source</a></div><a name="isEqual"></a><a name="method-isEqual"></a><a href="Ext.form.field.ComboBox.html#" rel="method-isEqual" class="cls expand">isEqual</a>(
2166 <span class="pre">Mixed value1, Mixed value2</span>)
2167  : Boolean</div><div class="description"><div class="short">Returns whether two field values are logically equal. Field implementations may override
2168 this to provide custom compa...</div><div class="long"><p>Returns whether two field <a href="Ext.form.field.ComboBox.html#getValue" rel="Ext.form.field.ComboBox#getValue" class="docClass">values</a> are logically equal. Field implementations may override
2169 this to provide custom comparison logic appropriate for the particular field's data type.</p>
2170 <h3 class="pa">Parameters</h3><ul><li><span class="pre">value1</span> : Mixed<div class="sub-desc"><p>The first value to compare</p>
2171 </div></li><li><span class="pre">value2</span> : Mixed<div class="sub-desc"><p>The second value to compare</p>
2172 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if the values are equal, false if inequal.</p>
2173 </li></ul></div></div></div><div id="method-isFileUpload" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-isFileUpload" rel="method-isFileUpload" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-isFileUpload" class="viewSource">view source</a></div><a name="isFileUpload"></a><a name="method-isFileUpload"></a><a href="Ext.form.field.ComboBox.html#" rel="method-isFileUpload" class="cls expand">isFileUpload</a> : Boolean</div><div class="description"><div class="short">Returns whether this Field is a file upload field; if it returns true, forms will use
2174 special techniques for submitti...</div><div class="long"><p>Returns whether this Field is a file upload field; if it returns true, forms will use
2175 special techniques for <a href="Ext.form.Basic.html#submit" rel="Ext.form.Basic#submit" class="docClass">submitting the form</a> via AJAX. See
2176 <a href="Ext.form.Basic.html#hasUpload" rel="Ext.form.Basic#hasUpload" class="docClass">Ext.form.Basic.hasUpload</a> for details. If this returns true, the <a href="Ext.form.field.ComboBox.html#extractFileInput" rel="Ext.form.field.ComboBox#extractFileInput" class="docClass">extractFileInput</a>
2177 method must also be implemented to return the corresponding file input element.</p>
2178 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;
2179 </li></ul></div></div></div><div id="method-isFloating" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-isFloating" rel="method-isFloating" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-isFloating" class="viewSource">view source</a></div><a name="isFloating"></a><a name="method-isFloating"></a><a href="Ext.form.field.ComboBox.html#" rel="method-isFloating" class="cls expand">isFloating</a> : Boolean</div><div class="description"><div class="short"><p>Method to determine whether this Component is floating.</p>
2180 </div><div class="long"><p>Method to determine whether this Component is floating.</p>
2181 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>the floating state of this component.</p>
2182 </li></ul></div></div></div><div id="method-isHidden" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-isHidden" rel="method-isHidden" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-isHidden" class="viewSource">view source</a></div><a name="isHidden"></a><a name="method-isHidden"></a><a href="Ext.form.field.ComboBox.html#" rel="method-isHidden" class="cls expand">isHidden</a> : Boolean</div><div class="description"><div class="short"><p>Method to determine whether this Component is currently set to hidden.</p>
2183 </div><div class="long"><p>Method to determine whether this Component is currently set to hidden.</p>
2184 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>the hidden state of this Component.</p>
2185 </li></ul></div></div></div><div id="method-isValid" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-isValid" rel="method-isValid" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-isValid" class="viewSource">view source</a></div><a name="isValid"></a><a name="method-isValid"></a><a href="Ext.form.field.ComboBox.html#" rel="method-isValid" class="cls expand">isValid</a> : Boolean</div><div class="description"><div class="short">Returns whether or not the field value is currently valid by validating the
2186 field's current value. The validitychange...</div><div class="long"><p>Returns whether or not the field value is currently valid by <a href="Ext.form.field.ComboBox.html#getErrors" rel="Ext.form.field.ComboBox#getErrors" class="docClass">validating</a> the
2187 field's current value. The <a href="Ext.form.field.ComboBox.html#validitychange" rel="Ext.form.field.ComboBox#validitychange" class="docClass">validitychange</a> event will not be fired; use <a href="Ext.form.field.ComboBox.html#validate" rel="Ext.form.field.ComboBox#validate" class="docClass">validate</a>
2188 instead if you want the event to fire. <b>Note</b>: <a href="Ext.form.field.ComboBox.html#disabled" rel="Ext.form.field.ComboBox#disabled" class="docClass">disabled</a> fields are always treated as valid.</p>
2189
2190
2191 <p>Implementations are encouraged to ensure that this method does not have side-effects such as
2192 triggering error message display.</p>
2193
2194 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if the value is valid, else false</p>
2195 </li></ul></div></div></div><div id="method-isVisible" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-isVisible" rel="method-isVisible" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-isVisible" class="viewSource">view source</a></div><a name="isVisible"></a><a name="method-isVisible"></a><a href="Ext.form.field.ComboBox.html#" rel="method-isVisible" class="cls expand">isVisible</a>(
2196 <span class="pre">Boolean deep</span>)
2197  : Boolean</div><div class="description"><div class="short"><p>Returns true if this component is visible.</p>
2198 </div><div class="long"><p>Returns true if this component is visible.</p>
2199 <h3 class="pa">Parameters</h3><ul><li><span class="pre">deep</span> : Boolean<div class="sub-desc"><p>. <p>Optional. Pass <code>true</code> to interrogate the visibility status of all
2200 parent Containers to determine whether this Component is truly visible to the user.</p></p>
2201
2202 <p>Generally, to determine whether a Component is hidden, the no argument form is needed. For example
2203 when creating dynamically laid out UIs in a hidden Container before showing them.</p>
2204
2205 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if this component is visible, false otherwise.</p>
2206 </li></ul></div></div></div><div id="method-isXType" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-isXType" rel="method-isXType" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-isXType" class="viewSource">view source</a></div><a name="isXType"></a><a name="method-isXType"></a><a href="Ext.form.field.ComboBox.html#" rel="method-isXType" class="cls expand">isXType</a>(
2207 <span class="pre">String xtype, [Boolean shallow]</span>)
2208  : Boolean</div><div class="description"><div class="short">Tests whether or not this Component is of a specific xtype. This can test whether this Component is descended
2209 from th...</div><div class="long"><p>Tests whether or not this Component is of a specific xtype. This can test whether this Component is descended
2210 from the xtype (default) or whether it is directly of the xtype specified (shallow = true).</p>
2211
2212
2213 <p><b>If using your own subclasses, be aware that a Component must register its own xtype
2214 to participate in determination of inherited xtypes.</b></p>
2215
2216
2217 <p>For a list of all available xtypes, see the <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a> header.</p>
2218
2219
2220 <p>Example usage:</p>
2221
2222
2223 <pre><code>var t = new Ext.form.field.Text();
2224 var isText = t.isXType('textfield');        // true
2225 var isBoxSubclass = t.isXType('field');       // true, descended from <a href="Ext.form.field.Base.html" rel="Ext.form.field.Base" class="docClass">Ext.form.field.Base</a>
2226 var isBoxInstance = t.isXType('field', true); // false, not a direct <a href="Ext.form.field.Base.html" rel="Ext.form.field.Base" class="docClass">Ext.form.field.Base</a> instance
2227 </code></pre>
2228
2229 <h3 class="pa">Parameters</h3><ul><li><span class="pre">xtype</span> : String<div class="sub-desc"><p>The xtype to check for this Component</p>
2230 </div></li><li><span class="pre">shallow</span> : Boolean<div class="sub-desc"><p>(optional) False to check whether this Component is descended from the xtype (this is
2231 the default), or true to check whether this Component is directly of the specified xtype.</p>
2232 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if this component descends from the specified xtype, false otherwise.</p>
2233 </li></ul></div></div></div><div id="method-markInvalid" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-markInvalid" rel="method-markInvalid" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-markInvalid" class="viewSource">view source</a></div><a name="markInvalid"></a><a name="method-markInvalid"></a><a href="Ext.form.field.ComboBox.html#" rel="method-markInvalid" class="cls expand">markInvalid</a>(
2234 <span class="pre">String/Array errors</span>)
2235  : void</div><div class="description"><div class="short">Display one or more error messages associated with this field, using msgTarget to determine how to
2236 display the messag...</div><div class="long"><p>Display one or more error messages associated with this field, using <a href="Ext.form.field.ComboBox.html#msgTarget" rel="Ext.form.field.ComboBox#msgTarget" class="docClass">msgTarget</a> to determine how to
2237 display the messages and applying <a href="Ext.form.field.ComboBox.html#invalidCls" rel="Ext.form.field.ComboBox#invalidCls" class="docClass">invalidCls</a> to the field's UI element.</p>
2238
2239
2240 <p><b>Note</b>: this method does not cause the Field's <a href="Ext.form.field.ComboBox.html#validate" rel="Ext.form.field.ComboBox#validate" class="docClass">validate</a> or <a href="Ext.form.field.ComboBox.html#isValid" rel="Ext.form.field.ComboBox#isValid" class="docClass">isValid</a> methods to
2241 return <code>false</code> if the value does <i>pass</i> validation. So simply marking a Field as invalid
2242 will not prevent submission of forms submitted with the <a href="Ext.form.action.Submit.html#clientValidation" rel="Ext.form.action.Submit#clientValidation" class="docClass">Ext.form.action.Submit.clientValidation</a>
2243 option set.</p>
2244
2245 <h3 class="pa">Parameters</h3><ul><li><span class="pre">errors</span> : String/Array<div class="sub-desc"><p>The validation message(s) to display.</p>
2246 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2247 </li></ul></div></div></div><div id="method-nextNode" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-nextNode" rel="method-nextNode" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-nextNode" class="viewSource">view source</a></div><a name="nextNode"></a><a name="method-nextNode"></a><a href="Ext.form.field.ComboBox.html#" rel="method-nextNode" class="cls expand">nextNode</a>(
2248 <span class="pre">String selector, Object includeSelf</span>)
2249  : void</div><div class="description"><div class="short">Returns the next node in the Component tree in tree traversal order.
2250
2251
2252 Note that this is not limited to siblings, and...</div><div class="long"><p>Returns the next node in the Component tree in tree traversal order.</p>
2253
2254
2255 <p>Note that this is not limited to siblings, and if invoked upon a node with no matching siblings, will
2256 walk the tree to attempt to find a match. Contrast with <a href="Ext.form.field.ComboBox.html#pnextSibling" rel="Ext.form.field.ComboBox#pnextSibling" class="docClass">pnextSibling</a>.</p>
2257
2258 <h3 class="pa">Parameters</h3><ul><li><span class="pre">selector</span> : String<div class="sub-desc"><p>Optional A <a href="Ext.ComponentQuery.html" rel="Ext.ComponentQuery" class="docClass">ComponentQuery</a> selector to filter the following nodes.</p>
2259 </div></li><li><span class="pre">includeSelf</span> : Object<div class="sub-desc">
2260 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;<p>The next node (or the next node which matches the selector). Returns null if there is no matching node.</p>
2261 </li></ul></div></div></div><div id="method-nextSibling" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-nextSibling" rel="method-nextSibling" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-nextSibling" class="viewSource">view source</a></div><a name="nextSibling"></a><a name="method-nextSibling"></a><a href="Ext.form.field.ComboBox.html#" rel="method-nextSibling" class="cls expand">nextSibling</a>(
2262 <span class="pre">String selector</span>)
2263  : void</div><div class="description"><div class="short">Returns the next sibling of this Component.
2264
2265
2266 Optionally selects the next sibling which matches the passed ComponentQ...</div><div class="long"><p>Returns the next sibling of this Component.</p>
2267
2268
2269 <p>Optionally selects the next sibling which matches the passed <a href="Ext.ComponentQuery.html" rel="Ext.ComponentQuery" class="docClass">ComponentQuery</a> selector.</p>
2270
2271
2272 <p>May also be refered to as <code><b>next()</b></code></p>
2273
2274
2275 <p>Note that this is limited to siblings, and if no siblings of the item match, <code>null</code> is returned. Contrast with <a href="Ext.form.field.ComboBox.html#nextNode" rel="Ext.form.field.ComboBox#nextNode" class="docClass">nextNode</a></p>
2276
2277 <h3 class="pa">Parameters</h3><ul><li><span class="pre">selector</span> : String<div class="sub-desc"><p>Optional A <a href="Ext.ComponentQuery.html" rel="Ext.ComponentQuery" class="docClass">ComponentQuery</a> selector to filter the following items.</p>
2278 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;<p>The next sibling (or the next sibling which matches the selector). Returns null if there is no matching sibling.</p>
2279 </li></ul></div></div></div><div id="method-observe" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-observe" rel="method-observe" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-observe" class="viewSource">view source</a></div><a name="observe"></a><a name="method-observe"></a><a href="Ext.form.field.ComboBox.html#" rel="method-observe" class="cls expand">observe</a>(
2280 <span class="pre">Function c, Object listeners</span>)
2281  : void</div><div class="description"><div class="short">Sets observability on the passed class constructor.
2282
2283 This makes any event fired on any instance of the passed class a...</div><div class="long"><p>Sets observability on the passed class constructor.</p>
2284
2285 <p>This makes any event fired on any instance of the passed class also fire a single event through
2286 the <strong>class</strong> allowing for central handling of events on many instances at once.</p>
2287
2288 <p>Usage:</p>
2289
2290 <pre><code>Ext.util.Observable.observe(Ext.data.Connection);
2291 Ext.data.Connection.on('beforerequest', function(con, options) {
2292     console.log('Ajax request made to ' + options.url);
2293 });
2294 </code></pre>
2295 <h3 class="pa">Parameters</h3><ul><li><span class="pre">c</span> : Function<div class="sub-desc"><p>The class constructor to make observable.</p>
2296 </div></li><li><span class="pre">listeners</span> : Object<div class="sub-desc"><p>An object containing a series of listeners to add. See <a href="Ext.form.field.ComboBox.html#addListener" rel="Ext.form.field.ComboBox#addListener" class="docClass">addListener</a>.</p>
2297 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2298 </li></ul></div></div></div><div id="method-on" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-on" rel="method-on" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-on" class="viewSource">view source</a></div><a name="on"></a><a name="method-on"></a><a href="Ext.form.field.ComboBox.html#" rel="method-on" class="cls expand">on</a>(
2299 <span class="pre">String eventName, Function handler, [Object scope], [Object options]</span>)
2300  : void</div><div class="description"><div class="short"><p>Appends an event handler to this object (shorthand for <a href="Ext.form.field.ComboBox.html#addListener" rel="Ext.form.field.ComboBox#addListener" class="docClass">addListener</a>.)</p>
2301 </div><div class="long"><p>Appends an event handler to this object (shorthand for <a href="Ext.form.field.ComboBox.html#addListener" rel="Ext.form.field.ComboBox#addListener" class="docClass">addListener</a>.)</p>
2302 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The type of event to listen for</p>
2303 </div></li><li><span class="pre">handler</span> : Function<div class="sub-desc"><p>The method the event invokes</p>
2304 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope (<code><b>this</b></code> reference) in which the handler function is executed.
2305 <b>If omitted, defaults to the object which fired the event.</b></p>
2306 </div></li><li><span class="pre">options</span> : Object<div class="sub-desc"><p>(optional) An object containing handler configuration.</p>
2307 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2308 </li></ul></div></div></div><div id="method-onTriggerClick" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-onTriggerClick" rel="method-onTriggerClick" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Picker.html" class="definedIn docClass">Ext.form.field.Picker</a><br/><a href="../source/Picker.html#Ext-form.field.Picker-method-onTriggerClick" class="viewSource">view source</a></div><a name="onTriggerClick"></a><a name="method-onTriggerClick"></a><a href="Ext.form.field.ComboBox.html#" rel="method-onTriggerClick" class="cls expand">onTriggerClick</a> : void</div><div class="description"><div class="short"><p>Handles the trigger click; by default toggles between expanding and collapsing the
2309 picker component.</p>
2310 </div><div class="long"><p>Handles the trigger click; by default toggles between expanding and collapsing the
2311 picker component.</p>
2312 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2313 </li></ul></div></div></div><div id="method-previousNode" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-previousNode" rel="method-previousNode" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-previousNode" class="viewSource">view source</a></div><a name="previousNode"></a><a name="method-previousNode"></a><a href="Ext.form.field.ComboBox.html#" rel="method-previousNode" class="cls expand">previousNode</a>(
2314 <span class="pre">String selector, Object includeSelf</span>)
2315  : void</div><div class="description"><div class="short">Returns the previous node in the Component tree in tree traversal order.
2316
2317
2318 Note that this is not limited to siblings,...</div><div class="long"><p>Returns the previous node in the Component tree in tree traversal order.</p>
2319
2320
2321 <p>Note that this is not limited to siblings, and if invoked upon a node with no matching siblings, will
2322 walk the tree in reverse order to attempt to find a match. Contrast with <a href="Ext.form.field.ComboBox.html#previousSibling" rel="Ext.form.field.ComboBox#previousSibling" class="docClass">previousSibling</a>.</p>
2323
2324 <h3 class="pa">Parameters</h3><ul><li><span class="pre">selector</span> : String<div class="sub-desc"><p>Optional. A <a href="Ext.ComponentQuery.html" rel="Ext.ComponentQuery" class="docClass">ComponentQuery</a> selector to filter the preceding nodes.</p>
2325 </div></li><li><span class="pre">includeSelf</span> : Object<div class="sub-desc">
2326 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;<p>The previous node (or the previous node which matches the selector). Returns null if there is no matching node.</p>
2327 </li></ul></div></div></div><div id="method-previousSibling" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-previousSibling" rel="method-previousSibling" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-previousSibling" class="viewSource">view source</a></div><a name="previousSibling"></a><a name="method-previousSibling"></a><a href="Ext.form.field.ComboBox.html#" rel="method-previousSibling" class="cls expand">previousSibling</a>(
2328 <span class="pre">String selector</span>)
2329  : void</div><div class="description"><div class="short">Returns the previous sibling of this Component.
2330
2331
2332 Optionally selects the previous sibling which matches the passed Co...</div><div class="long"><p>Returns the previous sibling of this Component.</p>
2333
2334
2335 <p>Optionally selects the previous sibling which matches the passed <a href="Ext.ComponentQuery.html" rel="Ext.ComponentQuery" class="docClass">ComponentQuery</a> selector.</p>
2336
2337
2338 <p>May also be refered to as <code><b>prev()</b></code></p>
2339
2340
2341 <p>Note that this is limited to siblings, and if no siblings of the item match, <code>null</code> is returned. Contrast with <a href="Ext.form.field.ComboBox.html#previousNode" rel="Ext.form.field.ComboBox#previousNode" class="docClass">previousNode</a></p>
2342
2343 <h3 class="pa">Parameters</h3><ul><li><span class="pre">selector</span> : String<div class="sub-desc"><p>Optional. A <a href="Ext.ComponentQuery.html" rel="Ext.ComponentQuery" class="docClass">ComponentQuery</a> selector to filter the preceding items.</p>
2344 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;<p>The previous sibling (or the previous sibling which matches the selector). Returns null if there is no matching sibling.</p>
2345 </li></ul></div></div></div><div id="method-processRawValue" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-processRawValue" rel="method-processRawValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-method-processRawValue" class="viewSource">view source</a></div><a name="processRawValue"></a><a name="method-processRawValue"></a><a href="Ext.form.field.ComboBox.html#" rel="method-processRawValue" class="cls expand">processRawValue</a>(
2346 <span class="pre">String value</span>)
2347  : String</div><div class="description"><div class="short">Performs any necessary manipulation of a raw String value to prepare it for conversion
2348 and/or validation. For text fi...</div><div class="long"><p>Performs any necessary manipulation of a raw String value to prepare it for <a href="Ext.form.field.ComboBox.html#stringToValue" rel="Ext.form.field.ComboBox#stringToValue" class="docClass">conversion</a>
2349 and/or <a href="Ext.form.field.ComboBox.html#validate" rel="Ext.form.field.ComboBox#validate" class="docClass">validation</a>. For text fields this applies the configured <a href="Ext.form.field.ComboBox.html#stripCharsRe" rel="Ext.form.field.ComboBox#stripCharsRe" class="docClass">stripCharsRe</a> to the
2350 raw value.</p>
2351 <h3 class="pa">Parameters</h3><ul><li><span class="pre">value</span> : String<div class="sub-desc"><p>The unprocessed string value</p>
2352 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>The processed string value</p>
2353 </li></ul></div></div></div><div id="method-rawToValue" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-rawToValue" rel="method-rawToValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-rawToValue" class="viewSource">view source</a></div><a name="rawToValue"></a><a name="method-rawToValue"></a><a href="Ext.form.field.ComboBox.html#" rel="method-rawToValue" class="cls expand">rawToValue</a>(
2354 <span class="pre">Mixed rawValue</span>)
2355  : Mixed</div><div class="description"><div class="short">Converts a raw input field value into a mixed-type value that is suitable for this particular field type.
2356 This allows...</div><div class="long"><p>Converts a raw input field value into a mixed-type value that is suitable for this particular field type.
2357 This allows controlling the normalization and conversion of user-entered values into field-type-appropriate
2358 values, e.g. a Date object for <a href="Ext.form.field.Date.html" rel="Ext.form.field.Date" class="docClass">Ext.form.field.Date</a>, and is invoked by <a href="Ext.form.field.ComboBox.html#getValue" rel="Ext.form.field.ComboBox#getValue" class="docClass">getValue</a>.</p>
2359
2360
2361 <p>It is up to individual implementations to decide how to handle raw values that cannot be successfully
2362 converted to the desired object type.</p>
2363
2364
2365 <p>See <a href="Ext.form.field.ComboBox.html#valueToRaw" rel="Ext.form.field.ComboBox#valueToRaw" class="docClass">valueToRaw</a> for the opposite conversion.</p>
2366
2367
2368 <p>The base implementation does no conversion, returning the raw value untouched.</p>
2369
2370 <h3 class="pa">Parameters</h3><ul><li><span class="pre">rawValue</span> : Mixed<div class="sub-desc">
2371 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Mixed</span>&nbsp; &nbsp;<p>The converted value.</p>
2372 </li></ul></div></div></div><div id="method-relayEvents" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-relayEvents" rel="method-relayEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-relayEvents" class="viewSource">view source</a></div><a name="relayEvents"></a><a name="method-relayEvents"></a><a href="Ext.form.field.ComboBox.html#" rel="method-relayEvents" class="cls expand">relayEvents</a>(
2373 <span class="pre">Object origin, Array events, Object prefix</span>)
2374  : void</div><div class="description"><div class="short"><p>Relays selected events from the specified Observable as if the events were fired by <code><b>this</b></code>.</p>
2375 </div><div class="long"><p>Relays selected events from the specified Observable as if the events were fired by <code><b>this</b></code>.</p>
2376 <h3 class="pa">Parameters</h3><ul><li><span class="pre">origin</span> : Object<div class="sub-desc"><p>The Observable whose events this object is to relay.</p>
2377 </div></li><li><span class="pre">events</span> : Array<div class="sub-desc"><p>Array of event names to relay.</p>
2378 </div></li><li><span class="pre">prefix</span> : Object<div class="sub-desc">
2379 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2380 </li></ul></div></div></div><div id="method-releaseCapture" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-releaseCapture" rel="method-releaseCapture" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-releaseCapture" class="viewSource">view source</a></div><a name="releaseCapture"></a><a name="method-releaseCapture"></a><a href="Ext.form.field.ComboBox.html#" rel="method-releaseCapture" class="cls expand">releaseCapture</a>(
2381 <span class="pre">Observable o</span>)
2382  : void</div><div class="description"><div class="short"><p>Removes <b>all</b> added captures from the Observable.</p>
2383 </div><div class="long"><p>Removes <b>all</b> added captures from the Observable.</p>
2384 <h3 class="pa">Parameters</h3><ul><li><span class="pre">o</span> : Observable<div class="sub-desc"><p>The Observable to release</p>
2385 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2386 </li></ul></div></div></div><div id="method-removeCls" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-removeCls" rel="method-removeCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-removeCls" class="viewSource">view source</a></div><a name="removeCls"></a><a name="method-removeCls"></a><a href="Ext.form.field.ComboBox.html#" rel="method-removeCls" class="cls expand">removeCls</a>(
2387 <span class="pre">Object className</span>)
2388  : Ext.Component</div><div class="description"><div class="short"><p>Removes a CSS class from the top level element representing this component.</p>
2389 </div><div class="long"><p>Removes a CSS class from the top level element representing this component.</p>
2390 <h3 class="pa">Parameters</h3><ul><li><span class="pre">className</span> : Object<div class="sub-desc">
2391 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>Returns the Component to allow method chaining.</p>
2392 </li></ul></div></div></div><div id="method-removeClsWithUI" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-removeClsWithUI" rel="method-removeClsWithUI" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-removeClsWithUI" class="viewSource">view source</a></div><a name="removeClsWithUI"></a><a name="method-removeClsWithUI"></a><a href="Ext.form.field.ComboBox.html#" rel="method-removeClsWithUI" class="cls expand">removeClsWithUI</a>(
2393 <span class="pre">String/Array cls</span>)
2394  : void</div><div class="description"><div class="short">Removes a cls to the uiCls array, which will also call removeUIClsToElement and removes
2395 it from all elements of this ...</div><div class="long"><p>Removes a cls to the uiCls array, which will also call <a href="Ext.form.field.ComboBox.html#removeUIClsToElement" rel="Ext.form.field.ComboBox#removeUIClsToElement" class="docClass">removeUIClsToElement</a> and removes
2396 it from all elements of this component.</p>
2397 <h3 class="pa">Parameters</h3><ul><li><span class="pre">cls</span> : String/Array<div class="sub-desc"><p>A string or an array of strings to remove to the uiCls</p>
2398 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2399 </li></ul></div></div></div><div id="method-removeListener" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-removeListener" rel="method-removeListener" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-removeListener" class="viewSource">view source</a></div><a name="removeListener"></a><a name="method-removeListener"></a><a href="Ext.form.field.ComboBox.html#" rel="method-removeListener" class="cls expand">removeListener</a>(
2400 <span class="pre">String eventName, Function handler, [Object scope]</span>)
2401  : void</div><div class="description"><div class="short"><p>Removes an event handler.</p>
2402 </div><div class="long"><p>Removes an event handler.</p>
2403 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The type of event the handler was associated with.</p>
2404 </div></li><li><span class="pre">handler</span> : Function<div class="sub-desc"><p>The handler to remove. <b>This must be a reference to the function passed into the <a href="Ext.form.field.ComboBox.html#addListener" rel="Ext.form.field.ComboBox#addListener" class="docClass">addListener</a> call.</b></p>
2405 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope originally specified for the handler.</p>
2406 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2407 </li></ul></div></div></div><div id="method-removeManagedListener" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-removeManagedListener" rel="method-removeManagedListener" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-removeManagedListener" class="viewSource">view source</a></div><a name="removeManagedListener"></a><a name="method-removeManagedListener"></a><a href="Ext.form.field.ComboBox.html#" rel="method-removeManagedListener" class="cls expand">removeManagedListener</a>(
2408 <span class="pre">Observable|Element item, Object|String ename, Function fn, Object scope</span>)
2409  : void</div><div class="description"><div class="short"><p>Removes listeners that were added by the <a href="Ext.form.field.ComboBox.html#mon" rel="Ext.form.field.ComboBox#mon" class="docClass">mon</a> method.</p>
2410 </div><div class="long"><p>Removes listeners that were added by the <a href="Ext.form.field.ComboBox.html#mon" rel="Ext.form.field.ComboBox#mon" class="docClass">mon</a> method.</p>
2411 <h3 class="pa">Parameters</h3><ul><li><span class="pre">item</span> : Observable|Element<div class="sub-desc"><p>The item from which to remove a listener/listeners.</p>
2412 </div></li><li><span class="pre">ename</span> : Object|String<div class="sub-desc"><p>The event name, or an object containing event name properties.</p>
2413 </div></li><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>Optional. If the <code>ename</code> parameter was an event name, this
2414 is the handler function.</p>
2415 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>Optional. If the <code>ename</code> parameter was an event name, this
2416 is the scope (<code>this</code> reference) in which the handler function is executed.</p>
2417 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2418 </li></ul></div></div></div><div id="method-reset" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-reset" rel="method-reset" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-reset" class="viewSource">view source</a></div><a name="reset"></a><a name="method-reset"></a><a href="Ext.form.field.ComboBox.html#" rel="method-reset" class="cls expand">reset</a> : void</div><div class="description"><div class="short">Resets the current field value to the originally loaded value and clears any validation messages.
2419 See Ext.form.Basic....</div><div class="long"><p>Resets the current field value to the originally loaded value and clears any validation messages.
2420 See <a href="Ext.form.Basic.html" rel="Ext.form.Basic" class="docClass">Ext.form.Basic</a>.<a href="Ext.form.Basic.html#trackResetOnLoad" rel="Ext.form.Basic#trackResetOnLoad" class="docClass">trackResetOnLoad</a></p>
2421 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2422 </li></ul></div></div></div><div id="method-resetOriginalValue" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-resetOriginalValue" rel="method-resetOriginalValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-resetOriginalValue" class="viewSource">view source</a></div><a name="resetOriginalValue"></a><a name="method-resetOriginalValue"></a><a href="Ext.form.field.ComboBox.html#" rel="method-resetOriginalValue" class="cls expand">resetOriginalValue</a> : void</div><div class="description"><div class="short">Resets the field's originalValue property so it matches the current value.
2423 This is called by Ext.form.Basic.setValues...</div><div class="long"><p>Resets the field's <a href="Ext.form.field.ComboBox.html#originalValue" rel="Ext.form.field.ComboBox#originalValue" class="docClass">originalValue</a> property so it matches the current <a href="Ext.form.field.ComboBox.html#getValue" rel="Ext.form.field.ComboBox#getValue" class="docClass">value</a>.
2424 This is called by <a href="Ext.form.Basic.html" rel="Ext.form.Basic" class="docClass">Ext.form.Basic</a>.<a href="Ext.form.Basic.html#setValues" rel="Ext.form.Basic#setValues" class="docClass">setValues</a> if the form's
2425 <a href="Ext.form.Basic.html#trackResetOnLoad" rel="Ext.form.Basic#trackResetOnLoad" class="docClass">trackResetOnLoad</a> property is set to true.</p>
2426 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2427 </li></ul></div></div></div><div id="method-resumeEvents" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-resumeEvents" rel="method-resumeEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-resumeEvents" class="viewSource">view source</a></div><a name="resumeEvents"></a><a name="method-resumeEvents"></a><a href="Ext.form.field.ComboBox.html#" rel="method-resumeEvents" class="cls expand">resumeEvents</a> : void</div><div class="description"><div class="short">Resume firing events. (see suspendEvents)
2428 If events were suspended using the queueSuspended parameter, then all
2429 event...</div><div class="long"><p>Resume firing events. (see <a href="Ext.form.field.ComboBox.html#suspendEvents" rel="Ext.form.field.ComboBox#suspendEvents" class="docClass">suspendEvents</a>)
2430 If events were suspended using the <code><b>queueSuspended</b></code> parameter, then all
2431 events fired during event suspension will be sent to any listeners now.</p>
2432 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2433 </li></ul></div></div></div><div id="method-select" class="member ni"><a href="Ext.form.field.ComboBox.html#method-select" rel="method-select" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-method-select" class="viewSource">view source</a></div><a name="select"></a><a name="method-select"></a><a href="Ext.form.field.ComboBox.html#" rel="method-select" class="cls expand">select</a>(
2434 <span class="pre">Object r</span>)
2435  : void</div><div class="description"><div class="short"><p>Selects an item by a <a href="Ext.data.Model.html" rel="Ext.data.Model" class="docClass">Model</a>, or by a key value.</p>
2436 </div><div class="long"><p>Selects an item by a <a href="Ext.data.Model.html" rel="Ext.data.Model" class="docClass">Model</a>, or by a key value.</p>
2437 <h3 class="pa">Parameters</h3><ul><li><span class="pre">r</span> : Object<div class="sub-desc">
2438 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2439 </li></ul></div></div></div><div id="method-selectText" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-selectText" rel="method-selectText" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-method-selectText" class="viewSource">view source</a></div><a name="selectText"></a><a name="method-selectText"></a><a href="Ext.form.field.ComboBox.html#" rel="method-selectText" class="cls expand">selectText</a>(
2440 <span class="pre">[Number start], [Number end]</span>)
2441  : void</div><div class="description"><div class="short"><p>Selects text in this field</p>
2442 </div><div class="long"><p>Selects text in this field</p>
2443 <h3 class="pa">Parameters</h3><ul><li><span class="pre">start</span> : Number<div class="sub-desc"><p>(optional) The index where the selection should start (defaults to 0)</p>
2444 </div></li><li><span class="pre">end</span> : Number<div class="sub-desc"><p>(optional) The index where the selection should end (defaults to the text length)</p>
2445 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2446 </li></ul></div></div></div><div id="method-sequenceFx" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-sequenceFx" rel="method-sequenceFx" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Animate.html" class="definedIn docClass">Ext.util.Animate</a><br/><a href="../source/Animate.html#Ext-util.Animate-method-sequenceFx" class="viewSource">view source</a></div><a name="sequenceFx"></a><a name="method-sequenceFx"></a><a href="Ext.form.field.ComboBox.html#" rel="method-sequenceFx" class="cls expand">sequenceFx</a> : Ext.core.Element</div><div class="description"><div class="short">Ensures that all effects queued after sequenceFx is called on this object are
2447 run in sequence.  This is the opposite ...</div><div class="long"><p>Ensures that all effects queued after sequenceFx is called on this object are
2448 run in sequence.  This is the opposite of <a href="Ext.form.field.ComboBox.html#syncFx" rel="Ext.form.field.ComboBox#syncFx" class="docClass">syncFx</a>.</p>
2449 <h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.core.Element</span>&nbsp; &nbsp;<p>The Element</p>
2450 </li></ul></div></div></div><div id="method-setActive" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setActive" rel="method-setActive" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Floating.html" class="definedIn docClass">Ext.util.Floating</a><br/><a href="../source/Floating.html#Ext-util.Floating-method-setActive" class="viewSource">view source</a></div><a name="setActive"></a><a name="method-setActive"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setActive" class="cls expand">setActive</a>(
2451 <span class="pre">Boolean active, Component newActive</span>)
2452  : void</div><div class="description"><div class="short">This method is called internally by Ext.ZIndexManager to signal that a floating
2453 Component has either been moved to th...</div><div class="long"><p>This method is called internally by <a href="Ext.ZIndexManager.html" rel="Ext.ZIndexManager" class="docClass">Ext.ZIndexManager</a> to signal that a floating
2454 Component has either been moved to the top of its zIndex stack, or pushed from the top of its zIndex stack.</p>
2455
2456
2457 <p>If a <i>Window</i> is superceded by another Window, deactivating it hides its shadow.</p>
2458
2459
2460 <p>This method also fires the <a href="Ext.form.field.ComboBox.html#activate" rel="Ext.form.field.ComboBox#activate" class="docClass">activate</a> or <a href="Ext.form.field.ComboBox.html#deactivate" rel="Ext.form.field.ComboBox#deactivate" class="docClass">deactivate</a> event depending on which action occurred.</p>
2461
2462 <h3 class="pa">Parameters</h3><ul><li><span class="pre">active</span> : Boolean<div class="sub-desc"><p>True to activate the Component, false to deactivate it (defaults to false)</p>
2463 </div></li><li><span class="pre">newActive</span> : Component<div class="sub-desc"><p>The newly active Component which is taking over topmost zIndex position.</p>
2464 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2465 </li></ul></div></div></div><div id="method-setActiveError" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setActiveError" rel="method-setActiveError" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-setActiveError" class="viewSource">view source</a></div><a name="setActiveError"></a><a name="method-setActiveError"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setActiveError" class="cls expand">setActiveError</a>(
2466 <span class="pre">String msg</span>)
2467  : void</div><div class="description"><div class="short">Sets the active error message to the given string. This replaces the entire error message
2468 contents with the given str...</div><div class="long"><p>Sets the active error message to the given string. This replaces the entire error message
2469 contents with the given string. Also see <a href="Ext.form.field.ComboBox.html#setActiveErrors" rel="Ext.form.field.ComboBox#setActiveErrors" class="docClass">setActiveErrors</a> which accepts an Array of
2470 messages and formats them according to the <a href="Ext.form.field.ComboBox.html#activeErrorsTpl" rel="Ext.form.field.ComboBox#activeErrorsTpl" class="docClass">activeErrorsTpl</a>.</p>
2471 <h3 class="pa">Parameters</h3><ul><li><span class="pre">msg</span> : String<div class="sub-desc"><p>The error message</p>
2472 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2473 </li></ul></div></div></div><div id="method-setActiveErrors" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setActiveErrors" rel="method-setActiveErrors" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-setActiveErrors" class="viewSource">view source</a></div><a name="setActiveErrors"></a><a name="method-setActiveErrors"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setActiveErrors" class="cls expand">setActiveErrors</a>(
2474 <span class="pre">Array errors</span>)
2475  : void</div><div class="description"><div class="short">Set the active error message to an Array of error messages. The messages are formatted into
2476 a single message string u...</div><div class="long"><p>Set the active error message to an Array of error messages. The messages are formatted into
2477 a single message string using the <a href="Ext.form.field.ComboBox.html#activeErrorsTpl" rel="Ext.form.field.ComboBox#activeErrorsTpl" class="docClass">activeErrorsTpl</a>. Also see <a href="Ext.form.field.ComboBox.html#setActiveError" rel="Ext.form.field.ComboBox#setActiveError" class="docClass">setActiveError</a>
2478 which allows setting the entire error contents with a single string.</p>
2479 <h3 class="pa">Parameters</h3><ul><li><span class="pre">errors</span> : Array<div class="sub-desc"><p>The error messages</p>
2480 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2481 </li></ul></div></div></div><div id="method-setAutoScroll" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setAutoScroll" rel="method-setAutoScroll" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-setAutoScroll" class="viewSource">view source</a></div><a name="setAutoScroll"></a><a name="method-setAutoScroll"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setAutoScroll" class="cls expand">setAutoScroll</a>(
2482 <span class="pre">Boolean scroll</span>)
2483  : Ext.Component</div><div class="description"><div class="short"><p>Sets the overflow on the content element of the component.</p>
2484 </div><div class="long"><p>Sets the overflow on the content element of the component.</p>
2485 <h3 class="pa">Parameters</h3><ul><li><span class="pre">scroll</span> : Boolean<div class="sub-desc"><p>True to allow the Component to auto scroll.</p>
2486 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2487 </li></ul></div></div></div><div id="method-setDisabled" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setDisabled" rel="method-setDisabled" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-setDisabled" class="viewSource">view source</a></div><a name="setDisabled"></a><a name="method-setDisabled"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setDisabled" class="cls expand">setDisabled</a>(
2488 <span class="pre">Boolean disabled</span>)
2489  : void</div><div class="description"><div class="short"><p>Enable or disable the component.</p>
2490 </div><div class="long"><p>Enable or disable the component.</p>
2491 <h3 class="pa">Parameters</h3><ul><li><span class="pre">disabled</span> : Boolean<div class="sub-desc">
2492 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2493 </li></ul></div></div></div><div id="method-setDocked" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setDocked" rel="method-setDocked" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-setDocked" class="viewSource">view source</a></div><a name="setDocked"></a><a name="method-setDocked"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setDocked" class="cls expand">setDocked</a>(
2494 <span class="pre">Object dock, Object layoutParent</span>)
2495  : Component</div><div class="description"><div class="short">Sets the dock position of this component in its parent panel. Note that
2496 this only has effect if this item is part of ...</div><div class="long"><p>Sets the dock position of this component in its parent panel. Note that
2497 this only has effect if this item is part of the dockedItems collection
2498 of a parent that has a DockLayout (note that any Panel has a DockLayout
2499 by default)</p>
2500 <h3 class="pa">Parameters</h3><ul><li><span class="pre">dock</span> : Object<div class="sub-desc">
2501 </div></li><li><span class="pre">layoutParent</span> : Object<div class="sub-desc">
2502 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Component</span>&nbsp; &nbsp;<p>this</p>
2503 </li></ul></div></div></div><div id="method-setEditable" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setEditable" rel="method-setEditable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Trigger.html" class="definedIn docClass">Ext.form.field.Trigger</a><br/><a href="../source/Trigger.html#Ext-form.field.Trigger-method-setEditable" class="viewSource">view source</a></div><a name="setEditable"></a><a name="method-setEditable"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setEditable" class="cls expand">setEditable</a>(
2504 <span class="pre">Boolean editable</span>)
2505  : void</div><div class="description"><div class="short"><p>&nbsp;</p></div><div class="long">
2506 <h3 class="pa">Parameters</h3><ul><li><span class="pre">editable</span> : Boolean<div class="sub-desc"><p>True to allow the user to directly edit the field text
2507 Allow or prevent the user from directly editing the field text.  If false is passed,
2508 the user will only be able to modify the field using the trigger.  Will also add
2509 a click event to the text field which will call the trigger. This method
2510 is the runtime equivalent of setting the 'editable' config option at config time.</p>
2511 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2512 </li></ul></div></div></div><div id="method-setFieldDefaults" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setFieldDefaults" rel="method-setFieldDefaults" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-setFieldDefaults" class="viewSource">view source</a></div><a name="setFieldDefaults"></a><a name="method-setFieldDefaults"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setFieldDefaults" class="cls expand">setFieldDefaults</a>(
2513 <span class="pre">Object defaults</span>)
2514  : void</div><div class="description"><div class="short">Applies a set of default configuration values to this Labelable instance. For each of the
2515 properties in the given obj...</div><div class="long"><p>Applies a set of default configuration values to this Labelable instance. For each of the
2516 properties in the given object, check if this component hasOwnProperty that config; if not
2517 then it's inheriting a default value from its prototype and we should apply the default value.</p>
2518 <h3 class="pa">Parameters</h3><ul><li><span class="pre">defaults</span> : Object<div class="sub-desc"><p>The defaults to apply to the object.</p>
2519 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2520 </li></ul></div></div></div><div id="method-setFieldStyle" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setFieldStyle" rel="method-setFieldStyle" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-setFieldStyle" class="viewSource">view source</a></div><a name="setFieldStyle"></a><a name="method-setFieldStyle"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setFieldStyle" class="cls expand">setFieldStyle</a>(
2521 <span class="pre">String/Object/Function style</span>)
2522  : void</div><div class="description"><div class="short"><p>Set the <a href="Ext.form.field.ComboBox.html#fieldStyle" rel="Ext.form.field.ComboBox#fieldStyle" class="docClass">CSS style</a> of the <a href="Ext.form.field.ComboBox.html#inputEl" rel="Ext.form.field.ComboBox#inputEl" class="docClass">field input element</a>.</p>
2523 </div><div class="long"><p>Set the <a href="Ext.form.field.ComboBox.html#fieldStyle" rel="Ext.form.field.ComboBox#fieldStyle" class="docClass">CSS style</a> of the <a href="Ext.form.field.ComboBox.html#inputEl" rel="Ext.form.field.ComboBox#inputEl" class="docClass">field input element</a>.</p>
2524 <h3 class="pa">Parameters</h3><ul><li><span class="pre">style</span> : String/Object/Function<div class="sub-desc"><p>The style(s) to apply. Should be a valid argument to
2525 <a href="Ext.core.Element.html#applyStyles" rel="Ext.core.Element#applyStyles" class="docClass">Ext.core.Element.applyStyles</a>.</p>
2526 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2527 </li></ul></div></div></div><div id="method-setHeight" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setHeight" rel="method-setHeight" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-setHeight" class="viewSource">view source</a></div><a name="setHeight"></a><a name="method-setHeight"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setHeight" class="cls expand">setHeight</a>(
2528 <span class="pre">Number height</span>)
2529  : Ext.Component</div><div class="description"><div class="short"><p>Sets the height of the component.  This method fires the <a href="Ext.form.field.ComboBox.html#resize" rel="Ext.form.field.ComboBox#resize" class="docClass">resize</a> event.</p>
2530 </div><div class="long"><p>Sets the height of the component.  This method fires the <a href="Ext.form.field.ComboBox.html#resize" rel="Ext.form.field.ComboBox#resize" class="docClass">resize</a> event.</p>
2531 <h3 class="pa">Parameters</h3><ul><li><span class="pre">height</span> : Number<div class="sub-desc"><p>The new height to set. This may be one of:<div class="mdetail-params"><ul>
2532 <li>A Number specifying the new height in the <a href="Ext.form.field.ComboBox.html#getEl" rel="Ext.form.field.ComboBox#getEl" class="docClass">Element</a>'s <a href="Ext.core.Element.html#defaultUnit" rel="Ext.core.Element#defaultUnit" class="docClass">Ext.core.Element.defaultUnit</a>s (by default, pixels).</li>
2533 <li>A String used to set the CSS height style.</li>
2534 <li><i>undefined</i> to leave the height unchanged.</li>
2535 </ul></div></p>
2536 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2537 </li></ul></div></div></div><div id="method-setLoading" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setLoading" rel="method-setLoading" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-setLoading" class="viewSource">view source</a></div><a name="setLoading"></a><a name="method-setLoading"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setLoading" class="cls expand">setLoading</a>(
2538 <span class="pre">Boolean/Object/String load, Boolean targetEl</span>)
2539  : Ext.LoadMask</div><div class="description"><div class="short"><p>This method allows you to show or hide a LoadMask on top of this component.</p>
2540 </div><div class="long"><p>This method allows you to show or hide a LoadMask on top of this component.</p>
2541 <h3 class="pa">Parameters</h3><ul><li><span class="pre">load</span> : Boolean/Object/String<div class="sub-desc"><p>True to show the default LoadMask, a config object
2542 that will be passed to the LoadMask constructor, or a message String to show. False to
2543 hide the current LoadMask.</p>
2544 </div></li><li><span class="pre">targetEl</span> : Boolean<div class="sub-desc"><p>True to mask the targetEl of this Component instead of the this.el.
2545 For example, setting this to true on a Panel will cause only the body to be masked. (defaults to false)</p>
2546 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.LoadMask</span>&nbsp; &nbsp;<p>The LoadMask instance that has just been shown.</p>
2547 </li></ul></div></div></div><div id="method-setPagePosition" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setPagePosition" rel="method-setPagePosition" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-setPagePosition" class="viewSource">view source</a></div><a name="setPagePosition"></a><a name="method-setPagePosition"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setPagePosition" class="cls expand">setPagePosition</a>(
2548 <span class="pre">Number x, Number y, Mixed animate</span>)
2549  : Ext.Component</div><div class="description"><div class="short">Sets the page XY position of the component.  To set the left and top instead, use setPosition.
2550 This method fires the ...</div><div class="long"><p>Sets the page XY position of the component.  To set the left and top instead, use <a href="Ext.form.field.ComboBox.html#setPosition" rel="Ext.form.field.ComboBox#setPosition" class="docClass">setPosition</a>.
2551 This method fires the <a href="Ext.form.field.ComboBox.html#move" rel="Ext.form.field.ComboBox#move" class="docClass">move</a> event.</p>
2552 <h3 class="pa">Parameters</h3><ul><li><span class="pre">x</span> : Number<div class="sub-desc"><p>The new x position</p>
2553 </div></li><li><span class="pre">y</span> : Number<div class="sub-desc"><p>The new y position</p>
2554 </div></li><li><span class="pre">animate</span> : Mixed<div class="sub-desc"><p>If passed, the Component is <i>animated</i> into its new position. If this parameter
2555 is a number, it is used as the animation duration in milliseconds.</p>
2556 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2557 </li></ul></div></div></div><div id="method-setPosition" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setPosition" rel="method-setPosition" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-setPosition" class="viewSource">view source</a></div><a name="setPosition"></a><a name="method-setPosition"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setPosition" class="cls expand">setPosition</a>(
2558 <span class="pre">Number left, Number top, Mixed animate</span>)
2559  : Ext.Component</div><div class="description"><div class="short">Sets the left and top of the component.  To set the page XY position instead, use setPagePosition.
2560 This method fires ...</div><div class="long"><p>Sets the left and top of the component.  To set the page XY position instead, use <a href="Ext.form.field.ComboBox.html#setPagePosition" rel="Ext.form.field.ComboBox#setPagePosition" class="docClass">setPagePosition</a>.
2561 This method fires the <a href="Ext.form.field.ComboBox.html#move" rel="Ext.form.field.ComboBox#move" class="docClass">move</a> event.</p>
2562 <h3 class="pa">Parameters</h3><ul><li><span class="pre">left</span> : Number<div class="sub-desc"><p>The new left</p>
2563 </div></li><li><span class="pre">top</span> : Number<div class="sub-desc"><p>The new top</p>
2564 </div></li><li><span class="pre">animate</span> : Mixed<div class="sub-desc"><p>If true, the Component is <i>animated</i> into its new position. You may also pass an animation configuration.</p>
2565 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2566 </li></ul></div></div></div><div id="method-setRawValue" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setRawValue" rel="method-setRawValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-setRawValue" class="viewSource">view source</a></div><a name="setRawValue"></a><a name="method-setRawValue"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setRawValue" class="cls expand">setRawValue</a>(
2567 <span class="pre">Mixed value</span>)
2568  : Mixed</div><div class="description"><div class="short">Sets the field's raw value directly, bypassing value conversion, change detection, and
2569 validation. To set the value w...</div><div class="long"><p>Sets the field's raw value directly, bypassing <a href="Ext.form.field.ComboBox.html#valueToRaw" rel="Ext.form.field.ComboBox#valueToRaw" class="docClass">value conversion</a>, change detection, and
2570 validation. To set the value with these additional inspections see <a href="Ext.form.field.ComboBox.html#setValue" rel="Ext.form.field.ComboBox#setValue" class="docClass">setValue</a>.</p>
2571 <h3 class="pa">Parameters</h3><ul><li><span class="pre">value</span> : Mixed<div class="sub-desc"><p>The value to set</p>
2572 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Mixed</span>&nbsp; &nbsp;<p>value The field value that is set</p>
2573 </li></ul></div></div></div><div id="method-setReadOnly" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setReadOnly" rel="method-setReadOnly" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Trigger.html" class="definedIn docClass">Ext.form.field.Trigger</a><br/><a href="../source/Trigger.html#Ext-form.field.Trigger-method-setReadOnly" class="viewSource">view source</a></div><a name="setReadOnly"></a><a name="method-setReadOnly"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setReadOnly" class="cls expand">setReadOnly</a>(
2574 <span class="pre">Boolean readOnly</span>)
2575  : void</div><div class="description"><div class="short"><p>&nbsp;</p></div><div class="long">
2576 <h3 class="pa">Parameters</h3><ul><li><span class="pre">readOnly</span> : Boolean<div class="sub-desc"><p>True to prevent the user changing the field and explicitly
2577 hide the trigger.
2578 Setting this to true will superceed settings editable and hideTrigger.
2579 Setting this to false will defer back to editable and hideTrigger. This method
2580 is the runtime equivalent of setting the 'readOnly' config option at config time.</p>
2581 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2582 </li></ul></div></div></div><div id="method-setSize" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setSize" rel="method-setSize" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-setSize" class="viewSource">view source</a></div><a name="setSize"></a><a name="method-setSize"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setSize" class="cls expand">setSize</a>(
2583 <span class="pre">Mixed width, Mixed height</span>)
2584  : Ext.Component</div><div class="description"><div class="short">Sets the width and height of this Component. This method fires the resize event. This method can accept
2585 either width ...</div><div class="long"><p>Sets the width and height of this Component. This method fires the <a href="Ext.form.field.ComboBox.html#resize" rel="Ext.form.field.ComboBox#resize" class="docClass">resize</a> event. This method can accept
2586 either width and height as separate arguments, or you can pass a size object like <code>{width:10, height:20}</code>.</p>
2587 <h3 class="pa">Parameters</h3><ul><li><span class="pre">width</span> : Mixed<div class="sub-desc"><p>The new width to set. This may be one of:<div class="mdetail-params"><ul>
2588 <li>A Number specifying the new width in the <a href="Ext.form.field.ComboBox.html#getEl" rel="Ext.form.field.ComboBox#getEl" class="docClass">Element</a>'s <a href="Ext.core.Element.html#defaultUnit" rel="Ext.core.Element#defaultUnit" class="docClass">Ext.core.Element.defaultUnit</a>s (by default, pixels).</li>
2589 <li>A String used to set the CSS width style.</li>
2590 <li>A size object in the format <code>{width: widthValue, height: heightValue}</code>.</li>
2591 <li><code>undefined</code> to leave the width unchanged.</li>
2592 </ul></div></p>
2593 </div></li><li><span class="pre">height</span> : Mixed<div class="sub-desc"><p>The new height to set (not required if a size object is passed as the first arg).
2594 This may be one of:<div class="mdetail-params"><ul>
2595 <li>A Number specifying the new height in the <a href="Ext.form.field.ComboBox.html#getEl" rel="Ext.form.field.ComboBox#getEl" class="docClass">Element</a>'s <a href="Ext.core.Element.html#defaultUnit" rel="Ext.core.Element#defaultUnit" class="docClass">Ext.core.Element.defaultUnit</a>s (by default, pixels).</li>
2596 <li>A String used to set the CSS height style. Animation may <b>not</b> be used.</li>
2597 <li><code>undefined</code> to leave the height unchanged.</li>
2598 </ul></div></p>
2599 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2600 </li></ul></div></div></div><div id="method-setUI" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setUI" rel="method-setUI" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-setUI" class="viewSource">view source</a></div><a name="setUI"></a><a name="method-setUI"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setUI" class="cls expand">setUI</a>(
2601 <span class="pre">String ui</span>)
2602  : void</div><div class="description"><div class="short">Sets the UI for the component. This will remove any existing UIs on the component. It will also
2603 loop through any uiCl...</div><div class="long"><p>Sets the UI for the component. This will remove any existing UIs on the component. It will also
2604 loop through any uiCls set on the component and rename them so they include the new UI</p>
2605 <h3 class="pa">Parameters</h3><ul><li><span class="pre">ui</span> : String<div class="sub-desc"><p>The new UI for the component</p>
2606 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2607 </li></ul></div></div></div><div id="method-setValue" class="member ni"><a href="Ext.form.field.ComboBox.html#method-setValue" rel="method-setValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-method-setValue" class="viewSource">view source</a></div><a name="setValue"></a><a name="method-setValue"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setValue" class="cls expand">setValue</a>(
2608 <span class="pre">String|Array value, Object doSelect</span>)
2609  : Ext.form.field.Field</div><div class="description"><div class="short">Sets the specified value(s) into the field. For each value, if a record is found in the store that
2610 matches based on t...</div><div class="long"><p>Sets the specified value(s) into the field. For each value, if a record is found in the <a href="Ext.form.field.ComboBox.html#store" rel="Ext.form.field.ComboBox#store" class="docClass">store</a> that
2611 matches based on the <a href="Ext.form.field.ComboBox.html#valueField" rel="Ext.form.field.ComboBox#valueField" class="docClass">valueField</a>, then that record's <a href="Ext.form.field.ComboBox.html#displayField" rel="Ext.form.field.ComboBox#displayField" class="docClass">displayField</a> will be displayed in the
2612 field.  If no match is found, and the <a href="Ext.form.field.ComboBox.html#valueNotFoundText" rel="Ext.form.field.ComboBox#valueNotFoundText" class="docClass">valueNotFoundText</a> config option is defined, then that will be
2613 displayed as the default field text. Otherwise a blank value will be shown, although the value will still be set.</p>
2614 <h3 class="pa">Parameters</h3><ul><li><span class="pre">value</span> : String|Array<div class="sub-desc"><p>The value(s) to be set. Can be either a single String or <a href="Ext.data.Model.html" rel="Ext.data.Model" class="docClass">Ext.data.Model</a>,
2615 or an Array of Strings or Models.</p>
2616 </div></li><li><span class="pre">doSelect</span> : Object<div class="sub-desc">
2617 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.form.field.Field</span>&nbsp; &nbsp;<p>this</p>
2618 </li></ul></div></div></div><div id="method-setVisible" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setVisible" rel="method-setVisible" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-setVisible" class="viewSource">view source</a></div><a name="setVisible"></a><a name="method-setVisible"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setVisible" class="cls expand">setVisible</a>(
2619 <span class="pre">Boolean visible</span>)
2620  : Ext.Component</div><div class="description"><div class="short"><p>Convenience function to hide or show this component by boolean.</p>
2621 </div><div class="long"><p>Convenience function to hide or show this component by boolean.</p>
2622 <h3 class="pa">Parameters</h3><ul><li><span class="pre">visible</span> : Boolean<div class="sub-desc"><p>True to show, false to hide</p>
2623 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2624 </li></ul></div></div></div><div id="method-setWidth" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-setWidth" rel="method-setWidth" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-setWidth" class="viewSource">view source</a></div><a name="setWidth"></a><a name="method-setWidth"></a><a href="Ext.form.field.ComboBox.html#" rel="method-setWidth" class="cls expand">setWidth</a>(
2625 <span class="pre">Number width</span>)
2626  : Ext.Component</div><div class="description"><div class="short"><p>Sets the width of the component.  This method fires the <a href="Ext.form.field.ComboBox.html#resize" rel="Ext.form.field.ComboBox#resize" class="docClass">resize</a> event.</p>
2627 </div><div class="long"><p>Sets the width of the component.  This method fires the <a href="Ext.form.field.ComboBox.html#resize" rel="Ext.form.field.ComboBox#resize" class="docClass">resize</a> event.</p>
2628 <h3 class="pa">Parameters</h3><ul><li><span class="pre">width</span> : Number<div class="sub-desc"><p>The new width to setThis may be one of:<div class="mdetail-params"><ul>
2629 <li>A Number specifying the new width in the <a href="Ext.form.field.ComboBox.html#getEl" rel="Ext.form.field.ComboBox#getEl" class="docClass">Element</a>'s <a href="Ext.core.Element.html#defaultUnit" rel="Ext.core.Element#defaultUnit" class="docClass">Ext.core.Element.defaultUnit</a>s (by default, pixels).</li>
2630 <li>A String used to set the CSS width style.</li>
2631 </ul></div></p>
2632 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2633 </li></ul></div></div></div><div id="method-show" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-show" rel="method-show" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-show" class="viewSource">view source</a></div><a name="show"></a><a name="method-show"></a><a href="Ext.form.field.ComboBox.html#" rel="method-show" class="cls expand">show</a>(
2634 <span class="pre">String/Element animateTarget, [Function callback], [Object scope]</span>)
2635  : Component</div><div class="description"><div class="short">Shows this Component, rendering it first if autoRender or {&quot;floating are true.
2636
2637
2638 After being shown, a floating C...</div><div class="long"><p>Shows this Component, rendering it first if <a href="Ext.form.field.ComboBox.html#autoRender" rel="Ext.form.field.ComboBox#autoRender" class="docClass">autoRender</a> or {<a href="Ext.form.field.ComboBox.html"floating" rel=""floating" class="docClass">&quot;floating</a> are <code>true</code>.</p>
2639
2640
2641 <p>After being shown, a <a href="Ext.form.field.ComboBox.html#floating" rel="Ext.form.field.ComboBox#floating" class="docClass">floating</a> Component (such as a <a href="Ext.window.Window.html" rel="Ext.window.Window" class="docClass">Ext.window.Window</a>), is activated it and brought to the front of
2642 its <a href="Ext.form.field.ComboBox.html#ZIndexManager" rel="Ext.form.field.ComboBox#ZIndexManager" class="docClass">z-index stack</a>.</p>
2643
2644 <h3 class="pa">Parameters</h3><ul><li><span class="pre">animateTarget</span> : String/Element<div class="sub-desc"><p>Optional, and <b>only valid for <a href="Ext.form.field.ComboBox.html#floating" rel="Ext.form.field.ComboBox#floating" class="docClass">floating</a> Components such as
2645 <a href="Ext.window.Window.html" rel="Ext.window.Window" class="docClass">Window</a>s or <a href="Ext.tip.ToolTip.html" rel="Ext.tip.ToolTip" class="docClass">ToolTip</a>s, or regular Components which have been configured
2646 with <code>floating: true</code>.</b> The target from which the Component should
2647 animate from while opening (defaults to null with no animation)</p>
2648 </div></li><li><span class="pre">callback</span> : Function<div class="sub-desc"><p>(optional) A callback function to call after the Component is displayed. Only necessary if animation was specified.</p>
2649 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope (<code>this</code> reference) in which the callback is executed. Defaults to this Component.</p>
2650 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Component</span>&nbsp; &nbsp;<p>this</p>
2651 </li></ul></div></div></div><div id="method-stopAnimation" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-stopAnimation" rel="method-stopAnimation" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Animate.html" class="definedIn docClass">Ext.util.Animate</a><br/><a href="../source/Animate.html#Ext-util.Animate-method-stopAnimation" class="viewSource">view source</a></div><a name="stopAnimation"></a><a name="method-stopAnimation"></a><a href="Ext.form.field.ComboBox.html#" rel="method-stopAnimation" class="cls expand">stopAnimation</a> : Ext.core.Element</div><div class="description"><div class="short">@deprecated 4.0 Replaced by stopAnimation
2652 Stops any running effects and clears this object's internal effects queue i...</div><div class="long"><p>@deprecated 4.0 Replaced by <a href="Ext.form.field.ComboBox.html#stopAnimation" rel="Ext.form.field.ComboBox#stopAnimation" class="docClass">stopAnimation</a>
2653 Stops any running effects and clears this object's internal effects queue if it contains
2654 any additional effects that haven't started yet.</p>
2655 <h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.core.Element</span>&nbsp; &nbsp;<p>The Element</p>
2656 </li></ul></div></div></div><div id="method-suspendEvents" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-suspendEvents" rel="method-suspendEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-suspendEvents" class="viewSource">view source</a></div><a name="suspendEvents"></a><a name="method-suspendEvents"></a><a href="Ext.form.field.ComboBox.html#" rel="method-suspendEvents" class="cls expand">suspendEvents</a>(
2657 <span class="pre">Boolean queueSuspended</span>)
2658  : void</div><div class="description"><div class="short"><p>Suspend the firing of all events. (see <a href="Ext.form.field.ComboBox.html#resumeEvents" rel="Ext.form.field.ComboBox#resumeEvents" class="docClass">resumeEvents</a>)</p>
2659 </div><div class="long"><p>Suspend the firing of all events. (see <a href="Ext.form.field.ComboBox.html#resumeEvents" rel="Ext.form.field.ComboBox#resumeEvents" class="docClass">resumeEvents</a>)</p>
2660 <h3 class="pa">Parameters</h3><ul><li><span class="pre">queueSuspended</span> : Boolean<div class="sub-desc"><p>Pass as true to queue up suspended events to be fired
2661 after the <a href="Ext.form.field.ComboBox.html#resumeEvents" rel="Ext.form.field.ComboBox#resumeEvents" class="docClass">resumeEvents</a> call instead of discarding all suspended events;</p>
2662 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2663 </li></ul></div></div></div><div id="method-syncFx" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-syncFx" rel="method-syncFx" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Animate.html" class="definedIn docClass">Ext.util.Animate</a><br/><a href="../source/Animate.html#Ext-util.Animate-method-syncFx" class="viewSource">view source</a></div><a name="syncFx"></a><a name="method-syncFx"></a><a href="Ext.form.field.ComboBox.html#" rel="method-syncFx" class="cls expand">syncFx</a> : Ext.core.Element</div><div class="description"><div class="short">Ensures that all effects queued after syncFx is called on this object are
2664 run concurrently.  This is the opposite of ...</div><div class="long"><p>Ensures that all effects queued after syncFx is called on this object are
2665 run concurrently.  This is the opposite of <a href="Ext.form.field.ComboBox.html#sequenceFx" rel="Ext.form.field.ComboBox#sequenceFx" class="docClass">sequenceFx</a>.</p>
2666 <h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.core.Element</span>&nbsp; &nbsp;<p>The Element</p>
2667 </li></ul></div></div></div><div id="method-toBack" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-toBack" rel="method-toBack" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Floating.html" class="definedIn docClass">Ext.util.Floating</a><br/><a href="../source/Floating.html#Ext-util.Floating-method-toBack" class="viewSource">view source</a></div><a name="toBack"></a><a name="method-toBack"></a><a href="Ext.form.field.ComboBox.html#" rel="method-toBack" class="cls expand">toBack</a> : Component</div><div class="description"><div class="short"><p>Sends this Component to the back of (lower z-index than) any other visible windows</p>
2668 </div><div class="long"><p>Sends this Component to the back of (lower z-index than) any other visible windows</p>
2669 <h3 class="pa">Returns</h3><ul><li><span class="pre">Component</span>&nbsp; &nbsp;<p>this</p>
2670 </li></ul></div></div></div><div id="method-toFront" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-toFront" rel="method-toFront" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Floating.html" class="definedIn docClass">Ext.util.Floating</a><br/><a href="../source/Floating.html#Ext-util.Floating-method-toFront" class="viewSource">view source</a></div><a name="toFront"></a><a name="method-toFront"></a><a href="Ext.form.field.ComboBox.html#" rel="method-toFront" class="cls expand">toFront</a>(
2671 <span class="pre">[Boolean preventFocus]</span>)
2672  : Component</div><div class="description"><div class="short">Brings this floating Component to the front of any other visible, floating Components managed by the same ZIndexManag...</div><div class="long"><p>Brings this floating Component to the front of any other visible, floating Components managed by the same <a href="Ext.ZIndexManager.html" rel="Ext.ZIndexManager" class="docClass">ZIndexManager</a></p>
2673
2674
2675 <p>If this Component is modal, inserts the modal mask just below this Component in the z-index stack.</p>
2676
2677 <h3 class="pa">Parameters</h3><ul><li><span class="pre">preventFocus</span> : Boolean<div class="sub-desc"><p>(optional) Specify <code>true</code> to prevent the Component from being focused.</p>
2678 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Component</span>&nbsp; &nbsp;<p>this</p>
2679 </li></ul></div></div></div><div id="method-un" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-un" rel="method-un" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-un" class="viewSource">view source</a></div><a name="un"></a><a name="method-un"></a><a href="Ext.form.field.ComboBox.html#" rel="method-un" class="cls expand">un</a>(
2680 <span class="pre">String eventName, Function handler, [Object scope]</span>)
2681  : void</div><div class="description"><div class="short"><p>Removes an event handler (shorthand for <a href="Ext.form.field.ComboBox.html#removeListener" rel="Ext.form.field.ComboBox#removeListener" class="docClass">removeListener</a>.)</p>
2682 </div><div class="long"><p>Removes an event handler (shorthand for <a href="Ext.form.field.ComboBox.html#removeListener" rel="Ext.form.field.ComboBox#removeListener" class="docClass">removeListener</a>.)</p>
2683 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The type of event the handler was associated with.</p>
2684 </div></li><li><span class="pre">handler</span> : Function<div class="sub-desc"><p>The handler to remove. <b>This must be a reference to the function passed into the <a href="Ext.form.field.ComboBox.html#addListener" rel="Ext.form.field.ComboBox#addListener" class="docClass">addListener</a> call.</b></p>
2685 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope originally specified for the handler.</p>
2686 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2687 </li></ul></div></div></div><div id="method-unsetActiveError" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-unsetActiveError" rel="method-unsetActiveError" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-unsetActiveError" class="viewSource">view source</a></div><a name="unsetActiveError"></a><a name="method-unsetActiveError"></a><a href="Ext.form.field.ComboBox.html#" rel="method-unsetActiveError" class="cls expand">unsetActiveError</a> : void</div><div class="description"><div class="short"><p>Clears the active error.</p>
2688 </div><div class="long"><p>Clears the active error.</p>
2689 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2690 </li></ul></div></div></div><div id="method-up" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-up" rel="method-up" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-up" class="viewSource">view source</a></div><a name="up"></a><a name="method-up"></a><a href="Ext.form.field.ComboBox.html#" rel="method-up" class="cls expand">up</a>(
2691 <span class="pre">String selector</span>)
2692  : Container</div><div class="description"><div class="short">Walks up the ownerCt axis looking for an ancestor Container which matches
2693 the passed simple selector.
2694
2695
2696 Example:
2697 var ...</div><div class="long"><p>Walks up the <code>ownerCt</code> axis looking for an ancestor Container which matches
2698 the passed simple selector.</p>
2699
2700
2701 <p>Example:
2702 <pre><code>var owningTabPanel = grid.up('tabpanel');
2703 </code></pre>
2704
2705 <h3 class="pa">Parameters</h3><ul><li><span class="pre">selector</span> : String<div class="sub-desc"><p>Optional. The simple selector to test.</p>
2706 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Container</span>&nbsp; &nbsp;<p>The matching ancestor Container (or <code>undefined</code> if no match was found).</p>
2707 </li></ul></div></div></div><div id="method-update" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-update" rel="method-update" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-update" class="viewSource">view source</a></div><a name="update"></a><a name="method-update"></a><a href="Ext.form.field.ComboBox.html#" rel="method-update" class="cls expand">update</a>(
2708 <span class="pre">Mixed htmlOrData, [Boolean loadScripts], [Function callback]</span>)
2709  : void</div><div class="description"><div class="short"><p>Update the content area of a component.</p>
2710 </div><div class="long"><p>Update the content area of a component.</p>
2711 <h3 class="pa">Parameters</h3><ul><li><span class="pre">htmlOrData</span> : Mixed<div class="sub-desc"><p>If this component has been configured with a template via the tpl config
2712 then it will use this argument as data to populate the template.
2713 If this component was not configured with a template, the components
2714 content area will be updated via <a href="Ext.core.Element.html" rel="Ext.core.Element" class="docClass">Ext.core.Element</a> update</p>
2715 </div></li><li><span class="pre">loadScripts</span> : Boolean<div class="sub-desc"><p>(optional) Only legitimate when using the html configuration. Defaults to false</p>
2716 </div></li><li><span class="pre">callback</span> : Function<div class="sub-desc"><p>(optional) Only legitimate when using the html configuration. Callback to execute when scripts have finished loading</p>
2717 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2718 </li></ul></div></div></div><div id="method-updateBox" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-updateBox" rel="method-updateBox" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-updateBox" class="viewSource">view source</a></div><a name="updateBox"></a><a name="method-updateBox"></a><a href="Ext.form.field.ComboBox.html#" rel="method-updateBox" class="cls expand">updateBox</a>(
2719 <span class="pre">Object box</span>)
2720  : Ext.Component</div><div class="description"><div class="short"><p>Sets the current box measurements of the component's underlying element.</p>
2721 </div><div class="long"><p>Sets the current box measurements of the component's underlying element.</p>
2722 <h3 class="pa">Parameters</h3><ul><li><span class="pre">box</span> : Object<div class="sub-desc"><p>An object in the format {x, y, width, height}</p>
2723 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2724 </li></ul></div></div></div><div id="method-validate" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-validate" rel="method-validate" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-validate" class="viewSource">view source</a></div><a name="validate"></a><a name="method-validate"></a><a href="Ext.form.field.ComboBox.html#" rel="method-validate" class="cls expand">validate</a> : Boolean</div><div class="description"><div class="short">Returns whether or not the field value is currently valid by validating the
2725 field's current value, and fires the vali...</div><div class="long"><p>Returns whether or not the field value is currently valid by <a href="Ext.form.field.ComboBox.html#getErrors" rel="Ext.form.field.ComboBox#getErrors" class="docClass">validating</a> the
2726 field's current value, and fires the <a href="Ext.form.field.ComboBox.html#validitychange" rel="Ext.form.field.ComboBox#validitychange" class="docClass">validitychange</a> event if the field's validity has
2727 changed since the last validation. <b>Note</b>: <a href="Ext.form.field.ComboBox.html#disabled" rel="Ext.form.field.ComboBox#disabled" class="docClass">disabled</a> fields are always treated as valid.</p>
2728
2729
2730 <p>Custom implementations of this method are allowed to have side-effects such as triggering error
2731 message display. To validate without side-effects, use <a href="Ext.form.field.ComboBox.html#isValid" rel="Ext.form.field.ComboBox#isValid" class="docClass">isValid</a>.</p>
2732
2733 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if the value is valid, else false</p>
2734 </li></ul></div></div></div><div id="method-validateValue" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-validateValue" rel="method-validateValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-validateValue" class="viewSource">view source</a></div><a name="validateValue"></a><a name="method-validateValue"></a><a href="Ext.form.field.ComboBox.html#" rel="method-validateValue" class="cls expand">validateValue</a>(
2735 <span class="pre">Mixed value</span>)
2736  : Boolean</div><div class="description"><div class="short">Uses getErrors to build an array of validation errors. If any errors are found, they are passed
2737 to markInvalid and fa...</div><div class="long"><p>Uses <a href="Ext.form.field.ComboBox.html#getErrors" rel="Ext.form.field.ComboBox#getErrors" class="docClass">getErrors</a> to build an array of validation errors. If any errors are found, they are passed
2738 to <a href="Ext.form.field.ComboBox.html#markInvalid" rel="Ext.form.field.ComboBox#markInvalid" class="docClass">markInvalid</a> and false is returned, otherwise true is returned.</p>
2739
2740
2741 <p>Previously, subclasses were invited to provide an implementation of this to process validations - from 3.2
2742 onwards <a href="Ext.form.field.ComboBox.html#getErrors" rel="Ext.form.field.ComboBox#getErrors" class="docClass">getErrors</a> should be overridden instead.</p>
2743
2744 <h3 class="pa">Parameters</h3><ul><li><span class="pre">value</span> : Mixed<div class="sub-desc"><p>The value to validate</p>
2745 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if all validations passed, false if one or more failed</p>
2746 </li></ul></div></div></div><div id="method-valueToRaw" class="member inherited"><a href="Ext.form.field.ComboBox.html#method-valueToRaw" rel="method-valueToRaw" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-valueToRaw" class="viewSource">view source</a></div><a name="valueToRaw"></a><a name="method-valueToRaw"></a><a href="Ext.form.field.ComboBox.html#" rel="method-valueToRaw" class="cls expand">valueToRaw</a>(
2747 <span class="pre">Mixed value</span>)
2748  : Mixed</div><div class="description"><div class="short">Converts a mixed-type value to a raw representation suitable for displaying in the field. This allows
2749 controlling how...</div><div class="long"><p>Converts a mixed-type value to a raw representation suitable for displaying in the field. This allows
2750 controlling how value objects passed to <a href="Ext.form.field.ComboBox.html#setValue" rel="Ext.form.field.ComboBox#setValue" class="docClass">setValue</a> are shown to the user, including localization.
2751 For instance, for a <a href="Ext.form.field.Date.html" rel="Ext.form.field.Date" class="docClass">Ext.form.field.Date</a>, this would control how a Date object passed to <a href="Ext.form.field.ComboBox.html#setValue" rel="Ext.form.field.ComboBox#setValue" class="docClass">setValue</a>
2752 would be converted to a String for display in the field.</p>
2753
2754
2755 <p>See <a href="Ext.form.field.ComboBox.html#rawToValue" rel="Ext.form.field.ComboBox#rawToValue" class="docClass">rawToValue</a> for the opposite conversion.</p>
2756
2757
2758 <p>The base implementation simply does a standard toString conversion, and converts
2759 <a href="Ext.html#isEmpty" rel="Ext#isEmpty" class="docClass">empty values</a> to an empty string.</p>
2760
2761 <h3 class="pa">Parameters</h3><ul><li><span class="pre">value</span> : Mixed<div class="sub-desc"><p>The mixed-type value to convert to the raw representation.</p>
2762 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Mixed</span>&nbsp; &nbsp;<p>The converted raw value.</p>
2763 </li></ul></div></div></div></div><div class="m-events"><a name="events"></a><div class="definedBy">Defined By</div><h3 class="evt p">Events</h3><div id="event-activate" class="member f inherited"><a href="Ext.form.field.ComboBox.html#event-activate" rel="event-activate" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-activate" class="viewSource">view source</a></div><a name="activate"></a><a name="event-activate"></a><a href="Ext.form.field.ComboBox.html#" rel="event-activate" class="cls expand">activate</a>(
2764 <span class="pre">Ext.Component this</span>)
2765 </div><div class="description"><div class="short"><p>Fires after a Component has been visually activated.</p>
2766 </div><div class="long"><p>Fires after a Component has been visually activated.</p>
2767 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2768 </div></li></ul></div></div></div><div id="event-added" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-added" rel="event-added" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-added" class="viewSource">view source</a></div><a name="added"></a><a name="event-added"></a><a href="Ext.form.field.ComboBox.html#" rel="event-added" class="cls expand">added</a>(
2769 <span class="pre">Ext.Component this, Ext.container.Container container, Number pos</span>)
2770 </div><div class="description"><div class="short"><p>Fires after a Component had been added to a Container.</p>
2771 </div><div class="long"><p>Fires after a Component had been added to a Container.</p>
2772 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2773 </div></li><li><span class="pre">container</span> : Ext.container.Container<div class="sub-desc"><p>Parent Container</p>
2774 </div></li><li><span class="pre">pos</span> : Number<div class="sub-desc"><p>position of Component</p>
2775 </div></li></ul></div></div></div><div id="event-afterrender" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-afterrender" rel="event-afterrender" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-afterrender" class="viewSource">view source</a></div><a name="afterrender"></a><a name="event-afterrender"></a><a href="Ext.form.field.ComboBox.html#" rel="event-afterrender" class="cls expand">afterrender</a>(
2776 <span class="pre">Ext.Component this</span>)
2777 </div><div class="description"><div class="short">Fires after the component rendering is finished.
2778
2779
2780 The afterrender event is fired after this Component has been rende...</div><div class="long"><p>Fires after the component rendering is finished.</p>
2781
2782
2783 <p>The afterrender event is fired after this Component has been <a href="Ext.form.field.ComboBox.html#rendered" rel="Ext.form.field.ComboBox#rendered" class="docClass">rendered</a>, been postprocesed
2784 by any afterRender method defined for the Component.</p>
2785
2786 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2787 </div></li></ul></div></div></div><div id="event-autosize" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-autosize" rel="event-autosize" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-event-autosize" class="viewSource">view source</a></div><a name="autosize"></a><a name="event-autosize"></a><a href="Ext.form.field.ComboBox.html#" rel="event-autosize" class="cls expand">autosize</a>(
2788 <span class="pre">Ext.form.field.Text this, Number width</span>)
2789 </div><div class="description"><div class="short">Fires when the autoSize function is triggered and the field is
2790 resized according to the grow/growMin/growMax configs ...</div><div class="long"><p>Fires when the <tt><b><a href="Ext.form.field.ComboBox.html#autoSize" rel="Ext.form.field.ComboBox#autoSize" class="docClass">autoSize</a></b></tt> function is triggered and the field is
2791 resized according to the <a href="Ext.form.field.ComboBox.html#grow" rel="Ext.form.field.ComboBox#grow" class="docClass">grow</a>/<a href="Ext.form.field.ComboBox.html#growMin" rel="Ext.form.field.ComboBox#growMin" class="docClass">growMin</a>/<a href="Ext.form.field.ComboBox.html#growMax" rel="Ext.form.field.ComboBox#growMax" class="docClass">growMax</a> configs as a result.
2792 This event provides a hook for the developer to apply additional logic at runtime to resize the
2793 field if needed.</p>
2794 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Text<div class="sub-desc"><p>This text field</p>
2795 </div></li><li><span class="pre">width</span> : Number<div class="sub-desc"><p>The new field width</p>
2796 </div></li></ul></div></div></div><div id="event-beforeactivate" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-beforeactivate" rel="event-beforeactivate" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-beforeactivate" class="viewSource">view source</a></div><a name="beforeactivate"></a><a name="event-beforeactivate"></a><a href="Ext.form.field.ComboBox.html#" rel="event-beforeactivate" class="cls expand">beforeactivate</a>(
2797 <span class="pre">Ext.Component this</span>)
2798 </div><div class="description"><div class="short">Fires before a Component has been visually activated.
2799 Returning false from an event listener can prevent the activate...</div><div class="long"><p>Fires before a Component has been visually activated.
2800 Returning false from an event listener can prevent the activate
2801 from occurring.</p>
2802 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2803 </div></li></ul></div></div></div><div id="event-beforedeactivate" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-beforedeactivate" rel="event-beforedeactivate" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-beforedeactivate" class="viewSource">view source</a></div><a name="beforedeactivate"></a><a name="event-beforedeactivate"></a><a href="Ext.form.field.ComboBox.html#" rel="event-beforedeactivate" class="cls expand">beforedeactivate</a>(
2804 <span class="pre">Ext.Component this</span>)
2805 </div><div class="description"><div class="short">Fires before a Component has been visually deactivated.
2806 Returning false from an event listener can prevent the deacti...</div><div class="long"><p>Fires before a Component has been visually deactivated.
2807 Returning false from an event listener can prevent the deactivate
2808 from occurring.</p>
2809 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2810 </div></li></ul></div></div></div><div id="event-beforedestroy" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-beforedestroy" rel="event-beforedestroy" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-beforedestroy" class="viewSource">view source</a></div><a name="beforedestroy"></a><a name="event-beforedestroy"></a><a href="Ext.form.field.ComboBox.html#" rel="event-beforedestroy" class="cls expand">beforedestroy</a>(
2811 <span class="pre">Ext.Component this</span>)
2812 </div><div class="description"><div class="short"><p>Fires before the component is <a href="Ext.form.field.ComboBox.html#destroy" rel="Ext.form.field.ComboBox#destroy" class="docClass">destroy</a>ed. Return false from an event handler to stop the <a href="Ext.form.field.ComboBox.html#destroy" rel="Ext.form.field.ComboBox#destroy" class="docClass">destroy</a>.</p>
2813 </div><div class="long"><p>Fires before the component is <a href="Ext.form.field.ComboBox.html#destroy" rel="Ext.form.field.ComboBox#destroy" class="docClass">destroy</a>ed. Return false from an event handler to stop the <a href="Ext.form.field.ComboBox.html#destroy" rel="Ext.form.field.ComboBox#destroy" class="docClass">destroy</a>.</p>
2814 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2815 </div></li></ul></div></div></div><div id="event-beforehide" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-beforehide" rel="event-beforehide" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-beforehide" class="viewSource">view source</a></div><a name="beforehide"></a><a name="event-beforehide"></a><a href="Ext.form.field.ComboBox.html#" rel="event-beforehide" class="cls expand">beforehide</a>(
2816 <span class="pre">Ext.Component this</span>)
2817 </div><div class="description"><div class="short"><p>Fires before the component is hidden when calling the <a href="Ext.form.field.ComboBox.html#hide" rel="Ext.form.field.ComboBox#hide" class="docClass">hide</a> method.
2818 Return false from an event handler to stop the hide.</p>
2819 </div><div class="long"><p>Fires before the component is hidden when calling the <a href="Ext.form.field.ComboBox.html#hide" rel="Ext.form.field.ComboBox#hide" class="docClass">hide</a> method.
2820 Return false from an event handler to stop the hide.</p>
2821 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2822 </div></li></ul></div></div></div><div id="event-beforequery" class="member ni"><a href="Ext.form.field.ComboBox.html#event-beforequery" rel="event-beforequery" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.ComboBox.html" class="definedIn docClass">Ext.form.field.ComboBox</a><br/><a href="../source/ComboBox.html#Ext-form.field.ComboBox-event-beforequery" class="viewSource">view source</a></div><a name="beforequery"></a><a name="event-beforequery"></a><a href="Ext.form.field.ComboBox.html#" rel="event-beforequery" class="cls expand">beforequery</a>(
2823 <span class="pre">Object queryEvent</span>)
2824 </div><div class="description"><div class="short">Fires before all queries are processed. Return false to cancel the query or set the queryEvent's
2825 cancel property to t...</div><div class="long"><p>Fires before all queries are processed. Return false to cancel the query or set the queryEvent's
2826 cancel property to true.</p>
2827 <h3 class="pa">Parameters</h3><ul><li><span class="pre">queryEvent</span> : Object<div class="sub-desc"><p>An object that has these properties:<ul>
2828 <li><code>combo</code> : <a href="Ext.form.field.ComboBox.html" rel="Ext.form.field.ComboBox" class="docClass">Ext.form.field.ComboBox</a> <div class="sub-desc">This combo box</div></li>
2829 <li><code>query</code> : String <div class="sub-desc">The query string</div></li>
2830 <li><code>forceAll</code> : Boolean <div class="sub-desc">True to force "all" query</div></li>
2831 <li><code>cancel</code> : Boolean <div class="sub-desc">Set to true to cancel the query</div></li>
2832 </ul></p>
2833 </div></li></ul></div></div></div><div id="event-beforerender" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-beforerender" rel="event-beforerender" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-beforerender" class="viewSource">view source</a></div><a name="beforerender"></a><a name="event-beforerender"></a><a href="Ext.form.field.ComboBox.html#" rel="event-beforerender" class="cls expand">beforerender</a>(
2834 <span class="pre">Ext.Component this</span>)
2835 </div><div class="description"><div class="short"><p>Fires before the component is <a href="Ext.form.field.ComboBox.html#rendered" rel="Ext.form.field.ComboBox#rendered" class="docClass">rendered</a>. Return false from an
2836 event handler to stop the <a href="Ext.form.field.ComboBox.html#render" rel="Ext.form.field.ComboBox#render" class="docClass">render</a>.</p>
2837 </div><div class="long"><p>Fires before the component is <a href="Ext.form.field.ComboBox.html#rendered" rel="Ext.form.field.ComboBox#rendered" class="docClass">rendered</a>. Return false from an
2838 event handler to stop the <a href="Ext.form.field.ComboBox.html#render" rel="Ext.form.field.ComboBox#render" class="docClass">render</a>.</p>
2839 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2840 </div></li></ul></div></div></div><div id="event-beforeshow" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-beforeshow" rel="event-beforeshow" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-beforeshow" class="viewSource">view source</a></div><a name="beforeshow"></a><a name="event-beforeshow"></a><a href="Ext.form.field.ComboBox.html#" rel="event-beforeshow" class="cls expand">beforeshow</a>(
2841 <span class="pre">Ext.Component this</span>)
2842 </div><div class="description"><div class="short"><p>Fires before the component is shown when calling the <a href="Ext.form.field.ComboBox.html#show" rel="Ext.form.field.ComboBox#show" class="docClass">show</a> method.
2843 Return false from an event handler to stop the show.</p>
2844 </div><div class="long"><p>Fires before the component is shown when calling the <a href="Ext.form.field.ComboBox.html#show" rel="Ext.form.field.ComboBox#show" class="docClass">show</a> method.
2845 Return false from an event handler to stop the show.</p>
2846 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2847 </div></li></ul></div></div></div><div id="event-beforestaterestore" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-beforestaterestore" rel="event-beforestaterestore" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-event-beforestaterestore" class="viewSource">view source</a></div><a name="beforestaterestore"></a><a name="event-beforestaterestore"></a><a href="Ext.form.field.ComboBox.html#" rel="event-beforestaterestore" class="cls expand">beforestaterestore</a>(
2848 <span class="pre">Ext.state.Stateful this, Object state</span>)
2849 </div><div class="description"><div class="short"><p>Fires before the state of the object is restored. Return false from an event handler to stop the restore.</p>
2850 </div><div class="long"><p>Fires before the state of the object is restored. Return false from an event handler to stop the restore.</p>
2851 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.state.Stateful<div class="sub-desc">
2852 </div></li><li><span class="pre">state</span> : Object<div class="sub-desc"><p>The hash of state values returned from the StateProvider. If this
2853 event is not vetoed, then the state object is passed to <b><tt>applyState</tt></b>. By default,
2854 that simply copies property values into this object. The method maybe overriden to
2855 provide custom state restoration.</p>
2856 </div></li></ul></div></div></div><div id="event-beforestatesave" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-beforestatesave" rel="event-beforestatesave" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-event-beforestatesave" class="viewSource">view source</a></div><a name="beforestatesave"></a><a name="event-beforestatesave"></a><a href="Ext.form.field.ComboBox.html#" rel="event-beforestatesave" class="cls expand">beforestatesave</a>(
2857 <span class="pre">Ext.state.Stateful this, Object state</span>)
2858 </div><div class="description"><div class="short"><p>Fires before the state of the object is saved to the configured state provider. Return false to stop the save.</p>
2859 </div><div class="long"><p>Fires before the state of the object is saved to the configured state provider. Return false to stop the save.</p>
2860 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.state.Stateful<div class="sub-desc">
2861 </div></li><li><span class="pre">state</span> : Object<div class="sub-desc"><p>The hash of state values. This is determined by calling
2862 <b><tt>getState()</tt></b> on the object. This method must be provided by the
2863 developer to return whetever representation of state is required, by default, <a href="Ext.state.Stateful.html" rel="Ext.state.Stateful" class="docClass">Ext.state.Stateful</a>
2864 has a null implementation.</p>
2865 </div></li></ul></div></div></div><div id="event-blur" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-blur" rel="event-blur" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-event-blur" class="viewSource">view source</a></div><a name="blur"></a><a name="event-blur"></a><a href="Ext.form.field.ComboBox.html#" rel="event-blur" class="cls expand">blur</a>(
2866 <span class="pre">Ext.form.field.Base this</span>)
2867 </div><div class="description"><div class="short"><p>Fires when this field loses input focus.</p>
2868 </div><div class="long"><p>Fires when this field loses input focus.</p>
2869 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Base<div class="sub-desc">
2870 </div></li></ul></div></div></div><div id="event-change" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-change" rel="event-change" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-event-change" class="viewSource">view source</a></div><a name="change"></a><a name="event-change"></a><a href="Ext.form.field.ComboBox.html#" rel="event-change" class="cls expand">change</a>(
2871 <span class="pre">Ext.form.field.Field this, Mixed newValue, Mixed oldValue</span>)
2872 </div><div class="description"><div class="short"><p>Fires when a user-initiated change is detected in the value of the field.</p>
2873 </div><div class="long"><p>Fires when a user-initiated change is detected in the value of the field.</p>
2874 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Field<div class="sub-desc">
2875 </div></li><li><span class="pre">newValue</span> : Mixed<div class="sub-desc"><p>The new value</p>
2876 </div></li><li><span class="pre">oldValue</span> : Mixed<div class="sub-desc"><p>The original value</p>
2877 </div></li></ul></div></div></div><div id="event-collapse" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-collapse" rel="event-collapse" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Picker.html" class="definedIn docClass">Ext.form.field.Picker</a><br/><a href="../source/Picker.html#Ext-form.field.Picker-event-collapse" class="viewSource">view source</a></div><a name="collapse"></a><a name="event-collapse"></a><a href="Ext.form.field.ComboBox.html#" rel="event-collapse" class="cls expand">collapse</a>(
2878 <span class="pre">Ext.form.field.Picker field</span>)
2879 </div><div class="description"><div class="short"><p>Fires when the field's picker is collapsed.</p>
2880 </div><div class="long"><p>Fires when the field's picker is collapsed.</p>
2881 <h3 class="pa">Parameters</h3><ul><li><span class="pre">field</span> : Ext.form.field.Picker<div class="sub-desc"><p>This field instance</p>
2882 </div></li></ul></div></div></div><div id="event-deactivate" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-deactivate" rel="event-deactivate" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-deactivate" class="viewSource">view source</a></div><a name="deactivate"></a><a name="event-deactivate"></a><a href="Ext.form.field.ComboBox.html#" rel="event-deactivate" class="cls expand">deactivate</a>(
2883 <span class="pre">Ext.Component this</span>)
2884 </div><div class="description"><div class="short"><p>Fires after a Component has been visually deactivated.</p>
2885 </div><div class="long"><p>Fires after a Component has been visually deactivated.</p>
2886 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2887 </div></li></ul></div></div></div><div id="event-destroy" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-destroy" rel="event-destroy" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-destroy" class="viewSource">view source</a></div><a name="destroy"></a><a name="event-destroy"></a><a href="Ext.form.field.ComboBox.html#" rel="event-destroy" class="cls expand">destroy</a>(
2888 <span class="pre">Ext.Component this</span>)
2889 </div><div class="description"><div class="short"><p>Fires after the component is <a href="Ext.form.field.ComboBox.html#destroy" rel="Ext.form.field.ComboBox#destroy" class="docClass">destroy</a>ed.</p>
2890 </div><div class="long"><p>Fires after the component is <a href="Ext.form.field.ComboBox.html#destroy" rel="Ext.form.field.ComboBox#destroy" class="docClass">destroy</a>ed.</p>
2891 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2892 </div></li></ul></div></div></div><div id="event-dirtychange" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-dirtychange" rel="event-dirtychange" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-event-dirtychange" class="viewSource">view source</a></div><a name="dirtychange"></a><a name="event-dirtychange"></a><a href="Ext.form.field.ComboBox.html#" rel="event-dirtychange" class="cls expand">dirtychange</a>(
2893 <span class="pre">Ext.form.field.Field this, Boolean isDirty</span>)
2894 </div><div class="description"><div class="short"><p>Fires when a change in the field's <a href="Ext.form.field.ComboBox.html#isDirty" rel="Ext.form.field.ComboBox#isDirty" class="docClass">isDirty</a> state is detected.</p>
2895 </div><div class="long"><p>Fires when a change in the field's <a href="Ext.form.field.ComboBox.html#isDirty" rel="Ext.form.field.ComboBox#isDirty" class="docClass">isDirty</a> state is detected.</p>
2896 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Field<div class="sub-desc">
2897 </div></li><li><span class="pre">isDirty</span> : Boolean<div class="sub-desc"><p>Whether or not the field is now dirty</p>
2898 </div></li></ul></div></div></div><div id="event-disable" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-disable" rel="event-disable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-disable" class="viewSource">view source</a></div><a name="disable"></a><a name="event-disable"></a><a href="Ext.form.field.ComboBox.html#" rel="event-disable" class="cls expand">disable</a>(
2899 <span class="pre">Ext.Component this</span>)
2900 </div><div class="description"><div class="short"><p>Fires after the component is disabled.</p>
2901 </div><div class="long"><p>Fires after the component is disabled.</p>
2902 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2903 </div></li></ul></div></div></div><div id="event-enable" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-enable" rel="event-enable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-enable" class="viewSource">view source</a></div><a name="enable"></a><a name="event-enable"></a><a href="Ext.form.field.ComboBox.html#" rel="event-enable" class="cls expand">enable</a>(
2904 <span class="pre">Ext.Component this</span>)
2905 </div><div class="description"><div class="short"><p>Fires after the component is enabled.</p>
2906 </div><div class="long"><p>Fires after the component is enabled.</p>
2907 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2908 </div></li></ul></div></div></div><div id="event-errorchange" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-errorchange" rel="event-errorchange" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-event-errorchange" class="viewSource">view source</a></div><a name="errorchange"></a><a name="event-errorchange"></a><a href="Ext.form.field.ComboBox.html#" rel="event-errorchange" class="cls expand">errorchange</a>(
2909 <span class="pre">Ext.form.Labelable this, String error</span>)
2910 </div><div class="description"><div class="short"><p>Fires when the active error message is changed via <a href="Ext.form.field.ComboBox.html#setActiveError" rel="Ext.form.field.ComboBox#setActiveError" class="docClass">setActiveError</a>.</p>
2911 </div><div class="long"><p>Fires when the active error message is changed via <a href="Ext.form.field.ComboBox.html#setActiveError" rel="Ext.form.field.ComboBox#setActiveError" class="docClass">setActiveError</a>.</p>
2912 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.Labelable<div class="sub-desc">
2913 </div></li><li><span class="pre">error</span> : String<div class="sub-desc"><p>The active error message</p>
2914 </div></li></ul></div></div></div><div id="event-expand" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-expand" rel="event-expand" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Picker.html" class="definedIn docClass">Ext.form.field.Picker</a><br/><a href="../source/Picker.html#Ext-form.field.Picker-event-expand" class="viewSource">view source</a></div><a name="expand"></a><a name="event-expand"></a><a href="Ext.form.field.ComboBox.html#" rel="event-expand" class="cls expand">expand</a>(
2915 <span class="pre">Ext.form.field.Picker field</span>)
2916 </div><div class="description"><div class="short"><p>Fires when the field's picker is expanded.</p>
2917 </div><div class="long"><p>Fires when the field's picker is expanded.</p>
2918 <h3 class="pa">Parameters</h3><ul><li><span class="pre">field</span> : Ext.form.field.Picker<div class="sub-desc"><p>This field instance</p>
2919 </div></li></ul></div></div></div><div id="event-focus" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-focus" rel="event-focus" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-event-focus" class="viewSource">view source</a></div><a name="focus"></a><a name="event-focus"></a><a href="Ext.form.field.ComboBox.html#" rel="event-focus" class="cls expand">focus</a>(
2920 <span class="pre">Ext.form.field.Base this</span>)
2921 </div><div class="description"><div class="short"><p>Fires when this field receives input focus.</p>
2922 </div><div class="long"><p>Fires when this field receives input focus.</p>
2923 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Base<div class="sub-desc">
2924 </div></li></ul></div></div></div><div id="event-hide" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-hide" rel="event-hide" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-hide" class="viewSource">view source</a></div><a name="hide"></a><a name="event-hide"></a><a href="Ext.form.field.ComboBox.html#" rel="event-hide" class="cls expand">hide</a>(
2925 <span class="pre">Ext.Component this</span>)
2926 </div><div class="description"><div class="short"><p>Fires after the component is hidden.
2927 Fires after the component is hidden when calling the <a href="Ext.form.field.ComboBox.html#hide" rel="Ext.form.field.ComboBox#hide" class="docClass">hide</a> method.</p>
2928 </div><div class="long"><p>Fires after the component is hidden.
2929 Fires after the component is hidden when calling the <a href="Ext.form.field.ComboBox.html#hide" rel="Ext.form.field.ComboBox#hide" class="docClass">hide</a> method.</p>
2930 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2931 </div></li></ul></div></div></div><div id="event-keydown" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-keydown" rel="event-keydown" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-event-keydown" class="viewSource">view source</a></div><a name="keydown"></a><a name="event-keydown"></a><a href="Ext.form.field.ComboBox.html#" rel="event-keydown" class="cls expand">keydown</a>(
2932 <span class="pre">Ext.form.field.Text this, Ext.EventObject e</span>)
2933 </div><div class="description"><div class="short"><p>Keydown input field event. This event only fires if <tt><b><a href="Ext.form.field.ComboBox.html#enableKeyEvents" rel="Ext.form.field.ComboBox#enableKeyEvents" class="docClass">enableKeyEvents</a></b></tt>
2934 is set to true.</p>
2935 </div><div class="long"><p>Keydown input field event. This event only fires if <tt><b><a href="Ext.form.field.ComboBox.html#enableKeyEvents" rel="Ext.form.field.ComboBox#enableKeyEvents" class="docClass">enableKeyEvents</a></b></tt>
2936 is set to true.</p>
2937 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Text<div class="sub-desc"><p>This text field</p>
2938 </div></li><li><span class="pre">e</span> : Ext.EventObject<div class="sub-desc">
2939 </div></li></ul></div></div></div><div id="event-keypress" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-keypress" rel="event-keypress" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-event-keypress" class="viewSource">view source</a></div><a name="keypress"></a><a name="event-keypress"></a><a href="Ext.form.field.ComboBox.html#" rel="event-keypress" class="cls expand">keypress</a>(
2940 <span class="pre">Ext.form.field.Text this, Ext.EventObject e</span>)
2941 </div><div class="description"><div class="short"><p>Keypress input field event. This event only fires if <tt><b><a href="Ext.form.field.ComboBox.html#enableKeyEvents" rel="Ext.form.field.ComboBox#enableKeyEvents" class="docClass">enableKeyEvents</a></b></tt>
2942 is set to true.</p>
2943 </div><div class="long"><p>Keypress input field event. This event only fires if <tt><b><a href="Ext.form.field.ComboBox.html#enableKeyEvents" rel="Ext.form.field.ComboBox#enableKeyEvents" class="docClass">enableKeyEvents</a></b></tt>
2944 is set to true.</p>
2945 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Text<div class="sub-desc"><p>This text field</p>
2946 </div></li><li><span class="pre">e</span> : Ext.EventObject<div class="sub-desc">
2947 </div></li></ul></div></div></div><div id="event-keyup" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-keyup" rel="event-keyup" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-event-keyup" class="viewSource">view source</a></div><a name="keyup"></a><a name="event-keyup"></a><a href="Ext.form.field.ComboBox.html#" rel="event-keyup" class="cls expand">keyup</a>(
2948 <span class="pre">Ext.form.field.Text this, Ext.EventObject e</span>)
2949 </div><div class="description"><div class="short"><p>Keyup input field event. This event only fires if <tt><b><a href="Ext.form.field.ComboBox.html#enableKeyEvents" rel="Ext.form.field.ComboBox#enableKeyEvents" class="docClass">enableKeyEvents</a></b></tt>
2950 is set to true.</p>
2951 </div><div class="long"><p>Keyup input field event. This event only fires if <tt><b><a href="Ext.form.field.ComboBox.html#enableKeyEvents" rel="Ext.form.field.ComboBox#enableKeyEvents" class="docClass">enableKeyEvents</a></b></tt>
2952 is set to true.</p>
2953 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Text<div class="sub-desc"><p>This text field</p>
2954 </div></li><li><span class="pre">e</span> : Ext.EventObject<div class="sub-desc">
2955 </div></li></ul></div></div></div><div id="event-move" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-move" rel="event-move" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-move" class="viewSource">view source</a></div><a name="move"></a><a name="event-move"></a><a href="Ext.form.field.ComboBox.html#" rel="event-move" class="cls expand">move</a>(
2956 <span class="pre">Ext.Component this, Number x, Number y</span>)
2957 </div><div class="description"><div class="short"><p>Fires after the component is moved.</p>
2958 </div><div class="long"><p>Fires after the component is moved.</p>
2959 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2960 </div></li><li><span class="pre">x</span> : Number<div class="sub-desc"><p>The new x position</p>
2961 </div></li><li><span class="pre">y</span> : Number<div class="sub-desc"><p>The new y position</p>
2962 </div></li></ul></div></div></div><div id="event-removed" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-removed" rel="event-removed" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-removed" class="viewSource">view source</a></div><a name="removed"></a><a name="event-removed"></a><a href="Ext.form.field.ComboBox.html#" rel="event-removed" class="cls expand">removed</a>(
2963 <span class="pre">Ext.Component this, Ext.container.Container ownerCt</span>)
2964 </div><div class="description"><div class="short"><p>Fires when a component is removed from an Ext.container.Container</p>
2965 </div><div class="long"><p>Fires when a component is removed from an Ext.container.Container</p>
2966 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2967 </div></li><li><span class="pre">ownerCt</span> : Ext.container.Container<div class="sub-desc"><p>Container which holds the component</p>
2968 </div></li></ul></div></div></div><div id="event-render" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-render" rel="event-render" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-render" class="viewSource">view source</a></div><a name="render"></a><a name="event-render"></a><a href="Ext.form.field.ComboBox.html#" rel="event-render" class="cls expand">render</a>(
2969 <span class="pre">Ext.Component this</span>)
2970 </div><div class="description"><div class="short"><p>Fires after the component markup is <a href="Ext.form.field.ComboBox.html#rendered" rel="Ext.form.field.ComboBox#rendered" class="docClass">rendered</a>.</p>
2971 </div><div class="long"><p>Fires after the component markup is <a href="Ext.form.field.ComboBox.html#rendered" rel="Ext.form.field.ComboBox#rendered" class="docClass">rendered</a>.</p>
2972 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2973 </div></li></ul></div></div></div><div id="event-resize" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-resize" rel="event-resize" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-resize" class="viewSource">view source</a></div><a name="resize"></a><a name="event-resize"></a><a href="Ext.form.field.ComboBox.html#" rel="event-resize" class="cls expand">resize</a>(
2974 <span class="pre">Ext.Component this, Number adjWidth, Number adjHeight</span>)
2975 </div><div class="description"><div class="short"><p>Fires after the component is resized.</p>
2976 </div><div class="long"><p>Fires after the component is resized.</p>
2977 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2978 </div></li><li><span class="pre">adjWidth</span> : Number<div class="sub-desc"><p>The box-adjusted width that was set</p>
2979 </div></li><li><span class="pre">adjHeight</span> : Number<div class="sub-desc"><p>The box-adjusted height that was set</p>
2980 </div></li></ul></div></div></div><div id="event-select" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-select" rel="event-select" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Picker.html" class="definedIn docClass">Ext.form.field.Picker</a><br/><a href="../source/Picker.html#Ext-form.field.Picker-event-select" class="viewSource">view source</a></div><a name="select"></a><a name="event-select"></a><a href="Ext.form.field.ComboBox.html#" rel="event-select" class="cls expand">select</a>(
2981 <span class="pre">Ext.form.field.Picker field, Mixed value</span>)
2982 </div><div class="description"><div class="short"><p>Fires when a value is selected via the picker.</p>
2983 </div><div class="long"><p>Fires when a value is selected via the picker.</p>
2984 <h3 class="pa">Parameters</h3><ul><li><span class="pre">field</span> : Ext.form.field.Picker<div class="sub-desc"><p>This field instance</p>
2985 </div></li><li><span class="pre">value</span> : Mixed<div class="sub-desc"><p>The value that was selected. The exact type of this value is dependent on
2986 the individual field and picker implementations.</p>
2987 </div></li></ul></div></div></div><div id="event-show" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-show" rel="event-show" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-show" class="viewSource">view source</a></div><a name="show"></a><a name="event-show"></a><a href="Ext.form.field.ComboBox.html#" rel="event-show" class="cls expand">show</a>(
2988 <span class="pre">Ext.Component this</span>)
2989 </div><div class="description"><div class="short"><p>Fires after the component is shown when calling the <a href="Ext.form.field.ComboBox.html#show" rel="Ext.form.field.ComboBox#show" class="docClass">show</a> method.</p>
2990 </div><div class="long"><p>Fires after the component is shown when calling the <a href="Ext.form.field.ComboBox.html#show" rel="Ext.form.field.ComboBox#show" class="docClass">show</a> method.</p>
2991 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2992 </div></li></ul></div></div></div><div id="event-specialkey" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-specialkey" rel="event-specialkey" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-event-specialkey" class="viewSource">view source</a></div><a name="specialkey"></a><a name="event-specialkey"></a><a href="Ext.form.field.ComboBox.html#" rel="event-specialkey" class="cls expand">specialkey</a>(
2993 <span class="pre">Ext.form.field.Base this, Ext.EventObject e</span>)
2994 </div><div class="description"><div class="short">Fires when any key related to navigation (arrows, tab, enter, esc, etc.) is pressed.
2995 To handle other keys see Ext.pan...</div><div class="long"><p>Fires when any key related to navigation (arrows, tab, enter, esc, etc.) is pressed.
2996 To handle other keys see <a href="Ext.panel.Panel.html#keys" rel="Ext.panel.Panel#keys" class="docClass">Ext.panel.Panel.keys</a> or <a href="Ext.util.KeyMap.html" rel="Ext.util.KeyMap" class="docClass">Ext.util.KeyMap</a>.
2997 You can check <a href="Ext.EventObject.html#getKey" rel="Ext.EventObject#getKey" class="docClass">Ext.EventObject.getKey</a> to determine which key was pressed.
2998 For example:</p>
2999
3000 <pre><code>var form = new Ext.form.Panel({
3001     ...
3002     items: [{
3003             fieldLabel: 'Field 1',
3004             name: 'field1',
3005             allowBlank: false
3006         },{
3007             fieldLabel: 'Field 2',
3008             name: 'field2',
3009             listeners: {
3010                 specialkey: function(field, e){
3011                     // e.HOME, e.END, e.PAGE_UP, e.PAGE_DOWN,
3012                     // e.TAB, e.ESC, arrow keys: e.LEFT, e.RIGHT, e.UP, e.DOWN
3013                     if (e.<a href="Ext.EventObject.html#getKey" rel="Ext.EventObject#getKey" class="docClass">getKey()</a> == e.ENTER) {
3014                         var form = field.up('form').getForm();
3015                         form.submit();
3016                     }
3017                 }
3018             }
3019         }
3020     ],
3021     ...
3022 });
3023 </code></pre>
3024
3025 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Base<div class="sub-desc">
3026 </div></li><li><span class="pre">e</span> : Ext.EventObject<div class="sub-desc"><p>The event object</p>
3027 </div></li></ul></div></div></div><div id="event-staterestore" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-staterestore" rel="event-staterestore" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-event-staterestore" class="viewSource">view source</a></div><a name="staterestore"></a><a name="event-staterestore"></a><a href="Ext.form.field.ComboBox.html#" rel="event-staterestore" class="cls expand">staterestore</a>(
3028 <span class="pre">Ext.state.Stateful this, Object state</span>)
3029 </div><div class="description"><div class="short"><p>Fires after the state of the object is restored.</p>
3030 </div><div class="long"><p>Fires after the state of the object is restored.</p>
3031 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.state.Stateful<div class="sub-desc">
3032 </div></li><li><span class="pre">state</span> : Object<div class="sub-desc"><p>The hash of state values returned from the StateProvider. This is passed
3033 to <b><tt>applyState</tt></b>. By default, that simply copies property values into this
3034 object. The method maybe overriden to provide custom state restoration.</p>
3035 </div></li></ul></div></div></div><div id="event-statesave" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-statesave" rel="event-statesave" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-event-statesave" class="viewSource">view source</a></div><a name="statesave"></a><a name="event-statesave"></a><a href="Ext.form.field.ComboBox.html#" rel="event-statesave" class="cls expand">statesave</a>(
3036 <span class="pre">Ext.state.Stateful this, Object state</span>)
3037 </div><div class="description"><div class="short"><p>Fires after the state of the object is saved to the configured state provider.</p>
3038 </div><div class="long"><p>Fires after the state of the object is saved to the configured state provider.</p>
3039 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.state.Stateful<div class="sub-desc">
3040 </div></li><li><span class="pre">state</span> : Object<div class="sub-desc"><p>The hash of state values. This is determined by calling
3041 <b><tt>getState()</tt></b> on the object. This method must be provided by the
3042 developer to return whetever representation of state is required, by default, <a href="Ext.state.Stateful.html" rel="Ext.state.Stateful" class="docClass">Ext.state.Stateful</a>
3043 has a null implementation.</p>
3044 </div></li></ul></div></div></div><div id="event-validitychange" class="member inherited"><a href="Ext.form.field.ComboBox.html#event-validitychange" rel="event-validitychange" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-event-validitychange" class="viewSource">view source</a></div><a name="validitychange"></a><a name="event-validitychange"></a><a href="Ext.form.field.ComboBox.html#" rel="event-validitychange" class="cls expand">validitychange</a>(
3045 <span class="pre">Ext.form.field.Field this, Boolean isValid</span>)
3046 </div><div class="description"><div class="short"><p>Fires when a change in the field's validity is detected.</p>
3047 </div><div class="long"><p>Fires when a change in the field's validity is detected.</p>
3048 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Field<div class="sub-desc">
3049 </div></li><li><span class="pre">isValid</span> : Boolean<div class="sub-desc"><p>Whether or not the field is now valid</p>
3050 </div></li></ul></div></div></div></div></div></div></div><div id="pageContent"></div></div></div></div></body></html>