a3ae05bb5bea169ab2257c4181086e411ad58a9a.svn-base 86 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392
  1. <div class="body-wrap">
  2. <div class="top-tools">
  3. <a class="inner-link" href="#Ext.data.GroupingStore-props"><img src="../resources/images/default/s.gif" class="item-icon icon-prop">Properties</a>
  4. <a class="inner-link" href="#Ext.data.GroupingStore-methods"><img src="../resources/images/default/s.gif" class="item-icon icon-method">Methods</a>
  5. <a class="inner-link" href="#Ext.data.GroupingStore-events"><img src="../resources/images/default/s.gif" class="item-icon icon-event">Events</a>
  6. <a class="inner-link" href="#Ext.data.GroupingStore-configs"><img src="../resources/images/default/s.gif" class="item-icon icon-config">Config Options</a>
  7. <a class="bookmark" href="../docs/?class=Ext.data.GroupingStore"><img src="../resources/images/default/s.gif" class="item-icon icon-fav">Direct Link</a>
  8. </div>
  9. <div class="inheritance res-block">
  10. <pre class="res-block-inner"><a ext:cls="Ext.util.Observable" ext:member="" href="output/Ext.util.Observable.html">Observable</a>
  11. <img src="resources/elbow-end.gif"/><a ext:cls="Ext.data.Store" ext:member="" href="output/Ext.data.Store.html">Store</a>
  12. <img src="resources/elbow-end.gif"/>GroupingStore</pre></div>
  13. <h1>Class Ext.data.GroupingStore</h1>
  14. <table cellspacing="0">
  15. <tr><td class="label">Package:</td><td class="hd-info">Ext.data</td></tr>
  16. <tr><td class="label">Defined In:</td><td class="hd-info"><a href="../src/GroupingStore.js" target="_blank">GroupingStore.js</a></td></tr>
  17. <tr><td class="label">Class:</td><td class="hd-info">GroupingStore</td></tr>
  18. <tr><td class="label">Extends:</td><td class="hd-info"><a ext:cls="Ext.data.Store" ext:member="" href="output/Ext.data.Store.html">Store</a></td></tr>
  19. </table>
  20. <div class="description">
  21. A specialized store implementation that provides for grouping records by one of the available fields. </div>
  22. <div class="hr"></div>
  23. <a id="Ext.data.GroupingStore-configs"></a>
  24. <h2>Config Options</h2>
  25. <table cellspacing="0" class="member-table">
  26. <tr>
  27. <th class="sig-header" colspan="2">Config Options</th>
  28. <th class="msource-header">Defined By</th>
  29. </tr>
  30. <tr class="config-row inherited">
  31. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  32. <td class="sig">
  33. <a id="Ext.data.GroupingStore-autoLoad"></a>
  34. <b>autoLoad</b> : Boolean/Object <div class="mdesc">
  35. If passed, this store's load method is automatically called after creation with the autoLoad object </div>
  36. </td>
  37. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#autoLoad" href="output/Ext.data.Store.html#autoLoad">Store</a></td>
  38. </tr>
  39. <tr class="config-row inherited alt">
  40. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  41. <td class="sig">
  42. <a id="Ext.data.GroupingStore-baseParams"></a>
  43. <b>baseParams</b> : Object <div class="mdesc">
  44. An object containing properties which are to be sent as parameters on any HTTP request </div>
  45. </td>
  46. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#baseParams" href="output/Ext.data.Store.html#baseParams">Store</a></td>
  47. </tr>
  48. <tr class="config-row inherited">
  49. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  50. <td class="sig">
  51. <a id="Ext.data.GroupingStore-data"></a>
  52. <b>data</b> : Array <div class="mdesc">
  53. Inline data to be loaded when the store is initialized. </div>
  54. </td>
  55. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#data" href="output/Ext.data.Store.html#data">Store</a></td>
  56. </tr>
  57. <tr class="config-row alt">
  58. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  59. <td class="sig">
  60. <a id="Ext.data.GroupingStore-groupField"></a>
  61. <b>groupField</b> : String <div class="mdesc">
  62. The field name by which to sort the store's data (defaults to ''). </div>
  63. </td>
  64. <td class="msource">GroupingStore</td>
  65. </tr>
  66. <tr class="config-row expandable">
  67. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  68. <td class="sig">
  69. <a id="Ext.data.GroupingStore-groupOnSort"></a>
  70. <b>groupOnSort</b> : Boolean <div class="mdesc">
  71. <div class="short">True to sort the data on the grouping field when a grouping operation occurs, false to sort based on the existing sor...</div>
  72. <div class="long">
  73. True to sort the data on the grouping field when a grouping operation occurs, false to sort based on the existing sort info (defaults to false). </div>
  74. </div>
  75. </td>
  76. <td class="msource">GroupingStore</td>
  77. </tr>
  78. <tr class="config-row inherited alt expandable">
  79. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  80. <td class="sig">
  81. <a id="Ext.data.GroupingStore-listeners"></a>
  82. <b>listeners</b> : Object <div class="mdesc">
  83. <div class="short">A config object containing one or more event handlers to be added to this object during initialization. This should b...</div>
  84. <div class="long">
  85. A config object containing one or more event handlers to be added to this object during initialization. This should be a valid listeners config object as specified in the <a ext:cls="Ext.util.Observable" ext:member="addListener" href="output/Ext.util.Observable.html#addListener">addListener</a> example for attaching multiple handlers at once. </div>
  86. </div>
  87. </td>
  88. <td class="msource"><a ext:cls="Ext.util.Observable" ext:member="#listeners" href="output/Ext.util.Observable.html#listeners">Observable</a></td>
  89. </tr>
  90. <tr class="config-row inherited">
  91. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  92. <td class="sig">
  93. <a id="Ext.data.GroupingStore-proxy"></a>
  94. <b>proxy</b> : Ext.data.DataProxy <div class="mdesc">
  95. The Proxy object which provides access to a data object. </div>
  96. </td>
  97. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#proxy" href="output/Ext.data.Store.html#proxy">Store</a></td>
  98. </tr>
  99. <tr class="config-row inherited alt expandable">
  100. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  101. <td class="sig">
  102. <a id="Ext.data.GroupingStore-pruneModifiedRecords"></a>
  103. <b>pruneModifiedRecords</b> : boolean <div class="mdesc">
  104. <div class="short">True to clear all modified record information each time the store is loaded or when a record is removed. (defaults to...</div>
  105. <div class="long">
  106. True to clear all modified record information each time the store is loaded or when a record is removed. (defaults to false). </div>
  107. </div>
  108. </td>
  109. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#pruneModifiedRecords" href="output/Ext.data.Store.html#pruneModifiedRecords">Store</a></td>
  110. </tr>
  111. <tr class="config-row inherited expandable">
  112. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  113. <td class="sig">
  114. <a id="Ext.data.GroupingStore-reader"></a>
  115. <b>reader</b> : Ext.data.Reader <div class="mdesc">
  116. <div class="short">The Reader object which processes the data object and returns an Array of Ext.data.record objects which are cached ke...</div>
  117. <div class="long">
  118. The Reader object which processes the data object and returns an Array of Ext.data.record objects which are cached keyed by their <em>id</em> property. </div>
  119. </div>
  120. </td>
  121. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#reader" href="output/Ext.data.Store.html#reader">Store</a></td>
  122. </tr>
  123. <tr class="config-row alt expandable">
  124. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  125. <td class="sig">
  126. <a id="Ext.data.GroupingStore-remoteGroup"></a>
  127. <b>remoteGroup</b> : Boolean <div class="mdesc">
  128. <div class="short">True if the grouping should apply on the server side, false if it is local only (defaults to false). If the grouping ...</div>
  129. <div class="long">
  130. True if the grouping should apply on the server side, false if it is local only (defaults to false). If the grouping is local, it can be applied immediately to the data. If it is remote, then it will simply act as a helper, automatically sending the grouping field name as the 'groupBy' param with each XHR call. </div>
  131. </div>
  132. </td>
  133. <td class="msource">GroupingStore</td>
  134. </tr>
  135. <tr class="config-row inherited expandable">
  136. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  137. <td class="sig">
  138. <a id="Ext.data.GroupingStore-remoteSort"></a>
  139. <b>remoteSort</b> : boolean <div class="mdesc">
  140. <div class="short">True if sorting is to be handled by requesting the Proxy to provide a refreshed version of the data object in sorted ...</div>
  141. <div class="long">
  142. True if sorting is to be handled by requesting the Proxy to provide a refreshed version of the data object in sorted order, as opposed to sorting the Record cache in place (defaults to false). <p>If remote sorting is specified, then clicking on a column header causes the current page to be requested from the server with the addition of the following two parameters: <div class="mdetail-params"><ul> <li><b>sort</b> : String<p class="sub-desc">The name (as specified in the Record's Field definition) of the field to sort on.</p></li> <li><b>dir</b> : String<p class="sub-desc">The direction of the sort, "ASC" or "DESC".</p></li> </ul></div></p> </div>
  143. </div>
  144. </td>
  145. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#remoteSort" href="output/Ext.data.Store.html#remoteSort">Store</a></td>
  146. </tr>
  147. <tr class="config-row inherited alt">
  148. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  149. <td class="sig">
  150. <a id="Ext.data.GroupingStore-sortInfo"></a>
  151. <b>sortInfo</b> : Object <div class="mdesc">
  152. A config object in the format: {field: "fieldName", direction: "ASC|DESC"} </div>
  153. </td>
  154. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#sortInfo" href="output/Ext.data.Store.html#sortInfo">Store</a></td>
  155. </tr>
  156. <tr class="config-row inherited">
  157. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  158. <td class="sig">
  159. <a id="Ext.data.GroupingStore-storeId"></a>
  160. <b>storeId</b> : String <div class="mdesc">
  161. If passed, the id to use to register with the StoreMgr </div>
  162. </td>
  163. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#storeId" href="output/Ext.data.Store.html#storeId">Store</a></td>
  164. </tr>
  165. <tr class="config-row inherited alt">
  166. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  167. <td class="sig">
  168. <a id="Ext.data.GroupingStore-url"></a>
  169. <b>url</b> : String <div class="mdesc">
  170. If passed, an HttpProxy is created for the passed URL </div>
  171. </td>
  172. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#url" href="output/Ext.data.Store.html#url">Store</a></td>
  173. </tr>
  174. </table>
  175. <a id="Ext.data.GroupingStore-props"></a>
  176. <h2>Public Properties</h2>
  177. <table cellspacing="0" class="member-table">
  178. <tr>
  179. <th class="sig-header" colspan="2">Property</th>
  180. <th class="msource-header">Defined By</th>
  181. </tr>
  182. <tr class="property-row inherited">
  183. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  184. <td class="sig">
  185. <a id="Ext.data.GroupingStore-baseParams"></a>
  186. <b>baseParams</b> : Object <div class="mdesc">
  187. An object containing properties which are used as parameters on any HTTP request. </div>
  188. </td>
  189. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#baseParams" href="output/Ext.data.Store.html#baseParams">Store</a></td>
  190. </tr>
  191. <tr class="property-row inherited alt expandable">
  192. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  193. <td class="sig">
  194. <a id="Ext.data.GroupingStore-lastOptions"></a>
  195. <b>lastOptions</b> : Object <div class="mdesc">
  196. <div class="short">Contains the last options object used as the parameter to the load method. See load
  197. for the details of what this may ...</div>
  198. <div class="long">
  199. Contains the last options object used as the parameter to the load method. See <a ext:cls="Ext.data.Store" ext:member="load" href="output/Ext.data.Store.html#load">load</a>
  200. for the details of what this may contain. This may be useful for accessing any params which
  201. were used to load the current Record cache. </div>
  202. </div>
  203. </td>
  204. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#lastOptions" href="output/Ext.data.Store.html#lastOptions">Store</a></td>
  205. </tr>
  206. </table>
  207. <a id="Ext.data.GroupingStore-methods"></a>
  208. <h2>Public Methods</h2>
  209. <table cellspacing="0" class="member-table">
  210. <tr>
  211. <th class="sig-header" colspan="2">Method</th>
  212. <th class="msource-header">Defined By</th>
  213. </tr>
  214. <tr class="method-row expandable">
  215. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  216. <td class="sig">
  217. <a id="Ext.data.GroupingStore-GroupingStore"></a>
  218. <b>GroupingStore</b>(&nbsp;<code>Object config</code>&nbsp;) <div class="mdesc">
  219. <div class="short">Creates a new GroupingStore.</div>
  220. <div class="long">
  221. Creates a new GroupingStore. <div class="mdetail-params">
  222. <strong>Parameters:</strong>
  223. <ul><li><code>config</code> : Object<div class="sub-desc">A config object containing the objects needed for the Store to access data,
  224. and read the data into Records.</div></li> </ul>
  225. <strong>Returns:</strong>
  226. <ul>
  227. <li><code></code></li>
  228. </ul>
  229. </div>
  230. </div>
  231. </div>
  232. </td>
  233. <td class="msource">GroupingStore</td>
  234. </tr>
  235. <tr class="method-row inherited alt expandable">
  236. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  237. <td class="sig">
  238. <a id="Ext.data.GroupingStore-add"></a>
  239. <b>add</b>(&nbsp;<code>Ext.data.Record[] records</code>&nbsp;) : void <div class="mdesc">
  240. <div class="short">Add Records to the Store and fires the add event.</div>
  241. <div class="long">
  242. Add Records to the Store and fires the add event. <div class="mdetail-params">
  243. <strong>Parameters:</strong>
  244. <ul><li><code>records</code> : Ext.data.Record[]<div class="sub-desc">An Array of Ext.data.Record objects to add to the cache.</div></li> </ul>
  245. <strong>Returns:</strong>
  246. <ul>
  247. <li><code>void</code></li>
  248. </ul>
  249. </div>
  250. </div>
  251. </div>
  252. </td>
  253. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#add" href="output/Ext.data.Store.html#add">Store</a></td>
  254. </tr>
  255. <tr class="method-row inherited expandable">
  256. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  257. <td class="sig">
  258. <a id="Ext.data.GroupingStore-addEvents"></a>
  259. <b>addEvents</b>(&nbsp;<code>Object object</code>&nbsp;) : void <div class="mdesc">
  260. <div class="short">Used to define events on this Observable</div>
  261. <div class="long">
  262. Used to define events on this Observable <div class="mdetail-params">
  263. <strong>Parameters:</strong>
  264. <ul><li><code>object</code> : Object<div class="sub-desc">The object with the events defined</div></li> </ul>
  265. <strong>Returns:</strong>
  266. <ul>
  267. <li><code>void</code></li>
  268. </ul>
  269. </div>
  270. </div>
  271. </div>
  272. </td>
  273. <td class="msource"><a ext:cls="Ext.util.Observable" ext:member="#addEvents" href="output/Ext.util.Observable.html#addEvents">Observable</a></td>
  274. </tr>
  275. <tr class="method-row inherited alt expandable">
  276. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  277. <td class="sig">
  278. <a id="Ext.data.GroupingStore-addListener"></a>
  279. <b>addListener</b>(&nbsp;<code>String eventName</code>, <code>Function handler</code>, <span class="optional" title="Optional">[<code>Object scope</code>]</span>, <span class="optional" title="Optional">[<code>Object options</code>]</span>&nbsp;) : void <div class="mdesc">
  280. <div class="short">Appends an event handler to this component</div>
  281. <div class="long">
  282. Appends an event handler to this component <div class="mdetail-params">
  283. <strong>Parameters:</strong>
  284. <ul><li><code>eventName</code> : String<div class="sub-desc">The type of event to listen for</div></li><li><code>handler</code> : Function<div class="sub-desc">The method the event invokes</div></li><li><code>scope</code> : Object<div class="sub-desc">(optional) The scope in which to execute the handler
  285. function. The handler function's "this" context.</div></li><li><code>options</code> : Object<div class="sub-desc">(optional) An object containing handler configuration
  286. properties. This may contain any of the following properties:<ul>
  287. <li><b>scope</b> : Object<p class="sub-desc">The scope in which to execute the handler function. The handler function's "this" context.</p></li>
  288. <li><b>delay</b> : Number<p class="sub-desc">The number of milliseconds to delay the invocation of the handler after the event fires.</p></li>
  289. <li><b>single</b> : Boolean<p class="sub-desc">True to add a handler to handle just the next firing of the event, and then remove itself.</p></li>
  290. <li>buffer {Number} Causes the handler to be scheduled to run in an <a ext:cls="Ext.util.DelayedTask" href="output/Ext.util.DelayedTask.html">Ext.util.DelayedTask</a> delayed
  291. by the specified number of milliseconds. If the event fires again within that time, the original
  292. handler is <em>not</em> invoked, but the new handler is scheduled in its place.</li>
  293. </ul><br>
  294. <p>
  295. <b>Combining Options</b><br>
  296. Using the options argument, it is possible to combine different types of listeners:<br>
  297. <br>
  298. A normalized, delayed, one-time listener that auto stops the event and passes a custom argument (forumId)
  299. <pre><code>el.on(<em>'click'</em>, <b>this</b>.onClick, <b>this</b>, {
  300. single: true,
  301. delay: 100,
  302. forumId: 4
  303. });</code></pre>
  304. <p>
  305. <b>Attaching multiple handlers in 1 call</b><br>
  306. The method also allows for a single argument to be passed which is a config object containing properties
  307. which specify multiple handlers.
  308. <p>
  309. <pre><code>foo.on({
  310. <em>'click'</em> : {
  311. fn: <b>this</b>.onClick,
  312. scope: <b>this</b>,
  313. delay: 100
  314. },
  315. <em>'mouseover'</em> : {
  316. fn: <b>this</b>.onMouseOver,
  317. scope: <b>this</b>
  318. },
  319. <em>'mouseout'</em> : {
  320. fn: <b>this</b>.onMouseOut,
  321. scope: <b>this</b>
  322. }
  323. });</code></pre>
  324. <p>
  325. Or a shorthand syntax:<br>
  326. <pre><code>foo.on({
  327. <em>'click'</em> : <b>this</b>.onClick,
  328. <em>'mouseover'</em> : <b>this</b>.onMouseOver,
  329. <em>'mouseout'</em> : <b>this</b>.onMouseOut,
  330. scope: <b>this</b>
  331. });</code></pre></div></li> </ul>
  332. <strong>Returns:</strong>
  333. <ul>
  334. <li><code>void</code></li>
  335. </ul>
  336. </div>
  337. </div>
  338. </div>
  339. </td>
  340. <td class="msource"><a ext:cls="Ext.util.Observable" ext:member="#addListener" href="output/Ext.util.Observable.html#addListener">Observable</a></td>
  341. </tr>
  342. <tr class="method-row inherited expandable">
  343. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  344. <td class="sig">
  345. <a id="Ext.data.GroupingStore-addSorted"></a>
  346. <b>addSorted</b>(&nbsp;<code>Ext.data.Record record</code>&nbsp;) : void <div class="mdesc">
  347. <div class="short">(Local sort only) Inserts the passed the record in the Store at the index where it
  348. should go based on the current sor...</div>
  349. <div class="long">
  350. (Local sort only) Inserts the passed the record in the Store at the index where it
  351. should go based on the current sort information <div class="mdetail-params">
  352. <strong>Parameters:</strong>
  353. <ul><li><code>record</code> : Ext.data.Record<div class="sub-desc"></div></li> </ul>
  354. <strong>Returns:</strong>
  355. <ul>
  356. <li><code>void</code></li>
  357. </ul>
  358. </div>
  359. </div>
  360. </div>
  361. </td>
  362. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#addSorted" href="output/Ext.data.Store.html#addSorted">Store</a></td>
  363. </tr>
  364. <tr class="method-row inherited alt expandable">
  365. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  366. <td class="sig">
  367. <a id="Ext.data.GroupingStore-clearFilter"></a>
  368. <b>clearFilter</b>(&nbsp;<code>Boolean suppressEvent</code>&nbsp;) : void <div class="mdesc">
  369. <div class="short">Revert to a view of the Record cache with no filtering applied.</div>
  370. <div class="long">
  371. Revert to a view of the Record cache with no filtering applied. <div class="mdetail-params">
  372. <strong>Parameters:</strong>
  373. <ul><li><code>suppressEvent</code> : Boolean<div class="sub-desc">If true the filter is cleared silently without notifying listeners</div></li> </ul>
  374. <strong>Returns:</strong>
  375. <ul>
  376. <li><code>void</code></li>
  377. </ul>
  378. </div>
  379. </div>
  380. </div>
  381. </td>
  382. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#clearFilter" href="output/Ext.data.Store.html#clearFilter">Store</a></td>
  383. </tr>
  384. <tr class="method-row expandable">
  385. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  386. <td class="sig">
  387. <a id="Ext.data.GroupingStore-clearGrouping"></a>
  388. <b>clearGrouping</b>() : void <div class="mdesc">
  389. <div class="short">Clears any existing grouping and refreshes the data using the default sort.</div>
  390. <div class="long">
  391. Clears any existing grouping and refreshes the data using the default sort. <div class="mdetail-params">
  392. <strong>Parameters:</strong>
  393. <ul><li>None.</li> </ul>
  394. <strong>Returns:</strong>
  395. <ul>
  396. <li><code>void</code></li>
  397. </ul>
  398. </div>
  399. </div>
  400. </div>
  401. </td>
  402. <td class="msource">GroupingStore</td>
  403. </tr>
  404. <tr class="method-row inherited alt expandable">
  405. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  406. <td class="sig">
  407. <a id="Ext.data.GroupingStore-collect"></a>
  408. <b>collect</b>(&nbsp;<code>String dataIndex</code>, <span class="optional" title="Optional">[<code>Boolean allowNull</code>]</span>, <span class="optional" title="Optional">[<code>Boolean bypassFilter</code>]</span>&nbsp;) : Array <div class="mdesc">
  409. <div class="short">Collects unique values for a particular dataIndex from this store.</div>
  410. <div class="long">
  411. Collects unique values for a particular dataIndex from this store. <div class="mdetail-params">
  412. <strong>Parameters:</strong>
  413. <ul><li><code>dataIndex</code> : String<div class="sub-desc">The property to collect</div></li><li><code>allowNull</code> : Boolean<div class="sub-desc">(optional) Pass true to allow null, undefined or empty string values</div></li><li><code>bypassFilter</code> : Boolean<div class="sub-desc">(optional) Pass true to collect from all records, even ones which are filtered</div></li> </ul>
  414. <strong>Returns:</strong>
  415. <ul>
  416. <li><code>Array</code><div class="sub-desc">An array of the unique values</div></li>
  417. </ul>
  418. </div>
  419. </div>
  420. </div>
  421. </td>
  422. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#collect" href="output/Ext.data.Store.html#collect">Store</a></td>
  423. </tr>
  424. <tr class="method-row inherited expandable">
  425. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  426. <td class="sig">
  427. <a id="Ext.data.GroupingStore-commitChanges"></a>
  428. <b>commitChanges</b>() : void <div class="mdesc">
  429. <div class="short">Commit all Records with outstanding changes. To handle updates for changes, subscribe to the
  430. Store's "update" event, ...</div>
  431. <div class="long">
  432. Commit all Records with outstanding changes. To handle updates for changes, subscribe to the
  433. Store's "update" event, and perform updating when the third parameter is Ext.data.Record.COMMIT. <div class="mdetail-params">
  434. <strong>Parameters:</strong>
  435. <ul><li>None.</li> </ul>
  436. <strong>Returns:</strong>
  437. <ul>
  438. <li><code>void</code></li>
  439. </ul>
  440. </div>
  441. </div>
  442. </div>
  443. </td>
  444. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#commitChanges" href="output/Ext.data.Store.html#commitChanges">Store</a></td>
  445. </tr>
  446. <tr class="method-row inherited alt expandable">
  447. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  448. <td class="sig">
  449. <a id="Ext.data.GroupingStore-each"></a>
  450. <b>each</b>(&nbsp;<code>Function fn</code>, <span class="optional" title="Optional">[<code>Object scope</code>]</span>&nbsp;) : void <div class="mdesc">
  451. <div class="short">Calls the specified function for each of the Records in the cache.</div>
  452. <div class="long">
  453. Calls the specified function for each of the Records in the cache. <div class="mdetail-params">
  454. <strong>Parameters:</strong>
  455. <ul><li><code>fn</code> : Function<div class="sub-desc">The function to call. The Record is passed as the first parameter.
  456. Returning <tt>false</tt> aborts and exits the iteration.</div></li><li><code>scope</code> : Object<div class="sub-desc">(optional) The scope in which to call the function (defaults to the Record).</div></li> </ul>
  457. <strong>Returns:</strong>
  458. <ul>
  459. <li><code>void</code></li>
  460. </ul>
  461. </div>
  462. </div>
  463. </div>
  464. </td>
  465. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#each" href="output/Ext.data.Store.html#each">Store</a></td>
  466. </tr>
  467. <tr class="method-row inherited expandable">
  468. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  469. <td class="sig">
  470. <a id="Ext.data.GroupingStore-filter"></a>
  471. <b>filter</b>(&nbsp;<code>String field</code>, <code>String/RegExp value</code>, <span class="optional" title="Optional">[<code>Boolean anyMatch</code>]</span>, <span class="optional" title="Optional">[<code>Boolean caseSensitive</code>]</span>&nbsp;) : void <div class="mdesc">
  472. <div class="short">Filter the records by a specified property.</div>
  473. <div class="long">
  474. Filter the records by a specified property. <div class="mdetail-params">
  475. <strong>Parameters:</strong>
  476. <ul><li><code>field</code> : String<div class="sub-desc">A field on your records</div></li><li><code>value</code> : String/RegExp<div class="sub-desc">Either a string that the field
  477. should start with or a RegExp to test against the field</div></li><li><code>anyMatch</code> : Boolean<div class="sub-desc">(optional) True to match any part not just the beginning</div></li><li><code>caseSensitive</code> : Boolean<div class="sub-desc">(optional) True for case sensitive comparison</div></li> </ul>
  478. <strong>Returns:</strong>
  479. <ul>
  480. <li><code>void</code></li>
  481. </ul>
  482. </div>
  483. </div>
  484. </div>
  485. </td>
  486. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#filter" href="output/Ext.data.Store.html#filter">Store</a></td>
  487. </tr>
  488. <tr class="method-row inherited alt expandable">
  489. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  490. <td class="sig">
  491. <a id="Ext.data.GroupingStore-filterBy"></a>
  492. <b>filterBy</b>(&nbsp;<code>Function fn</code>, <span class="optional" title="Optional">[<code>Object scope</code>]</span>&nbsp;) : void <div class="mdesc">
  493. <div class="short">Filter by a function. The specified function will be called for each
  494. Record in this Store. If the function returns tr...</div>
  495. <div class="long">
  496. Filter by a function. The specified function will be called for each
  497. Record in this Store. If the function returns <tt>true</tt> the Record is included,
  498. otherwise it is filtered out. <div class="mdetail-params">
  499. <strong>Parameters:</strong>
  500. <ul><li><code>fn</code> : Function<div class="sub-desc">The function to be called. It will be passed the following parameters:<ul>
  501. <li><b>record</b> : Ext.data.Record<p class="sub-desc">The <a ext:cls="Ext.data.Record" href="output/Ext.data.Record.html">record</a>
  502. to test for filtering. Access field values using <a ext:cls="Ext.data.Record" ext:member="get" href="output/Ext.data.Record.html#get">Ext.data.Record.get</a>.</p></li>
  503. <li><b>id</b> : Object<p class="sub-desc">The ID of the Record passed.</p></li>
  504. </ul></div></li><li><code>scope</code> : Object<div class="sub-desc">(optional) The scope of the function (defaults to this)</div></li> </ul>
  505. <strong>Returns:</strong>
  506. <ul>
  507. <li><code>void</code></li>
  508. </ul>
  509. </div>
  510. </div>
  511. </div>
  512. </td>
  513. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#filterBy" href="output/Ext.data.Store.html#filterBy">Store</a></td>
  514. </tr>
  515. <tr class="method-row inherited expandable">
  516. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  517. <td class="sig">
  518. <a id="Ext.data.GroupingStore-find"></a>
  519. <b>find</b>(&nbsp;<code>String property</code>, <code>String/RegExp value</code>, <span class="optional" title="Optional">[<code>Number startIndex</code>]</span>, <span class="optional" title="Optional">[<code>Boolean anyMatch</code>]</span>, <span class="optional" title="Optional">[<code>Boolean caseSensitive</code>]</span>&nbsp;) : Number <div class="mdesc">
  520. <div class="short">Finds the index of the first matching record in this store by a specific property/value.</div>
  521. <div class="long">
  522. Finds the index of the first matching record in this store by a specific property/value. <div class="mdetail-params">
  523. <strong>Parameters:</strong>
  524. <ul><li><code>property</code> : String<div class="sub-desc">A property on your objects</div></li><li><code>value</code> : String/RegExp<div class="sub-desc">Either string that the property values
  525. should start with or a RegExp to test against the property.</div></li><li><code>startIndex</code> : Number<div class="sub-desc">(optional) The index to start searching at</div></li><li><code>anyMatch</code> : Boolean<div class="sub-desc">(optional) True to match any part of the string, not just the beginning</div></li><li><code>caseSensitive</code> : Boolean<div class="sub-desc">(optional) True for case sensitive comparison</div></li> </ul>
  526. <strong>Returns:</strong>
  527. <ul>
  528. <li><code>Number</code><div class="sub-desc">The matched index or -1</div></li>
  529. </ul>
  530. </div>
  531. </div>
  532. </div>
  533. </td>
  534. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#find" href="output/Ext.data.Store.html#find">Store</a></td>
  535. </tr>
  536. <tr class="method-row inherited alt expandable">
  537. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  538. <td class="sig">
  539. <a id="Ext.data.GroupingStore-findBy"></a>
  540. <b>findBy</b>(&nbsp;<code>Function fn</code>, <span class="optional" title="Optional">[<code>Object scope</code>]</span>, <span class="optional" title="Optional">[<code>Number startIndex</code>]</span>&nbsp;) : Number <div class="mdesc">
  541. <div class="short">Find the index of the first matching Record in this Store by a function.
  542. If the function returns true it is considere...</div>
  543. <div class="long">
  544. Find the index of the first matching Record in this Store by a function.
  545. If the function returns <tt>true</tt> it is considered a match. <div class="mdetail-params">
  546. <strong>Parameters:</strong>
  547. <ul><li><code>fn</code> : Function<div class="sub-desc">The function to be called. It will be passed the following parameters:<ul>
  548. <li><b>record</b> : Ext.data.Record<p class="sub-desc">The <a ext:cls="Ext.data.Record" href="output/Ext.data.Record.html">record</a>
  549. to test for filtering. Access field values using <a ext:cls="Ext.data.Record" ext:member="get" href="output/Ext.data.Record.html#get">Ext.data.Record.get</a>.</p></li>
  550. <li><b>id</b> : Object<p class="sub-desc">The ID of the Record passed.</p></li>
  551. </ul></div></li><li><code>scope</code> : Object<div class="sub-desc">(optional) The scope of the function (defaults to this)</div></li><li><code>startIndex</code> : Number<div class="sub-desc">(optional) The index to start searching at</div></li> </ul>
  552. <strong>Returns:</strong>
  553. <ul>
  554. <li><code>Number</code><div class="sub-desc">The matched index or -1</div></li>
  555. </ul>
  556. </div>
  557. </div>
  558. </div>
  559. </td>
  560. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#findBy" href="output/Ext.data.Store.html#findBy">Store</a></td>
  561. </tr>
  562. <tr class="method-row inherited expandable">
  563. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  564. <td class="sig">
  565. <a id="Ext.data.GroupingStore-fireEvent"></a>
  566. <b>fireEvent</b>(&nbsp;<code>String eventName</code>, <code>Object... args</code>&nbsp;) : Boolean <div class="mdesc">
  567. <div class="short">Fires the specified event with the passed parameters (minus the event name).</div>
  568. <div class="long">
  569. Fires the specified event with the passed parameters (minus the event name). <div class="mdetail-params">
  570. <strong>Parameters:</strong>
  571. <ul><li><code>eventName</code> : String<div class="sub-desc"></div></li><li><code>args</code> : Object...<div class="sub-desc">Variable number of parameters are passed to handlers</div></li> </ul>
  572. <strong>Returns:</strong>
  573. <ul>
  574. <li><code>Boolean</code><div class="sub-desc">returns false if any of the handlers return false otherwise it returns true</div></li>
  575. </ul>
  576. </div>
  577. </div>
  578. </div>
  579. </td>
  580. <td class="msource"><a ext:cls="Ext.util.Observable" ext:member="#fireEvent" href="output/Ext.util.Observable.html#fireEvent">Observable</a></td>
  581. </tr>
  582. <tr class="method-row inherited alt expandable">
  583. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  584. <td class="sig">
  585. <a id="Ext.data.GroupingStore-getAt"></a>
  586. <b>getAt</b>(&nbsp;<code>Number index</code>&nbsp;) : Ext.data.Record <div class="mdesc">
  587. <div class="short">Get the Record at the specified index.</div>
  588. <div class="long">
  589. Get the Record at the specified index. <div class="mdetail-params">
  590. <strong>Parameters:</strong>
  591. <ul><li><code>index</code> : Number<div class="sub-desc">The index of the Record to find.</div></li> </ul>
  592. <strong>Returns:</strong>
  593. <ul>
  594. <li><code>Ext.data.Record</code><div class="sub-desc">The Record at the passed index. Returns undefined if not found.</div></li>
  595. </ul>
  596. </div>
  597. </div>
  598. </div>
  599. </td>
  600. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#getAt" href="output/Ext.data.Store.html#getAt">Store</a></td>
  601. </tr>
  602. <tr class="method-row inherited expandable">
  603. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  604. <td class="sig">
  605. <a id="Ext.data.GroupingStore-getById"></a>
  606. <b>getById</b>(&nbsp;<code>String id</code>&nbsp;) : Ext.data.Record <div class="mdesc">
  607. <div class="short">Get the Record with the specified id.</div>
  608. <div class="long">
  609. Get the Record with the specified id. <div class="mdetail-params">
  610. <strong>Parameters:</strong>
  611. <ul><li><code>id</code> : String<div class="sub-desc">The id of the Record to find.</div></li> </ul>
  612. <strong>Returns:</strong>
  613. <ul>
  614. <li><code>Ext.data.Record</code><div class="sub-desc">The Record with the passed id. Returns undefined if not found.</div></li>
  615. </ul>
  616. </div>
  617. </div>
  618. </div>
  619. </td>
  620. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#getById" href="output/Ext.data.Store.html#getById">Store</a></td>
  621. </tr>
  622. <tr class="method-row inherited alt expandable">
  623. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  624. <td class="sig">
  625. <a id="Ext.data.GroupingStore-getCount"></a>
  626. <b>getCount</b>() : Number <div class="mdesc">
  627. <div class="short">Gets the number of cached records.
  628. If using paging, this may not be the total size of the dataset. If the data object...</div>
  629. <div class="long">
  630. Gets the number of cached records.
  631. <p>If using paging, this may not be the total size of the dataset. If the data object
  632. used by the Reader contains the dataset size, then the <a ext:cls="Ext.data.Store" ext:member="getTotalCount" href="output/Ext.data.Store.html#getTotalCount">getTotalCount</a> function returns
  633. the dataset size.</p> <div class="mdetail-params">
  634. <strong>Parameters:</strong>
  635. <ul><li>None.</li> </ul>
  636. <strong>Returns:</strong>
  637. <ul>
  638. <li><code>Number</code><div class="sub-desc">The number of Records in the Store's cache.</div></li>
  639. </ul>
  640. </div>
  641. </div>
  642. </div>
  643. </td>
  644. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#getCount" href="output/Ext.data.Store.html#getCount">Store</a></td>
  645. </tr>
  646. <tr class="method-row inherited expandable">
  647. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  648. <td class="sig">
  649. <a id="Ext.data.GroupingStore-getModifiedRecords"></a>
  650. <b>getModifiedRecords</b>() : Ext.data.Record[] <div class="mdesc">
  651. <div class="short">Gets all records modified since the last commit. Modified records are persisted across load operations
  652. (e.g., during...</div>
  653. <div class="long">
  654. Gets all records modified since the last commit. Modified records are persisted across load operations
  655. (e.g., during paging). <div class="mdetail-params">
  656. <strong>Parameters:</strong>
  657. <ul><li>None.</li> </ul>
  658. <strong>Returns:</strong>
  659. <ul>
  660. <li><code>Ext.data.Record[]</code><div class="sub-desc">An array of Records containing outstanding modifications.</div></li>
  661. </ul>
  662. </div>
  663. </div>
  664. </div>
  665. </td>
  666. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#getModifiedRecords" href="output/Ext.data.Store.html#getModifiedRecords">Store</a></td>
  667. </tr>
  668. <tr class="method-row inherited alt expandable">
  669. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  670. <td class="sig">
  671. <a id="Ext.data.GroupingStore-getRange"></a>
  672. <b>getRange</b>(&nbsp;<span class="optional" title="Optional">[<code>Number startIndex</code>]</span>, <span class="optional" title="Optional">[<code>Number endIndex</code>]</span>&nbsp;) : Ext.data.Record[] <div class="mdesc">
  673. <div class="short">Returns a range of Records between specified indices.</div>
  674. <div class="long">
  675. Returns a range of Records between specified indices. <div class="mdetail-params">
  676. <strong>Parameters:</strong>
  677. <ul><li><code>startIndex</code> : Number<div class="sub-desc">(optional) The starting index (defaults to 0)</div></li><li><code>endIndex</code> : Number<div class="sub-desc">(optional) The ending index (defaults to the last Record in the Store)</div></li> </ul>
  678. <strong>Returns:</strong>
  679. <ul>
  680. <li><code>Ext.data.Record[]</code><div class="sub-desc">An array of Records</div></li>
  681. </ul>
  682. </div>
  683. </div>
  684. </div>
  685. </td>
  686. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#getRange" href="output/Ext.data.Store.html#getRange">Store</a></td>
  687. </tr>
  688. <tr class="method-row inherited expandable">
  689. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  690. <td class="sig">
  691. <a id="Ext.data.GroupingStore-getSortState"></a>
  692. <b>getSortState</b>() : Object <div class="mdesc">
  693. <div class="short">Returns an object describing the current sort state of this Store.</div>
  694. <div class="long">
  695. Returns an object describing the current sort state of this Store. <div class="mdetail-params">
  696. <strong>Parameters:</strong>
  697. <ul><li>None.</li> </ul>
  698. <strong>Returns:</strong>
  699. <ul>
  700. <li><code>Object</code><div class="sub-desc">The sort state of the Store. An object with two properties:<ul> <li><b>field : String<p class="sub-desc">The name of the field by which the Records are sorted.</p></li> <li><b>direction : String<p class="sub-desc">The sort order, "ASC" or "DESC".</p></li> </ul></div></li>
  701. </ul>
  702. </div>
  703. </div>
  704. </div>
  705. </td>
  706. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#getSortState" href="output/Ext.data.Store.html#getSortState">Store</a></td>
  707. </tr>
  708. <tr class="method-row inherited alt expandable">
  709. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  710. <td class="sig">
  711. <a id="Ext.data.GroupingStore-getTotalCount"></a>
  712. <b>getTotalCount</b>() : Number <div class="mdesc">
  713. <div class="short">Gets the total number of records in the dataset as returned by the server.
  714. If using paging, for this to be accurate, ...</div>
  715. <div class="long">
  716. Gets the total number of records in the dataset as returned by the server.
  717. <p>If using paging, for this to be accurate, the data object used by the Reader must contain
  718. the dataset size. For remote data sources, this is provided by a query on the server.</p> <div class="mdetail-params">
  719. <strong>Parameters:</strong>
  720. <ul><li>None.</li> </ul>
  721. <strong>Returns:</strong>
  722. <ul>
  723. <li><code>Number</code><div class="sub-desc">The number of Records as specified in the data object passed to the Reader by the Proxy <p><b>This value is not updated when changing the contents of the Store locally.</b></p></div></li>
  724. </ul>
  725. </div>
  726. </div>
  727. </div>
  728. </td>
  729. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#getTotalCount" href="output/Ext.data.Store.html#getTotalCount">Store</a></td>
  730. </tr>
  731. <tr class="method-row expandable">
  732. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  733. <td class="sig">
  734. <a id="Ext.data.GroupingStore-groupBy"></a>
  735. <b>groupBy</b>(&nbsp;<code>String field</code>, <span class="optional" title="Optional">[<code>Boolean forceRegroup</code>]</span>&nbsp;) : void <div class="mdesc">
  736. <div class="short">Groups the data by the specified field.</div>
  737. <div class="long">
  738. Groups the data by the specified field. <div class="mdetail-params">
  739. <strong>Parameters:</strong>
  740. <ul><li><code>field</code> : String<div class="sub-desc">The field name by which to sort the store's data</div></li><li><code>forceRegroup</code> : Boolean<div class="sub-desc">(optional) True to force the group to be refreshed even if the field passed
  741. in is the same as the current grouping field, false to skip grouping on the same field (defaults to false)</div></li> </ul>
  742. <strong>Returns:</strong>
  743. <ul>
  744. <li><code>void</code></li>
  745. </ul>
  746. </div>
  747. </div>
  748. </div>
  749. </td>
  750. <td class="msource">GroupingStore</td>
  751. </tr>
  752. <tr class="method-row inherited alt expandable">
  753. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  754. <td class="sig">
  755. <a id="Ext.data.GroupingStore-hasListener"></a>
  756. <b>hasListener</b>(&nbsp;<code>String eventName</code>&nbsp;) : Boolean <div class="mdesc">
  757. <div class="short">Checks to see if this object has any listeners for a specified event</div>
  758. <div class="long">
  759. Checks to see if this object has any listeners for a specified event <div class="mdetail-params">
  760. <strong>Parameters:</strong>
  761. <ul><li><code>eventName</code> : String<div class="sub-desc">The name of the event to check for</div></li> </ul>
  762. <strong>Returns:</strong>
  763. <ul>
  764. <li><code>Boolean</code><div class="sub-desc">True if the event is being listened for, else false</div></li>
  765. </ul>
  766. </div>
  767. </div>
  768. </div>
  769. </td>
  770. <td class="msource"><a ext:cls="Ext.util.Observable" ext:member="#hasListener" href="output/Ext.util.Observable.html#hasListener">Observable</a></td>
  771. </tr>
  772. <tr class="method-row inherited expandable">
  773. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  774. <td class="sig">
  775. <a id="Ext.data.GroupingStore-indexOf"></a>
  776. <b>indexOf</b>(&nbsp;<code>Ext.data.Record record</code>&nbsp;) : Number <div class="mdesc">
  777. <div class="short">Get the index within the cache of the passed Record.</div>
  778. <div class="long">
  779. Get the index within the cache of the passed Record. <div class="mdetail-params">
  780. <strong>Parameters:</strong>
  781. <ul><li><code>record</code> : Ext.data.Record<div class="sub-desc">The Ext.data.Record object to to find.</div></li> </ul>
  782. <strong>Returns:</strong>
  783. <ul>
  784. <li><code>Number</code><div class="sub-desc">The index of the passed Record. Returns -1 if not found.</div></li>
  785. </ul>
  786. </div>
  787. </div>
  788. </div>
  789. </td>
  790. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#indexOf" href="output/Ext.data.Store.html#indexOf">Store</a></td>
  791. </tr>
  792. <tr class="method-row inherited alt expandable">
  793. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  794. <td class="sig">
  795. <a id="Ext.data.GroupingStore-indexOfId"></a>
  796. <b>indexOfId</b>(&nbsp;<code>String id</code>&nbsp;) : Number <div class="mdesc">
  797. <div class="short">Get the index within the cache of the Record with the passed id.</div>
  798. <div class="long">
  799. Get the index within the cache of the Record with the passed id. <div class="mdetail-params">
  800. <strong>Parameters:</strong>
  801. <ul><li><code>id</code> : String<div class="sub-desc">The id of the Record to find.</div></li> </ul>
  802. <strong>Returns:</strong>
  803. <ul>
  804. <li><code>Number</code><div class="sub-desc">The index of the Record. Returns -1 if not found.</div></li>
  805. </ul>
  806. </div>
  807. </div>
  808. </div>
  809. </td>
  810. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#indexOfId" href="output/Ext.data.Store.html#indexOfId">Store</a></td>
  811. </tr>
  812. <tr class="method-row inherited expandable">
  813. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  814. <td class="sig">
  815. <a id="Ext.data.GroupingStore-insert"></a>
  816. <b>insert</b>(&nbsp;<code>Number index</code>, <code>Ext.data.Record[] records</code>&nbsp;) : void <div class="mdesc">
  817. <div class="short">Inserts Records to the Store at the given index and fires the add event.</div>
  818. <div class="long">
  819. Inserts Records to the Store at the given index and fires the add event. <div class="mdetail-params">
  820. <strong>Parameters:</strong>
  821. <ul><li><code>index</code> : Number<div class="sub-desc">The start index at which to insert the passed Records.</div></li><li><code>records</code> : Ext.data.Record[]<div class="sub-desc">An Array of Ext.data.Record objects to add to the cache.</div></li> </ul>
  822. <strong>Returns:</strong>
  823. <ul>
  824. <li><code>void</code></li>
  825. </ul>
  826. </div>
  827. </div>
  828. </div>
  829. </td>
  830. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#insert" href="output/Ext.data.Store.html#insert">Store</a></td>
  831. </tr>
  832. <tr class="method-row inherited alt expandable">
  833. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  834. <td class="sig">
  835. <a id="Ext.data.GroupingStore-isFiltered"></a>
  836. <b>isFiltered</b>() : Boolean <div class="mdesc">
  837. <div class="short">Returns true if this store is currently filtered</div>
  838. <div class="long">
  839. Returns true if this store is currently filtered <div class="mdetail-params">
  840. <strong>Parameters:</strong>
  841. <ul><li>None.</li> </ul>
  842. <strong>Returns:</strong>
  843. <ul>
  844. <li><code>Boolean</code></li>
  845. </ul>
  846. </div>
  847. </div>
  848. </div>
  849. </td>
  850. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#isFiltered" href="output/Ext.data.Store.html#isFiltered">Store</a></td>
  851. </tr>
  852. <tr class="method-row inherited expandable">
  853. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  854. <td class="sig">
  855. <a id="Ext.data.GroupingStore-load"></a>
  856. <b>load</b>(&nbsp;<code>Object options</code>&nbsp;) : void <div class="mdesc">
  857. <div class="short">Loads the Record cache from the configured Proxy using the configured Reader.
  858. If using remote paging, then the first ...</div>
  859. <div class="long">
  860. Loads the Record cache from the configured Proxy using the configured Reader.
  861. <p>If using remote paging, then the first load call must specify the <tt>start</tt>
  862. and <tt>limit</tt> properties in the options.params property to establish the initial
  863. position within the dataset, and the number of Records to cache on each read from the Proxy.</p>
  864. <p><b>It is important to note that for remote data sources, loading is asynchronous,
  865. and this call will return before the new data has been loaded. Perform any post-processing
  866. in a callback function, or in a "load" event handler.</b></p> <div class="mdetail-params">
  867. <strong>Parameters:</strong>
  868. <ul><li><code>options</code> : Object<div class="sub-desc">An object containing properties which control loading options:<ul>
  869. <li><b>params</b> :Object<p class="sub-desc">An object containing properties to pass as HTTP parameters to a remote data source.</p></li>
  870. <li><b>callback</b> : Function}<p class="sub-desc">A function to be called after the Records have been loaded. The callback is
  871. passed the following arguments:<ul>
  872. <li>r : Ext.data.Record[]</li>
  873. <li>options: Options object from the load call</li>
  874. <li>success: Boolean success indicator</li></ul></p></li>
  875. <li><b>scope</b> : Object<p class="sub-desc">Scope with which to call the callback (defaults to the Store object)</p></li>
  876. <li><b>add</b> : Boolean<p class="sub-desc">Indicator to append loaded records rather than replace the current cache.</p></li>
  877. </ul></div></li> </ul>
  878. <strong>Returns:</strong>
  879. <ul>
  880. <li><code>void</code></li>
  881. </ul>
  882. </div>
  883. </div>
  884. </div>
  885. </td>
  886. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#load" href="output/Ext.data.Store.html#load">Store</a></td>
  887. </tr>
  888. <tr class="method-row inherited alt expandable">
  889. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  890. <td class="sig">
  891. <a id="Ext.data.GroupingStore-loadData"></a>
  892. <b>loadData</b>(&nbsp;<code>Object data</code>, <span class="optional" title="Optional">[<code>Boolean append</code>]</span>&nbsp;) : void <div class="mdesc">
  893. <div class="short">Loads data from a passed data block. A Reader which understands the format of the data
  894. must have been configured in t...</div>
  895. <div class="long">
  896. Loads data from a passed data block. A Reader which understands the format of the data
  897. must have been configured in the constructor. <div class="mdetail-params">
  898. <strong>Parameters:</strong>
  899. <ul><li><code>data</code> : Object<div class="sub-desc">The data block from which to read the Records. The format of the data expected
  900. is dependent on the type of Reader that is configured and should correspond to that Reader's readRecords parameter.</div></li><li><code>append</code> : Boolean<div class="sub-desc">(Optional) True to append the new Records rather than replace the existing cache.</div></li> </ul>
  901. <strong>Returns:</strong>
  902. <ul>
  903. <li><code>void</code></li>
  904. </ul>
  905. </div>
  906. </div>
  907. </div>
  908. </td>
  909. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#loadData" href="output/Ext.data.Store.html#loadData">Store</a></td>
  910. </tr>
  911. <tr class="method-row inherited expandable">
  912. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  913. <td class="sig">
  914. <a id="Ext.data.GroupingStore-on"></a>
  915. <b>on</b>(&nbsp;<code>String eventName</code>, <code>Function handler</code>, <span class="optional" title="Optional">[<code>Object scope</code>]</span>, <span class="optional" title="Optional">[<code>Object options</code>]</span>&nbsp;) : void <div class="mdesc">
  916. <div class="short">Appends an event handler to this element (shorthand for addListener)</div>
  917. <div class="long">
  918. Appends an event handler to this element (shorthand for addListener) <div class="mdetail-params">
  919. <strong>Parameters:</strong>
  920. <ul><li><code>eventName</code> : String<div class="sub-desc">The type of event to listen for</div></li><li><code>handler</code> : Function<div class="sub-desc">The method the event invokes</div></li><li><code>scope</code> : Object<div class="sub-desc">(optional) The scope in which to execute the handler
  921. function. The handler function's "this" context.</div></li><li><code>options</code> : Object<div class="sub-desc">(optional)</div></li> </ul>
  922. <strong>Returns:</strong>
  923. <ul>
  924. <li><code>void</code></li>
  925. </ul>
  926. </div>
  927. </div>
  928. </div>
  929. </td>
  930. <td class="msource"><a ext:cls="Ext.util.Observable" ext:member="#on" href="output/Ext.util.Observable.html#on">Observable</a></td>
  931. </tr>
  932. <tr class="method-row inherited alt expandable">
  933. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  934. <td class="sig">
  935. <a id="Ext.data.GroupingStore-purgeListeners"></a>
  936. <b>purgeListeners</b>() : void <div class="mdesc">
  937. <div class="short">Removes all listeners for this object</div>
  938. <div class="long">
  939. Removes all listeners for this object <div class="mdetail-params">
  940. <strong>Parameters:</strong>
  941. <ul><li>None.</li> </ul>
  942. <strong>Returns:</strong>
  943. <ul>
  944. <li><code>void</code></li>
  945. </ul>
  946. </div>
  947. </div>
  948. </div>
  949. </td>
  950. <td class="msource"><a ext:cls="Ext.util.Observable" ext:member="#purgeListeners" href="output/Ext.util.Observable.html#purgeListeners">Observable</a></td>
  951. </tr>
  952. <tr class="method-row inherited expandable">
  953. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  954. <td class="sig">
  955. <a id="Ext.data.GroupingStore-query"></a>
  956. <b>query</b>(&nbsp;<code>String field</code>, <code>String/RegExp value</code>, <span class="optional" title="Optional">[<code>Boolean anyMatch</code>]</span>, <span class="optional" title="Optional">[<code>Boolean caseSensitive</code>]</span>&nbsp;) : MixedCollection <div class="mdesc">
  957. <div class="short">Query the records by a specified property.</div>
  958. <div class="long">
  959. Query the records by a specified property. <div class="mdetail-params">
  960. <strong>Parameters:</strong>
  961. <ul><li><code>field</code> : String<div class="sub-desc">A field on your records</div></li><li><code>value</code> : String/RegExp<div class="sub-desc">Either a string that the field
  962. should start with or a RegExp to test against the field</div></li><li><code>anyMatch</code> : Boolean<div class="sub-desc">(optional) True to match any part not just the beginning</div></li><li><code>caseSensitive</code> : Boolean<div class="sub-desc">(optional) True for case sensitive comparison</div></li> </ul>
  963. <strong>Returns:</strong>
  964. <ul>
  965. <li><code>MixedCollection</code><div class="sub-desc">Returns an Ext.util.MixedCollection of the matched records</div></li>
  966. </ul>
  967. </div>
  968. </div>
  969. </div>
  970. </td>
  971. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#query" href="output/Ext.data.Store.html#query">Store</a></td>
  972. </tr>
  973. <tr class="method-row inherited alt expandable">
  974. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  975. <td class="sig">
  976. <a id="Ext.data.GroupingStore-queryBy"></a>
  977. <b>queryBy</b>(&nbsp;<code>Function fn</code>, <span class="optional" title="Optional">[<code>Object scope</code>]</span>&nbsp;) : MixedCollection <div class="mdesc">
  978. <div class="short">Query the cached records in this Store using a filtering function. The specified function
  979. will be called with each re...</div>
  980. <div class="long">
  981. Query the cached records in this Store using a filtering function. The specified function
  982. will be called with each record in this Store. If the function returns <tt>true</tt> the record is
  983. included in the results. <div class="mdetail-params">
  984. <strong>Parameters:</strong>
  985. <ul><li><code>fn</code> : Function<div class="sub-desc">The function to be called. It will be passed the following parameters:<ul>
  986. <li><b>record</b> : Ext.data.Record<p class="sub-desc">The <a ext:cls="Ext.data.Record" href="output/Ext.data.Record.html">record</a>
  987. to test for filtering. Access field values using <a ext:cls="Ext.data.Record" ext:member="get" href="output/Ext.data.Record.html#get">Ext.data.Record.get</a>.</p></li>
  988. <li><b>id</b> : Object<p class="sub-desc">The ID of the Record passed.</p></li>
  989. </ul></div></li><li><code>scope</code> : Object<div class="sub-desc">(optional) The scope of the function (defaults to this)</div></li> </ul>
  990. <strong>Returns:</strong>
  991. <ul>
  992. <li><code>MixedCollection</code><div class="sub-desc">Returns an Ext.util.MixedCollection of the matched records</div></li>
  993. </ul>
  994. </div>
  995. </div>
  996. </div>
  997. </td>
  998. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#queryBy" href="output/Ext.data.Store.html#queryBy">Store</a></td>
  999. </tr>
  1000. <tr class="method-row inherited expandable">
  1001. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1002. <td class="sig">
  1003. <a id="Ext.data.GroupingStore-rejectChanges"></a>
  1004. <b>rejectChanges</b>() : void <div class="mdesc">
  1005. <div class="short">Cancel outstanding changes on all changed records.</div>
  1006. <div class="long">
  1007. Cancel outstanding changes on all changed records. <div class="mdetail-params">
  1008. <strong>Parameters:</strong>
  1009. <ul><li>None.</li> </ul>
  1010. <strong>Returns:</strong>
  1011. <ul>
  1012. <li><code>void</code></li>
  1013. </ul>
  1014. </div>
  1015. </div>
  1016. </div>
  1017. </td>
  1018. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#rejectChanges" href="output/Ext.data.Store.html#rejectChanges">Store</a></td>
  1019. </tr>
  1020. <tr class="method-row inherited alt expandable">
  1021. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1022. <td class="sig">
  1023. <a id="Ext.data.GroupingStore-reload"></a>
  1024. <b>reload</b>(&nbsp;<span class="optional" title="Optional">[<code>Object options</code>]</span>&nbsp;) : void <div class="mdesc">
  1025. <div class="short">Reloads the Record cache from the configured Proxy using the configured Reader and
  1026. the options from the last load ope...</div>
  1027. <div class="long">
  1028. Reloads the Record cache from the configured Proxy using the configured Reader and
  1029. the options from the last load operation performed. <div class="mdetail-params">
  1030. <strong>Parameters:</strong>
  1031. <ul><li><code>options</code> : Object<div class="sub-desc">(optional) An object containing properties which may override the options
  1032. used in the last load operation. See <a ext:cls="Ext.data.Store" ext:member="load" href="output/Ext.data.Store.html#load">load</a> for details (defaults to null, in which case
  1033. the most recently used options are reused).</div></li> </ul>
  1034. <strong>Returns:</strong>
  1035. <ul>
  1036. <li><code>void</code></li>
  1037. </ul>
  1038. </div>
  1039. </div>
  1040. </div>
  1041. </td>
  1042. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#reload" href="output/Ext.data.Store.html#reload">Store</a></td>
  1043. </tr>
  1044. <tr class="method-row inherited expandable">
  1045. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1046. <td class="sig">
  1047. <a id="Ext.data.GroupingStore-remove"></a>
  1048. <b>remove</b>(&nbsp;<code>Ext.data.Record record</code>&nbsp;) : void <div class="mdesc">
  1049. <div class="short">Remove a Record from the Store and fires the remove event.</div>
  1050. <div class="long">
  1051. Remove a Record from the Store and fires the remove event. <div class="mdetail-params">
  1052. <strong>Parameters:</strong>
  1053. <ul><li><code>record</code> : Ext.data.Record<div class="sub-desc">Th Ext.data.Record object to remove from the cache.</div></li> </ul>
  1054. <strong>Returns:</strong>
  1055. <ul>
  1056. <li><code>void</code></li>
  1057. </ul>
  1058. </div>
  1059. </div>
  1060. </div>
  1061. </td>
  1062. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#remove" href="output/Ext.data.Store.html#remove">Store</a></td>
  1063. </tr>
  1064. <tr class="method-row inherited alt expandable">
  1065. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1066. <td class="sig">
  1067. <a id="Ext.data.GroupingStore-removeAll"></a>
  1068. <b>removeAll</b>() : void <div class="mdesc">
  1069. <div class="short">Remove all Records from the Store and fires the clear event.</div>
  1070. <div class="long">
  1071. Remove all Records from the Store and fires the clear event. <div class="mdetail-params">
  1072. <strong>Parameters:</strong>
  1073. <ul><li>None.</li> </ul>
  1074. <strong>Returns:</strong>
  1075. <ul>
  1076. <li><code>void</code></li>
  1077. </ul>
  1078. </div>
  1079. </div>
  1080. </div>
  1081. </td>
  1082. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#removeAll" href="output/Ext.data.Store.html#removeAll">Store</a></td>
  1083. </tr>
  1084. <tr class="method-row inherited expandable">
  1085. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1086. <td class="sig">
  1087. <a id="Ext.data.GroupingStore-removeListener"></a>
  1088. <b>removeListener</b>(&nbsp;<code>String eventName</code>, <code>Function handler</code>, <span class="optional" title="Optional">[<code>Object scope</code>]</span>&nbsp;) : void <div class="mdesc">
  1089. <div class="short">Removes a listener</div>
  1090. <div class="long">
  1091. Removes a listener <div class="mdetail-params">
  1092. <strong>Parameters:</strong>
  1093. <ul><li><code>eventName</code> : String<div class="sub-desc">The type of event to listen for</div></li><li><code>handler</code> : Function<div class="sub-desc">The handler to remove</div></li><li><code>scope</code> : Object<div class="sub-desc">(optional) The scope (this object) for the handler</div></li> </ul>
  1094. <strong>Returns:</strong>
  1095. <ul>
  1096. <li><code>void</code></li>
  1097. </ul>
  1098. </div>
  1099. </div>
  1100. </div>
  1101. </td>
  1102. <td class="msource"><a ext:cls="Ext.util.Observable" ext:member="#removeListener" href="output/Ext.util.Observable.html#removeListener">Observable</a></td>
  1103. </tr>
  1104. <tr class="method-row inherited alt expandable">
  1105. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1106. <td class="sig">
  1107. <a id="Ext.data.GroupingStore-resumeEvents"></a>
  1108. <b>resumeEvents</b>() : void <div class="mdesc">
  1109. <div class="short">Resume firing events. (see <a ext:cls="Ext.util.Observable" ext:member="suspendEvents" href="output/Ext.util.Observable.html#suspendEvents">suspendEvents</a>)</div>
  1110. <div class="long">
  1111. Resume firing events. (see <a ext:cls="Ext.util.Observable" ext:member="suspendEvents" href="output/Ext.util.Observable.html#suspendEvents">suspendEvents</a>) <div class="mdetail-params">
  1112. <strong>Parameters:</strong>
  1113. <ul><li>None.</li> </ul>
  1114. <strong>Returns:</strong>
  1115. <ul>
  1116. <li><code>void</code></li>
  1117. </ul>
  1118. </div>
  1119. </div>
  1120. </div>
  1121. </td>
  1122. <td class="msource"><a ext:cls="Ext.util.Observable" ext:member="#resumeEvents" href="output/Ext.util.Observable.html#resumeEvents">Observable</a></td>
  1123. </tr>
  1124. <tr class="method-row inherited expandable">
  1125. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1126. <td class="sig">
  1127. <a id="Ext.data.GroupingStore-setDefaultSort"></a>
  1128. <b>setDefaultSort</b>(&nbsp;<code>String fieldName</code>, <span class="optional" title="Optional">[<code>String dir</code>]</span>&nbsp;) : void <div class="mdesc">
  1129. <div class="short">Sets the default sort column and order to be used by the next load operation.</div>
  1130. <div class="long">
  1131. Sets the default sort column and order to be used by the next load operation. <div class="mdetail-params">
  1132. <strong>Parameters:</strong>
  1133. <ul><li><code>fieldName</code> : String<div class="sub-desc">The name of the field to sort by.</div></li><li><code>dir</code> : String<div class="sub-desc">(optional) The sort order, "ASC" or "DESC" (defaults to "ASC")</div></li> </ul>
  1134. <strong>Returns:</strong>
  1135. <ul>
  1136. <li><code>void</code></li>
  1137. </ul>
  1138. </div>
  1139. </div>
  1140. </div>
  1141. </td>
  1142. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#setDefaultSort" href="output/Ext.data.Store.html#setDefaultSort">Store</a></td>
  1143. </tr>
  1144. <tr class="method-row inherited alt expandable">
  1145. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1146. <td class="sig">
  1147. <a id="Ext.data.GroupingStore-sort"></a>
  1148. <b>sort</b>(&nbsp;<code>String fieldName</code>, <span class="optional" title="Optional">[<code>String dir</code>]</span>&nbsp;) : void <div class="mdesc">
  1149. <div class="short">Sort the Records.
  1150. If remote sorting is used, the sort is performed on the server, and the cache is
  1151. reloaded. If local...</div>
  1152. <div class="long">
  1153. Sort the Records.
  1154. If remote sorting is used, the sort is performed on the server, and the cache is
  1155. reloaded. If local sorting is used, the cache is sorted internally. <div class="mdetail-params">
  1156. <strong>Parameters:</strong>
  1157. <ul><li><code>fieldName</code> : String<div class="sub-desc">The name of the field to sort by.</div></li><li><code>dir</code> : String<div class="sub-desc">(optional) The sort order, "ASC" or "DESC" (defaults to "ASC")</div></li> </ul>
  1158. <strong>Returns:</strong>
  1159. <ul>
  1160. <li><code>void</code></li>
  1161. </ul>
  1162. </div>
  1163. </div>
  1164. </div>
  1165. </td>
  1166. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#sort" href="output/Ext.data.Store.html#sort">Store</a></td>
  1167. </tr>
  1168. <tr class="method-row inherited expandable">
  1169. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1170. <td class="sig">
  1171. <a id="Ext.data.GroupingStore-sum"></a>
  1172. <b>sum</b>(&nbsp;<code>String property</code>, <code>Number start</code>, <code>Number end</code>&nbsp;) : Number <div class="mdesc">
  1173. <div class="short">Sums the value of <i>property</i> for each record between start and end and returns the result.</div>
  1174. <div class="long">
  1175. Sums the value of <i>property</i> for each record between start and end and returns the result. <div class="mdetail-params">
  1176. <strong>Parameters:</strong>
  1177. <ul><li><code>property</code> : String<div class="sub-desc">A field on your records</div></li><li><code>start</code> : Number<div class="sub-desc">The record index to start at (defaults to 0)</div></li><li><code>end</code> : Number<div class="sub-desc">The last record index to include (defaults to length - 1)</div></li> </ul>
  1178. <strong>Returns:</strong>
  1179. <ul>
  1180. <li><code>Number</code><div class="sub-desc">The sum</div></li>
  1181. </ul>
  1182. </div>
  1183. </div>
  1184. </div>
  1185. </td>
  1186. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#sum" href="output/Ext.data.Store.html#sum">Store</a></td>
  1187. </tr>
  1188. <tr class="method-row inherited alt expandable">
  1189. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1190. <td class="sig">
  1191. <a id="Ext.data.GroupingStore-suspendEvents"></a>
  1192. <b>suspendEvents</b>() : void <div class="mdesc">
  1193. <div class="short">Suspend the firing of all events. (see <a ext:cls="Ext.util.Observable" ext:member="resumeEvents" href="output/Ext.util.Observable.html#resumeEvents">resumeEvents</a>)</div>
  1194. <div class="long">
  1195. Suspend the firing of all events. (see <a ext:cls="Ext.util.Observable" ext:member="resumeEvents" href="output/Ext.util.Observable.html#resumeEvents">resumeEvents</a>) <div class="mdetail-params">
  1196. <strong>Parameters:</strong>
  1197. <ul><li>None.</li> </ul>
  1198. <strong>Returns:</strong>
  1199. <ul>
  1200. <li><code>void</code></li>
  1201. </ul>
  1202. </div>
  1203. </div>
  1204. </div>
  1205. </td>
  1206. <td class="msource"><a ext:cls="Ext.util.Observable" ext:member="#suspendEvents" href="output/Ext.util.Observable.html#suspendEvents">Observable</a></td>
  1207. </tr>
  1208. <tr class="method-row inherited expandable">
  1209. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1210. <td class="sig">
  1211. <a id="Ext.data.GroupingStore-un"></a>
  1212. <b>un</b>(&nbsp;<code>String eventName</code>, <code>Function handler</code>, <span class="optional" title="Optional">[<code>Object scope</code>]</span>&nbsp;) : void <div class="mdesc">
  1213. <div class="short">Removes a listener (shorthand for removeListener)</div>
  1214. <div class="long">
  1215. Removes a listener (shorthand for removeListener) <div class="mdetail-params">
  1216. <strong>Parameters:</strong>
  1217. <ul><li><code>eventName</code> : String<div class="sub-desc">The type of event to listen for</div></li><li><code>handler</code> : Function<div class="sub-desc">The handler to remove</div></li><li><code>scope</code> : Object<div class="sub-desc">(optional) The scope (this object) for the handler</div></li> </ul>
  1218. <strong>Returns:</strong>
  1219. <ul>
  1220. <li><code>void</code></li>
  1221. </ul>
  1222. </div>
  1223. </div>
  1224. </div>
  1225. </td>
  1226. <td class="msource"><a ext:cls="Ext.util.Observable" ext:member="#un" href="output/Ext.util.Observable.html#un">Observable</a></td>
  1227. </tr>
  1228. </table>
  1229. <a id="Ext.data.GroupingStore-events"></a>
  1230. <h2>Public Events</h2>
  1231. <table cellspacing="0" class="member-table">
  1232. <tr>
  1233. <th class="sig-header" colspan="2">Event</th>
  1234. <th class="msource-header">Defined By</th>
  1235. </tr>
  1236. <tr class="event-row inherited expandable">
  1237. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1238. <td class="sig">
  1239. <a id="Ext.data.GroupingStore-add"></a>
  1240. <b>add</b> : (&nbsp;<code>Store this</code>, <code>Ext.data.Record[] records</code>, <code>Number index</code>&nbsp;) <div class="mdesc">
  1241. <div class="short">Fires when Records have been added to the Store</div>
  1242. <div class="long">
  1243. Fires when Records have been added to the Store <div class="mdetail-params">
  1244. <strong style="font-weight:normal;">Listeners will be called with the following arguments:</strong>
  1245. <ul><li><code>this</code> : Store<div class="sub-desc"></div></li><li><code>records</code> : Ext.data.Record[]<div class="sub-desc">The array of Records added</div></li><li><code>index</code> : Number<div class="sub-desc">The index at which the record(s) were added</div></li> </ul>
  1246. </div>
  1247. </div>
  1248. </div>
  1249. </td>
  1250. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#event-add" href="output/Ext.data.Store.html#event-add">Store</a></td>
  1251. </tr>
  1252. <tr class="event-row inherited alt expandable">
  1253. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1254. <td class="sig">
  1255. <a id="Ext.data.GroupingStore-beforeload"></a>
  1256. <b>beforeload</b> : (&nbsp;<code>Store this</code>, <code>Object options</code>&nbsp;) <div class="mdesc">
  1257. <div class="short">Fires before a request is made for a new data object. If the beforeload handler returns false
  1258. the load action will b...</div>
  1259. <div class="long">
  1260. Fires before a request is made for a new data object. If the beforeload handler returns false
  1261. the load action will be canceled. <div class="mdetail-params">
  1262. <strong style="font-weight:normal;">Listeners will be called with the following arguments:</strong>
  1263. <ul><li><code>this</code> : Store<div class="sub-desc"></div></li><li><code>options</code> : Object<div class="sub-desc">The loading options that were specified (see <a ext:cls="Ext.data.Store" ext:member="load" href="output/Ext.data.Store.html#load">load</a> for details)</div></li> </ul>
  1264. </div>
  1265. </div>
  1266. </div>
  1267. </td>
  1268. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#event-beforeload" href="output/Ext.data.Store.html#event-beforeload">Store</a></td>
  1269. </tr>
  1270. <tr class="event-row inherited expandable">
  1271. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1272. <td class="sig">
  1273. <a id="Ext.data.GroupingStore-clear"></a>
  1274. <b>clear</b> : (&nbsp;<code>Store this</code>&nbsp;) <div class="mdesc">
  1275. <div class="short">Fires when the data cache has been cleared.</div>
  1276. <div class="long">
  1277. Fires when the data cache has been cleared. <div class="mdetail-params">
  1278. <strong style="font-weight:normal;">Listeners will be called with the following arguments:</strong>
  1279. <ul><li><code>this</code> : Store<div class="sub-desc"></div></li> </ul>
  1280. </div>
  1281. </div>
  1282. </div>
  1283. </td>
  1284. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#event-clear" href="output/Ext.data.Store.html#event-clear">Store</a></td>
  1285. </tr>
  1286. <tr class="event-row inherited alt expandable">
  1287. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1288. <td class="sig">
  1289. <a id="Ext.data.GroupingStore-datachanged"></a>
  1290. <b>datachanged</b> : (&nbsp;<code>Store this</code>&nbsp;) <div class="mdesc">
  1291. <div class="short">Fires when the data cache has changed, and a widget which is using this Store
  1292. as a Record cache should refresh its view.</div>
  1293. <div class="long">
  1294. Fires when the data cache has changed, and a widget which is using this Store
  1295. as a Record cache should refresh its view. <div class="mdetail-params">
  1296. <strong style="font-weight:normal;">Listeners will be called with the following arguments:</strong>
  1297. <ul><li><code>this</code> : Store<div class="sub-desc"></div></li> </ul>
  1298. </div>
  1299. </div>
  1300. </div>
  1301. </td>
  1302. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#event-datachanged" href="output/Ext.data.Store.html#event-datachanged">Store</a></td>
  1303. </tr>
  1304. <tr class="event-row inherited expandable">
  1305. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1306. <td class="sig">
  1307. <a id="Ext.data.GroupingStore-load"></a>
  1308. <b>load</b> : (&nbsp;<code>Store this</code>, <code>Ext.data.Record[] records</code>, <code>Object options</code>&nbsp;) <div class="mdesc">
  1309. <div class="short">Fires after a new set of Records has been loaded.</div>
  1310. <div class="long">
  1311. Fires after a new set of Records has been loaded. <div class="mdetail-params">
  1312. <strong style="font-weight:normal;">Listeners will be called with the following arguments:</strong>
  1313. <ul><li><code>this</code> : Store<div class="sub-desc"></div></li><li><code>records</code> : Ext.data.Record[]<div class="sub-desc">The Records that were loaded</div></li><li><code>options</code> : Object<div class="sub-desc">The loading options that were specified (see <a ext:cls="Ext.data.Store" ext:member="load" href="output/Ext.data.Store.html#load">load</a> for details)</div></li> </ul>
  1314. </div>
  1315. </div>
  1316. </div>
  1317. </td>
  1318. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#event-load" href="output/Ext.data.Store.html#event-load">Store</a></td>
  1319. </tr>
  1320. <tr class="event-row inherited alt expandable">
  1321. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1322. <td class="sig">
  1323. <a id="Ext.data.GroupingStore-loadexception"></a>
  1324. <b>loadexception</b> : () <div class="mdesc">
  1325. <div class="short">Fires if an exception occurs in the Proxy during loading.
  1326. Called with the signature of the Proxy's "loadexception" ev...</div>
  1327. <div class="long">
  1328. Fires if an exception occurs in the Proxy during loading.
  1329. Called with the signature of the Proxy's "loadexception" event. <div class="mdetail-params">
  1330. <strong style="font-weight:normal;">Listeners will be called with the following arguments:</strong>
  1331. <ul><li>None.</li> </ul>
  1332. </div>
  1333. </div>
  1334. </div>
  1335. </td>
  1336. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#event-loadexception" href="output/Ext.data.Store.html#event-loadexception">Store</a></td>
  1337. </tr>
  1338. <tr class="event-row inherited expandable">
  1339. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1340. <td class="sig">
  1341. <a id="Ext.data.GroupingStore-metachange"></a>
  1342. <b>metachange</b> : (&nbsp;<code>Store this</code>, <code>Object meta</code>&nbsp;) <div class="mdesc">
  1343. <div class="short">Fires when this store's reader provides new metadata (fields). This is currently only supported for JsonReaders.</div>
  1344. <div class="long">
  1345. Fires when this store's reader provides new metadata (fields). This is currently only supported for JsonReaders. <div class="mdetail-params">
  1346. <strong style="font-weight:normal;">Listeners will be called with the following arguments:</strong>
  1347. <ul><li><code>this</code> : Store<div class="sub-desc"></div></li><li><code>meta</code> : Object<div class="sub-desc">The JSON metadata</div></li> </ul>
  1348. </div>
  1349. </div>
  1350. </div>
  1351. </td>
  1352. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#event-metachange" href="output/Ext.data.Store.html#event-metachange">Store</a></td>
  1353. </tr>
  1354. <tr class="event-row inherited alt expandable">
  1355. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1356. <td class="sig">
  1357. <a id="Ext.data.GroupingStore-remove"></a>
  1358. <b>remove</b> : (&nbsp;<code>Store this</code>, <code>Ext.data.Record record</code>, <code>Number index</code>&nbsp;) <div class="mdesc">
  1359. <div class="short">Fires when a Record has been removed from the Store</div>
  1360. <div class="long">
  1361. Fires when a Record has been removed from the Store <div class="mdetail-params">
  1362. <strong style="font-weight:normal;">Listeners will be called with the following arguments:</strong>
  1363. <ul><li><code>this</code> : Store<div class="sub-desc"></div></li><li><code>record</code> : Ext.data.Record<div class="sub-desc">The Record that was removed</div></li><li><code>index</code> : Number<div class="sub-desc">The index at which the record was removed</div></li> </ul>
  1364. </div>
  1365. </div>
  1366. </div>
  1367. </td>
  1368. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#event-remove" href="output/Ext.data.Store.html#event-remove">Store</a></td>
  1369. </tr>
  1370. <tr class="event-row inherited expandable">
  1371. <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
  1372. <td class="sig">
  1373. <a id="Ext.data.GroupingStore-update"></a>
  1374. <b>update</b> : (&nbsp;<code>Store this</code>, <code>Ext.data.Record record</code>, <code>String operation</code>&nbsp;) <div class="mdesc">
  1375. <div class="short">Fires when a Record has been updated</div>
  1376. <div class="long">
  1377. Fires when a Record has been updated <div class="mdetail-params">
  1378. <strong style="font-weight:normal;">Listeners will be called with the following arguments:</strong>
  1379. <ul><li><code>this</code> : Store<div class="sub-desc"></div></li><li><code>record</code> : Ext.data.Record<div class="sub-desc">The Record that was updated</div></li><li><code>operation</code> : String<div class="sub-desc">The update operation being performed. Value may be one of:
  1380. <pre><code>Ext.data.Record.EDIT
  1381. Ext.data.Record.REJECT
  1382. Ext.data.Record.COMMIT</code></pre></div></li> </ul>
  1383. </div>
  1384. </div>
  1385. </div>
  1386. </td>
  1387. <td class="msource"><a ext:cls="Ext.data.Store" ext:member="#event-update" href="output/Ext.data.Store.html#event-update">Store</a></td>
  1388. </tr>
  1389. </table>
  1390. </div>