Upgrade to ExtJS 3.3.1 - Released 11/30/2010
[extjs.git] / docs / output / Ext.grid.NumberColumn.html
1 <div class="body-wrap" xmlns:ext="http://www.extjs.com"><div class="top-tools"><a class="inner-link" href="#Ext.grid.NumberColumn-props"><img src="resources/images/default/s.gif" class="item-icon icon-prop">Properties</a>&#13;<a class="inner-link" href="#Ext.grid.NumberColumn-methods"><img src="resources/images/default/s.gif" class="item-icon icon-method">Methods</a>&#13;<a class="inner-link" href="#Ext.grid.NumberColumn-events"><img src="resources/images/default/s.gif" class="item-icon icon-event">Events</a>&#13;<a class="inner-link" href="#Ext.grid.NumberColumn-configs"><img src="resources/images/default/s.gif" class="item-icon icon-config">Config Options</a>&#13;<a class="bookmark" href="../docs/?class=Ext.grid.NumberColumn"><img src="resources/images/default/s.gif" class="item-icon icon-fav">Direct Link</a>&#13;</div><div class="inheritance res-block"><pre class="res-block-inner"><a href="output/Ext.grid.Column.html" ext:member="" ext:cls="Ext.grid.Column">Column</a>
2   <img src="resources/elbow-end.gif">NumberColumn</pre></div><h1>Class <a href="source/Column.html#cls-Ext.grid.NumberColumn">Ext.grid.NumberColumn</a></h1><table cellspacing="0"><tr><td class="label">Package:</td><td class="hd-info">Ext.grid</td></tr><tr><td class="label">Defined In:</td><td class="hd-info"><a href="source/Column.html#cls-Ext.grid.NumberColumn">Column.js</a></td></tr><tr><td class="label">Class:</td><td class="hd-info"><a href="source/Column.html#cls-Ext.grid.NumberColumn">NumberColumn</a></td></tr><tr><td class="label">Extends:</td><td class="hd-info"><a href="output/Ext.grid.Column.html" ext:cls="Ext.grid.Column" ext:member="">Column</a></td></tr></table><div class="description"><p>A Column definition class which renders a numeric data field according to a <a href="output/Ext.grid.NumberColumn.html#Ext.grid.NumberColumn-format" ext:member="format" ext:cls="Ext.grid.NumberColumn">format</a> string.  See the
3 <a href="output/Ext.grid.Column.html#Ext.grid.Column-xtype" ext:member="xtype" ext:cls="Ext.grid.Column">xtype</a> config option of <a href="output/Ext.grid.Column.html" ext:cls="Ext.grid.Column">Ext.grid.Column</a> for more details.</p></div><div class="hr"></div><a id="Ext.grid.NumberColumn-configs"></a><h2>Config Options</h2><table cellspacing="0" class="member-table"><tbody><tr><th colspan="2" class="sig-header">Config Options</th><th class="msource-header">Defined By</th></tr><tr class="config-row  inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-align"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-align">align</a></b> : String<div class="mdesc">Optional. Set the CSS text-align property of the column.  Defaults to undefined.</div></td><td class="msource"><a href="output/Ext.grid.Column.html#align" ext:member="#align" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-css"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-css">css</a></b> : String<div class="mdesc"><div class="short">Optional. An inline style definition string which is applied to all table cells in the column
4 (excluding headers). De...</div><div class="long">Optional. An inline style definition string which is applied to all table cells in the column
5 (excluding headers). Defaults to undefined.</div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#css" ext:member="#css" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-dataIndex"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-dataIndex">dataIndex</a></b> : String<div class="mdesc"><div class="short">Required. The name of the field in the
6 grid's Ext.data.Store's Ext.data.Record definition from
7 which to draw the colu...</div><div class="long"><p><b>Required</b>. The name of the field in the
8 grid's <a href="output/Ext.data.Store.html" ext:cls="Ext.data.Store">Ext.data.Store</a>'s <a href="output/Ext.data.Record.html" ext:cls="Ext.data.Record">Ext.data.Record</a> definition from
9 which to draw the column's value.</p></div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#dataIndex" ext:member="#dataIndex" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-editable"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-editable">editable</a></b> : Boolean<div class="mdesc"><div class="short">Optional. Defaults to true, enabling the configured
10 editor.  Set to false to initially disable editing on this column...</div><div class="long">Optional. Defaults to <tt>true</tt>, enabling the configured
11 <tt><a href="output/Ext.grid.Column.html#Ext.grid.Column-editor" ext:member="editor" ext:cls="Ext.grid.Column">editor</a></tt>.  Set to <tt>false</tt> to initially disable editing on this column.
12 The initial configuration may be dynamically altered using
13 <a href="output/Ext.grid.ColumnModel.html" ext:cls="Ext.grid.ColumnModel">Ext.grid.ColumnModel</a>.<a href="output/Ext.grid.ColumnModel.html#Ext.grid.ColumnModel-setEditable" ext:member="setEditable" ext:cls="Ext.grid.ColumnModel">setEditable()</a>.</div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#editable" ext:member="#editable" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-editor"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-editor">editor</a></b> : Ext.form.Field<div class="mdesc"><div class="short">Optional. The Ext.form.Field to use when editing values in this column
14 if editing is supported by the grid. See edita...</div><div class="long">Optional. The <a href="output/Ext.form.Field.html" ext:cls="Ext.form.Field">Ext.form.Field</a> to use when editing values in this column
15 if editing is supported by the grid. See <tt><a href="output/Ext.grid.Column.html#Ext.grid.Column-editable" ext:member="editable" ext:cls="Ext.grid.Column">editable</a></tt> also.</div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#editor" ext:member="#editor" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-emptyGroupText"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-emptyGroupText">emptyGroupText</a></b> : String<div class="mdesc"><div class="short">Optional. If the grid is being rendered by an Ext.grid.GroupingView, this option
16 may be used to specify the text to d...</div><div class="long">Optional. If the grid is being rendered by an <a href="output/Ext.grid.GroupingView.html" ext:cls="Ext.grid.GroupingView">Ext.grid.GroupingView</a>, this option
17 may be used to specify the text to display when there is an empty group value. Defaults to the
18 <a href="output/Ext.grid.GroupingView.html" ext:cls="Ext.grid.GroupingView">Ext.grid.GroupingView</a>.<a href="output/Ext.grid.GroupingView.html#Ext.grid.GroupingView-emptyGroupText" ext:member="emptyGroupText" ext:cls="Ext.grid.GroupingView">emptyGroupText</a>.</div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#emptyGroupText" ext:member="#emptyGroupText" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row  inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-fixed"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-fixed">fixed</a></b> : Boolean<div class="mdesc">Optional. <tt>true</tt> if the column width cannot be changed.  Defaults to <tt>false</tt>.</div></td><td class="msource"><a href="output/Ext.grid.Column.html#fixed" ext:member="#fixed" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.NumberColumn-format"></a><b><a href="source/Column.html#cfg-Ext.grid.NumberColumn-format">format</a></b> : String<div class="mdesc"><div class="short">A formatting string as used by Ext.util.Format.number to format a numeric value for this Column
19 (defaults to '0,000.0...</div><div class="long">A formatting string as used by <a href="output/Ext.util.Format.html#Ext.util.Format-number" ext:member="number" ext:cls="Ext.util.Format">Ext.util.Format.number</a> to format a numeric value for this Column
20 (defaults to <tt>'0,000.00'</tt>).</div></div></td><td class="msource">NumberColumn</td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-groupName"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-groupName">groupName</a></b> : String<div class="mdesc"><div class="short">Optional. If the grid is being rendered by an Ext.grid.GroupingView, this option
21 may be used to specify the text with...</div><div class="long">Optional. If the grid is being rendered by an <a href="output/Ext.grid.GroupingView.html" ext:cls="Ext.grid.GroupingView">Ext.grid.GroupingView</a>, this option
22 may be used to specify the text with which to prefix the group field value in the group header line.
23 See also <a href="output/Ext.grid.Column.html#Ext.grid.Column-groupRenderer" ext:member="groupRenderer" ext:cls="Ext.grid.Column">groupRenderer</a> and
24 <a href="output/Ext.grid.GroupingView.html" ext:cls="Ext.grid.GroupingView">Ext.grid.GroupingView</a>.<a href="output/Ext.grid.GroupingView.html#Ext.grid.GroupingView-showGroupName" ext:member="showGroupName" ext:cls="Ext.grid.GroupingView">showGroupName</a>.</div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#groupName" ext:member="#groupName" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-groupRenderer"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-groupRenderer">groupRenderer</a></b> : Function<div class="mdesc"><div class="short">Optional. If the grid is being rendered by an Ext.grid.GroupingView, this option
25 may be used to specify the function ...</div><div class="long"><p>Optional. If the grid is being rendered by an <a href="output/Ext.grid.GroupingView.html" ext:cls="Ext.grid.GroupingView">Ext.grid.GroupingView</a>, this option
26 may be used to specify the function used to format the grouping field value for display in the group
27 <a href="output/Ext.grid.Column.html#Ext.grid.Column-groupName" ext:member="groupName" ext:cls="Ext.grid.Column">header</a>.  If a <tt><b>groupRenderer</b></tt> is not specified, the configured
28 <tt><b><a href="output/Ext.grid.Column.html#Ext.grid.Column-renderer" ext:member="renderer" ext:cls="Ext.grid.Column">renderer</a></b></tt> will be called; if a <tt><b><a href="output/Ext.grid.Column.html#Ext.grid.Column-renderer" ext:member="renderer" ext:cls="Ext.grid.Column">renderer</a></b></tt> is also not specified
29 the new value of the group field will be used.</p>
30 <p>The called function (either the <tt><b>groupRenderer</b></tt> or <tt><b><a href="output/Ext.grid.Column.html#Ext.grid.Column-renderer" ext:member="renderer" ext:cls="Ext.grid.Column">renderer</a></b></tt>) will be
31 passed the following parameters:
32 <div class="mdetail-params"><ul>
33 <li><b>v</b> : Object<p class="sub-desc">The new value of the group field.</p></li>
34 <li><b>unused</b> : undefined<p class="sub-desc">Unused parameter.</p></li>
35 <li><b>r</b> : Ext.data.Record<p class="sub-desc">The Record providing the data
36 for the row which caused group change.</p></li>
37 <li><b>rowIndex</b> : Number<p class="sub-desc">The row index of the Record which caused group change.</p></li>
38 <li><b>colIndex</b> : Number<p class="sub-desc">The column index of the group field.</p></li>
39 <li><b>ds</b> : Ext.data.Store<p class="sub-desc">The Store which is providing the data Model.</p></li>
40 </ul></div></p>
41 <p>The function should return a string value.</p></div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#groupRenderer" ext:member="#groupRenderer" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-groupable"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-groupable">groupable</a></b> : Boolean<div class="mdesc"><div class="short">Optional. If the grid is being rendered by an Ext.grid.GroupingView, this option
42 may be used to disable the header me...</div><div class="long">Optional. If the grid is being rendered by an <a href="output/Ext.grid.GroupingView.html" ext:cls="Ext.grid.GroupingView">Ext.grid.GroupingView</a>, this option
43 may be used to disable the header menu item to group by the column selected. Defaults to <tt>true</tt>,
44 which enables the header menu group option.  Set to <tt>false</tt> to disable (but still show) the
45 group option in the header menu for the column. See also <code><a href="output/Ext.grid.Column.html#Ext.grid.Column-groupName" ext:member="groupName" ext:cls="Ext.grid.Column">groupName</a></code>.</div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#groupable" ext:member="#groupable" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-header"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-header">header</a></b> : String<div class="mdesc"><div class="short">Optional. The header text to be used as innerHTML
46 (html tags are accepted) to display in the Grid view.  Note: to
47 hav...</div><div class="long">Optional. The header text to be used as innerHTML
48 (html tags are accepted) to display in the Grid view.  <b>Note</b>: to
49 have a clickable header with no text displayed use <tt>'&amp;#160;'</tt>.</div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#header" ext:member="#header" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-hidden"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-hidden">hidden</a></b> : Boolean<div class="mdesc"><div class="short">Optional. true to initially hide this column. Defaults to false.
50 A hidden column may be shown via the header row menu...</div><div class="long">Optional. <tt>true</tt> to initially hide this column. Defaults to <tt>false</tt>.
51 A hidden column <a href="output/Ext.grid.GridPanel.html#Ext.grid.GridPanel-enableColumnHide" ext:member="enableColumnHide" ext:cls="Ext.grid.GridPanel">may be shown via the header row menu</a>.
52 If a column is never to be shown, simply do not include this column in the Column Model at all.</div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#hidden" ext:member="#hidden" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-hideable"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-hideable">hideable</a></b> : Boolean<div class="mdesc"><div class="short">Optional. Specify as false to prevent the user from hiding this column
53 (defaults to true).  To disallow column hiding...</div><div class="long">Optional. Specify as <tt>false</tt> to prevent the user from hiding this column
54 (defaults to true).  To disallow column hiding globally for all columns in the grid, use
55 <a href="output/Ext.grid.GridPanel.html#Ext.grid.GridPanel-enableColumnHide" ext:member="enableColumnHide" ext:cls="Ext.grid.GridPanel">Ext.grid.GridPanel.enableColumnHide</a> instead.</div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#hideable" ext:member="#hideable" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-id"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-id">id</a></b> : String<div class="mdesc"><div class="short">Optional. A name which identifies this column (defaults to the column's initial
56 ordinal position.) The id is used to ...</div><div class="long">Optional. A name which identifies this column (defaults to the column's initial
57 ordinal position.) The <tt>id</tt> is used to create a CSS <b>class</b> name which is applied to all
58 table cells (including headers) in that column (in this context the <tt>id</tt> does not need to be
59 unique). The class name takes the form of <pre>x-grid3-td-<b>id</b></pre>
60 Header cells will also receive this class name, but will also have the class <pre>x-grid3-hd</pre>
61 So, to target header cells, use CSS selectors such as:<pre>.x-grid3-hd-row .x-grid3-td-<b>id</b></pre>
62 The <a href="output/Ext.grid.GridPanel.html#Ext.grid.GridPanel-autoExpandColumn" ext:member="autoExpandColumn" ext:cls="Ext.grid.GridPanel">Ext.grid.GridPanel.autoExpandColumn</a> grid config option references the column via this
63 unique identifier.</div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#id" ext:member="#id" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row  inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-menuDisabled"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-menuDisabled">menuDisabled</a></b> : Boolean<div class="mdesc">Optional. <tt>true</tt> to disable the column menu. Defaults to <tt>false</tt>.</div></td><td class="msource"><a href="output/Ext.grid.Column.html#menuDisabled" ext:member="#menuDisabled" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-renderer"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-renderer">renderer</a></b> : Mixed<div class="mdesc"><div class="short">For an alternative to specifying a renderer see xtype
64 Optional. A renderer is an 'interceptor' method which can be us...</div><div class="long"><p>For an alternative to specifying a renderer see <code><a href="output/Ext.grid.Column.html#Ext.grid.Column-xtype" ext:member="xtype" ext:cls="Ext.grid.Column">xtype</a></code></p>
65 <p>Optional. A renderer is an 'interceptor' method which can be used transform data (value,
66 appearance, etc.) before it is rendered). This may be specified in either of three ways:
67 <div class="mdetail-params"><ul>
68 <li>A renderer function used to return HTML markup for a cell given the cell's data value.</li>
69 <li>A string which references a property name of the <a href="output/Ext.util.Format.html" ext:cls="Ext.util.Format">Ext.util.Format</a> class which
70 provides a renderer function.</li>
71 <li>An object specifying both the renderer function, and its execution scope (<tt><b>this</b></tt>
72 reference) e.g.:<pre style="margin-left:1.2em"><code>{
73     fn: this.gridRenderer,
74     scope: this
75 }</code></pre></li></ul></div>
76 If not specified, the default renderer uses the raw data value.</p>
77 <p>For information about the renderer function (passed parameters, etc.), see
78 <a href="output/Ext.grid.ColumnModel.html#Ext.grid.ColumnModel-setRenderer" ext:member="setRenderer" ext:cls="Ext.grid.ColumnModel">Ext.grid.ColumnModel.setRenderer</a>. An example of specifying renderer function inline:</p><pre><code><b>var</b> companyColumn = {
79    header: <em>'Company Name'</em>,
80    dataIndex: <em>'company'</em>,
81    renderer: <b>function</b>(value, metaData, record, rowIndex, colIndex, store) {
82       <i>// provide the logic depending on business rules</i>
83       <i>// name of your own choosing to manipulate the cell depending upon</i>
84       <i>// the data <b>in</b> the underlying Record object.</i>
85       <b>if</b> (value == <em>'whatever'</em>) {
86           <i>//metaData.css : String : A CSS class name to add to the TD element of the cell.</i>
87           <i>//metaData.attr : String : An html attribute definition string to apply to</i>
88           <i>//                         the data container element within the table</i>
89           <i>//                         cell (e.g. <em>'style=<em>"color:red;"</em>'</em>).</i>
90           metaData.css = <em>'name-of-css-class-you-will-define'</em>;
91       }
92       <b>return</b> value;
93    }
94 }</code></pre>
95 See also <a href="output/Ext.grid.Column.html#Ext.grid.Column-scope" ext:member="scope" ext:cls="Ext.grid.Column">scope</a>.</div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#renderer" ext:member="#renderer" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row  inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-resizable"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-resizable">resizable</a></b> : Boolean<div class="mdesc">Optional. <tt>false</tt> to disable column resizing. Defaults to <tt>true</tt>.</div></td><td class="msource"><a href="output/Ext.grid.Column.html#resizable" ext:member="#resizable" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row  inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-scope"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-scope">scope</a></b> : Object<div class="mdesc">Optional. The scope (<tt><b>this</b></tt> reference) in which to execute the
96 renderer.  Defaults to the Column configuration object.</div></td><td class="msource"><a href="output/Ext.grid.Column.html#scope" ext:member="#scope" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-sortable"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-sortable">sortable</a></b> : Boolean<div class="mdesc"><div class="short">Optional. true if sorting is to be allowed on this column.
97 Defaults to the value of the Ext.grid.ColumnModel.defaultS...</div><div class="long">Optional. <tt>true</tt> if sorting is to be allowed on this column.
98 Defaults to the value of the <code><a href="output/Ext.grid.ColumnModel.html#Ext.grid.ColumnModel-defaultSortable" ext:member="defaultSortable" ext:cls="Ext.grid.ColumnModel">Ext.grid.ColumnModel.defaultSortable</a></code> property.
99 Whether local/remote sorting is used is specified in <code><a href="output/Ext.data.Store.html#Ext.data.Store-remoteSort" ext:member="remoteSort" ext:cls="Ext.data.Store">Ext.data.Store.remoteSort</a></code>.</div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#sortable" ext:member="#sortable" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-tooltip"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-tooltip">tooltip</a></b> : String<div class="mdesc"><div class="short">Optional. A text string to use as the column header's tooltip.  If Quicktips
100 are enabled, this value will be used as ...</div><div class="long">Optional. A text string to use as the column header's tooltip.  If Quicktips
101 are enabled, this value will be used as the text of the quick tip, otherwise it will be set as the
102 header's HTML title attribute. Defaults to ''.</div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#tooltip" ext:member="#tooltip" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-width"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-width">width</a></b> : Number<div class="mdesc"><div class="short">Optional. The initial width in pixels of the column.
103 The width of each column can also be affected if any of the foll...</div><div class="long">Optional. The initial width in pixels of the column.
104 The width of each column can also be affected if any of the following are configured:
105 <div class="mdetail-params"><ul>
106 <li><a href="output/Ext.grid.GridPanel.html" ext:cls="Ext.grid.GridPanel">Ext.grid.GridPanel</a>.<tt><a href="output/Ext.grid.GridPanel.html#Ext.grid.GridPanel-autoExpandColumn" ext:member="autoExpandColumn" ext:cls="Ext.grid.GridPanel">autoExpandColumn</a></tt></li>
107 <li><a href="output/Ext.grid.GridView.html" ext:cls="Ext.grid.GridView">Ext.grid.GridView</a>.<tt><a href="output/Ext.grid.GridView.html#Ext.grid.GridView-forceFit" ext:member="forceFit" ext:cls="Ext.grid.GridView">forceFit</a></tt>
108 <div class="sub-desc">
109 <p>By specifying <tt>forceFit:true</tt>, <a href="output/Ext.grid.Column.html#Ext.grid.Column-fixed" ext:member="fixed" ext:cls="Ext.grid.Column">non-fixed width</a> columns will be
110 re-proportioned (based on the relative initial widths) to fill the width of the grid so
111 that no horizontal scrollbar is shown.</p>
112 </div></li>
113 <li><a href="output/Ext.grid.GridView.html" ext:cls="Ext.grid.GridView">Ext.grid.GridView</a>.<tt><a href="output/Ext.grid.GridView.html#Ext.grid.GridView-autoFill" ext:member="autoFill" ext:cls="Ext.grid.GridView">autoFill</a></tt></li>
114 <li><a href="output/Ext.grid.GridPanel.html" ext:cls="Ext.grid.GridPanel">Ext.grid.GridPanel</a>.<tt><a href="output/Ext.grid.GridPanel.html#Ext.grid.GridPanel-minColumnWidth" ext:member="minColumnWidth" ext:cls="Ext.grid.GridPanel">minColumnWidth</a></tt></li>
115 <br><p><b>Note</b>: when the width of each column is determined, a space on the right side
116 is reserved for the vertical scrollbar.  The
117 <a href="output/Ext.grid.GridView.html" ext:cls="Ext.grid.GridView">Ext.grid.GridView</a>.<tt><a href="output/Ext.grid.GridView.html#Ext.grid.GridView-scrollOffset" ext:member="scrollOffset" ext:cls="Ext.grid.GridView">scrollOffset</a></tt>
118 can be modified to reduce or eliminate the reserved offset.</p></div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#width" ext:member="#width" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="config-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-xtype"></a><b><a href="source/Column.html#cfg-Ext.grid.Column-xtype">xtype</a></b> : String<div class="mdesc"><div class="short">Optional. A String which references a predefined Ext.grid.Column subclass
119 type which is preconfigured with an appropr...</div><div class="long">Optional. A String which references a predefined <a href="output/Ext.grid.Column.html" ext:cls="Ext.grid.Column">Ext.grid.Column</a> subclass
120 type which is preconfigured with an appropriate <code><a href="output/Ext.grid.Column.html#Ext.grid.Column-renderer" ext:member="renderer" ext:cls="Ext.grid.Column">renderer</a></code> to be easily
121 configured into a ColumnModel. The predefined <a href="output/Ext.grid.Column.html" ext:cls="Ext.grid.Column">Ext.grid.Column</a> subclass types are:
122 <div class="mdetail-params"><ul>
123 <li><b><tt>gridcolumn</tt></b> : <a href="output/Ext.grid.Column.html" ext:cls="Ext.grid.Column">Ext.grid.Column</a> (<b>Default</b>)<p class="sub-desc"></p></li>
124 <li><b><tt>booleancolumn</tt></b> : <a href="output/Ext.grid.BooleanColumn.html" ext:cls="Ext.grid.BooleanColumn">Ext.grid.BooleanColumn</a><p class="sub-desc"></p></li>
125 <li><b><tt>numbercolumn</tt></b> : <a href="output/Ext.grid.NumberColumn.html" ext:cls="Ext.grid.NumberColumn">Ext.grid.NumberColumn</a><p class="sub-desc"></p></li>
126 <li><b><tt>datecolumn</tt></b> : <a href="output/Ext.grid.DateColumn.html" ext:cls="Ext.grid.DateColumn">Ext.grid.DateColumn</a><p class="sub-desc"></p></li>
127 <li><b><tt>templatecolumn</tt></b> : <a href="output/Ext.grid.TemplateColumn.html" ext:cls="Ext.grid.TemplateColumn">Ext.grid.TemplateColumn</a><p class="sub-desc"></p></li>
128 </ul></div>
129 <p>Configuration properties for the specified <code>xtype</code> may be specified with
130 the Column configuration properties, for example:</p>
131 <pre><code><b>var</b> grid = <b>new</b> Ext.grid.GridPanel({
132     ...
133     columns: [{
134         header: <em>'Last Updated'</em>,
135         dataIndex: <em>'lastChange'</em>,
136         width: 85,
137         sortable: true,
138         <i>//renderer: Ext.util.Format.dateRenderer(<em>'m/d/Y'</em>),</i>
139         xtype: <em>'datecolumn'</em>, <i>// use xtype instead of renderer</i>
140         format: <em>'M/d/Y'</em> <i>// configuration property <b>for</b> <a href="output/Ext.grid.DateColumn.html" ext:cls="Ext.grid.DateColumn">Ext.grid.DateColumn</a></i>
141     }, {
142         ...
143     }]
144 });</code></pre></div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#xtype" ext:member="#xtype" ext:cls="Ext.grid.Column">Column</a></td></tr></tbody></table><a id="Ext.grid.NumberColumn-props"></a><h2>Public Properties</h2><table cellspacing="0" class="member-table"><tbody><tr><th colspan="2" class="sig-header">Property</th><th class="msource-header">Defined By</th></tr><tr class="property-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-renderer"></a><b><a href="source/Column.html#prop-Ext.grid.Column-renderer">renderer</a></b> : Function<div class="mdesc"><div class="short">Optional. A function which returns displayable data when passed the following parameters:
145 &lt;div class="mdetail-params"...</div><div class="long">Optional. A function which returns displayable data when passed the following parameters:
146 <div class="mdetail-params"><ul>
147 <li><b>value</b> : Object<p class="sub-desc">The data value for the cell.</p></li>
148 <li><b>metadata</b> : Object<p class="sub-desc">An object in which you may set the following attributes:<ul>
149 <li><b>css</b> : String<p class="sub-desc">A CSS class name to add to the cell's TD element.</p></li>
150 <li><b>attr</b> : String<p class="sub-desc">An HTML attribute definition string to apply to the data container
151 element <i>within</i> the table cell (e.g. 'style="color:red;"').</p></li></ul></p></li>
152 <li><b>record</b> : Ext.data.record<p class="sub-desc">The <a href="output/Ext.data.Record.html" ext:cls="Ext.data.Record">Ext.data.Record</a> from which the data was
153 extracted.</p></li>
154 <li><b>rowIndex</b> : Number<p class="sub-desc">Row index</p></li>
155 <li><b>colIndex</b> : Number<p class="sub-desc">Column index</p></li>
156 <li><b>store</b> : Ext.data.Store<p class="sub-desc">The <a href="output/Ext.data.Store.html" ext:cls="Ext.data.Store">Ext.data.Store</a> object from which the Record
157 was extracted.</p></li>
158 </ul></div></div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#renderer" ext:member="#renderer" ext:cls="Ext.grid.Column">Column</a></td></tr></tbody></table><a id="Ext.grid.NumberColumn-methods"></a><h2>Public Methods</h2><table cellspacing="0" class="member-table"><tbody><tr><th colspan="2" class="sig-header">Method</th><th class="msource-header">Defined By</th></tr><tr class="method-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-getCellEditor"></a><b><a href="source/Column.html#method-Ext.grid.Column-getCellEditor">getCellEditor</a></b>(&nbsp;<code>Number&nbsp;rowIndex</code>&nbsp;)
159     :
160                                         Ext.Editor<div class="mdesc"><div class="short">Returns the editor defined for this column that was created to wrap the Field
161 used to edit the cell.</div><div class="long">Returns the <a href="output/Ext.Editor.html" ext:cls="Ext.Editor">editor</a> defined for this column that was created to wrap the <a href="output/Ext.form.Field.html" ext:cls="Ext.form.Field">Field</a>
162 used to edit the cell.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>rowIndex</code> : Number<div class="sub-desc">The row index</div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Editor</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#getCellEditor" ext:member="#getCellEditor" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="method-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-setEditor"></a><b><a href="source/Column.html#method-Ext.grid.Column-setEditor">setEditor</a></b>(&nbsp;<code>Ext.Editor/Ext.form.Field&nbsp;editor</code>&nbsp;)
163     :
164                                         void<div class="mdesc"><div class="short">Sets a new editor for this column.</div><div class="long">Sets a new editor for this column.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>editor</code> : Ext.Editor/Ext.form.Field<div class="sub-desc">The editor to set</div></li></ul><strong>Returns:</strong><ul><li>void</li></ul></div></div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#setEditor" ext:member="#setEditor" ext:cls="Ext.grid.Column">Column</a></td></tr></tbody></table><a id="Ext.grid.NumberColumn-events"></a><h2>Public Events</h2><table cellspacing="0" class="member-table"><tbody><tr><th colspan="2" class="sig-header">Event</th><th class="msource-header">Defined By</th></tr><tr class="method-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-click"></a><b><a href="source/Column.html#event-Ext.grid.Column-click">click</a></b> :
165                                       (&nbsp;<code>Column&nbsp;this</code>,&nbsp;<code>Grid&nbsp;The</code>,&nbsp;<code>Number&nbsp;rowIndex</code>,&nbsp;<code>Ext.EventObject&nbsp;e</code>&nbsp;)
166     <div class="mdesc"><div class="short">Fires when this Column is clicked.</div><div class="long">Fires when this Column is clicked.<div class="mdetail-params"><strong style="font-weight: normal;">Listeners will be called with the following arguments:</strong><ul><li><code>this</code> : Column<div class="sub-desc"></div></li><li><code>The</code> : Grid<div class="sub-desc">owning GridPanel</div></li><li><code>rowIndex</code> : Number<div class="sub-desc"></div></li><li><code>e</code> : Ext.EventObject<div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#click" ext:member="#click" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="method-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-contextmenu"></a><b><a href="source/Column.html#event-Ext.grid.Column-contextmenu">contextmenu</a></b> :
167                                       (&nbsp;<code>Column&nbsp;this</code>,&nbsp;<code>Grid&nbsp;The</code>,&nbsp;<code>Number&nbsp;rowIndex</code>,&nbsp;<code>Ext.EventObject&nbsp;e</code>&nbsp;)
168     <div class="mdesc"><div class="short">Fires when this Column is right clicked.</div><div class="long">Fires when this Column is right clicked.<div class="mdetail-params"><strong style="font-weight: normal;">Listeners will be called with the following arguments:</strong><ul><li><code>this</code> : Column<div class="sub-desc"></div></li><li><code>The</code> : Grid<div class="sub-desc">owning GridPanel</div></li><li><code>rowIndex</code> : Number<div class="sub-desc"></div></li><li><code>e</code> : Ext.EventObject<div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#contextmenu" ext:member="#contextmenu" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="method-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-dblclick"></a><b><a href="source/Column.html#event-Ext.grid.Column-dblclick">dblclick</a></b> :
169                                       (&nbsp;<code>Column&nbsp;this</code>,&nbsp;<code>Grid&nbsp;The</code>,&nbsp;<code>Number&nbsp;rowIndex</code>,&nbsp;<code>Ext.EventObject&nbsp;e</code>&nbsp;)
170     <div class="mdesc"><div class="short">Fires when this Column is double clicked.</div><div class="long">Fires when this Column is double clicked.<div class="mdetail-params"><strong style="font-weight: normal;">Listeners will be called with the following arguments:</strong><ul><li><code>this</code> : Column<div class="sub-desc"></div></li><li><code>The</code> : Grid<div class="sub-desc">owning GridPanel</div></li><li><code>rowIndex</code> : Number<div class="sub-desc"></div></li><li><code>e</code> : Ext.EventObject<div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#dblclick" ext:member="#dblclick" ext:cls="Ext.grid.Column">Column</a></td></tr><tr class="method-row expandable inherited"><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.Column-mousedown"></a><b><a href="source/Column.html#event-Ext.grid.Column-mousedown">mousedown</a></b> :
171                                       (&nbsp;<code>Column&nbsp;this</code>,&nbsp;<code>Grid&nbsp;The</code>,&nbsp;<code>Number&nbsp;rowIndex</code>,&nbsp;<code>Ext.EventObject&nbsp;e</code>&nbsp;)
172     <div class="mdesc"><div class="short">Fires when this Column receives a mousedown event.</div><div class="long">Fires when this Column receives a mousedown event.<div class="mdetail-params"><strong style="font-weight: normal;">Listeners will be called with the following arguments:</strong><ul><li><code>this</code> : Column<div class="sub-desc"></div></li><li><code>The</code> : Grid<div class="sub-desc">owning GridPanel</div></li><li><code>rowIndex</code> : Number<div class="sub-desc"></div></li><li><code>e</code> : Ext.EventObject<div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource"><a href="output/Ext.grid.Column.html#mousedown" ext:member="#mousedown" ext:cls="Ext.grid.Column">Column</a></td></tr></tbody></table></div>