Upgrade to ExtJS 3.3.1 - Released 11/30/2010
[extjs.git] / docs / output / Ext.grid.BooleanColumn.html
1 <div class="body-wrap" xmlns:ext="http://www.extjs.com"><div class="top-tools"><a class="inner-link" href="#Ext.grid.BooleanColumn-props"><img src="resources/images/default/s.gif" class="item-icon icon-prop">Properties</a>&#13;<a class="inner-link" href="#Ext.grid.BooleanColumn-methods"><img src="resources/images/default/s.gif" class="item-icon icon-method">Methods</a>&#13;<a class="inner-link" href="#Ext.grid.BooleanColumn-events"><img src="resources/images/default/s.gif" class="item-icon icon-event">Events</a>&#13;<a class="inner-link" href="#Ext.grid.BooleanColumn-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.BooleanColumn"><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">BooleanColumn</pre></div><h1>Class <a href="source/Column.html#cls-Ext.grid.BooleanColumn">Ext.grid.BooleanColumn</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.BooleanColumn">Column.js</a></td></tr><tr><td class="label">Class:</td><td class="hd-info"><a href="source/Column.html#cls-Ext.grid.BooleanColumn">BooleanColumn</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 boolean data fields.  See the <a href="output/Ext.grid.Column.html#Ext.grid.Column-xtype" ext:member="xtype" ext:cls="Ext.grid.Column">xtype</a>
3 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.BooleanColumn-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  "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.BooleanColumn-falseText"></a><b><a href="source/Column.html#cfg-Ext.grid.BooleanColumn-falseText">falseText</a></b> : String<div class="mdesc">The string returned by the renderer when the column value is falsy (but not undefined) (defaults to
19 <tt>'false'</tt>).</div></td><td class="msource">BooleanColumn</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 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
20 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
21 may be used to specify the text with which to prefix the group field value in the group header line.
22 See also <a href="output/Ext.grid.Column.html#Ext.grid.Column-groupRenderer" ext:member="groupRenderer" ext:cls="Ext.grid.Column">groupRenderer</a> and
23 <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
24 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
25 may be used to specify the function used to format the grouping field value for display in the group
26 <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
27 <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
28 the new value of the group field will be used.</p>
29 <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
30 passed the following parameters:
31 <div class="mdetail-params"><ul>
32 <li><b>v</b> : Object<p class="sub-desc">The new value of the group field.</p></li>
33 <li><b>unused</b> : undefined<p class="sub-desc">Unused parameter.</p></li>
34 <li><b>r</b> : Ext.data.Record<p class="sub-desc">The Record providing the data
35 for the row which caused group change.</p></li>
36 <li><b>rowIndex</b> : Number<p class="sub-desc">The row index of the Record which caused group change.</p></li>
37 <li><b>colIndex</b> : Number<p class="sub-desc">The column index of the group field.</p></li>
38 <li><b>ds</b> : Ext.data.Store<p class="sub-desc">The Store which is providing the data Model.</p></li>
39 </ul></div></p>
40 <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
41 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
42 may be used to disable the header menu item to group by the column selected. Defaults to <tt>true</tt>,
43 which enables the header menu group option.  Set to <tt>false</tt> to disable (but still show) the
44 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
45 (html tags are accepted) to display in the Grid view.  Note: to
46 hav...</div><div class="long">Optional. The header text to be used as innerHTML
47 (html tags are accepted) to display in the Grid view.  <b>Note</b>: to
48 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.
49 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>.
50 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>.
51 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
52 (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
53 (defaults to true).  To disallow column hiding globally for all columns in the grid, use
54 <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
55 ordinal position.) The id is used to ...</div><div class="long">Optional. A name which identifies this column (defaults to the column's initial
56 ordinal position.) The <tt>id</tt> is used to create a CSS <b>class</b> name which is applied to all
57 table cells (including headers) in that column (in this context the <tt>id</tt> does not need to be
58 unique). The class name takes the form of <pre>x-grid3-td-<b>id</b></pre>
59 Header cells will also receive this class name, but will also have the class <pre>x-grid3-hd</pre>
60 So, to target header cells, use CSS selectors such as:<pre>.x-grid3-hd-row .x-grid3-td-<b>id</b></pre>
61 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
62 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
63 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>
64 <p>Optional. A renderer is an 'interceptor' method which can be used transform data (value,
65 appearance, etc.) before it is rendered). This may be specified in either of three ways:
66 <div class="mdetail-params"><ul>
67 <li>A renderer function used to return HTML markup for a cell given the cell's data value.</li>
68 <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
69 provides a renderer function.</li>
70 <li>An object specifying both the renderer function, and its execution scope (<tt><b>this</b></tt>
71 reference) e.g.:<pre style="margin-left:1.2em"><code>{
72     fn: this.gridRenderer,
73     scope: this
74 }</code></pre></li></ul></div>
75 If not specified, the default renderer uses the raw data value.</p>
76 <p>For information about the renderer function (passed parameters, etc.), see
77 <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 = {
78    header: <em>'Company Name'</em>,
79    dataIndex: <em>'company'</em>,
80    renderer: <b>function</b>(value, metaData, record, rowIndex, colIndex, store) {
81       <i>// provide the logic depending on business rules</i>
82       <i>// name of your own choosing to manipulate the cell depending upon</i>
83       <i>// the data <b>in</b> the underlying Record object.</i>
84       <b>if</b> (value == <em>'whatever'</em>) {
85           <i>//metaData.css : String : A CSS class name to add to the TD element of the cell.</i>
86           <i>//metaData.attr : String : An html attribute definition string to apply to</i>
87           <i>//                         the data container element within the table</i>
88           <i>//                         cell (e.g. <em>'style=<em>"color:red;"</em>'</em>).</i>
89           metaData.css = <em>'name-of-css-class-you-will-define'</em>;
90       }
91       <b>return</b> value;
92    }
93 }</code></pre>
94 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
95 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.
96 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.
97 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.
98 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
99 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
100 are enabled, this value will be used as the text of the quick tip, otherwise it will be set as the
101 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  "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.BooleanColumn-trueText"></a><b><a href="source/Column.html#cfg-Ext.grid.BooleanColumn-trueText">trueText</a></b> : String<div class="mdesc">The string returned by the renderer when the column value is not falsy (defaults to <tt>'true'</tt>).</div></td><td class="msource">BooleanColumn</td></tr><tr class="config-row  "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.grid.BooleanColumn-undefinedText"></a><b><a href="source/Column.html#cfg-Ext.grid.BooleanColumn-undefinedText">undefinedText</a></b> : String<div class="mdesc">The string returned by the renderer when the column value is undefined (defaults to <tt>'&amp;#160;'</tt>).</div></td><td class="msource">BooleanColumn</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.
102 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.
103 The width of each column can also be affected if any of the following are configured:
104 <div class="mdetail-params"><ul>
105 <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>
106 <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>
107 <div class="sub-desc">
108 <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
109 re-proportioned (based on the relative initial widths) to fill the width of the grid so
110 that no horizontal scrollbar is shown.</p>
111 </div></li>
112 <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>
113 <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>
114 <br><p><b>Note</b>: when the width of each column is determined, a space on the right side
115 is reserved for the vertical scrollbar.  The
116 <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>
117 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
118 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
119 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
120 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:
121 <div class="mdetail-params"><ul>
122 <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>
123 <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>
124 <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>
125 <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>
126 <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>
127 </ul></div>
128 <p>Configuration properties for the specified <code>xtype</code> may be specified with
129 the Column configuration properties, for example:</p>
130 <pre><code><b>var</b> grid = <b>new</b> Ext.grid.GridPanel({
131     ...
132     columns: [{
133         header: <em>'Last Updated'</em>,
134         dataIndex: <em>'lastChange'</em>,
135         width: 85,
136         sortable: true,
137         <i>//renderer: Ext.util.Format.dateRenderer(<em>'m/d/Y'</em>),</i>
138         xtype: <em>'datecolumn'</em>, <i>// use xtype instead of renderer</i>
139         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>
140     }, {
141         ...
142     }]
143 });</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.BooleanColumn-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:
144 &lt;div class="mdetail-params"...</div><div class="long">Optional. A function which returns displayable data when passed the following parameters:
145 <div class="mdetail-params"><ul>
146 <li><b>value</b> : Object<p class="sub-desc">The data value for the cell.</p></li>
147 <li><b>metadata</b> : Object<p class="sub-desc">An object in which you may set the following attributes:<ul>
148 <li><b>css</b> : String<p class="sub-desc">A CSS class name to add to the cell's TD element.</p></li>
149 <li><b>attr</b> : String<p class="sub-desc">An HTML attribute definition string to apply to the data container
150 element <i>within</i> the table cell (e.g. 'style="color:red;"').</p></li></ul></p></li>
151 <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
152 extracted.</p></li>
153 <li><b>rowIndex</b> : Number<p class="sub-desc">Row index</p></li>
154 <li><b>colIndex</b> : Number<p class="sub-desc">Column index</p></li>
155 <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
156 was extracted.</p></li>
157 </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.BooleanColumn-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;)
158     :
159                                         Ext.Editor<div class="mdesc"><div class="short">Returns the editor defined for this column that was created to wrap the Field
160 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>
161 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;)
162     :
163                                         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.BooleanColumn-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> :
164                                       (&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;)
165     <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> :
166                                       (&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;)
167     <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> :
168                                       (&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;)
169     <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> :
170                                       (&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;)
171     <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>