Path
组件允许您以直观的“浏览途径记录”方式呈现从选定项目(如报表)至其根项目的路径。例如,当用户要深化到文件夹和子文件夹中以查找要查看或计划的报表时,您可能希望使用此组件。在此示例中,当用户在路径中向下导航时,可以直观地显示并更新路径,同时显示根文件夹如何通向第一个子文件夹,第一个子文件夹又如何通向第二个子文件夹,依此类推,直至到达报表。
rootItemID
和 rootText
是确定路径中的第一个节点的两个关键属性。将 rootItemID
属性设置为将显示为路径中的根(第一个)项目的项目标识符。为此属性设置的值将创建一个上限,即用户可以在 Crystal Enterprise 项目的层次结构内导航的范围上限。可以使用 rootText
属性来自定义在路径中代表此顶层项目的实际文本。
使用 repeatDirection
属性来指定是按从左到右(通过设置水平选项)还是按从上到下(通过设置垂直选项)的方式向用户显示路径。必须将 repeatDirection
属性设置为 com.businessobjects.jsf.sdk.properties.RepeatDirection
类的字段。使用 separatorText
属性来指定要使用哪些字符来分隔路径中的项目。例如,您可能希望创建一个箭头(“->”)来代表从一个元素指向下一个元素的路径。默认情况下,此属性设置为大于字符(“>”)。可以设置 showSelectedItem
属性,以便将选定项目显示为路径中的最后一个元素或隐藏该选定项目。默认情况下,此属性设置为 true
。如果设置为 false
,则将选定项目的父项目显示为路径中的最后一个元素。
除了组件的常规特性之外,showImages
特性还访问包含更多属性的 ImagesProps
类:
showImages
属性
showImages
属性访问 ImagesProps
类的实例,该类包含指定如何显示路径中项目相关图像的属性。对于要显示关联图像的路径中的每个项目,必须将 visible
属性设置为 true
。默认情况下,它设置为 false
。homeUrl
属性允许您在设计时指定要与第一个项目(或根项目)一起显示的图像。当 repeatDirection
属性设置为水平时,此项目是最左边的项目,当 repeatDirection
属性设置为垂直时,则是顶层项目。路径中其他项目的图像是从 Crystal Enterprise 中自动检索出的。
注意: 有关属性类的更多信息,请参阅如何将属性类与 Crystal Enterprise 的 JavaServer Faces 组件结合使用?
要自定义 Path
组件的外观,请设置组件不同部分的样式属性。
样式属性 | 说明 | 样式类 |
---|---|---|
要启用 Path
组件的自动事件处理功能,请将 autoHandleEvents
属性设置为 true
。当设置为 true
时,如果用户与组件交互触发了操作事件,此属性将实施默认行为。例如:
事件 | 默认行为 |
---|---|
单击组件中的某个项目时,通过数据绑定的 |
如果将 autoHandleEvents
属性设置为 false
,则不会处理此事件。
Path
组件支持将数据绑定到 EnterpriseItem
Bean 或 EnterpriseItems
Bean。这些 Bean 为要在 Path
组件中显示的一个或多个项目提供了来源。使用 itemSource
属性可将组件绑定到所需的 Bean。
Business Objects http://www.china.businessobjects.com 支持服务 http://www.china.businessobjects.com |