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 屬性為將成為格線中根項目的資料夾識別項。
UserRootFolder
若要調整 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)。若要進一步瞭解在視覺化設計工具中操作元件的相關資訊,請參閱我要如何操作 ItemsGrid 元件中的資料行?
注意 只有 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,就不會處理這些事件。
ItemsGrid 元件能支援資料繫結至 EnterpriseItem Bean 或 EnterpriseItems Bean。這些 Bean 可以為顯示於 ItemsGrid 元件資料列中的項目提供來源。使用 itemSource 屬性以將元件繫結至所要的 Bean。
| Business Objects http://www.china.businessobjects.com Support services http://www.china.businessobjects.com |