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
属性设置为将成为网格中根项目的文件夹的标识符。
要将 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)。
注意: 只有 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
,则不会自动处理这些事件。 如果将 autoHandleEvents
设置为 false
,可以编写自己的事件处理程序。
ItemsGrid
组件支持将数据绑定到 EnterpriseItem
Bean 或 EnterpriseItems
Bean。这些 Bean 为要在 ItemsGrid
组件的行中显示的一个或多个项目提供了来源。使用 itemSource
属性可将组件绑定到所需的 Bean。
Business Objects http://www.china.businessobjects.com/ 支持服务 http://www.china.businessobjects.com/services/services.htm |