ItemsGrid
元件會將項目來源 (如報表) 的欄位顯示為資料表中的資料行。ItemsGrid
中的每一列都代表項目來源中的一筆資料錄。ItemsGrid
可讓使用者選取個別項目、瀏覽大型項目集,以及依據資料行將項目排序。ItemsGrid
元件的每一個資料行都是個別的 ItemsColumn
元件。
defaultRoot
和 rootItemID
是決定 ItemsGrid
元件中可導覽到的最上層項目的兩個主要屬性。defaultRoot
屬性可用來指定 ItemsGrid
元件中項目階層的根節點。這個屬性的設定值會對使用者在 Crystal Enterprise 項目階層內所能導覽到的位置建立上限。可能的值為 com.businessobjects.jsf.sdk.properties.DefaultRootType
類別的欄位:
None
ItemsGrid
元件的根會設定為 Crystal Enterprise 系統內資料夾樹狀結構的預設根。
Custom
自訂根 (由 rootItemID
屬性所指定) 可當作 ItemsGrid
元件的根來使用。設定 rootItemID
屬性為將成為格線中根項目的資料夾識別項。
若要調整 ItemsGrid
元件在頁面上的位置,請設定 horizontalAlign
屬性為所要的值。showHeader
、showImages
和 showDrillUpLink
屬性可用來自訂 ItemsGrid
元件的一般顯示外觀。根據預設,showHeader
屬性設定為 True
,如此便會在格線的每個欄位頂端顯示頁首文字標籤。showImages
屬性必須設定為 com.businessobjects.jsf.sdk.properties.Image
類別的欄位。根據預設,此屬性設定為 None
,但可加以修改,在格線中的每個項目旁顯示 Icon
(圖示) 或 Thumbnail
(縮圖) 表示法。如需有關顯示圖示的詳細資料,請參閱我要如何在 ItemsGrid 元件中顯示影像?。
showDrillUpLink
屬性會指出是否要顯示可讓使用者在項目階層中向上導覽的連結。根據預設,這個屬性設定為 True
。
還有許多屬性可用來自訂如何在 ItemsGrid
元件內顯示資訊。根據預設,allowSorting
屬性設定為 False
,如此可防止使用者對項目進行排序。設定這個屬性為 True
,可顯示允許使用者對格線中項目 (資料列) 清單進行排序的排序連結。只有特定欄位 (資料行) 經過最佳化,並建議用於排序:
為了讓使用者能夠輕易地區別資料列和資料行,您可以使用 showGridLines
屬性來指定所要顯示的格線類型。這個屬性必須設定為 com.businessobjects.jsf.sdk.properties.GridLines
類別的欄位。根據預設,這個屬性設定為 Both
;設定為 Horizontal
會顯示分隔資料列的線條;Vertical
會分隔資料行;或 None
會隱藏所有線條。此外,allowDrillDown
屬性還會控制格線中項目的行為,並會在使用者按一下某項目時,促使格線機動地擷取該項目內容的細目。根據預設,這個屬性設定為 True
。
您也可以選取 ItemsColumn
子元件並設定屬性值,以自訂格線的個別資料行。如需有關 ItemsColumn
屬性的詳細資料,請參閱標示屬性 (itemsColumn)。
注意: 只有 EnterpriseItem
或 EnterpriseItems
Bean 的 fields
屬性所指定的欄位,才應該使用 ItemsColumn
元件的 fields
屬性來加以設定。您必須從 Crystal Enterprise 查詢這項資訊,如此 ItemsGrid
元件才能夠填入適當的資料行。如需有關欄位的詳細資訊,請參閱EnterpriseItem Bean。
除了元件的一般屬性 (Attribute) 之外,尚有一些屬性 (Attribute) 必須設定為屬性類別 (Property Class)。
alerts
屬性
alerts
屬性會存取 AlertProps
類別的執行個體;此類別包含的屬性可指定於 ItemsGrid
元件中顯示警示項目的時機及方法。根據預設,visible
屬性設定為 True
,並且 ItemsGrid
元件會顯示警示。設定這個屬性為 False
便會抑制警示。當警示發生時,就會向使用者顯示影像以指出這種情形。設定 imageUrl
屬性為顯示影像的位置。根據預設,showAlertMessage
及 showAlertTime
子屬性都設定為 True
,這就會分別顯示附帶說明以及警示發生時的時間。設定這些屬性為 False
,則會隱藏這項資訊。
注意: 如果已開啟警示,您就必須將資料繫結於此控制項的 EnterpriseItems
Bean 所代表項目的處理資訊傳回。這可藉由選擇 SI_PROCESSINGINFO
作為 Bean 的 fields
屬性值來完成。
注意: 如需有關屬性類別的詳細資訊,請參閱我要如何使用結合 JavaServer Faces Components for Crystal Enterprise 的屬性類別?。
若要自訂 ItemsGrid
元件的外觀,請設定控制項之各種組件的樣式屬性。
樣式屬性 | 說明 | 樣式類別 |
---|---|---|
若要啟用 ItemsGrid
元件的自動事件處理功能,請設定 autoHandleEvents
屬性為 True
。設定為 True
時,這個屬性會實作當使用者與元件互動時所觸發動作事件的預設行為。例如:
如果 autoHandleEvents
屬性設定為 False
,就不會自動處理這些事件。如果將 autoHandleEvents
設定為 false
,您便可以自行撰寫事件處理常式。
ItemsGrid
元件能支援資料繫結至 EnterpriseItem
Bean 或 EnterpriseItems
Bean。這些 Bean 可以為顯示於 ItemsGrid
元件資料列中的項目提供來源。使用 itemSource
屬性以將元件繫結至所要的 Bean。
Business Objects http://www.taiwan.businessobjects.com/ 支援服務 http://www.businessobjects.com/services/support/ |