ext.data.record.html

Ext中文API,学习ext的同志只要你学会ext里的一种控件后其实其他的就大同小异了

                            </div>
                            <div class="long">
                                 生成一个构造函数，该函数能产生符合特定规划的Record对象。 @param {Array} o  数组。各个字段的定义，包括字段名、数据类型（可选的）、映射项（用于在<a href="###" onClick="alert('Ext.data.Reader');">Ext.data.Reader</a>的数据对象中提取真实的数据）。 每一个字段的定义对象可包含以下的属性：<ul> <li><b>name</b> : String<div class="sub-desc">Record对象所引用的字段名称。通常是一标识作它者引用， 例如，在列定义中，该值会作为<a href="###" onClick="alert('Ext.grid.ColumnModel');">Ext.grid.ColumnModel</a>的<em>dataIndex</em>属性。</div></li> <li><b>mapping</b> : String<div class="sub-desc">（可选的） 如果使用的是<a href="###" onClick="alert('Ext.data.Reader');">Ext.data.Reader</a>，这是一个Reader能够获取数据对象的数组值创建到Record对象下面的对应的映射项； 如果使用的是<a href="###" onClick="alert('Ext.data.JsonReader');">Ext.data.JsonReader</a>，那么这是一个javascript表达式的字符串， 能够获取数据的引用到Record对象的下面； 如果使用的是<a href="###" onClick="alert('Ext.data.XmlReader');">Ext.data.XmlReader</a>，这是一个<a href="###" onClick="alert('Ext.DomQuery');">Ext.DomQuery</a>路径， 能够获取数据元素的引用到Record对象的下面； 如果映射名与字段名都是相同的，那么映射名可以省略。 </div></li> <li><b>type</b> : String<div class="sub-desc">（可选的） 指明数据类型，转化为可显示的值。有效值是： <ul><li>auto （auto是默认的，不声明就用auto。不作转换）</li> <li>string</li> <li>int</li> <li>float</li> <li>boolean</li> <li>date</li></ul></div></li> <li><b>sortType</b> : Mixed<div class="sub-desc">（可选的） <a href="###" onClick="alert('Ext.data.SortTypes');">Ext.data.SortTypes</a>的成语。</div></li> <li><b>sortDir</b> : String<div class="sub-desc">（可选的） 初始化的排序方向，“ASC”或“DESC”。</div></li> <li><b>convert</b> : Function<div class="sub-desc">（可选的） 由Reader提供的用于转换值的函数，将值变为Record下面的对象。它会送入以下的参数：<ul> <li><b>v</b> : Mixed<div class="sub-desc">数据值，和Reader读取的一样。</div></li> <li><b>rec</b> : Mixed<div class="sub-desc">包含行的数据对象，和Reader读取的一样。 这可以是数组，对象，XML元素对象，这取决于Reader对象的类型。</div></li> </ul></div></li> <li><b>dateFormat</b> : String<div class="sub-desc">（可选的） 字符串格式的{@link Date#parseDate Date.parseDate}函数, 或“timestamp”表示Reader读取UNIX格式的timestamp，或“time”是Reader读取的是javascript毫秒的timestamp。</div></li> <li><b>defaultValue</b> : Mixed<div class="sub-desc">（可选的）默认值。<b> 当经过{@link Ext.data.Reader Reader}创建Record时会使用该值；</b> 当<b><tt>mapping</tt></b>的引用项不存在的时候，典型的情况为undefined时候会使用该值（默认为''） </div></li> </ul> 透过create方法会返回一个构造器的函数，这样就可以用来创建一个一个Record对象了。 数据对象（在第一个参数上）一定要有一个属性，是名为<b>names</b>的属性，以说明是什么字段。 <br>用法：<br><pre><code>
var TopicRecord = Ext.data.Record.create([
    {name: 'title', mapping: 'topic_title'},
    {name: 'author', mapping: 'username'},
    {name: 'totalPosts', mapping: 'topic_replies', type: 'int'},
    {name: 'lastPost', mapping: 'post_time', type: 'date'},
    {name: 'lastPoster', mapping: 'user2'},
    {name: 'excerpt', mapping: 'post_text'}
]);

var myNewRecord = new TopicRecord({
    title: 'Do my job please',
    author: 'noobie',
    totalPosts: 1,
    lastPost: new Date(),
    lastPoster: 'Animal',
    excerpt: 'No way dude!'
});
myStore.add(myNewRecord);
</code></pre> <p> 简单地说，除了 <tt>name</tt>属性是必须的外，其他属性是可以不要的，因此，你只要传入一个字符串就可满足最低条件了，因为它就代表字段名称。</p> @method create @return {function} 根据定义创建新Records的构造器。 
                                <div class="mdetail-params">
                                    <strong>参数项：</strong>
                                    <ul>
                                        
                                            <li>
                                                <code>
                                                    o
                                                </code> : Array
                                                <div class="sub-desc">
                                                    
                                                </div>
                                            </li>
                                        
                                    </ul>
                                    <b>返回：</b>
                                    <ul>
                                        <li>
                                            <code>
                                                function
                                            </code>
                                            根据定义创建新Records的构造器。
                                        </li>
                                    </ul>
                                </div>
                            </div>
                        </div>
                    </td>
                    <td class="msource">
                        
                        Record
                        
                    </td>
                </tr>
            
                <tr class="method-row expandable">
                    <td class="micon">
                        <a class="exi" href="#expand">&nbsp;</a>
                    </td>
                    <td class="sig">
                        <!--ClassName--><a id="set-set"></a>
                        <b>set</b>
                        (
                        
                            
                                <code>
                                    String name
                                </code>
                            
                        )
                        
                            : Object
                        
                        <div class="mdesc">
                            <div class="short">
                                 根据字段设置值。

 
                            </div>
                            <div class="long">
                                 根据字段设置值。


                                <div class="mdetail-params">
                                    <strong>参数项：</strong>
                                    <ul>
                                        
                                            <li>
                                                <code>
                                                    name
                                                </code> : String
                                                <div class="sub-desc">
                                                    字段名称的字符串
                                                </div>
                                            </li>
                                        
                                    </ul>
                                    <b>返回：</b>
                                    <ul>
                                        <li>
                                            <code>
                                                Object
                                            </code>
                                            值
                                        </li>
                                    </ul>
                                </div>
                            </div>
                        </div>
                    </td>
                    <td class="msource">
                        
                        Record
                        
                    </td>
                </tr>
            
                <tr class="method-row expandable">
                    <td class="micon">
                        <a class="exi" href="#expand">&nbsp;</a>
                    </td>
                    <td class="sig">
                        <!--ClassName--><a id="get-get"></a>
                        <b>get</b>
                        (
                        
                            
                                <code>
                                    String name
                                </code>
                            
                        )
                        
                            : Object
                        
                        <div class="mdesc">
                            <div class="short">
                                 根据字段返回值。

 
                            </div>
                            <div class="long">
                                 根据字段返回值。


                                <div class="mdetail-params">
                                    <strong>参数项：</strong>
                                    <ul>
                                        
                                            <li>
                                                <code>
                                                    name
                                                </code> : String
                                                <div class="sub-desc">
                                                    字段名称的字符串
                                                </div>
                                            </li>
                                        
                                    </ul>
                                    <b>返回：</b>
                                    <ul>
                                        <li>
                                            <code>
                                                Object
                                            </code>
                                            值
                                        </li>
                                    </ul>
                                </div>
                            </div>
                        </div>
                    </td>
                    <td class="msource">
                        
                        Record
                        
                    </td>
                </tr>
            
                <tr class="method-row expandable">
                    <td class="micon">
                        <a class="exi" href="#expand">&nbsp;</a>
                    </td>
                    <td class="sig">
                        <!--ClassName--><a id="beginEdit-beginEdit"></a>
                        <b>beginEdit</b>
                        (
                        )
                        
                        <div class="mdesc">
                            <div class="short">
                                 开始进入编辑。编辑期间，没有与所在的store任何关联的事件。 
                            </div>
                            <div class="long">
                                 开始进入编辑。编辑期间，没有与所在的store任何关联的事件。
                                <div class="mdetail-params">
                                    <strong>参数项：</strong>
                                    <ul>
                                        
                                    </ul>
                                    <b>返回：</b>
                                    <ul>
                                        <li>
                                            <code>
                                                void
                                            </code>
                                            
                                        </li>
                                    </ul>
                                </div>
                            </div>
                        </div>
                    </td>
                    <td class="msource">
                        
                        Record
                        
                    </td>
                </tr>
            
                <tr class="method-row expandable">
                    <td class="micon">
                        <a class="exi" href="#expand">&nbsp;</a>
                    </td>
                    <td class="sig">
                        <!--ClassName--><a id="cancelEdit-cancelEdit"></a>
                        <b>cancelEdit</b>
                        (
                        )
                        
                        <div class="mdesc">
                            <div class="short">
                                 取消所有已修改过的数据。 
                            </div>
                            <div class="long">
                                 取消所有已修改过的数据。
                                <div class="mdetail-params">
                                    <strong>参数项：</strong>
                                    <ul>
                                        
                                    </ul>
                                    <b>返回：</b>
                                    <ul>
                                        <li>
                                            <code>
                                                void
                                            </code>
                                            
                                        </li>
                                    </ul>
                                </div>
                            </div>
                        </div>
                    </td>
                    <td class="msource">
                        
                        Record
                        
                    </td>
                </tr>
            
                <tr class="method-row expandable">
                    <td class="micon">
                        <a class="exi" href="#expand">&nbsp;</a>
                    </td>
                    <td class="sig">
                        <!--ClassName--><a id="endEdit-endEdit"></a>
                        <b>endEdit</b>
                        (
                        )
                        
                        <div class="mdesc">
                            <div class="short">
                                 结束编辑。如数据有变动，则会通知所在的store。 
                            </div>
                            <div class="long">
                                 结束编辑。如数据有变动，则会通知所在的store。
                                <div class="mdetail-params">
                                    <strong>参数项：</strong>
                                    <ul>
                                        
                                    </ul>
                                    <b>返回：</b>
                                    <ul>
                                        <li>
                                            <code>
                                                void
                                            </code>
                                            
                                        </li>
                                    </ul>
                                </div>
                            </div>
                        </div>
                    </td>
                    <td class="msource">
                        
                        Record
                        
                    </td>