總覽

Path 元件可讓您建立從選定項目 (例如報表) 到其根項目的視覺化「瀏覽途徑記錄 (Breadcrumb Trail)」路徑表示。例如,當使用者在擷取資料夾及子資料夾中的細目,以尋找待檢視或排定的報表時,您可能會希望使用這個元件。在這個範例中,當使用者循路徑往下導覽時,路徑可以視覺化方式顯示並加以更新,同時顯示根資料夾如何通往第一個子資料夾,再依次通往第二個子資料夾,以下類推直到抵達報表為止。

rootItemIDrootText 是決定路徑中第一個節點的兩個主要屬性。請將 rootItemID 屬性設定成將顯示為路徑中根 (第一個) 項目的項目識別項。這個屬性的設定值會對使用者在 Crystal Enterprise 項目階層內所能導覽到的位置建立上限。您可以使用 rootText 屬性,來自訂表示路徑中這個頂端項目的實際文字。

使用 repeatDirection 屬性,指定是要以由左至右的方式 (設定 [水平] 選項),或是由上至下的方式 (設定 [垂直] 選項),來向使用者顯示路徑。repeatDirection 屬性必須設定為 com.businessobjects.jsf.sdk.properties.RepeatDirection 類別的欄位。使用 separatorText 屬性,指定要使用哪些字元來分隔路徑中的項目。例如,您可能希望建構箭號 ("->"),來表示從一個元素通往下一個元素的路徑。根據預設,這個屬性設定為大於字元 (">")。您可以設定 showSelectedItem 屬性為將選取的項目當作路徑中最後一個元素加以顯示或隱藏。根據預設,此屬性設定為 True。如果設定為 False,選取的項目的父項目會顯示為路徑中的最後一個元素。

除了元件的一般屬性之外,showImages 屬性會存取包含更多屬性的 ImagesProps 類別:

注意    如需有關屬性類別的詳細資訊,請參閱我要如何使用結合 JavaServer Faces Components for Crystal Enterprise 的屬性類別?

若要自訂 Path 元件的外觀,請設定元件之各種組件的樣式屬性。

樣式屬性 說明 樣式類別

itemStyle

路徑中所有項目的樣式。

定義於樣式表中,並且從 JSP 頁面連結到的樣式類別的字串名稱。

selectedItemStyle

個別選取的項目的樣式。

定義於樣式表中,並且從 JSP 頁面連結到的樣式類別的字串名稱。

separatorStyle

可分隔路徑中個別項目的字元的樣式。

定義於樣式表中,並且從 JSP 頁面連結到的樣式類別的字串名稱。

事件處理

若要啟用 Path 元件的自動事件處理功能,請設定 autoHandleEvents 屬性為 True。設定為 True 時,這個屬性會實作當使用者與元件互動時所觸發動作事件的預設行為。例如:

事件 預設行為

ItemClicked

按一下元件中的項目時,會設定資料繫結的 EnterpriseItemEnterpriseItems Bean,在針對該項目所指定之 parentItemID 以下顯示項目。

如果 autoHandleEvents 屬性設定為 False,就不會處理這個事件。

資料繫結

Path 元件能支援資料繫結至 EnterpriseItem Bean 或 EnterpriseItems Bean。這些 Bean 可以為要顯示於 Path 元件中的項目提供來源。使用 itemSource 屬性以將元件繫結至所要的 Bean。


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