概述

ItemsGrid 组件将项目来源(如报表)的字段显示为表中的列。ItemsGrid 中的每一行都代表项目来源中的一条记录。ItemsGrid 允许用户选择个别项目、在大型项目集中分页并按列对项目进行排序。ItemsGrid 组件的每个列都是一个单独的 ItemsColumn 组件。

defaultRootrootItemID 是两个关键属性,它们确定了可在 ItemsGrid 组件中导航到的顶层项目。defaultRoot 属性用于指定 ItemsGrid 组件中项目层次结构的根节点。为此属性设置的值将创建一个上限,即用户可以在 Crystal Enterprise 项目的层次结构内导航的范围上限。可能的值是 com.businessobjects.jsf.sdk.properties.DefaultRootType 类的字段:

要将 ItemsGrid 组件放在页面上,请将 horizontalAlign 属性设置为所需的值。可以使用 showHeadershowImagesshowDrillUpLink 属性来自定义 ItemsGrid 组件的一般显示外观。默认情况下,showHeader 属性设置为 true,即在网格每个列的顶部显示一个页眉文本标签。必须将 showImages 属性设置为 com.businessobjects.jsf.sdk.properties.Image 类的字段。默认情况下,该属性设置为 None,但可以修改它以便在网格中每个项目的旁边显示 IconThumbnail 图示。有关显示图标的更多信息,请参阅如何在 ItemsGrid 组件中显示图像?

showDrillUpLink 属性指明是否显示允许用户在项目层次结构中向上导航的链接。 此属性默认情况下设置为 true

还可以使用许多属性来自定义信息在 ItemsGrid 组件的显示方式。默认情况下,allowSorting 属性设置为 false,从而防止了用户对项目进行排序。将此属性设置为 true 可显示一个排序链接,该链接允许用户对网格中的项目(行)列表进行排序。只有某些字段(列)经过优化,并且建议进行排序:

为了让用户轻松地区分行和列,您可以使用 showGridLines 属性来指定显示哪种类型的网格线。必须将此属性设置为 com.businessobjects.jsf.sdk.properties.GridLines 类的字段。默认情况下,此属性设置为 Both;设置为 Horizontal 可显示分隔行的线条,设置为 Vertical 可显示分隔列的线条,也可以设置为 None 以隐藏所有线条。此外,allowDrillDown 属性控制网格中项目的行为,并在用户单击某个项目时使网格动态地深化到该项目的内容中。此属性默认情况下设置为 true

通过选择 ItemsColumn 子组件并设置属性值,还可以自定义网格的个别列。有关 ItemsColumn 属性的详细信息,请参阅标记属性 (itemsColumn)

注意:    只有 EnterpriseItemEnterpriseItems Bean 的 fields 属性指定的那些字段才应该使用 ItemsColumn 组件的 fields 属性设置。必须从 Crystal Enterprise 中查询此信息,以便 ItemsGrid 组件能够填充相应的列。有关字段的更多信息,请参阅EnterpriseItem Bean

除了组件的常规属性外,还有一些必须设置为特性类的属性。

注意:    有关属性类的更多信息,请参阅如何将属性类与 Crystal Enterprise 的 JavaServer Faces 组件结合使用?

要自定义 ItemsGrid 组件的外观,请设置控件不同部分的样式属性。

样式属性说明样式类

alternatingItemStyle

所有其他项目(交替项目)的样式。

在样式表中定义并从 JSP 页中链接或直接在 JSP 页中指定的样式类的字符串名称。

headerStyle

列表开头处页眉(如果有)的样式。

在样式表中定义并从 JSP 页中链接或直接在 JSP 页中指定的样式类的字符串名称。

itemStyle

个别项目的样式。

在样式表中定义并从 JSP 页中链接或直接在 JSP 页中指定的样式类的字符串名称。

pagerStyle

页面选择 UI 的样式。

PagerProps

事件处理

要启用 ItemsGrid 组件的自动事件处理功能,请将 autoHandleEvents 属性设置为 true。当设置为 true 时,如果用户与组件交互触发了操作事件,此属性将实施默认行为。例如:

事件默认行为

AlertClicked

单击某个警报项目时,显示该警报项目的内容。必须将 allowDrillDown 属性设置为 true

DrillUpClicked

单击“上移一个级别”超级链接时,ItemsGrid 组件向上导航一个层次级别,并显示父项目。

ItemClicked

单击某个项目时,显示项目的内容,同时按 sortField 属性指定的字段并依据 itemSourcesortDirection 属性指定的排序方向对内容进行排序。必须将 ItemsGrid 组件的 allowDrillDown 属性设置为 true

PagerClicked

单击下一页、上一页、下一页码范围或上一页码范围按钮时,页面索引发生更改,并且相应设置和显示当前页面。

SortClicked

单击某个字段(列)标题时,将依据该字段对 ItemsGrid 组件中的项目(行)进行排序。再次单击该字段时,排序顺序将会颠倒。

如果将 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