3cb2cdfd030826ce1c69416681345937e2aa3933.svn-base 77 KB

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