Upgrade to ExtJS 4.0.0 - Released 04/26/2011
[extjs.git] / docs / api / Ext.util.MixedCollection.html
1 <!DOCTYPE html><html><head><title>Ext.util.MixedCollection | 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.util.MixedCollection',
13         docClass: 'Ext.util.MixedCollection',
14         docReq: 'Ext.util.MixedCollection',
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 = 'MixedCollection.html#Ext-util.MixedCollection';
33     clsInfo = {"methods":["MixedCollection","add","addAll","addEvents","addListener","addManagedListener","capture","clear","clearListeners","clearManagedListeners","clone","collect","contains","containsKey","each","eachKey","enableBubble","filter","filterBy","findBy","findIndex","findIndexBy","fireEvent","first","get","getAt","getByKey","getCount","getKey","getRange","getSortState","hasListener","indexOf","indexOfKey","initSortable","insert","last","observe","on","relayEvents","releaseCapture","remove","removeAll","removeAt","removeAtKey","removeListener","removeManagedListener","reorder","replace","resumeEvents","sort","sortBy","sortByKey","sum","suspendEvents","un"],"cfgs":["allowFunctions","listeners"],"properties":["defaultSortDirection","isSortable","sortRoot","sorters"],"events":["add","clear","remove","replace"],"subclasses":["Ext.form.CheckboxManager","Ext.form.RadioManager","Ext.data.Errors","Ext.data.StoreManager","Ext.draw.CompositeSprite"]};
34     Ext.onReady(function() {
35         Ext.create('Docs.classPanel');
36     });
37 </script><div id="top-block" class="top-block"><h1 id="clsTitle" class="cls"><a href="../source/MixedCollection.html#Ext-util.MixedCollection" target="_blank">Ext.util.MixedCollection</a></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.util.AbstractMixedCollection.html" rel="Ext.util.AbstractMixedCollection" class="cls docClass">Ext.util.AbstractMixedCollection</a><div class="subclass"><strong>Ext.util.MixedCollection</strong></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.Sortable.html" rel="Ext.util.Sortable" class="cls docClass">Ext.util.Sortable</a></div></pre><p>
38 Represents a collection of a set of key and value pairs. Each key in the MixedCollection
39 must be unique, the same key cannot exist twice. This collection is ordered, items in the
40 collection can be accessed by index  or via the key. Newly added items are added to
41 the end of the collection. This class is similar to <a href="Ext.util.HashMap.html" rel="Ext.util.HashMap" class="docClass">Ext.util.HashMap</a> however it
42 is heavier and provides more functionality. Sample usage:
43 <pre class="prettyprint"><code>var coll = new Ext.util.MixedCollection();
44 coll.add('key1', 'val1');
45 coll.add('key2', 'val2');
46 coll.add('key3', 'val3');
47
48 console.log(coll.get('key1')); // prints 'val1'
49 console.log(coll.indexOfKey('key3')); // prints 2
50 </code></pre>
51
52 <p>
53 The MixedCollection also has support for sorting and filtering of the values in the collection.
54 <pre class="prettyprint"><code>var coll = new Ext.util.MixedCollection();
55 coll.add('key1', 100);
56 coll.add('key2', -100);
57 coll.add('key3', 17);
58 coll.add('key4', 0);
59 var biggerThanZero = coll.filterBy(function(value){
60     return value > 0;
61 });
62 console.log(biggerThanZero.getCount()); // prints 2
63 </code></pre>
64 </p>
65
66 <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">Other Configs</h4><div id="config-allowFunctions" class="member f inherited"><a href="Ext.util.MixedCollection.html#config-allowFunctions" rel="config-allowFunctions" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-cfg-allowFunctions" class="viewSource">view source</a></div><a name="allowFunctions"></a><a name="config-allowFunctions"></a><a href="Ext.util.MixedCollection.html#" rel="config-allowFunctions" class="cls expand">allowFunctions</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Specify <tt>true</tt> if the <a href="Ext.util.MixedCollection.html#addAll" rel="Ext.util.MixedCollection#addAll" class="docClass">addAll</a>
67 function should add function references to the collection. Defaults to
68 <tt>false</tt>.</p>
69 </div><div class="long"><p>Specify <tt>true</tt> if the <a href="Ext.util.MixedCollection.html#addAll" rel="Ext.util.MixedCollection#addAll" class="docClass">addAll</a>
70 function should add function references to the collection. Defaults to
71 <tt>false</tt>.</p>
72 </div></div></div><div id="config-listeners" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.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
73 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
74 object during initialization.  This should be a valid listeners config object as specified in the
75 <a href="Ext.util.MixedCollection.html#addListener" rel="Ext.util.MixedCollection#addListener" class="docClass">addListener</a> example for attaching multiple handlers at once.</p></p>
76
77 <br><p><b><u>DOM events from ExtJs <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Components</a></u></b></p>
78
79
80 <br><p>While <i>some</i> ExtJs Component classes export selected DOM events (e.g. "click", "mouseover" etc), this
81
82
83 <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
84 <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
85 events directly from a child element of a Component, we need to specify the <code>element</code> option to
86 identify the Component property to add a DOM listener to:</p>
87
88 <pre><code>new Ext.panel.Panel({
89     width: 400,
90     height: 200,
91     dockedItems: [{
92         xtype: 'toolbar'
93     }],
94     listeners: {
95         click: {
96             element: 'el', //bind to the underlying el property on the panel
97             fn: function(){ console.log('click el'); }
98         },
99         dblclick: {
100             element: 'body', //bind to the underlying body property on the panel
101             fn: function(){ console.log('dblclick body'); }
102         }
103     }
104 });
105 </code></pre>
106
107
108 <p></p></p>
109 </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-defaultSortDirection" class="member f inherited"><a href="Ext.util.MixedCollection.html#property-defaultSortDirection" rel="property-defaultSortDirection" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Sortable.html" class="definedIn docClass">Ext.util.Sortable</a><br/><a href="../source/Sortable.html#Ext-util.Sortable-property-defaultSortDirection" class="viewSource">view source</a></div><a name="defaultSortDirection"></a><a name="property-defaultSortDirection"></a><a href="Ext.util.MixedCollection.html#" rel="property-defaultSortDirection" class="cls expand">defaultSortDirection</a><span> : String</span></div><div class="description"><div class="short"><p>The default sort direction to use if one is not specified (defaults to "ASC")</p>
110 </div><div class="long"><p>The default sort direction to use if one is not specified (defaults to "ASC")</p>
111 </div></div></div><div id="property-isSortable" class="member inherited"><a href="Ext.util.MixedCollection.html#property-isSortable" rel="property-isSortable" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Sortable.html" class="definedIn docClass">Ext.util.Sortable</a><br/><a href="../source/Sortable.html#Ext-util.Sortable-property-isSortable" class="viewSource">view source</a></div><a name="isSortable"></a><a name="property-isSortable"></a><a href="Ext.util.MixedCollection.html#" rel="property-isSortable" class="cls expand">isSortable</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Flag denoting that this object is sortable. Always true.</p>
112 </div><div class="long"><p>Flag denoting that this object is sortable. Always true.</p>
113 </div></div></div><div id="property-sortRoot" class="member inherited"><a href="Ext.util.MixedCollection.html#property-sortRoot" rel="property-sortRoot" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Sortable.html" class="definedIn docClass">Ext.util.Sortable</a><br/><a href="../source/Sortable.html#Ext-util.Sortable-property-sortRoot" class="viewSource">view source</a></div><a name="sortRoot"></a><a name="property-sortRoot"></a><a href="Ext.util.MixedCollection.html#" rel="property-sortRoot" class="cls expand">sortRoot</a><span> : String</span></div><div class="description"><div class="short"><p>The property in each item that contains the data to sort. (defaults to null)</p>
114 </div><div class="long"><p>The property in each item that contains the data to sort. (defaults to null)</p>
115 </div></div></div><div id="property-sorters" class="member inherited"><a href="Ext.util.MixedCollection.html#property-sorters" rel="property-sorters" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Sortable.html" class="definedIn docClass">Ext.util.Sortable</a><br/><a href="../source/Sortable.html#Ext-util.Sortable-property-sorters" class="viewSource">view source</a></div><a name="sorters"></a><a name="property-sorters"></a><a href="Ext.util.MixedCollection.html#" rel="property-sorters" class="cls expand">sorters</a><span> : Ext.util.MixedCollection</span></div><div class="description"><div class="short"><p>The collection of <a href="Ext.util.Sorter.html" rel="Ext.util.Sorter" class="docClass">Sorters</a> currently applied to this Store</p>
116 </div><div class="long"><p>The collection of <a href="Ext.util.Sorter.html" rel="Ext.util.Sorter" class="docClass">Sorters</a> currently applied to this Store</p>
117 </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-MixedCollection" class="member f ni"><a href="Ext.util.MixedCollection.html#method-MixedCollection" rel="method-MixedCollection" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.MixedCollection.html" class="definedIn docClass">Ext.util.MixedCollection</a><br/><a href="../source/MixedCollection.html#Ext-util.MixedCollection-method-constructor" class="viewSource">view source</a></div><a name="MixedCollection"></a><a name="method-MixedCollection"></a><a href="Ext.util.MixedCollection.html#" rel="method-MixedCollection" class="cls expand">MixedCollection</a>(
118 <span class="pre">Boolean allowFunctions, Function keyFn</span>)
119  : void</div><div class="description"><div class="short"><p>&nbsp;</p></div><div class="long">
120 <h3 class="pa">Parameters</h3><ul><li><span class="pre">allowFunctions</span> : Boolean<div class="sub-desc"><p>Specify <tt>true</tt> if the <a href="Ext.util.MixedCollection.html#addAll" rel="Ext.util.MixedCollection#addAll" class="docClass">addAll</a>
121 function should add function references to the collection. Defaults to
122 <tt>false</tt>.</p>
123 </div></li><li><span class="pre">keyFn</span> : Function<div class="sub-desc"><p>A function that can accept an item of the type(s) stored in this MixedCollection
124 and return the key value for that item.  This is used when available to look up the key on items that
125 were passed without an explicit key parameter to a MixedCollection method.  Passing this parameter is
126 equivalent to providing an implementation for the <a href="Ext.util.MixedCollection.html#getKey" rel="Ext.util.MixedCollection#getKey" class="docClass">getKey</a> method.</p>
127 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
128 </li></ul></div></div></div><div id="method-add" class="member inherited"><a href="Ext.util.MixedCollection.html#method-add" rel="method-add" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-add" class="viewSource">view source</a></div><a name="add"></a><a name="method-add"></a><a href="Ext.util.MixedCollection.html#" rel="method-add" class="cls expand">add</a>(
129 <span class="pre">String key, Object o</span>)
130  : Object</div><div class="description"><div class="short"><p>Adds an item to the collection. Fires the <a href="Ext.util.MixedCollection.html#add" rel="Ext.util.MixedCollection#add" class="docClass">add</a> event when complete.</p>
131 </div><div class="long"><p>Adds an item to the collection. Fires the <a href="Ext.util.MixedCollection.html#add" rel="Ext.util.MixedCollection#add" class="docClass">add</a> event when complete.</p>
132 <h3 class="pa">Parameters</h3><ul><li><span class="pre">key</span> : String<div class="sub-desc"><p>The key to associate with the item, or the new item.</p>
133
134
135 <p>If a <a href="Ext.util.MixedCollection.html#getKey" rel="Ext.util.MixedCollection#getKey" class="docClass">getKey</a> implementation was specified for this MixedCollection,
136 or if the key of the stored items is in a property called <tt><b>id</b></tt>,
137 the MixedCollection will be able to <i>derive</i> the key for the new item.
138 In this case just pass the new item in this parameter.</p>
139
140 </div></li><li><span class="pre">o</span> : Object<div class="sub-desc"><p>The item to add.</p>
141 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>The item added.</p>
142 </li></ul></div></div></div><div id="method-addAll" class="member inherited"><a href="Ext.util.MixedCollection.html#method-addAll" rel="method-addAll" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-addAll" class="viewSource">view source</a></div><a name="addAll"></a><a name="method-addAll"></a><a href="Ext.util.MixedCollection.html#" rel="method-addAll" class="cls expand">addAll</a>(
143 <span class="pre">Object/Array objs</span>)
144  : void</div><div class="description"><div class="short"><p>Adds all elements of an Array or an Object to the collection.</p>
145 </div><div class="long"><p>Adds all elements of an Array or an Object to the collection.</p>
146 <h3 class="pa">Parameters</h3><ul><li><span class="pre">objs</span> : Object/Array<div class="sub-desc"><p>An Object containing properties which will be added
147 to the collection, or an Array of values, each of which are added to the collection.
148 Functions references will be added to the collection if <code><a href="Ext.util.MixedCollection.html#allowFunctions" rel="Ext.util.MixedCollection#allowFunctions" class="docClass">allowFunctions</a></code>
149 has been set to <tt>true</tt>.</p>
150 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
151 </li></ul></div></div></div><div id="method-addEvents" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.html#" rel="method-addEvents" class="cls expand">addEvents</a>(
152 <span class="pre">Object/String o, String </span>)
153  : void</div><div class="description"><div class="short"><p>Adds the specified events to the list of events which this Observable may fire.</p>
154 </div><div class="long"><p>Adds the specified events to the list of events which this Observable may fire.</p>
155 <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>
156 or the first event name string if multiple event names are being passed as separate parameters.</p>
157 </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.
158 Usage:</p>
159
160 <pre><code>this.addEvents('storeloaded', 'storecleared');
161 </code></pre>
162
163 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
164 </li></ul></div></div></div><div id="method-addListener" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.html#" rel="method-addListener" class="cls expand">addListener</a>(
165 <span class="pre">String eventName, Function handler, [Object scope], [Object options]</span>)
166  : void</div><div class="description"><div class="short"><p>Appends an event handler to this object.</p>
167 </div><div class="long"><p>Appends an event handler to this object.</p>
168 <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>
169 </div></li><li><span class="pre">handler</span> : Function<div class="sub-desc"><p>The method the event invokes.</p>
170 </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.
171 <b>If omitted, defaults to the object which fired the event.</b></p>
172 </div></li><li><span class="pre">options</span> : Object<div class="sub-desc"><p>(optional) An object containing handler configuration.
173 properties. This may contain any of the following properties:<ul>
174 <li><b>scope</b> : Object<div class="sub-desc">The scope (<code><b>this</b></code> reference) in which the handler function is executed.
175 <b>If omitted, defaults to the object which fired the event.</b></div></li>
176 <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>
177 <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>
178 <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
179 by the specified number of milliseconds. If the event fires again within that time, the original
180 handler is <em>not</em> invoked, but the new handler is scheduled in its place.</div></li>
181 <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>
182 if the event was bubbled up from a child Observable.</div></li>
183 <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>
184 The name of a Component property which references an element to add a listener to.</p>
185
186 <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
187 will exist only after the Component is rendered. For example, to add a click listener to a Panel's body:
188 <pre><code>new Ext.panel.Panel({
189     title: 'The title',
190     listeners: {
191         click: this.handlePanelClick,
192         element: 'body'
193     }
194 });
195 </code></pre></p>
196
197
198 <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>
199
200
201 <p></div></li>
202 </ul><br></p>
203
204 <p>
205 <b>Combining Options</b><br>
206 Using the options argument, it is possible to combine different types of listeners:<br>
207 <br>
208 A delayed, one-time listener.
209 <pre><code>myPanel.on('hide', this.handleClick, this, {
210 single: true,
211 delay: 100
212 });</code></pre>
213 <p>
214 <b>Attaching multiple handlers in 1 call</b><br>
215 The method also allows for a single argument to be passed which is a config object containing properties
216 which specify multiple events. For example:
217 <pre><code>myGridPanel.on({
218     cellClick: this.onCellClick,
219     mouseover: this.onMouseOver,
220     mouseout: this.onMouseOut,
221     scope: this // Important. Ensure "this" is correct during handler execution
222 });
223 </code></pre>.
224 <p>
225
226 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
227 </li></ul></div></div></div><div id="method-addManagedListener" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.html#" rel="method-addManagedListener" class="cls expand">addManagedListener</a>(
228 <span class="pre">Observable/Element item, Object/String ename, Function fn, Object scope, Object opt</span>)
229  : void</div><div class="description"><div class="short"><p>Adds listeners to any Observable object (or Element) which are automatically removed when this Component
230 is destroyed.
231
232 </div><div class="long"><p>Adds listeners to any Observable object (or Element) which are automatically removed when this Component
233 is destroyed.
234
235 <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>
236 </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>
237 </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
238 is the handler function.</p>
239 </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
240 is the scope (<code>this</code> reference) in which the handler function is executed.</p>
241 </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
242 is the <a href="Ext.util.Observable.html#addListener" rel="Ext.util.Observable#addListener" class="docClass">addListener</a> options.</p>
243 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
244 </li></ul></div></div></div><div id="method-capture" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.html#" rel="method-capture" class="cls expand">capture</a>(
245 <span class="pre">Observable o, Function fn, [Object scope]</span>)
246  : void</div><div class="description"><div class="short">Starts capture on the specified Observable. All events will be passed
247 to the supplied function with the event name + ...</div><div class="long"><p>Starts capture on the specified Observable. All events will be passed
248 to the supplied function with the event name + standard signature of the event
249 <b>before</b> the event is fired. If the supplied function returns false,
250 the event will not fire.</p>
251 <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>
252 </div></li><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>The function to call when an event is fired.</p>
253 </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>
254 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
255 </li></ul></div></div></div><div id="method-clear" class="member inherited"><a href="Ext.util.MixedCollection.html#method-clear" rel="method-clear" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-clear" class="viewSource">view source</a></div><a name="clear"></a><a name="method-clear"></a><a href="Ext.util.MixedCollection.html#" rel="method-clear" class="cls expand">clear</a> : void</div><div class="description"><div class="short"><p>Removes all items from the collection.  Fires the <a href="Ext.util.MixedCollection.html#clear" rel="Ext.util.MixedCollection#clear" class="docClass">clear</a> event when complete.</p>
256 </div><div class="long"><p>Removes all items from the collection.  Fires the <a href="Ext.util.MixedCollection.html#clear" rel="Ext.util.MixedCollection#clear" class="docClass">clear</a> event when complete.</p>
257 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
258 </li></ul></div></div></div><div id="method-clearListeners" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.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>
259 </div><div class="long"><p>Removes all listeners for this object including the managed listeners</p>
260 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
261 </li></ul></div></div></div><div id="method-clearManagedListeners" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.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>
262 </div><div class="long"><p>Removes all managed listeners for this object.</p>
263 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
264 </li></ul></div></div></div><div id="method-clone" class="member inherited"><a href="Ext.util.MixedCollection.html#method-clone" rel="method-clone" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-clone" class="viewSource">view source</a></div><a name="clone"></a><a name="method-clone"></a><a href="Ext.util.MixedCollection.html#" rel="method-clone" class="cls expand">clone</a> : MixedCollection</div><div class="description"><div class="short"><p>Creates a shallow copy of this collection</p>
265 </div><div class="long"><p>Creates a shallow copy of this collection</p>
266 <h3 class="pa">Returns</h3><ul><li><span class="pre">MixedCollection</span>&nbsp; &nbsp;
267 </li></ul></div></div></div><div id="method-collect" class="member inherited"><a href="Ext.util.MixedCollection.html#method-collect" rel="method-collect" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-collect" class="viewSource">view source</a></div><a name="collect"></a><a name="method-collect"></a><a href="Ext.util.MixedCollection.html#" rel="method-collect" class="cls expand">collect</a>(
268 <span class="pre">String property, String root, [Boolean allowBlank]</span>)
269  : Array</div><div class="description"><div class="short"><p>Collects unique values of a particular property in this MixedCollection</p>
270 </div><div class="long"><p>Collects unique values of a particular property in this MixedCollection</p>
271 <h3 class="pa">Parameters</h3><ul><li><span class="pre">property</span> : String<div class="sub-desc"><p>The property to collect on</p>
272 </div></li><li><span class="pre">root</span> : String<div class="sub-desc"><p>Optional 'root' property to extract the first argument from. This is used mainly when
273 summing fields in records, where the fields are all stored inside the 'data' object</p>
274 </div></li><li><span class="pre">allowBlank</span> : Boolean<div class="sub-desc"><p>(optional) Pass true to allow null, undefined or empty string values</p>
275 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Array</span>&nbsp; &nbsp;<p>The unique values</p>
276 </li></ul></div></div></div><div id="method-contains" class="member inherited"><a href="Ext.util.MixedCollection.html#method-contains" rel="method-contains" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-contains" class="viewSource">view source</a></div><a name="contains"></a><a name="method-contains"></a><a href="Ext.util.MixedCollection.html#" rel="method-contains" class="cls expand">contains</a>(
277 <span class="pre">Object o</span>)
278  : Boolean</div><div class="description"><div class="short"><p>Returns true if the collection contains the passed Object as an item.</p>
279 </div><div class="long"><p>Returns true if the collection contains the passed Object as an item.</p>
280 <h3 class="pa">Parameters</h3><ul><li><span class="pre">o</span> : Object<div class="sub-desc"><p>The Object to look for in the collection.</p>
281 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if the collection contains the Object as an item.</p>
282 </li></ul></div></div></div><div id="method-containsKey" class="member inherited"><a href="Ext.util.MixedCollection.html#method-containsKey" rel="method-containsKey" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-containsKey" class="viewSource">view source</a></div><a name="containsKey"></a><a name="method-containsKey"></a><a href="Ext.util.MixedCollection.html#" rel="method-containsKey" class="cls expand">containsKey</a>(
283 <span class="pre">String key</span>)
284  : Boolean</div><div class="description"><div class="short"><p>Returns true if the collection contains the passed Object as a key.</p>
285 </div><div class="long"><p>Returns true if the collection contains the passed Object as a key.</p>
286 <h3 class="pa">Parameters</h3><ul><li><span class="pre">key</span> : String<div class="sub-desc"><p>The key to look for in the collection.</p>
287 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if the collection contains the Object as a key.</p>
288 </li></ul></div></div></div><div id="method-each" class="member inherited"><a href="Ext.util.MixedCollection.html#method-each" rel="method-each" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-each" class="viewSource">view source</a></div><a name="each"></a><a name="method-each"></a><a href="Ext.util.MixedCollection.html#" rel="method-each" class="cls expand">each</a>(
289 <span class="pre">Function fn, [Object scope]</span>)
290  : void</div><div class="description"><div class="short">Executes the specified function once for every item in the collection, passing the following arguments:
291
292
293 item : Mixe...</div><div class="long"><p>Executes the specified function once for every item in the collection, passing the following arguments:</p>
294
295 <div class="mdetail-params"><ul>
296 <li><b>item</b> : Mixed<p class="sub-desc">The collection item</p></li>
297 <li><b>index</b> : Number<p class="sub-desc">The item's index</p></li>
298 <li><b>length</b> : Number<p class="sub-desc">The total number of items in the collection</p></li>
299 </ul></div>
300
301
302 <p>The function should return a boolean value. Returning false from the function will stop the iteration.</p>
303 <h3 class="pa">Parameters</h3><ul><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>The function to execute for each item.</p>
304 </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 current item in the iteration.</p>
305 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
306 </li></ul></div></div></div><div id="method-eachKey" class="member inherited"><a href="Ext.util.MixedCollection.html#method-eachKey" rel="method-eachKey" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-eachKey" class="viewSource">view source</a></div><a name="eachKey"></a><a name="method-eachKey"></a><a href="Ext.util.MixedCollection.html#" rel="method-eachKey" class="cls expand">eachKey</a>(
307 <span class="pre">Function fn, [Object scope]</span>)
308  : void</div><div class="description"><div class="short">Executes the specified function once for every key in the collection, passing each
309 key, and its associated item as th...</div><div class="long"><p>Executes the specified function once for every key in the collection, passing each
310 key, and its associated item as the first two parameters.</p>
311 <h3 class="pa">Parameters</h3><ul><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>The function to execute for each item.</p>
312 </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 browser window.</p>
313 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
314 </li></ul></div></div></div><div id="method-enableBubble" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.html#" rel="method-enableBubble" class="cls expand">enableBubble</a>(
315 <span class="pre">String/Array events</span>)
316  : void</div><div class="description"><div class="short">Enables events fired by this Observable to bubble up an owner hierarchy by calling
317 this.getBubbleTarget() if present....</div><div class="long"><p>Enables events fired by this Observable to bubble up an owner hierarchy by calling
318 <code>this.getBubbleTarget()</code> if present. There is no implementation in the Observable base class.</p>
319
320
321 <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
322 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
323 access the required target more quickly.</p>
324
325
326 <p>Example:</p>
327
328
329 <pre><code>Ext.override(Ext.form.field.Base, {
330 //  Add functionality to Field&#39;s initComponent to enable the change event to bubble
331 initComponent : Ext.Function.createSequence(Ext.form.field.Base.prototype.initComponent, function() {
332     this.enableBubble('change');
333 }),
334
335 //  We know that we want Field&#39;s events to bubble directly to the FormPanel.
336 getBubbleTarget : function() {
337     if (!this.formPanel) {
338         this.formPanel = this.findParentByType('form');
339     }
340     return this.formPanel;
341 }
342 });
343
344 var myForm = new Ext.formPanel({
345 title: 'User Details',
346 items: [{
347     ...
348 }],
349 listeners: {
350     change: function() {
351         // Title goes red if form has been modified.
352         myForm.header.setStyle('color', 'red');
353     }
354 }
355 });
356 </code></pre>
357
358 <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>
359 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
360 </li></ul></div></div></div><div id="method-filter" class="member inherited"><a href="Ext.util.MixedCollection.html#method-filter" rel="method-filter" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-filter" class="viewSource">view source</a></div><a name="filter"></a><a name="method-filter"></a><a href="Ext.util.MixedCollection.html#" rel="method-filter" class="cls expand">filter</a>(
361 <span class="pre">Array/String property, String/RegExp value, [Boolean anyMatch], [Boolean caseSensitive]</span>)
362  : MixedCollection</div><div class="description"><div class="short">Filters the objects in this collection by a set of Filters, or by a single
363 property/value pair with optional paramete...</div><div class="long"><p>Filters the objects in this collection by a set of <a href="Ext.util.Filter.html" rel="Ext.util.Filter" class="docClass">Filter</a>s, or by a single
364 property/value pair with optional parameters for substring matching and case sensitivity. See
365 <a href="Ext.util.Filter.html" rel="Ext.util.Filter" class="docClass">Filter</a> for an example of using Filter objects (preferred). Alternatively,
366 MixedCollection can be easily filtered by property like this:</p>
367
368
369 <pre><code>//create a simple store with a few people defined
370 var people = new Ext.util.MixedCollection();
371 people.addAll([
372     {id: 1, age: 25, name: 'Ed'},
373     {id: 2, age: 24, name: 'Tommy'},
374     {id: 3, age: 24, name: 'Arne'},
375     {id: 4, age: 26, name: 'Aaron'}
376 ]);
377
378 //a new MixedCollection containing only the items where age == 24
379 var middleAged = people.filter('age', 24);
380 </code></pre>
381
382 <h3 class="pa">Parameters</h3><ul><li><span class="pre">property</span> : Array/String<div class="sub-desc"><p>A property on your objects, or an array of <a href="Ext.util.Filter.html" rel="Ext.util.Filter" class="docClass">Filter</a> objects</p>
383 </div></li><li><span class="pre">value</span> : String/RegExp<div class="sub-desc"><p>Either string that the property values
384 should start with or a RegExp to test against the property</p>
385 </div></li><li><span class="pre">anyMatch</span> : Boolean<div class="sub-desc"><p>(optional) True to match any part of the string, not just the beginning</p>
386 </div></li><li><span class="pre">caseSensitive</span> : Boolean<div class="sub-desc"><p>(optional) True for case sensitive comparison (defaults to False).</p>
387 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">MixedCollection</span>&nbsp; &nbsp;<p>The new filtered collection</p>
388 </li></ul></div></div></div><div id="method-filterBy" class="member inherited"><a href="Ext.util.MixedCollection.html#method-filterBy" rel="method-filterBy" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-filterBy" class="viewSource">view source</a></div><a name="filterBy"></a><a name="method-filterBy"></a><a href="Ext.util.MixedCollection.html#" rel="method-filterBy" class="cls expand">filterBy</a>(
389 <span class="pre">Function fn, [Object scope]</span>)
390  : MixedCollection</div><div class="description"><div class="short">Filter by a function. Returns a new collection that has been filtered.
391 The passed function will be called with each o...</div><div class="long"><p>Filter by a function. Returns a <i>new</i> collection that has been filtered.
392 The passed function will be called with each object in the collection.
393 If the function returns true, the value is included otherwise it is filtered.</p>
394 <h3 class="pa">Parameters</h3><ul><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>The function to be called, it will receive the args o (the object), k (the key)</p>
395 </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 this MixedCollection.</p>
396 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">MixedCollection</span>&nbsp; &nbsp;<p>The new filtered collection</p>
397 </li></ul></div></div></div><div id="method-findBy" class="member inherited"><a href="Ext.util.MixedCollection.html#method-findBy" rel="method-findBy" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-findBy" class="viewSource">view source</a></div><a name="findBy"></a><a name="method-findBy"></a><a href="Ext.util.MixedCollection.html#" rel="method-findBy" class="cls expand">findBy</a>(
398 <span class="pre">Function fn, [Object scope]</span>)
399  : Object</div><div class="description"><div class="short"><p>Returns the first item in the collection which elicits a true return value from the
400 passed selection function.</p>
401 </div><div class="long"><p>Returns the first item in the collection which elicits a true return value from the
402 passed selection function.</p>
403 <h3 class="pa">Parameters</h3><ul><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>The selection function to execute for each item.</p>
404 </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 browser window.</p>
405 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>The first item in the collection which returned true from the selection function.</p>
406 </li></ul></div></div></div><div id="method-findIndex" class="member inherited"><a href="Ext.util.MixedCollection.html#method-findIndex" rel="method-findIndex" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-findIndex" class="viewSource">view source</a></div><a name="findIndex"></a><a name="method-findIndex"></a><a href="Ext.util.MixedCollection.html#" rel="method-findIndex" class="cls expand">findIndex</a>(
407 <span class="pre">String property, String/RegExp value, [Number start], [Boolean anyMatch], [Boolean caseSensitive]</span>)
408  : Number</div><div class="description"><div class="short"><p>Finds the index of the first matching object in this collection by a specific property/value.</p>
409 </div><div class="long"><p>Finds the index of the first matching object in this collection by a specific property/value.</p>
410 <h3 class="pa">Parameters</h3><ul><li><span class="pre">property</span> : String<div class="sub-desc"><p>The name of a property on your objects.</p>
411 </div></li><li><span class="pre">value</span> : String/RegExp<div class="sub-desc"><p>A string that the property values
412 should start with or a RegExp to test against the property.</p>
413 </div></li><li><span class="pre">start</span> : Number<div class="sub-desc"><p>(optional) The index to start searching at (defaults to 0).</p>
414 </div></li><li><span class="pre">anyMatch</span> : Boolean<div class="sub-desc"><p>(optional) True to match any part of the string, not just the beginning.</p>
415 </div></li><li><span class="pre">caseSensitive</span> : Boolean<div class="sub-desc"><p>(optional) True for case sensitive comparison.</p>
416 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Number</span>&nbsp; &nbsp;<p>The matched index or -1</p>
417 </li></ul></div></div></div><div id="method-findIndexBy" class="member inherited"><a href="Ext.util.MixedCollection.html#method-findIndexBy" rel="method-findIndexBy" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-findIndexBy" class="viewSource">view source</a></div><a name="findIndexBy"></a><a name="method-findIndexBy"></a><a href="Ext.util.MixedCollection.html#" rel="method-findIndexBy" class="cls expand">findIndexBy</a>(
418 <span class="pre">Function fn, [Object scope], [Number start]</span>)
419  : Number</div><div class="description"><div class="short">Find the index of the first matching object in this collection by a function.
420 If the function returns true it is cons...</div><div class="long"><p>Find the index of the first matching object in this collection by a function.
421 If the function returns <i>true</i> it is considered a match.</p>
422 <h3 class="pa">Parameters</h3><ul><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>The function to be called, it will receive the args o (the object), k (the key).</p>
423 </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 this MixedCollection.</p>
424 </div></li><li><span class="pre">start</span> : Number<div class="sub-desc"><p>(optional) The index to start searching at (defaults to 0).</p>
425 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Number</span>&nbsp; &nbsp;<p>The matched index or -1</p>
426 </li></ul></div></div></div><div id="method-fireEvent" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.html#" rel="method-fireEvent" class="cls expand">fireEvent</a>(
427 <span class="pre">String eventName, Object... args</span>)
428  : Boolean</div><div class="description"><div class="short">Fires the specified event with the passed parameters (minus the event name).
429
430
431 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>
432
433
434 <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>)
435 by calling <a href="Ext.util.MixedCollection.html#enableBubble" rel="Ext.util.MixedCollection#enableBubble" class="docClass">enableBubble</a>.</p>
436
437 <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>
438 </div></li><li><span class="pre">args</span> : Object...<div class="sub-desc"><p>Variable number of parameters are passed to handlers.</p>
439 </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>
440 </li></ul></div></div></div><div id="method-first" class="member inherited"><a href="Ext.util.MixedCollection.html#method-first" rel="method-first" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-first" class="viewSource">view source</a></div><a name="first"></a><a name="method-first"></a><a href="Ext.util.MixedCollection.html#" rel="method-first" class="cls expand">first</a> : Object</div><div class="description"><div class="short"><p>Returns the first item in the collection.</p>
441 </div><div class="long"><p>Returns the first item in the collection.</p>
442 <h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>the first item in the collection..</p>
443 </li></ul></div></div></div><div id="method-get" class="member inherited"><a href="Ext.util.MixedCollection.html#method-get" rel="method-get" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-get" class="viewSource">view source</a></div><a name="get"></a><a name="method-get"></a><a href="Ext.util.MixedCollection.html#" rel="method-get" class="cls expand">get</a>(
444 <span class="pre">String/Number key</span>)
445  : Object</div><div class="description"><div class="short">Returns the item associated with the passed key OR index.
446 Key has priority over index.  This is the equivalent
447 of cal...</div><div class="long"><p>Returns the item associated with the passed key OR index.
448 Key has priority over index.  This is the equivalent
449 of calling <a href="Ext.util.MixedCollection.html#key" rel="Ext.util.MixedCollection#key" class="docClass">key</a> first, then if nothing matched calling <a href="Ext.util.MixedCollection.html#getAt" rel="Ext.util.MixedCollection#getAt" class="docClass">getAt</a>.</p>
450 <h3 class="pa">Parameters</h3><ul><li><span class="pre">key</span> : String/Number<div class="sub-desc"><p>The key or index of the item.</p>
451 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>If the item is found, returns the item.  If the item was not found, returns <tt>undefined</tt>.
452 If an item was found, but is a Class, returns <tt>null</tt>.</p>
453 </li></ul></div></div></div><div id="method-getAt" class="member inherited"><a href="Ext.util.MixedCollection.html#method-getAt" rel="method-getAt" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-getAt" class="viewSource">view source</a></div><a name="getAt"></a><a name="method-getAt"></a><a href="Ext.util.MixedCollection.html#" rel="method-getAt" class="cls expand">getAt</a>(
454 <span class="pre">Number index</span>)
455  : Object</div><div class="description"><div class="short"><p>Returns the item at the specified index.</p>
456 </div><div class="long"><p>Returns the item at the specified index.</p>
457 <h3 class="pa">Parameters</h3><ul><li><span class="pre">index</span> : Number<div class="sub-desc"><p>The index of the item.</p>
458 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>The item at the specified index.</p>
459 </li></ul></div></div></div><div id="method-getByKey" class="member inherited"><a href="Ext.util.MixedCollection.html#method-getByKey" rel="method-getByKey" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-getByKey" class="viewSource">view source</a></div><a name="getByKey"></a><a name="method-getByKey"></a><a href="Ext.util.MixedCollection.html#" rel="method-getByKey" class="cls expand">getByKey</a>(
460 <span class="pre">String/Number key</span>)
461  : Object</div><div class="description"><div class="short"><p>Returns the item associated with the passed key.</p>
462 </div><div class="long"><p>Returns the item associated with the passed key.</p>
463 <h3 class="pa">Parameters</h3><ul><li><span class="pre">key</span> : String/Number<div class="sub-desc"><p>The key of the item.</p>
464 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>The item associated with the passed key.</p>
465 </li></ul></div></div></div><div id="method-getCount" class="member inherited"><a href="Ext.util.MixedCollection.html#method-getCount" rel="method-getCount" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-getCount" class="viewSource">view source</a></div><a name="getCount"></a><a name="method-getCount"></a><a href="Ext.util.MixedCollection.html#" rel="method-getCount" class="cls expand">getCount</a> : Number</div><div class="description"><div class="short"><p>Returns the number of items in the collection.</p>
466 </div><div class="long"><p>Returns the number of items in the collection.</p>
467 <h3 class="pa">Returns</h3><ul><li><span class="pre">Number</span>&nbsp; &nbsp;<p>the number of items in the collection.</p>
468 </li></ul></div></div></div><div id="method-getKey" class="member inherited"><a href="Ext.util.MixedCollection.html#method-getKey" rel="method-getKey" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-getKey" class="viewSource">view source</a></div><a name="getKey"></a><a name="method-getKey"></a><a href="Ext.util.MixedCollection.html#" rel="method-getKey" class="cls expand">getKey</a>(
469 <span class="pre">Object item</span>)
470  : Object</div><div class="description"><div class="short">MixedCollection has a generic way to fetch keys if you implement getKey.  The default implementation
471 simply returns i...</div><div class="long"><p>MixedCollection has a generic way to fetch keys if you implement getKey.  The default implementation
472 simply returns <b><code>item.id</code></b> but you can provide your own implementation
473 to return a different value as in the following examples:</p>
474
475 <pre><code>// normal way
476 var mc = new Ext.util.MixedCollection();
477 mc.add(someEl.dom.id, someEl);
478 mc.add(otherEl.dom.id, otherEl);
479 //and so on
480
481 // using getKey
482 var mc = new Ext.util.MixedCollection();
483 mc.getKey = function(el){
484    return el.dom.id;
485 };
486 mc.add(someEl);
487 mc.add(otherEl);
488
489 // or via the constructor
490 var mc = new Ext.util.MixedCollection(false, function(el){
491    return el.dom.id;
492 });
493 mc.add(someEl);
494 mc.add(otherEl);
495 </code></pre>
496
497 <h3 class="pa">Parameters</h3><ul><li><span class="pre">item</span> : Object<div class="sub-desc"><p>The item for which to find the key.</p>
498 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>The key for the passed item.</p>
499 </li></ul></div></div></div><div id="method-getRange" class="member inherited"><a href="Ext.util.MixedCollection.html#method-getRange" rel="method-getRange" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-getRange" class="viewSource">view source</a></div><a name="getRange"></a><a name="method-getRange"></a><a href="Ext.util.MixedCollection.html#" rel="method-getRange" class="cls expand">getRange</a>(
500 <span class="pre">[Number startIndex], [Number endIndex]</span>)
501  : Array</div><div class="description"><div class="short"><p>Returns a range of items in this collection</p>
502 </div><div class="long"><p>Returns a range of items in this collection</p>
503 <h3 class="pa">Parameters</h3><ul><li><span class="pre">startIndex</span> : Number<div class="sub-desc"><p>(optional) The starting index. Defaults to 0.</p>
504 </div></li><li><span class="pre">endIndex</span> : Number<div class="sub-desc"><p>(optional) The ending index. Defaults to the last item.</p>
505 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Array</span>&nbsp; &nbsp;<p>An array of items</p>
506 </li></ul></div></div></div><div id="method-getSortState" class="member inherited"><a href="Ext.util.MixedCollection.html#method-getSortState" rel="method-getSortState" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Sortable.html" class="definedIn docClass">Ext.util.Sortable</a><br/><a href="../source/Sortable.html#Ext-util.Sortable-method-getSortState" class="viewSource">view source</a></div><a name="getSortState"></a><a name="method-getSortState"></a><a href="Ext.util.MixedCollection.html#" rel="method-getSortState" class="cls expand">getSortState</a> : Object</div><div class="description"><div class="short"><p>Returns an object describing the current sort state of this Store.</p>
507 </div><div class="long"><p>Returns an object describing the current sort state of this Store.</p>
508 <h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>The sort state of the Store. An object with two properties:<ul>
509 <li><b>field</b> : String<p class="sub-desc">The name of the field by which the Records are sorted.</p></li>
510 <li><b>direction</b> : String<p class="sub-desc">The sort order, 'ASC' or 'DESC' (case-sensitive).</p></li>
511 </ul>
512 See <tt><a href="Ext.util.MixedCollection.html#sortInfo" rel="Ext.util.MixedCollection#sortInfo" class="docClass">sortInfo</a></tt> for additional details.</p>
513 </li></ul></div></div></div><div id="method-hasListener" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.html#" rel="method-hasListener" class="cls expand">hasListener</a>(
514 <span class="pre">String eventName</span>)
515  : Boolean</div><div class="description"><div class="short"><p>Checks to see if this object has any listeners for a specified event</p>
516 </div><div class="long"><p>Checks to see if this object has any listeners for a specified event</p>
517 <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>
518 </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>
519 </li></ul></div></div></div><div id="method-indexOf" class="member inherited"><a href="Ext.util.MixedCollection.html#method-indexOf" rel="method-indexOf" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-indexOf" class="viewSource">view source</a></div><a name="indexOf"></a><a name="method-indexOf"></a><a href="Ext.util.MixedCollection.html#" rel="method-indexOf" class="cls expand">indexOf</a>(
520 <span class="pre">Object o</span>)
521  : Number</div><div class="description"><div class="short"><p>Returns index within the collection of the passed Object.</p>
522 </div><div class="long"><p>Returns index within the collection of the passed Object.</p>
523 <h3 class="pa">Parameters</h3><ul><li><span class="pre">o</span> : Object<div class="sub-desc"><p>The item to find the index of.</p>
524 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Number</span>&nbsp; &nbsp;<p>index of the item. Returns -1 if not found.</p>
525 </li></ul></div></div></div><div id="method-indexOfKey" class="member inherited"><a href="Ext.util.MixedCollection.html#method-indexOfKey" rel="method-indexOfKey" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-indexOfKey" class="viewSource">view source</a></div><a name="indexOfKey"></a><a name="method-indexOfKey"></a><a href="Ext.util.MixedCollection.html#" rel="method-indexOfKey" class="cls expand">indexOfKey</a>(
526 <span class="pre">String key</span>)
527  : Number</div><div class="description"><div class="short"><p>Returns index within the collection of the passed key.</p>
528 </div><div class="long"><p>Returns index within the collection of the passed key.</p>
529 <h3 class="pa">Parameters</h3><ul><li><span class="pre">key</span> : String<div class="sub-desc"><p>The key to find the index of.</p>
530 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Number</span>&nbsp; &nbsp;<p>index of the key.</p>
531 </li></ul></div></div></div><div id="method-initSortable" class="member inherited"><a href="Ext.util.MixedCollection.html#method-initSortable" rel="method-initSortable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Sortable.html" class="definedIn docClass">Ext.util.Sortable</a><br/><a href="../source/Sortable.html#Ext-util.Sortable-method-initSortable" class="viewSource">view source</a></div><a name="initSortable"></a><a name="method-initSortable"></a><a href="Ext.util.MixedCollection.html#" rel="method-initSortable" class="cls expand">initSortable</a> : void</div><div class="description"><div class="short">Performs initialization of this mixin. Component classes using this mixin should call this method
532 during their own in...</div><div class="long"><p>Performs initialization of this mixin. Component classes using this mixin should call this method
533 during their own initialization.</p>
534 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
535 </li></ul></div></div></div><div id="method-insert" class="member inherited"><a href="Ext.util.MixedCollection.html#method-insert" rel="method-insert" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-insert" class="viewSource">view source</a></div><a name="insert"></a><a name="method-insert"></a><a href="Ext.util.MixedCollection.html#" rel="method-insert" class="cls expand">insert</a>(
536 <span class="pre">Number index, String key, [Object o]</span>)
537  : Object</div><div class="description"><div class="short"><p>Inserts an item at the specified index in the collection. Fires the <a href="Ext.util.MixedCollection.html#add" rel="Ext.util.MixedCollection#add" class="docClass">add</a> event when complete.</p>
538 </div><div class="long"><p>Inserts an item at the specified index in the collection. Fires the <a href="Ext.util.MixedCollection.html#add" rel="Ext.util.MixedCollection#add" class="docClass">add</a> event when complete.</p>
539 <h3 class="pa">Parameters</h3><ul><li><span class="pre">index</span> : Number<div class="sub-desc"><p>The index to insert the item at.</p>
540 </div></li><li><span class="pre">key</span> : String<div class="sub-desc"><p>The key to associate with the new item, or the item itself.</p>
541 </div></li><li><span class="pre">o</span> : Object<div class="sub-desc"><p>(optional) If the second parameter was a key, the new item.</p>
542 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>The item inserted.</p>
543 </li></ul></div></div></div><div id="method-last" class="member inherited"><a href="Ext.util.MixedCollection.html#method-last" rel="method-last" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-last" class="viewSource">view source</a></div><a name="last"></a><a name="method-last"></a><a href="Ext.util.MixedCollection.html#" rel="method-last" class="cls expand">last</a> : Object</div><div class="description"><div class="short"><p>Returns the last item in the collection.</p>
544 </div><div class="long"><p>Returns the last item in the collection.</p>
545 <h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>the last item in the collection..</p>
546 </li></ul></div></div></div><div id="method-observe" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.html#" rel="method-observe" class="cls expand">observe</a>(
547 <span class="pre">Function c, Object listeners</span>)
548  : void</div><div class="description"><div class="short">Sets observability on the passed class constructor.
549
550 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>
551
552 <p>This makes any event fired on any instance of the passed class also fire a single event through
553 the <strong>class</strong> allowing for central handling of events on many instances at once.</p>
554
555 <p>Usage:</p>
556
557 <pre><code>Ext.util.Observable.observe(Ext.data.Connection);
558 Ext.data.Connection.on('beforerequest', function(con, options) {
559     console.log('Ajax request made to ' + options.url);
560 });
561 </code></pre>
562 <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>
563 </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.util.MixedCollection.html#addListener" rel="Ext.util.MixedCollection#addListener" class="docClass">addListener</a>.</p>
564 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
565 </li></ul></div></div></div><div id="method-on" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.html#" rel="method-on" class="cls expand">on</a>(
566 <span class="pre">String eventName, Function handler, [Object scope], [Object options]</span>)
567  : void</div><div class="description"><div class="short"><p>Appends an event handler to this object (shorthand for <a href="Ext.util.MixedCollection.html#addListener" rel="Ext.util.MixedCollection#addListener" class="docClass">addListener</a>.)</p>
568 </div><div class="long"><p>Appends an event handler to this object (shorthand for <a href="Ext.util.MixedCollection.html#addListener" rel="Ext.util.MixedCollection#addListener" class="docClass">addListener</a>.)</p>
569 <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>
570 </div></li><li><span class="pre">handler</span> : Function<div class="sub-desc"><p>The method the event invokes</p>
571 </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.
572 <b>If omitted, defaults to the object which fired the event.</b></p>
573 </div></li><li><span class="pre">options</span> : Object<div class="sub-desc"><p>(optional) An object containing handler configuration.</p>
574 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
575 </li></ul></div></div></div><div id="method-relayEvents" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.html#" rel="method-relayEvents" class="cls expand">relayEvents</a>(
576 <span class="pre">Object origin, Array events, Object prefix</span>)
577  : 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>
578 </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>
579 <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>
580 </div></li><li><span class="pre">events</span> : Array<div class="sub-desc"><p>Array of event names to relay.</p>
581 </div></li><li><span class="pre">prefix</span> : Object<div class="sub-desc">
582 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
583 </li></ul></div></div></div><div id="method-releaseCapture" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.html#" rel="method-releaseCapture" class="cls expand">releaseCapture</a>(
584 <span class="pre">Observable o</span>)
585  : void</div><div class="description"><div class="short"><p>Removes <b>all</b> added captures from the Observable.</p>
586 </div><div class="long"><p>Removes <b>all</b> added captures from the Observable.</p>
587 <h3 class="pa">Parameters</h3><ul><li><span class="pre">o</span> : Observable<div class="sub-desc"><p>The Observable to release</p>
588 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
589 </li></ul></div></div></div><div id="method-remove" class="member inherited"><a href="Ext.util.MixedCollection.html#method-remove" rel="method-remove" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-remove" class="viewSource">view source</a></div><a name="remove"></a><a name="method-remove"></a><a href="Ext.util.MixedCollection.html#" rel="method-remove" class="cls expand">remove</a>(
590 <span class="pre">Object o</span>)
591  : Object</div><div class="description"><div class="short"><p>Remove an item from the collection.</p>
592 </div><div class="long"><p>Remove an item from the collection.</p>
593 <h3 class="pa">Parameters</h3><ul><li><span class="pre">o</span> : Object<div class="sub-desc"><p>The item to remove.</p>
594 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>The item removed or false if no item was removed.</p>
595 </li></ul></div></div></div><div id="method-removeAll" class="member inherited"><a href="Ext.util.MixedCollection.html#method-removeAll" rel="method-removeAll" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-removeAll" class="viewSource">view source</a></div><a name="removeAll"></a><a name="method-removeAll"></a><a href="Ext.util.MixedCollection.html#" rel="method-removeAll" class="cls expand">removeAll</a>(
596 <span class="pre">Array items</span>)
597  : Ext.util.MixedCollection</div><div class="description"><div class="short"><p>Remove all items in the passed array from the collection.</p>
598 </div><div class="long"><p>Remove all items in the passed array from the collection.</p>
599 <h3 class="pa">Parameters</h3><ul><li><span class="pre">items</span> : Array<div class="sub-desc"><p>An array of items to be removed.</p>
600 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.util.MixedCollection</span>&nbsp; &nbsp;<p>this object</p>
601 </li></ul></div></div></div><div id="method-removeAt" class="member inherited"><a href="Ext.util.MixedCollection.html#method-removeAt" rel="method-removeAt" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-removeAt" class="viewSource">view source</a></div><a name="removeAt"></a><a name="method-removeAt"></a><a href="Ext.util.MixedCollection.html#" rel="method-removeAt" class="cls expand">removeAt</a>(
602 <span class="pre">Number index</span>)
603  : Object</div><div class="description"><div class="short"><p>Remove an item from a specified index in the collection. Fires the <a href="Ext.util.MixedCollection.html#remove" rel="Ext.util.MixedCollection#remove" class="docClass">remove</a> event when complete.</p>
604 </div><div class="long"><p>Remove an item from a specified index in the collection. Fires the <a href="Ext.util.MixedCollection.html#remove" rel="Ext.util.MixedCollection#remove" class="docClass">remove</a> event when complete.</p>
605 <h3 class="pa">Parameters</h3><ul><li><span class="pre">index</span> : Number<div class="sub-desc"><p>The index within the collection of the item to remove.</p>
606 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>The item removed or false if no item was removed.</p>
607 </li></ul></div></div></div><div id="method-removeAtKey" class="member inherited"><a href="Ext.util.MixedCollection.html#method-removeAtKey" rel="method-removeAtKey" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-removeAtKey" class="viewSource">view source</a></div><a name="removeAtKey"></a><a name="method-removeAtKey"></a><a href="Ext.util.MixedCollection.html#" rel="method-removeAtKey" class="cls expand">removeAtKey</a>(
608 <span class="pre">String key</span>)
609  : Object</div><div class="description"><div class="short"><p>Removed an item associated with the passed key fom the collection.</p>
610 </div><div class="long"><p>Removed an item associated with the passed key fom the collection.</p>
611 <h3 class="pa">Parameters</h3><ul><li><span class="pre">key</span> : String<div class="sub-desc"><p>The key of the item to remove.</p>
612 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>The item removed or false if no item was removed.</p>
613 </li></ul></div></div></div><div id="method-removeListener" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.html#" rel="method-removeListener" class="cls expand">removeListener</a>(
614 <span class="pre">String eventName, Function handler, [Object scope]</span>)
615  : void</div><div class="description"><div class="short"><p>Removes an event handler.</p>
616 </div><div class="long"><p>Removes an event handler.</p>
617 <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>
618 </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.util.MixedCollection.html#addListener" rel="Ext.util.MixedCollection#addListener" class="docClass">addListener</a> call.</b></p>
619 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope originally specified for the handler.</p>
620 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
621 </li></ul></div></div></div><div id="method-removeManagedListener" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.html#" rel="method-removeManagedListener" class="cls expand">removeManagedListener</a>(
622 <span class="pre">Observable|Element item, Object|String ename, Function fn, Object scope</span>)
623  : void</div><div class="description"><div class="short"><p>Removes listeners that were added by the <a href="Ext.util.MixedCollection.html#mon" rel="Ext.util.MixedCollection#mon" class="docClass">mon</a> method.</p>
624 </div><div class="long"><p>Removes listeners that were added by the <a href="Ext.util.MixedCollection.html#mon" rel="Ext.util.MixedCollection#mon" class="docClass">mon</a> method.</p>
625 <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>
626 </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>
627 </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
628 is the handler function.</p>
629 </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
630 is the scope (<code>this</code> reference) in which the handler function is executed.</p>
631 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
632 </li></ul></div></div></div><div id="method-reorder" class="member ni"><a href="Ext.util.MixedCollection.html#method-reorder" rel="method-reorder" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.MixedCollection.html" class="definedIn docClass">Ext.util.MixedCollection</a><br/><a href="../source/MixedCollection.html#Ext-util.MixedCollection-method-reorder" class="viewSource">view source</a></div><a name="reorder"></a><a name="method-reorder"></a><a href="Ext.util.MixedCollection.html#" rel="method-reorder" class="cls expand">reorder</a>(
633 <span class="pre">Object mapping</span>)
634  : void</div><div class="description"><div class="short">Reorders each of the items based on a mapping from old index to new index. Internally this
635 just translates into a sor...</div><div class="long"><p>Reorders each of the items based on a mapping from old index to new index. Internally this
636 just translates into a sort. The 'sort' event is fired whenever reordering has occured.</p>
637 <h3 class="pa">Parameters</h3><ul><li><span class="pre">mapping</span> : Object<div class="sub-desc"><p>Mapping from old item index to new item index</p>
638 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
639 </li></ul></div></div></div><div id="method-replace" class="member inherited"><a href="Ext.util.MixedCollection.html#method-replace" rel="method-replace" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-replace" class="viewSource">view source</a></div><a name="replace"></a><a name="method-replace"></a><a href="Ext.util.MixedCollection.html#" rel="method-replace" class="cls expand">replace</a>(
640 <span class="pre">String key, [Object o]</span>)
641  : Object</div><div class="description"><div class="short"><p>Replaces an item in the collection. Fires the <a href="Ext.util.MixedCollection.html#replace" rel="Ext.util.MixedCollection#replace" class="docClass">replace</a> event when complete.</p>
642 </div><div class="long"><p>Replaces an item in the collection. Fires the <a href="Ext.util.MixedCollection.html#replace" rel="Ext.util.MixedCollection#replace" class="docClass">replace</a> event when complete.</p>
643 <h3 class="pa">Parameters</h3><ul><li><span class="pre">key</span> : String<div class="sub-desc"><p>The key associated with the item to replace, or the replacement item.</p>
644
645
646 <p>If you supplied a <a href="Ext.util.MixedCollection.html#getKey" rel="Ext.util.MixedCollection#getKey" class="docClass">getKey</a> implementation for this MixedCollection, or if the key
647 of your stored items is in a property called <tt><b>id</b></tt>, then the MixedCollection
648 will be able to <i>derive</i> the key of the replacement item. If you want to replace an item
649 with one having the same key value, then just pass the replacement item in this parameter.</p>
650
651 </div></li><li><span class="pre">o</span> : Object<div class="sub-desc"><p>{Object} o (optional) If the first parameter passed was a key, the item to associate
652 with that key.</p>
653 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>The new item.</p>
654 </li></ul></div></div></div><div id="method-resumeEvents" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.html#" rel="method-resumeEvents" class="cls expand">resumeEvents</a> : void</div><div class="description"><div class="short">Resume firing events. (see suspendEvents)
655 If events were suspended using the queueSuspended parameter, then all
656 event...</div><div class="long"><p>Resume firing events. (see <a href="Ext.util.MixedCollection.html#suspendEvents" rel="Ext.util.MixedCollection#suspendEvents" class="docClass">suspendEvents</a>)
657 If events were suspended using the <code><b>queueSuspended</b></code> parameter, then all
658 events fired during event suspension will be sent to any listeners now.</p>
659 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
660 </li></ul></div></div></div><div id="method-sort" class="member inherited"><a href="Ext.util.MixedCollection.html#method-sort" rel="method-sort" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Sortable.html" class="definedIn docClass">Ext.util.Sortable</a><br/><a href="../source/Sortable.html#Ext-util.Sortable-method-sort" class="viewSource">view source</a></div><a name="sort"></a><a name="method-sort"></a><a href="Ext.util.MixedCollection.html#" rel="method-sort" class="cls expand">sort</a>(
661 <span class="pre">String|Array sorters, String direction, Object where, Object doSort</span>)
662  : void</div><div class="description"><div class="short">Sorts the data in the Store by one or more of its properties. Example usage:
663
664
665 //sort by a single field
666 myStore.sort(...</div><div class="long"><p>Sorts the data in the Store by one or more of its properties. Example usage:</p>
667
668
669 <pre><code>//sort by a single field
670 myStore.sort('myField', 'DESC');
671
672 //sorting by multiple fields
673 myStore.sort([
674     {
675         property : 'age',
676         direction: 'ASC'
677     },
678     {
679         property : 'name',
680         direction: 'DESC'
681     }
682 ]);
683 </code></pre>
684
685
686 <p>Internally, Store converts the passed arguments into an array of <a href="Ext.util.Sorter.html" rel="Ext.util.Sorter" class="docClass">Ext.util.Sorter</a> instances, and delegates the actual
687 sorting to its internal <a href="Ext.util.MixedCollection.html" rel="Ext.util.MixedCollection" class="docClass">Ext.util.MixedCollection</a>.</p>
688
689
690 <p>When passing a single string argument to sort, Store maintains a ASC/DESC toggler per field, so this code:</p>
691
692
693 <pre><code>store.sort('myField');
694 store.sort('myField');
695      </code></pre>
696
697
698 <p>Is equivalent to this code, because Store handles the toggling automatically:</p>
699
700
701 <pre><code>store.sort('myField', 'ASC');
702 store.sort('myField', 'DESC');
703 </code></pre>
704
705 <h3 class="pa">Parameters</h3><ul><li><span class="pre">sorters</span> : String|Array<div class="sub-desc"><p>Either a string name of one of the fields in this Store's configured <a href="Ext.data.Model.html" rel="Ext.data.Model" class="docClass">Model</a>,
706 or an Array of sorter configurations.</p>
707 </div></li><li><span class="pre">direction</span> : String<div class="sub-desc"><p>The overall direction to sort the data by. Defaults to "ASC".</p>
708 </div></li><li><span class="pre">where</span> : Object<div class="sub-desc">
709 </div></li><li><span class="pre">doSort</span> : Object<div class="sub-desc">
710 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
711 </li></ul></div></div></div><div id="method-sortBy" class="member ni"><a href="Ext.util.MixedCollection.html#method-sortBy" rel="method-sortBy" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.MixedCollection.html" class="definedIn docClass">Ext.util.MixedCollection</a><br/><a href="../source/MixedCollection.html#Ext-util.MixedCollection-method-sortBy" class="viewSource">view source</a></div><a name="sortBy"></a><a name="method-sortBy"></a><a href="Ext.util.MixedCollection.html#" rel="method-sortBy" class="cls expand">sortBy</a>(
712 <span class="pre">Function sorterFn</span>)
713  : void</div><div class="description"><div class="short"><p>Sorts the collection by a single sorter function</p>
714 </div><div class="long"><p>Sorts the collection by a single sorter function</p>
715 <h3 class="pa">Parameters</h3><ul><li><span class="pre">sorterFn</span> : Function<div class="sub-desc"><p>The function to sort by</p>
716 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
717 </li></ul></div></div></div><div id="method-sortByKey" class="member ni"><a href="Ext.util.MixedCollection.html#method-sortByKey" rel="method-sortByKey" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.MixedCollection.html" class="definedIn docClass">Ext.util.MixedCollection</a><br/><a href="../source/MixedCollection.html#Ext-util.MixedCollection-method-sortByKey" class="viewSource">view source</a></div><a name="sortByKey"></a><a name="method-sortByKey"></a><a href="Ext.util.MixedCollection.html#" rel="method-sortByKey" class="cls expand">sortByKey</a>(
718 <span class="pre">[String direction], [Function fn]</span>)
719  : void</div><div class="description"><div class="short"><p>Sorts this collection by <b>key</b>s.</p>
720 </div><div class="long"><p>Sorts this collection by <b>key</b>s.</p>
721 <h3 class="pa">Parameters</h3><ul><li><span class="pre">direction</span> : String<div class="sub-desc"><p>(optional) 'ASC' or 'DESC'. Defaults to 'ASC'.</p>
722 </div></li><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>(optional) Comparison function that defines the sort order.
723 Defaults to sorting by case insensitive string.</p>
724 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
725 </li></ul></div></div></div><div id="method-sum" class="member inherited"><a href="Ext.util.MixedCollection.html#method-sum" rel="method-sum" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-method-sum" class="viewSource">view source</a></div><a name="sum"></a><a name="method-sum"></a><a href="Ext.util.MixedCollection.html#" rel="method-sum" class="cls expand">sum</a>(
726 <span class="pre">String property, String root, [Number start], [Number end]</span>)
727  : Number</div><div class="description"><div class="short"><p>Collects all of the values of the given property and returns their sum</p>
728 </div><div class="long"><p>Collects all of the values of the given property and returns their sum</p>
729 <h3 class="pa">Parameters</h3><ul><li><span class="pre">property</span> : String<div class="sub-desc"><p>The property to sum by</p>
730 </div></li><li><span class="pre">root</span> : String<div class="sub-desc"><p>Optional 'root' property to extract the first argument from. This is used mainly when
731 summing fields in records, where the fields are all stored inside the 'data' object</p>
732 </div></li><li><span class="pre">start</span> : Number<div class="sub-desc"><p>(optional) The record index to start at (defaults to <tt>0</tt>)</p>
733 </div></li><li><span class="pre">end</span> : Number<div class="sub-desc"><p>(optional) The record index to end at (defaults to <tt>-1</tt>)</p>
734 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Number</span>&nbsp; &nbsp;<p>The total</p>
735 </li></ul></div></div></div><div id="method-suspendEvents" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.html#" rel="method-suspendEvents" class="cls expand">suspendEvents</a>(
736 <span class="pre">Boolean queueSuspended</span>)
737  : void</div><div class="description"><div class="short"><p>Suspend the firing of all events. (see <a href="Ext.util.MixedCollection.html#resumeEvents" rel="Ext.util.MixedCollection#resumeEvents" class="docClass">resumeEvents</a>)</p>
738 </div><div class="long"><p>Suspend the firing of all events. (see <a href="Ext.util.MixedCollection.html#resumeEvents" rel="Ext.util.MixedCollection#resumeEvents" class="docClass">resumeEvents</a>)</p>
739 <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
740 after the <a href="Ext.util.MixedCollection.html#resumeEvents" rel="Ext.util.MixedCollection#resumeEvents" class="docClass">resumeEvents</a> call instead of discarding all suspended events;</p>
741 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
742 </li></ul></div></div></div><div id="method-un" class="member inherited"><a href="Ext.util.MixedCollection.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.util.MixedCollection.html#" rel="method-un" class="cls expand">un</a>(
743 <span class="pre">String eventName, Function handler, [Object scope]</span>)
744  : void</div><div class="description"><div class="short"><p>Removes an event handler (shorthand for <a href="Ext.util.MixedCollection.html#removeListener" rel="Ext.util.MixedCollection#removeListener" class="docClass">removeListener</a>.)</p>
745 </div><div class="long"><p>Removes an event handler (shorthand for <a href="Ext.util.MixedCollection.html#removeListener" rel="Ext.util.MixedCollection#removeListener" class="docClass">removeListener</a>.)</p>
746 <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>
747 </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.util.MixedCollection.html#addListener" rel="Ext.util.MixedCollection#addListener" class="docClass">addListener</a> call.</b></p>
748 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope originally specified for the handler.</p>
749 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
750 </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-add" class="member f inherited"><a href="Ext.util.MixedCollection.html#event-add" rel="event-add" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-event-add" class="viewSource">view source</a></div><a name="add"></a><a name="event-add"></a><a href="Ext.util.MixedCollection.html#" rel="event-add" class="cls expand">add</a>(
751 <span class="pre">Number index, Object o, String key</span>)
752 </div><div class="description"><div class="short"><p>Fires when an item is added to the collection.</p>
753 </div><div class="long"><p>Fires when an item is added to the collection.</p>
754 <h3 class="pa">Parameters</h3><ul><li><span class="pre">index</span> : Number<div class="sub-desc"><p>The index at which the item was added.</p>
755 </div></li><li><span class="pre">o</span> : Object<div class="sub-desc"><p>The item added.</p>
756 </div></li><li><span class="pre">key</span> : String<div class="sub-desc"><p>The key associated with the added item.</p>
757 </div></li></ul></div></div></div><div id="event-clear" class="member inherited"><a href="Ext.util.MixedCollection.html#event-clear" rel="event-clear" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-event-clear" class="viewSource">view source</a></div><a name="clear"></a><a name="event-clear"></a><a href="Ext.util.MixedCollection.html#" rel="event-clear" class="cls expand">clear</a></div><div class="description"><div class="short"><p>Fires when the collection is cleared.</p>
758 </div><div class="long"><p>Fires when the collection is cleared.</p>
759 </div></div></div><div id="event-remove" class="member inherited"><a href="Ext.util.MixedCollection.html#event-remove" rel="event-remove" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-event-remove" class="viewSource">view source</a></div><a name="remove"></a><a name="event-remove"></a><a href="Ext.util.MixedCollection.html#" rel="event-remove" class="cls expand">remove</a>(
760 <span class="pre">Object o, [String key]</span>)
761 </div><div class="description"><div class="short"><p>Fires when an item is removed from the collection.</p>
762 </div><div class="long"><p>Fires when an item is removed from the collection.</p>
763 <h3 class="pa">Parameters</h3><ul><li><span class="pre">o</span> : Object<div class="sub-desc"><p>The item being removed.</p>
764 </div></li><li><span class="pre">key</span> : String<div class="sub-desc"><p>(optional) The key associated with the removed item.</p>
765 </div></li></ul></div></div></div><div id="event-replace" class="member inherited"><a href="Ext.util.MixedCollection.html#event-replace" rel="event-replace" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.AbstractMixedCollection.html" class="definedIn docClass">Ext.util.AbstractMixedCollection</a><br/><a href="../source/AbstractMixedCollection.html#Ext-util.AbstractMixedCollection-event-replace" class="viewSource">view source</a></div><a name="replace"></a><a name="event-replace"></a><a href="Ext.util.MixedCollection.html#" rel="event-replace" class="cls expand">replace</a>(
766 <span class="pre">String key, Object old, Object new</span>)
767 </div><div class="description"><div class="short"><p>Fires when an item is replaced in the collection.</p>
768 </div><div class="long"><p>Fires when an item is replaced in the collection.</p>
769 <h3 class="pa">Parameters</h3><ul><li><span class="pre">key</span> : String<div class="sub-desc"><p>he key associated with the new added.</p>
770 </div></li><li><span class="pre">old</span> : Object<div class="sub-desc"><p>The item being replaced.</p>
771 </div></li><li><span class="pre">new</span> : Object<div class="sub-desc"><p>The new item.</p>
772 </div></li></ul></div></div></div></div></div></div></div><div id="pageContent"></div></div></div></div></body></html>