ItemsGrid 组件将项目来源(如报表)的字段显示为表中的列。ItemsGrid 中的每一行都代表项目来源中的一条记录。ItemsGrid 允许用户选择个别项目、在大型项目集中分页并按列对项目进行排序。ItemsGrid 组件的每个列都是一个单独的 ItemsColumn 组件。
defaultRoot 和 rootItemID 是两个关键属性,它们确定了可在 ItemsGrid 组件中导航到的顶层项目。defaultRoot 属性用于指定 ItemsGrid 组件中项目层次结构的根节点。为此属性设置的值将创建一个上限,即用户可以在 Crystal Enterprise 项目的层次结构内导航的范围上限。可能的值是 com.businessobjects.jsf.sdk.properties.DefaultRootType 类的字段:
无
ItemsGrid 组件的根节点设置为 Crystal Enterprise 系统内文件夹树的默认根节点。
Custom
使用 rootItemID 属性指定的自定义根节点作为 ItemsGrid 组件的根节点。将 rootItemID 属性设置为将成为网格中根项目的文件夹的标识符。
UserRootFolder
要将 ItemsGrid 组件放在页面上,请将 horizontalAlign 属性设置为所需的值。可以使用 showHeader、showImages 和 showDrillUpLink 属性来自定义 ItemsGrid 组件的一般显示外观。默认情况下,showHeader 属性设置为 true,即在网格每个列的顶部显示一个页眉文本标签。必须将 showImages 属性设置为 com.businessobjects.jsf.sdk.properties.Image 类的字段。默认情况下,该属性设置为 None,但可以修改它以便在网格中每个项目的旁边显示 Icon 或 Thumbnail 图示。有关显示图标的更多信息,请参阅如何在 ItemsGrid 组件中显示图像?。
showDrillUpLink 属性指明是否显示允许用户在项目层次结构中向上导航的链接。此属性默认情况下设置为 true。
还可以使用许多属性来自定义信息在 ItemsGrid 组件的显示方式。默认情况下,allowSorting 属性设置为 false,从而防止了用户对项目进行排序。将此属性设置为 true 可显示一个排序链接,该链接允许用户对网格中的项目(行)列表进行排序。只有某些字段(列)经过优化,并且建议进行排序:
为了让用户轻松地区分行和列,您可以使用 showGridLines 属性来指定显示哪种类型的网格线。必须将此属性设置为 com.businessobjects.jsf.sdk.properties.GridLines 类的字段。默认情况下,此属性设置为 Both;设置为 Horizontal 可显示分隔行的线条,设置为 Vertical 可显示分隔列的线条,也可以设置为 None 以隐藏所有线条。此外,allowDrillDown 属性控制网格中项目的行为,并在用户单击某个项目时使网格动态地深化到该项目的内容中。此属性默认情况下设置为 true。
通过选择 ItemsColumn 子组件并设置属性值,还可以自定义网格的个别列。有关 ItemsColumn 属性的详细信息,请参阅标记属性 (itemsColumn)。要了解在可视设计器中处理组件的更多信息,请参阅如何在 ItemsGrid 组件中处理列?
注意: 只有 EnterpriseItem 或 EnterpriseItems Bean 的 fields 属性指定的那些字段才应该使用 ItemsColumn 组件的 fields 属性设置。必须从 Crystal Enterprise 中查询此信息,以便 ItemsGrid 组件能够填充相应的列。有关字段的更多信息,请参阅EnterpriseItem Bean。
alerts 属性
alerts 属性访问 AlertProps 类的实例,该类包含用于指定何时以及如何在 ItemsGrid 组件中显示警报项目的属性。默认情况下,visible 属性设置为 true,因此 ItemsGrid 组件将显示警报。将此属性设置为 false 以抑制显示警报。当出现警报时,将向用户显示一幅图像,以指明发生了此情况。将 imageUrl 属性设置为要显示的图像的位置。默认情况下,showAlertMessage 和 showAlertTime 子属性均设置为 true,即在出现警报时分别显示附带的说明和时间。将这些属性设置为 false 可隐藏此信息。
注意: 如果启用了警报,您必须返回由绑定到此控件的 EnterpriseItems Bean 数据代表的项目处理信息。通过选择 SI_PROCESSINGINFO 作为该 Bean 的 fields 属性的值,可以达到此目的。
注意: 有关属性类的更多信息,请参阅如何将属性类与 Crystal Enterprise 的 JavaServer Faces 组件结合使用?:
要自定义 ItemsGrid 组件的外观,请设置控件不同部分的样式属性。
| 样式属性 | 说明 | 样式类 |
|---|---|---|
要启用 ItemsGrid 组件的自动事件处理功能,请将 autoHandleEvents 属性设置为 true。当设置为 true 时,如果用户与组件交互触发了操作事件,此属性将实施默认行为。例如:
如果将 autoHandleEvents 属性设置为 false,则不会处理这些事件。
ItemsGrid 组件支持将数据绑定到 EnterpriseItem Bean 或 EnterpriseItems Bean。这些 Bean 为要在 ItemsGrid 组件的行中显示的一个或多个项目提供了来源。使用 itemSource 属性可将组件绑定到所需的 Bean。
| Business Objects http://www.china.businessobjects.com 支持服务 http://www.china.businessobjects.com |