JS 网格控件的功能

上次修改时间: 2015年3月9日

适用范围: SharePoint Foundation 2010

JS 网格控件中的每个单元格均支持其自己的基于样式的行为。

JS 网格控件的功能

JS 网格控件支持以下功能:

  • 异步验证

  • 复制和粘贴操作

  • 导出至 Microsoft Excel

  • 显示和编辑控件

  • 向下填充操作

  • 优先

  • 多视图:网格、甘特和网格以及透视

  • 撤消和恢复操作

  • 小组件

异步验证

需要显示来自服务器的错误,以便用户能够进行纠正。多数网格实现的异步特性都会使此过程复杂化。例如,用户可进行无效更改,然后在服务器返回错误前将该更改滚动到视图外部。或者用户可进行多项需要单独注意的无效更改(例如,通过使用向下填充操作或复制和粘贴操作)。

在 JS 网格控件的 Microsoft 项目实现中,可结合使用验证消息和状态栏,以告知用户要执行的操作。由于错误是由服务器返回的,因此状态栏可记录变化的总数,并使用户可在这些错误间导航。

JS 网格控件可执行数据类型错误检查。当用户输入的信息不符合声明的列的数据类型时,会在单元格周围显示一个红框,并且会在相应行上显示一个红色指示符。此行为由 JS 网格控件提供。

复制和粘贴

支持从 Excel 进行复制和粘贴。

编辑模式状态

如果单元格的编辑模式允许,则用户可直接在网格单元格中键入内容。JS 网格控件 EditMode 枚举(参见表 1)指定记录或文件中包含的单元格是否应允许编辑。

表 1. EditMode 值

说明

Defer

始终延迟读/写状态;该控件无法控制自己的状态。

ReadOnly

如果应用于记录或字段,则这些单元格均不可编辑;如果应用于行,请检查每个单元格的编辑模式。

ReadOnlyDefer

除非行、列或网格控件上的设置另行指定,否则该单元格是只读的。如果应用于行,请检查每个单元格的编辑模式。

ReadWrite

除非行、列或网格控件上的设置另行指定,否则该单元格是可编辑的。

ReadWriteDefer

除非行、列或网格控件上的设置另行指定,否则该单元格是可编辑的。

导出至 Excel

如果分页,则 JS 网格控件会请求从服务器到客户端的数据的所有页。

更新状态指示符显示消息"准备要导出的数据"。当数据位于内存中时,该控件会使用 Project Server 逻辑将数据集转换为工作表 XML。

向下填充操作

支持向下填充操作。

优先

优先级的顺序是单元格、行、列,然后是网格。

文本方向

JS 网格控件和 JS 网格控件甘特图支持从右向左 (RTL) 书写语言。

结合使用 TextDirection 属性和区域设置 ID (LCID) 属性可提供适当的区域性网格或甘特图。设置控件的 LCID 会将指示 LCID 传递到网格窗格。网格窗格会将该 LCID 传递到列。

gf.EditMode = TextDirection.RightToLeft;

备注

日期列是此行为的例外:日期列显示针对输入 LCID 设置格式的日期和日期选取器。

撤消和恢复

JS 网格控件支持 20 级撤消。撤消和恢复跟踪更改和原始值。撤消 (Ctrl+Z) 操作通过应用原始值来反向对恢复堆栈所做的最后一次更改。恢复 (Ctrl+Y) 操作则重新应用撤消的最后一次更改。

对于撤消和恢复操作,该控件接受无鼠标输入。如果需要执行撤消和恢复操作,则包含网格的页面必须提供这一功能。

网格公开了两种管理撤消和恢复操作的方法:

  • undoLastAction   撤消最后一次更改。如果撤消堆栈为空,则 undoLastAction 返回 0;否则返回剩余撤消操作数。

  • redoLastAction   恢复最后一次更改。如果恢复堆栈为空,则 redoLastAction 返回 0;否则返回剩余恢复操作数。

小组件控件

JS 网格控件通过小组件框架和基础结构提供数据验证支持。

小组件可以是复杂的控件。开发人员可构建自己的小组件控件,并包括自己的图标和单击操作。

有关 JS 网格控件小组件控件的详细信息,请参阅 JS 网格控件小组件

请参阅

引用

GridSerializer

概念

客户端对象模型分发和部署

托管对象模型和 ECMAScript 对象模型的区别

其他资源

Locale ID (LCID) Chart