概述

Path 组件允许您以直观的“浏览途径记录”方式呈现从选定项目(如文件夹或类别)至其根项目的路径。 例如,当用户要深化到文件夹和子文件夹中以查找要查看的报表时,您可能希望使用此组件。在此示例中,当用户在路径中向下导航时,可以直观地显示并更新路径,同时显示根文件夹如何通向第一个子文件夹,第一个子文件夹又如何通向第二个子文件夹,依此类推,直至到达报表。

rootItemIDrootText 是确定路径中的第一个节点的两个关键属性。将 rootItemID 属性设置为将显示为路径中的根(第一个)项目的项目标识符。为此属性设置的值将创建一个上限,即用户可以在 Crystal Enterprise 项目的层次结构内导航的范围上限。可以使用 rootText 属性来自定义在路径中代表此顶层项目的实际文本。

使用 repeatDirection 属性来指定是按从左到右(通过设置水平选项)还是按从上到下(通过设置垂直选项)的方式向用户显示路径。必须将 repeatDirection 属性设置为 com.businessobjects.jsf.sdk.properties.RepeatDirection 类的字段。使用 separatorText 属性来指定要使用哪些字符来分隔路径中的项目。例如,您可能希望创建一个箭头(“->”)来代表从一个元素指向下一个元素的路径。默认情况下,此属性设置为大于字符(“>”)。可以设置 showSelectedItem 属性,以便将选定项目显示为路径中的最后一个元素或隐藏该选定项目。默认情况下,此属性设置为 true。如果设置为 false,则将选定项目的父项目显示为路径中的最后一个元素。

除了组件的常规特性之外,showImages 特性还访问包含更多属性的 ImagesProps 类:

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

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

样式属性说明样式类

itemStyle

路径中所有项目的样式。

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

selectedItemStyle

单独选定项目的样式。

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

separatorStyle

在路径中分隔个别项目的字符的样式。

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

事件处理

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

事件默认行为

ItemClicked

单击组件中的某个项目时,通过数据绑定的 EnterpriseItemEnterpriseItems Bean 将设置为在为该项目指定的 parentItemID 下显示项目。

如果将 autoHandleEvents 属性设置为 false,则不会自动处理此事件。 如果将 autoHandleEvents 设置为 false,可以编写自己的事件处理程序。

数据绑定

Path 组件支持将数据绑定到 EnterpriseItem Bean 或 EnterpriseItems Bean。这些 Bean 为要在 Path 组件中显示的一个或多个项目提供了来源。使用 itemSource 属性可将组件绑定到所需的 Bean。



Business Objects
http://www.china.businessobjects.com/

支持服务
http://www.china.businessobjects.com/services/services.htm