Path
元件可讓您建立從選定項目 (例如:資料夾或類別) 到其根項目的視覺化「瀏覽途徑記錄 (Breadcrumb Trail)」路徑表示。例如,當使用者在擷取資料夾及子資料夾中的細目,以尋找待檢視的報表時,您可能會希望使用這個元件。在這個範例中,當使用者循路徑往下導覽時,路徑可以視覺化方式顯示並加以更新,同時顯示根資料夾如何通往第一個子資料夾,再依次通往第二個子資料夾,以下類推直到抵達報表為止。
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 擷取出來。
注意: 如需有關屬性類別的詳細資訊,請參閱我要如何使用結合 JavaServer Faces Components for Crystal Enterprise 的屬性類別?。
若要自訂 Path
元件的外觀,請設定元件之各種組件的樣式屬性。
樣式屬性 | 說明 | 樣式類別 |
---|---|---|
若要啟用 Path
元件的自動事件處理功能,請設定 autoHandleEvents
屬性為 True
。設定為 True
時,這個屬性會實作當使用者與元件互動時所觸發動作事件的預設行為。例如:
事件 | 預設行為 |
---|---|
按一下元件中的項目時,會設定資料繫結的 |
如果 autoHandleEvents
屬性設定為 False
,就不會自動處理此事件。如果將 autoHandleEvents
設定為 false
,您便可以自行撰寫事件處理常式。
Path
元件能支援資料繫結至 EnterpriseItem
Bean 或 EnterpriseItems
Bean。這些 Bean 可以為要顯示於 Path
元件中的項目提供來源。使用 itemSource
屬性以將元件繫結至所要的 Bean。
Business Objects http://www.taiwan.businessobjects.com/ 支援服務 http://www.businessobjects.com/services/support/ |