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