Upgrade to ExtJS 4.0.0 - Released 04/26/2011
[extjs.git] / docs / api / Ext.selection.Model.html
1 <!DOCTYPE html><html><head><title>Ext.selection.Model | Ext JS 4.0 Documentation</title><script type="text/javascript" src="../ext-all.js"></script><link rel="stylesheet" href="../reset.css" type="text/css"><link rel="stylesheet" href="../scrollbars.css" type="text/css"><link rel="stylesheet" href="../docs.css" type="text/css"><link id="styleCss" rel="stylesheet" href="../style.css" type="text/css"><script type="text/javascript" src="../prettify.js"></script><link rel="stylesheet" href="../prettify.css" type="text/css"><!-- link(rel: 'stylesheet', href: req.baseURL + '/css/ext4.css', type: 'text/css')--><link rel="shortcut icon" type="image/ico" href="../favicon.ico"><!--[if IE]>
2 <style type="text/css">.head-band { display: none; }
3 .header { border: 0; top: 0; left: 0px; background: url(../header.gif) repeat-x; }
4 .doc-tab .members .member a.more { background-color: #efefef; }
5 </style><link rel="stylesheet" href="/new/css/ie.css" type="text/css"><![endif]-->
6 </head><body id="ext-body" class="iScroll"><div id="notice" class="notice">For up to date documentation and features, visit 
7 <a href="http://docs.sencha.com/ext-js/4-0">http://docs.sencha.com/ext-js/4-0</a></div><div class="wrapper"><div class="head-band"></div><div class="header"><h2><a href="../index.html">Sencha Documentation</a></h2></div><div id="search"><form><input type="text" placeholder="Search" id="search-field" autocomplete="off" name="q"></form><div id="search-box"></div></div><div id="treePanel"></div><div id="container"><script type="text/javascript">
8
9     req = {
10         liveURL: '.',
11         standAloneMode: true,
12         origDocClass: 'Ext.selection.Model',
13         docClass: 'Ext.selection.Model',
14         docReq: 'Ext.selection.Model',
15         version: '4.0',
16         baseURL: '.',
17         baseDocURL: '.',
18         baseProdURL: '.'
19     };
20
21     clsInfo = {};
22
23
24
25 </script>
26
27 <script type="text/javascript" src="../search.js"></script>
28 <!--script type="text/javascript" src="/new/javascripts/app/examples.js"></script-->
29 <script type="text/javascript" src="../class_tree.js"></script>
30 <script type="text/javascript" src="../class_doc.js"></script>
31 <script type="text/javascript">
32     req.source = 'Model2.html#Ext-selection.Model';
33     clsInfo = {"methods":["addEvents","addListener","addManagedListener","capture","clearListeners","clearManagedListeners","deselect","enableBubble","fireEvent","getLastSelected","getSelection","getSelectionMode","hasListener","hasSelection","isFocused","isLocked","isSelected","observe","on","relayEvents","releaseCapture","removeListener","removeManagedListener","resumeEvents","select","selectRange","setLastFocused","setLocked","setSelectionMode","suspendEvents","un"],"cfgs":["allowDeselect","listeners","mode"],"properties":["selected"],"events":["selectionchange"],"subclasses":["Ext.selection.CellModel","Ext.selection.RowModel","Ext.selection.DataViewModel"]};
34     Ext.onReady(function() {
35         Ext.create('Docs.classPanel');
36     });
37 </script><div id="top-block" class="top-block"><h1 id="clsTitle" class="cls"><a href="../source/Model2.html#Ext-selection.Model" target="_blank">Ext.selection.Model</a></h1></div><div id="docContent"><div id="doc-overview-content"><div class="lft"><pre class="subclasses"><h4>Hierarchy</h4><div class="subclass f"><a href="Ext.util.Observable.html" rel="Ext.util.Observable" class="cls docClass">Ext.util.Observable</a><div class="subclass"><strong>Ext.selection.Model</strong></div></div></pre><p>Tracks what records are currently selected in a databound widget.</p>
38
39 <p>This is an abstract class and is not meant to be directly used.</p>
40
41 <p>DataBound UI widgets such as GridPanel, TreePanel, and ListView
42 should subclass AbstractStoreSelectionModel and provide a way
43 to binding to the component.</p>
44
45 <p>The abstract methods onSelectChange and onLastFocusChanged should
46 be implemented in these subclasses to update the UI widget.</p>
47 <div class="members"><div class="m-cfgs"><div class="definedBy">Defined By</div><a name="configs"></a><h3 class="cfg p">Config Options</h3><h4 class="cfgGroup">Other Configs</h4><div id="config-allowDeselect" class="member f ni"><a href="Ext.selection.Model.html#config-allowDeselect" rel="config-allowDeselect" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-cfg-allowDeselect" class="viewSource">view source</a></div><a name="allowDeselect"></a><a name="config-allowDeselect"></a><a href="Ext.selection.Model.html#" rel="config-allowDeselect" class="cls expand">allowDeselect</a><span> : Boolean</span></div><div class="description"><div class="short">Allow users to deselect a record in a DataView, List or Grid. Only applicable when the SelectionModel's mode is 'SING...</div><div class="long"><p>Allow users to deselect a record in a DataView, List or Grid. Only applicable when the SelectionModel's mode is 'SINGLE'. Defaults to false.</p>
48 </div></div></div><div id="config-listeners" class="member inherited"><a href="Ext.selection.Model.html#config-listeners" rel="config-listeners" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-cfg-listeners" class="viewSource">view source</a></div><a name="listeners"></a><a name="config-listeners"></a><a href="Ext.selection.Model.html#" rel="config-listeners" class="cls expand">listeners</a><span> : Object</span></div><div class="description"><div class="short">(optional) A config object containing one or more event handlers to be added to this
49 object during initialization.  T...</div><div class="long"><p>(optional) <p>A config object containing one or more event handlers to be added to this
50 object during initialization.  This should be a valid listeners config object as specified in the
51 <a href="Ext.selection.Model.html#addListener" rel="Ext.selection.Model#addListener" class="docClass">addListener</a> example for attaching multiple handlers at once.</p></p>
52
53 <br><p><b><u>DOM events from ExtJs <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Components</a></u></b></p>
54
55
56 <br><p>While <i>some</i> ExtJs Component classes export selected DOM events (e.g. "click", "mouseover" etc), this
57
58
59 <p>is usually only done when extra value can be added. For example the <a href="Ext.view.View.html" rel="Ext.view.View" class="docClass">DataView</a>'s
60 <b><code><a href="Ext.view.View.html#click" rel="Ext.view.View#click" class="docClass">click</a></code></b> event passing the node clicked on. To access DOM
61 events directly from a child element of a Component, we need to specify the <code>element</code> option to
62 identify the Component property to add a DOM listener to:</p>
63
64 <pre><code>new Ext.panel.Panel({
65     width: 400,
66     height: 200,
67     dockedItems: [{
68         xtype: 'toolbar'
69     }],
70     listeners: {
71         click: {
72             element: 'el', //bind to the underlying el property on the panel
73             fn: function(){ console.log('click el'); }
74         },
75         dblclick: {
76             element: 'body', //bind to the underlying body property on the panel
77             fn: function(){ console.log('dblclick body'); }
78         }
79     }
80 });
81 </code></pre>
82
83
84 <p></p></p>
85 </div></div></div><div id="config-mode" class="member ni"><a href="Ext.selection.Model.html#config-mode" rel="config-mode" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-cfg-mode" class="viewSource">view source</a></div><a name="mode"></a><a name="config-mode"></a><a href="Ext.selection.Model.html#" rel="config-mode" class="cls expand">mode</a><span> : String</span></div><div class="description"><div class="short"><p>Modes of selection.
86 Valid values are SINGLE, SIMPLE, and MULTI. Defaults to 'SINGLE'</p>
87 </div><div class="long"><p>Modes of selection.
88 Valid values are SINGLE, SIMPLE, and MULTI. Defaults to 'SINGLE'</p>
89 </div></div></div></div><div class="m-properties"><a name="properties"></a><div class="definedBy">Defined By</div><h3 class="prp p">Properties</h3><div id="property-selected" class="member f ni"><a href="Ext.selection.Model.html#property-selected" rel="property-selected" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-property-selected" class="viewSource">view source</a></div><a name="selected"></a><a name="property-selected"></a><a href="Ext.selection.Model.html#" rel="property-selected" class="cls expand">selected</a><span> : Object</span></div><div class="description"><div class="short"><p>READ-ONLY A MixedCollection that maintains all of the currently selected
90 records.</p>
91 </div><div class="long"><p>READ-ONLY A MixedCollection that maintains all of the currently selected
92 records.</p>
93 </div></div></div></div><div class="m-methods"><a name="methods"></a><div class="definedBy">Defined By</div><h3 class="mth p">Methods</h3><div id="method-addEvents" class="member f inherited"><a href="Ext.selection.Model.html#method-addEvents" rel="method-addEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-addEvents" class="viewSource">view source</a></div><a name="addEvents"></a><a name="method-addEvents"></a><a href="Ext.selection.Model.html#" rel="method-addEvents" class="cls expand">addEvents</a>(
94 <span class="pre">Object/String o, String </span>)
95  : void</div><div class="description"><div class="short"><p>Adds the specified events to the list of events which this Observable may fire.</p>
96 </div><div class="long"><p>Adds the specified events to the list of events which this Observable may fire.</p>
97 <h3 class="pa">Parameters</h3><ul><li><span class="pre">o</span> : Object/String<div class="sub-desc"><p>Either an object with event names as properties with a value of <code>true</code>
98 or the first event name string if multiple event names are being passed as separate parameters.</p>
99 </div></li><li><span class="pre"></span> : String<div class="sub-desc"><p>[additional] Optional additional event names if multiple event names are being passed as separate parameters.
100 Usage:</p>
101
102 <pre><code>this.addEvents('storeloaded', 'storecleared');
103 </code></pre>
104
105 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
106 </li></ul></div></div></div><div id="method-addListener" class="member inherited"><a href="Ext.selection.Model.html#method-addListener" rel="method-addListener" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-addListener" class="viewSource">view source</a></div><a name="addListener"></a><a name="method-addListener"></a><a href="Ext.selection.Model.html#" rel="method-addListener" class="cls expand">addListener</a>(
107 <span class="pre">String eventName, Function handler, [Object scope], [Object options]</span>)
108  : void</div><div class="description"><div class="short"><p>Appends an event handler to this object.</p>
109 </div><div class="long"><p>Appends an event handler to this object.</p>
110 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The name of the event to listen for. May also be an object who's property names are event names. See</p>
111 </div></li><li><span class="pre">handler</span> : Function<div class="sub-desc"><p>The method the event invokes.</p>
112 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope (<code><b>this</b></code> reference) in which the handler function is executed.
113 <b>If omitted, defaults to the object which fired the event.</b></p>
114 </div></li><li><span class="pre">options</span> : Object<div class="sub-desc"><p>(optional) An object containing handler configuration.
115 properties. This may contain any of the following properties:<ul>
116 <li><b>scope</b> : Object<div class="sub-desc">The scope (<code><b>this</b></code> reference) in which the handler function is executed.
117 <b>If omitted, defaults to the object which fired the event.</b></div></li>
118 <li><b>delay</b> : Number<div class="sub-desc">The number of milliseconds to delay the invocation of the handler after the event fires.</div></li>
119 <li><b>single</b> : Boolean<div class="sub-desc">True to add a handler to handle just the next firing of the event, and then remove itself.</div></li>
120 <li><b>buffer</b> : Number<div class="sub-desc">Causes the handler to be scheduled to run in an <a href="Ext.util.DelayedTask.html" rel="Ext.util.DelayedTask" class="docClass">Ext.util.DelayedTask</a> delayed
121 by the specified number of milliseconds. If the event fires again within that time, the original
122 handler is <em>not</em> invoked, but the new handler is scheduled in its place.</div></li>
123 <li><b>target</b> : Observable<div class="sub-desc">Only call the handler if the event was fired on the target Observable, <i>not</i>
124 if the event was bubbled up from a child Observable.</div></li>
125 <li><b>element</b> : String<div class="sub-desc"><b>This option is only valid for listeners bound to <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Components</a>.</b>
126 The name of a Component property which references an element to add a listener to.</p>
127
128 <p>This option is useful during Component construction to add DOM event listeners to elements of <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Components</a> which
129 will exist only after the Component is rendered. For example, to add a click listener to a Panel's body:
130 <pre><code>new Ext.panel.Panel({
131     title: 'The title',
132     listeners: {
133         click: this.handlePanelClick,
134         element: 'body'
135     }
136 });
137 </code></pre></p>
138
139
140 <p>When added in this way, the options available are the options applicable to <a href="Ext.core.Element.html#addListener" rel="Ext.core.Element#addListener" class="docClass">Ext.core.Element.addListener</a></p>
141
142
143 <p></div></li>
144 </ul><br></p>
145
146 <p>
147 <b>Combining Options</b><br>
148 Using the options argument, it is possible to combine different types of listeners:<br>
149 <br>
150 A delayed, one-time listener.
151 <pre><code>myPanel.on('hide', this.handleClick, this, {
152 single: true,
153 delay: 100
154 });</code></pre>
155 <p>
156 <b>Attaching multiple handlers in 1 call</b><br>
157 The method also allows for a single argument to be passed which is a config object containing properties
158 which specify multiple events. For example:
159 <pre><code>myGridPanel.on({
160     cellClick: this.onCellClick,
161     mouseover: this.onMouseOver,
162     mouseout: this.onMouseOut,
163     scope: this // Important. Ensure "this" is correct during handler execution
164 });
165 </code></pre>.
166 <p>
167
168 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
169 </li></ul></div></div></div><div id="method-addManagedListener" class="member inherited"><a href="Ext.selection.Model.html#method-addManagedListener" rel="method-addManagedListener" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-addManagedListener" class="viewSource">view source</a></div><a name="addManagedListener"></a><a name="method-addManagedListener"></a><a href="Ext.selection.Model.html#" rel="method-addManagedListener" class="cls expand">addManagedListener</a>(
170 <span class="pre">Observable/Element item, Object/String ename, Function fn, Object scope, Object opt</span>)
171  : void</div><div class="description"><div class="short"><p>Adds listeners to any Observable object (or Element) which are automatically removed when this Component
172 is destroyed.
173
174 </div><div class="long"><p>Adds listeners to any Observable object (or Element) which are automatically removed when this Component
175 is destroyed.
176
177 <h3 class="pa">Parameters</h3><ul><li><span class="pre">item</span> : Observable/Element<div class="sub-desc"><p>The item to which to add a listener/listeners.</p>
178 </div></li><li><span class="pre">ename</span> : Object/String<div class="sub-desc"><p>The event name, or an object containing event name properties.</p>
179 </div></li><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>Optional. If the <code>ename</code> parameter was an event name, this
180 is the handler function.</p>
181 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>Optional. If the <code>ename</code> parameter was an event name, this
182 is the scope (<code>this</code> reference) in which the handler function is executed.</p>
183 </div></li><li><span class="pre">opt</span> : Object<div class="sub-desc"><p>Optional. If the <code>ename</code> parameter was an event name, this
184 is the <a href="Ext.util.Observable.html#addListener" rel="Ext.util.Observable#addListener" class="docClass">addListener</a> options.</p>
185 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
186 </li></ul></div></div></div><div id="method-capture" class="member inherited"><a href="Ext.selection.Model.html#method-capture" rel="method-capture" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-capture" class="viewSource">view source</a></div><a name="capture"></a><a name="method-capture"></a><a href="Ext.selection.Model.html#" rel="method-capture" class="cls expand">capture</a>(
187 <span class="pre">Observable o, Function fn, [Object scope]</span>)
188  : void</div><div class="description"><div class="short">Starts capture on the specified Observable. All events will be passed
189 to the supplied function with the event name + ...</div><div class="long"><p>Starts capture on the specified Observable. All events will be passed
190 to the supplied function with the event name + standard signature of the event
191 <b>before</b> the event is fired. If the supplied function returns false,
192 the event will not fire.</p>
193 <h3 class="pa">Parameters</h3><ul><li><span class="pre">o</span> : Observable<div class="sub-desc"><p>The Observable to capture events from.</p>
194 </div></li><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>The function to call when an event is fired.</p>
195 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope (<code>this</code> reference) in which the function is executed. Defaults to the Observable firing the event.</p>
196 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
197 </li></ul></div></div></div><div id="method-clearListeners" class="member inherited"><a href="Ext.selection.Model.html#method-clearListeners" rel="method-clearListeners" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-clearListeners" class="viewSource">view source</a></div><a name="clearListeners"></a><a name="method-clearListeners"></a><a href="Ext.selection.Model.html#" rel="method-clearListeners" class="cls expand">clearListeners</a> : void</div><div class="description"><div class="short"><p>Removes all listeners for this object including the managed listeners</p>
198 </div><div class="long"><p>Removes all listeners for this object including the managed listeners</p>
199 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
200 </li></ul></div></div></div><div id="method-clearManagedListeners" class="member inherited"><a href="Ext.selection.Model.html#method-clearManagedListeners" rel="method-clearManagedListeners" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-clearManagedListeners" class="viewSource">view source</a></div><a name="clearManagedListeners"></a><a name="method-clearManagedListeners"></a><a href="Ext.selection.Model.html#" rel="method-clearManagedListeners" class="cls expand">clearManagedListeners</a> : void</div><div class="description"><div class="short"><p>Removes all managed listeners for this object.</p>
201 </div><div class="long"><p>Removes all managed listeners for this object.</p>
202 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
203 </li></ul></div></div></div><div id="method-deselect" class="member ni"><a href="Ext.selection.Model.html#method-deselect" rel="method-deselect" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-method-deselect" class="viewSource">view source</a></div><a name="deselect"></a><a name="method-deselect"></a><a href="Ext.selection.Model.html#" rel="method-deselect" class="cls expand">deselect</a>(
204 <span class="pre">Ext.data.Model/Index records, Boolean suppressEvent</span>)
205  : void</div><div class="description"><div class="short"><p>Deselects a record instance by record instance or index.</p>
206 </div><div class="long"><p>Deselects a record instance by record instance or index.</p>
207 <h3 class="pa">Parameters</h3><ul><li><span class="pre">records</span> : Ext.data.Model/Index<div class="sub-desc"><p>An array of records or an index</p>
208 </div></li><li><span class="pre">suppressEvent</span> : Boolean<div class="sub-desc"><p>Set to false to not fire a deselect event</p>
209 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
210 </li></ul></div></div></div><div id="method-enableBubble" class="member inherited"><a href="Ext.selection.Model.html#method-enableBubble" rel="method-enableBubble" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-enableBubble" class="viewSource">view source</a></div><a name="enableBubble"></a><a name="method-enableBubble"></a><a href="Ext.selection.Model.html#" rel="method-enableBubble" class="cls expand">enableBubble</a>(
211 <span class="pre">String/Array events</span>)
212  : void</div><div class="description"><div class="short">Enables events fired by this Observable to bubble up an owner hierarchy by calling
213 this.getBubbleTarget() if present....</div><div class="long"><p>Enables events fired by this Observable to bubble up an owner hierarchy by calling
214 <code>this.getBubbleTarget()</code> if present. There is no implementation in the Observable base class.</p>
215
216
217 <p>This is commonly used by Ext.Components to bubble events to owner Containers. See <a href="Ext.Component.html#getBubbleTarget" rel="Ext.Component#getBubbleTarget" class="docClass">Ext.Component.getBubbleTarget</a>. The default
218 implementation in <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a> returns the Component's immediate owner. But if a known target is required, this can be overridden to
219 access the required target more quickly.</p>
220
221
222 <p>Example:</p>
223
224
225 <pre><code>Ext.override(Ext.form.field.Base, {
226 //  Add functionality to Field&#39;s initComponent to enable the change event to bubble
227 initComponent : Ext.Function.createSequence(Ext.form.field.Base.prototype.initComponent, function() {
228     this.enableBubble('change');
229 }),
230
231 //  We know that we want Field&#39;s events to bubble directly to the FormPanel.
232 getBubbleTarget : function() {
233     if (!this.formPanel) {
234         this.formPanel = this.findParentByType('form');
235     }
236     return this.formPanel;
237 }
238 });
239
240 var myForm = new Ext.formPanel({
241 title: 'User Details',
242 items: [{
243     ...
244 }],
245 listeners: {
246     change: function() {
247         // Title goes red if form has been modified.
248         myForm.header.setStyle('color', 'red');
249     }
250 }
251 });
252 </code></pre>
253
254 <h3 class="pa">Parameters</h3><ul><li><span class="pre">events</span> : String/Array<div class="sub-desc"><p>The event name to bubble, or an Array of event names.</p>
255 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
256 </li></ul></div></div></div><div id="method-fireEvent" class="member inherited"><a href="Ext.selection.Model.html#method-fireEvent" rel="method-fireEvent" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-fireEvent" class="viewSource">view source</a></div><a name="fireEvent"></a><a name="method-fireEvent"></a><a href="Ext.selection.Model.html#" rel="method-fireEvent" class="cls expand">fireEvent</a>(
257 <span class="pre">String eventName, Object... args</span>)
258  : Boolean</div><div class="description"><div class="short">Fires the specified event with the passed parameters (minus the event name).
259
260
261 An event may be set to bubble up an Ob...</div><div class="long"><p>Fires the specified event with the passed parameters (minus the event name).</p>
262
263
264 <p>An event may be set to bubble up an Observable parent hierarchy (See <a href="Ext.Component.html#getBubbleTarget" rel="Ext.Component#getBubbleTarget" class="docClass">Ext.Component.getBubbleTarget</a>)
265 by calling <a href="Ext.selection.Model.html#enableBubble" rel="Ext.selection.Model#enableBubble" class="docClass">enableBubble</a>.</p>
266
267 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The name of the event to fire.</p>
268 </div></li><li><span class="pre">args</span> : Object...<div class="sub-desc"><p>Variable number of parameters are passed to handlers.</p>
269 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>returns false if any of the handlers return false otherwise it returns true.</p>
270 </li></ul></div></div></div><div id="method-getLastSelected" class="member ni"><a href="Ext.selection.Model.html#method-getLastSelected" rel="method-getLastSelected" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-method-getLastSelected" class="viewSource">view source</a></div><a name="getLastSelected"></a><a name="method-getLastSelected"></a><a href="Ext.selection.Model.html#" rel="method-getLastSelected" class="cls expand">getLastSelected</a> : void</div><div class="description"><div class="short"><p>Returns the last selected record.</p>
271 </div><div class="long"><p>Returns the last selected record.</p>
272 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
273 </li></ul></div></div></div><div id="method-getSelection" class="member ni"><a href="Ext.selection.Model.html#method-getSelection" rel="method-getSelection" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-method-getSelection" class="viewSource">view source</a></div><a name="getSelection"></a><a name="method-getSelection"></a><a href="Ext.selection.Model.html#" rel="method-getSelection" class="cls expand">getSelection</a> : void</div><div class="description"><div class="short"><p>Returns an array of the currently selected records.</p>
274 </div><div class="long"><p>Returns an array of the currently selected records.</p>
275 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
276 </li></ul></div></div></div><div id="method-getSelectionMode" class="member ni"><a href="Ext.selection.Model.html#method-getSelectionMode" rel="method-getSelectionMode" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-method-getSelectionMode" class="viewSource">view source</a></div><a name="getSelectionMode"></a><a name="method-getSelectionMode"></a><a href="Ext.selection.Model.html#" rel="method-getSelectionMode" class="cls expand">getSelectionMode</a> : void</div><div class="description"><div class="short"><p>Returns the current selectionMode. SINGLE, MULTI or SIMPLE.</p>
277 </div><div class="long"><p>Returns the current selectionMode. SINGLE, MULTI or SIMPLE.</p>
278 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
279 </li></ul></div></div></div><div id="method-hasListener" class="member inherited"><a href="Ext.selection.Model.html#method-hasListener" rel="method-hasListener" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-hasListener" class="viewSource">view source</a></div><a name="hasListener"></a><a name="method-hasListener"></a><a href="Ext.selection.Model.html#" rel="method-hasListener" class="cls expand">hasListener</a>(
280 <span class="pre">String eventName</span>)
281  : Boolean</div><div class="description"><div class="short"><p>Checks to see if this object has any listeners for a specified event</p>
282 </div><div class="long"><p>Checks to see if this object has any listeners for a specified event</p>
283 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The name of the event to check for</p>
284 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if the event is being listened for, else false</p>
285 </li></ul></div></div></div><div id="method-hasSelection" class="member ni"><a href="Ext.selection.Model.html#method-hasSelection" rel="method-hasSelection" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-method-hasSelection" class="viewSource">view source</a></div><a name="hasSelection"></a><a name="method-hasSelection"></a><a href="Ext.selection.Model.html#" rel="method-hasSelection" class="cls expand">hasSelection</a> : Boolean</div><div class="description"><div class="short"><p>Returns true if there is a selected record.</p>
286 </div><div class="long"><p>Returns true if there is a selected record.</p>
287 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;
288 </li></ul></div></div></div><div id="method-isFocused" class="member ni"><a href="Ext.selection.Model.html#method-isFocused" rel="method-isFocused" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-method-isFocused" class="viewSource">view source</a></div><a name="isFocused"></a><a name="method-isFocused"></a><a href="Ext.selection.Model.html#" rel="method-isFocused" class="cls expand">isFocused</a>(
289 <span class="pre">Object Ext</span>)
290  : void</div><div class="description"><div class="short"><p>Determines if this record is currently focused.</p>
291 </div><div class="long"><p>Determines if this record is currently focused.</p>
292 <h3 class="pa">Parameters</h3><ul><li><span class="pre">Ext</span> : Object<div class="sub-desc"><p>.data.Record record</p>
293 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
294 </li></ul></div></div></div><div id="method-isLocked" class="member ni"><a href="Ext.selection.Model.html#method-isLocked" rel="method-isLocked" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-method-isLocked" class="viewSource">view source</a></div><a name="isLocked"></a><a name="method-isLocked"></a><a href="Ext.selection.Model.html#" rel="method-isLocked" class="cls expand">isLocked</a> : Boolean</div><div class="description"><div class="short"><p>Returns true if the selections are locked.</p>
295 </div><div class="long"><p>Returns true if the selections are locked.</p>
296 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;
297 </li></ul></div></div></div><div id="method-isSelected" class="member ni"><a href="Ext.selection.Model.html#method-isSelected" rel="method-isSelected" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-method-isSelected" class="viewSource">view source</a></div><a name="isSelected"></a><a name="method-isSelected"></a><a href="Ext.selection.Model.html#" rel="method-isSelected" class="cls expand">isSelected</a>(
298 <span class="pre">Record/Number record</span>)
299  : Boolean</div><div class="description"><div class="short"><p>Returns <tt>true</tt> if the specified row is selected.</p>
300 </div><div class="long"><p>Returns <tt>true</tt> if the specified row is selected.</p>
301 <h3 class="pa">Parameters</h3><ul><li><span class="pre">record</span> : Record/Number<div class="sub-desc"><p>The record or index of the record to check</p>
302 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;
303 </li></ul></div></div></div><div id="method-observe" class="member inherited"><a href="Ext.selection.Model.html#method-observe" rel="method-observe" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-observe" class="viewSource">view source</a></div><a name="observe"></a><a name="method-observe"></a><a href="Ext.selection.Model.html#" rel="method-observe" class="cls expand">observe</a>(
304 <span class="pre">Function c, Object listeners</span>)
305  : void</div><div class="description"><div class="short">Sets observability on the passed class constructor.
306
307 This makes any event fired on any instance of the passed class a...</div><div class="long"><p>Sets observability on the passed class constructor.</p>
308
309 <p>This makes any event fired on any instance of the passed class also fire a single event through
310 the <strong>class</strong> allowing for central handling of events on many instances at once.</p>
311
312 <p>Usage:</p>
313
314 <pre><code>Ext.util.Observable.observe(Ext.data.Connection);
315 Ext.data.Connection.on('beforerequest', function(con, options) {
316     console.log('Ajax request made to ' + options.url);
317 });
318 </code></pre>
319 <h3 class="pa">Parameters</h3><ul><li><span class="pre">c</span> : Function<div class="sub-desc"><p>The class constructor to make observable.</p>
320 </div></li><li><span class="pre">listeners</span> : Object<div class="sub-desc"><p>An object containing a series of listeners to add. See <a href="Ext.selection.Model.html#addListener" rel="Ext.selection.Model#addListener" class="docClass">addListener</a>.</p>
321 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
322 </li></ul></div></div></div><div id="method-on" class="member inherited"><a href="Ext.selection.Model.html#method-on" rel="method-on" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-on" class="viewSource">view source</a></div><a name="on"></a><a name="method-on"></a><a href="Ext.selection.Model.html#" rel="method-on" class="cls expand">on</a>(
323 <span class="pre">String eventName, Function handler, [Object scope], [Object options]</span>)
324  : void</div><div class="description"><div class="short"><p>Appends an event handler to this object (shorthand for <a href="Ext.selection.Model.html#addListener" rel="Ext.selection.Model#addListener" class="docClass">addListener</a>.)</p>
325 </div><div class="long"><p>Appends an event handler to this object (shorthand for <a href="Ext.selection.Model.html#addListener" rel="Ext.selection.Model#addListener" class="docClass">addListener</a>.)</p>
326 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The type of event to listen for</p>
327 </div></li><li><span class="pre">handler</span> : Function<div class="sub-desc"><p>The method the event invokes</p>
328 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope (<code><b>this</b></code> reference) in which the handler function is executed.
329 <b>If omitted, defaults to the object which fired the event.</b></p>
330 </div></li><li><span class="pre">options</span> : Object<div class="sub-desc"><p>(optional) An object containing handler configuration.</p>
331 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
332 </li></ul></div></div></div><div id="method-relayEvents" class="member inherited"><a href="Ext.selection.Model.html#method-relayEvents" rel="method-relayEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-relayEvents" class="viewSource">view source</a></div><a name="relayEvents"></a><a name="method-relayEvents"></a><a href="Ext.selection.Model.html#" rel="method-relayEvents" class="cls expand">relayEvents</a>(
333 <span class="pre">Object origin, Array events, Object prefix</span>)
334  : void</div><div class="description"><div class="short"><p>Relays selected events from the specified Observable as if the events were fired by <code><b>this</b></code>.</p>
335 </div><div class="long"><p>Relays selected events from the specified Observable as if the events were fired by <code><b>this</b></code>.</p>
336 <h3 class="pa">Parameters</h3><ul><li><span class="pre">origin</span> : Object<div class="sub-desc"><p>The Observable whose events this object is to relay.</p>
337 </div></li><li><span class="pre">events</span> : Array<div class="sub-desc"><p>Array of event names to relay.</p>
338 </div></li><li><span class="pre">prefix</span> : Object<div class="sub-desc">
339 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
340 </li></ul></div></div></div><div id="method-releaseCapture" class="member inherited"><a href="Ext.selection.Model.html#method-releaseCapture" rel="method-releaseCapture" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-releaseCapture" class="viewSource">view source</a></div><a name="releaseCapture"></a><a name="method-releaseCapture"></a><a href="Ext.selection.Model.html#" rel="method-releaseCapture" class="cls expand">releaseCapture</a>(
341 <span class="pre">Observable o</span>)
342  : void</div><div class="description"><div class="short"><p>Removes <b>all</b> added captures from the Observable.</p>
343 </div><div class="long"><p>Removes <b>all</b> added captures from the Observable.</p>
344 <h3 class="pa">Parameters</h3><ul><li><span class="pre">o</span> : Observable<div class="sub-desc"><p>The Observable to release</p>
345 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
346 </li></ul></div></div></div><div id="method-removeListener" class="member inherited"><a href="Ext.selection.Model.html#method-removeListener" rel="method-removeListener" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-removeListener" class="viewSource">view source</a></div><a name="removeListener"></a><a name="method-removeListener"></a><a href="Ext.selection.Model.html#" rel="method-removeListener" class="cls expand">removeListener</a>(
347 <span class="pre">String eventName, Function handler, [Object scope]</span>)
348  : void</div><div class="description"><div class="short"><p>Removes an event handler.</p>
349 </div><div class="long"><p>Removes an event handler.</p>
350 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The type of event the handler was associated with.</p>
351 </div></li><li><span class="pre">handler</span> : Function<div class="sub-desc"><p>The handler to remove. <b>This must be a reference to the function passed into the <a href="Ext.selection.Model.html#addListener" rel="Ext.selection.Model#addListener" class="docClass">addListener</a> call.</b></p>
352 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope originally specified for the handler.</p>
353 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
354 </li></ul></div></div></div><div id="method-removeManagedListener" class="member inherited"><a href="Ext.selection.Model.html#method-removeManagedListener" rel="method-removeManagedListener" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-removeManagedListener" class="viewSource">view source</a></div><a name="removeManagedListener"></a><a name="method-removeManagedListener"></a><a href="Ext.selection.Model.html#" rel="method-removeManagedListener" class="cls expand">removeManagedListener</a>(
355 <span class="pre">Observable|Element item, Object|String ename, Function fn, Object scope</span>)
356  : void</div><div class="description"><div class="short"><p>Removes listeners that were added by the <a href="Ext.selection.Model.html#mon" rel="Ext.selection.Model#mon" class="docClass">mon</a> method.</p>
357 </div><div class="long"><p>Removes listeners that were added by the <a href="Ext.selection.Model.html#mon" rel="Ext.selection.Model#mon" class="docClass">mon</a> method.</p>
358 <h3 class="pa">Parameters</h3><ul><li><span class="pre">item</span> : Observable|Element<div class="sub-desc"><p>The item from which to remove a listener/listeners.</p>
359 </div></li><li><span class="pre">ename</span> : Object|String<div class="sub-desc"><p>The event name, or an object containing event name properties.</p>
360 </div></li><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>Optional. If the <code>ename</code> parameter was an event name, this
361 is the handler function.</p>
362 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>Optional. If the <code>ename</code> parameter was an event name, this
363 is the scope (<code>this</code> reference) in which the handler function is executed.</p>
364 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
365 </li></ul></div></div></div><div id="method-resumeEvents" class="member inherited"><a href="Ext.selection.Model.html#method-resumeEvents" rel="method-resumeEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-resumeEvents" class="viewSource">view source</a></div><a name="resumeEvents"></a><a name="method-resumeEvents"></a><a href="Ext.selection.Model.html#" rel="method-resumeEvents" class="cls expand">resumeEvents</a> : void</div><div class="description"><div class="short">Resume firing events. (see suspendEvents)
366 If events were suspended using the queueSuspended parameter, then all
367 event...</div><div class="long"><p>Resume firing events. (see <a href="Ext.selection.Model.html#suspendEvents" rel="Ext.selection.Model#suspendEvents" class="docClass">suspendEvents</a>)
368 If events were suspended using the <code><b>queueSuspended</b></code> parameter, then all
369 events fired during event suspension will be sent to any listeners now.</p>
370 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
371 </li></ul></div></div></div><div id="method-select" class="member ni"><a href="Ext.selection.Model.html#method-select" rel="method-select" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-method-select" class="viewSource">view source</a></div><a name="select"></a><a name="method-select"></a><a href="Ext.selection.Model.html#" rel="method-select" class="cls expand">select</a>(
372 <span class="pre">Ext.data.Model/Index records, Boolean keepExisting, Boolean suppressEvent</span>)
373  : void</div><div class="description"><div class="short"><p>Selects a record instance by record instance or index.</p>
374 </div><div class="long"><p>Selects a record instance by record instance or index.</p>
375 <h3 class="pa">Parameters</h3><ul><li><span class="pre">records</span> : Ext.data.Model/Index<div class="sub-desc"><p>An array of records or an index</p>
376 </div></li><li><span class="pre">keepExisting</span> : Boolean<div class="sub-desc">
377 </div></li><li><span class="pre">suppressEvent</span> : Boolean<div class="sub-desc"><p>Set to false to not fire a select event</p>
378 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
379 </li></ul></div></div></div><div id="method-selectRange" class="member ni"><a href="Ext.selection.Model.html#method-selectRange" rel="method-selectRange" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-method-selectRange" class="viewSource">view source</a></div><a name="selectRange"></a><a name="method-selectRange"></a><a href="Ext.selection.Model.html#" rel="method-selectRange" class="cls expand">selectRange</a>(
380 <span class="pre">Ext.data.Model/Number startRow, Ext.data.Model/Number endRow, [Boolean keepExisting], Object dir</span>)
381  : void</div><div class="description"><div class="short">Selects a range of rows if the selection model is not locked.
382 All rows in between startRow and endRow are also select...</div><div class="long"><p>Selects a range of rows if the selection model <a href="Ext.selection.Model.html#isLocked" rel="Ext.selection.Model#isLocked" class="docClass">is not locked</a>.
383 All rows in between startRow and endRow are also selected.</p>
384 <h3 class="pa">Parameters</h3><ul><li><span class="pre">startRow</span> : Ext.data.Model/Number<div class="sub-desc"><p>The record or index of the first row in the range</p>
385 </div></li><li><span class="pre">endRow</span> : Ext.data.Model/Number<div class="sub-desc"><p>The record or index of the last row in the range</p>
386 </div></li><li><span class="pre">keepExisting</span> : Boolean<div class="sub-desc"><p>(optional) True to retain existing selections</p>
387 </div></li><li><span class="pre">dir</span> : Object<div class="sub-desc">
388 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
389 </li></ul></div></div></div><div id="method-setLastFocused" class="member ni"><a href="Ext.selection.Model.html#method-setLastFocused" rel="method-setLastFocused" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-method-setLastFocused" class="viewSource">view source</a></div><a name="setLastFocused"></a><a name="method-setLastFocused"></a><a href="Ext.selection.Model.html#" rel="method-setLastFocused" class="cls expand">setLastFocused</a>(
390 <span class="pre">Ext.data.Model record, Object supressFocus</span>)
391  : void</div><div class="description"><div class="short"><p>&nbsp;</p></div><div class="long">
392 <h3 class="pa">Parameters</h3><ul><li><span class="pre">record</span> : Ext.data.Model<div class="sub-desc"><p>Set a record as the last focused record. This does NOT mean
393 that the record has been selected.</p>
394 </div></li><li><span class="pre">supressFocus</span> : Object<div class="sub-desc">
395 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
396 </li></ul></div></div></div><div id="method-setLocked" class="member ni"><a href="Ext.selection.Model.html#method-setLocked" rel="method-setLocked" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-method-setLocked" class="viewSource">view source</a></div><a name="setLocked"></a><a name="method-setLocked"></a><a href="Ext.selection.Model.html#" rel="method-setLocked" class="cls expand">setLocked</a>(
397 <span class="pre">Boolean locked</span>)
398  : void</div><div class="description"><div class="short"><p>Locks the current selection and disables any changes from
399 happening to the selection.</p>
400 </div><div class="long"><p>Locks the current selection and disables any changes from
401 happening to the selection.</p>
402 <h3 class="pa">Parameters</h3><ul><li><span class="pre">locked</span> : Boolean<div class="sub-desc">
403 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
404 </li></ul></div></div></div><div id="method-setSelectionMode" class="member ni"><a href="Ext.selection.Model.html#method-setSelectionMode" rel="method-setSelectionMode" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-method-setSelectionMode" class="viewSource">view source</a></div><a name="setSelectionMode"></a><a name="method-setSelectionMode"></a><a href="Ext.selection.Model.html#" rel="method-setSelectionMode" class="cls expand">setSelectionMode</a>(
405 <span class="pre">Object selMode</span>)
406  : void</div><div class="description"><div class="short"><p>Sets the current selectionMode. SINGLE, MULTI or SIMPLE.</p>
407 </div><div class="long"><p>Sets the current selectionMode. SINGLE, MULTI or SIMPLE.</p>
408 <h3 class="pa">Parameters</h3><ul><li><span class="pre">selMode</span> : Object<div class="sub-desc">
409 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
410 </li></ul></div></div></div><div id="method-suspendEvents" class="member inherited"><a href="Ext.selection.Model.html#method-suspendEvents" rel="method-suspendEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-suspendEvents" class="viewSource">view source</a></div><a name="suspendEvents"></a><a name="method-suspendEvents"></a><a href="Ext.selection.Model.html#" rel="method-suspendEvents" class="cls expand">suspendEvents</a>(
411 <span class="pre">Boolean queueSuspended</span>)
412  : void</div><div class="description"><div class="short"><p>Suspend the firing of all events. (see <a href="Ext.selection.Model.html#resumeEvents" rel="Ext.selection.Model#resumeEvents" class="docClass">resumeEvents</a>)</p>
413 </div><div class="long"><p>Suspend the firing of all events. (see <a href="Ext.selection.Model.html#resumeEvents" rel="Ext.selection.Model#resumeEvents" class="docClass">resumeEvents</a>)</p>
414 <h3 class="pa">Parameters</h3><ul><li><span class="pre">queueSuspended</span> : Boolean<div class="sub-desc"><p>Pass as true to queue up suspended events to be fired
415 after the <a href="Ext.selection.Model.html#resumeEvents" rel="Ext.selection.Model#resumeEvents" class="docClass">resumeEvents</a> call instead of discarding all suspended events;</p>
416 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
417 </li></ul></div></div></div><div id="method-un" class="member inherited"><a href="Ext.selection.Model.html#method-un" rel="method-un" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-un" class="viewSource">view source</a></div><a name="un"></a><a name="method-un"></a><a href="Ext.selection.Model.html#" rel="method-un" class="cls expand">un</a>(
418 <span class="pre">String eventName, Function handler, [Object scope]</span>)
419  : void</div><div class="description"><div class="short"><p>Removes an event handler (shorthand for <a href="Ext.selection.Model.html#removeListener" rel="Ext.selection.Model#removeListener" class="docClass">removeListener</a>.)</p>
420 </div><div class="long"><p>Removes an event handler (shorthand for <a href="Ext.selection.Model.html#removeListener" rel="Ext.selection.Model#removeListener" class="docClass">removeListener</a>.)</p>
421 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The type of event the handler was associated with.</p>
422 </div></li><li><span class="pre">handler</span> : Function<div class="sub-desc"><p>The handler to remove. <b>This must be a reference to the function passed into the <a href="Ext.selection.Model.html#addListener" rel="Ext.selection.Model#addListener" class="docClass">addListener</a> call.</b></p>
423 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope originally specified for the handler.</p>
424 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
425 </li></ul></div></div></div></div><div class="m-events"><a name="events"></a><div class="definedBy">Defined By</div><h3 class="evt p">Events</h3><div id="event-selectionchange" class="member f ni"><a href="Ext.selection.Model.html#event-selectionchange" rel="event-selectionchange" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.selection.Model.html" class="definedIn docClass">Ext.selection.Model</a><br/><a href="../source/Model2.html#Ext-selection.Model-event-selectionchange" class="viewSource">view source</a></div><a name="selectionchange"></a><a name="event-selectionchange"></a><a href="Ext.selection.Model.html#" rel="event-selectionchange" class="cls expand">selectionchange</a>(
426 <span class="pre">Ext.selection.Model this, Array selected</span>)
427 </div><div class="description"><div class="short"><p>Fired after a selection change has occurred</p>
428 </div><div class="long"><p>Fired after a selection change has occurred</p>
429 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.selection.Model<div class="sub-desc">
430 </div></li><li><span class="pre">selected</span> : Array<div class="sub-desc"><p>The selected records</p>
431 </div></li></ul></div></div></div></div></div></div></div><div id="pageContent"></div></div></div></div></body></html>