總覽

ItemsGrid 元件會將項目來源 (如報表) 的欄位顯示為資料表中的資料行。ItemsGrid 中的每一列都代表項目來源中的一筆資料錄。ItemsGrid 可讓使用者選取個別項目、瀏覽大型項目集,以及依據資料行將項目排序。ItemsGrid 元件的每一個資料行都是個別的 ItemsColumn 元件。

defaultRootrootItemID 是決定 ItemsGrid 元件中可導覽到的最上層項目的兩個主要屬性。defaultRoot 屬性可用來指定 ItemsGrid 元件中項目階層的根節點。這個屬性的設定值會對使用者在 Crystal Enterprise 項目階層內所能導覽到的位置建立上限。可能的值為 com.businessobjects.jsf.sdk.properties.DefaultRootType 類別的欄位:

若要調整 ItemsGrid 元件在頁面上的位置,請設定 horizontalAlign 屬性為所要的值。showHeadershowImagesshowDrillUpLink 屬性可用來自訂 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 元件中的資料行?

注意    只有 EnterpriseItemEnterpriseItems Bean 的 fields 屬性所指定的欄位,才應該使用 ItemsColumn 元件的 fields 屬性來加以設定。您必須從 Crystal Enterprise 查詢這項資訊,如此 ItemsGrid 元件才能夠填入適當的資料行。如需有關欄位的詳細資訊,請參閱EnterpriseItem Bean

除了元件的一般屬性 (Attribute) 之外,尚有一些屬性 (Attribute) 必須設定為屬性類別 (Property Class)。

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

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

樣式屬性 說明 樣式類別

alternatingItemStyle

每隔一個項目的樣式 (交替項目)。

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

headerStyle

清單開頭處頁首的樣式 (若有的話)。

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

itemStyle

個別項目的樣式。

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

pagerStyle

頁面選擇 UI 的樣式。

PagerProps

事件處理

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

事件 預設行為

AlertClicked

按一下警示項目時,會顯示該警示項目的內容。allowDrillDown 屬性必須設定為 True

DrillUpClicked

按一下 [向上一層] 超連結時,ItemsGrid 元件會向上導覽一個階層層級,並顯示父項目。

ItemClicked

按一下項目時,會顯示該項目的內容,並依據 sortField 屬性指定的欄位,及依照 itemSourcesortDirection 屬性指定的排序方向來排序內容。ItemsGrid 元件的 allowDrillDown 屬性必須設定為 True

PagerClicked

按一下 [下一頁]、[上一頁]、[下一頁範圍] 或 [上一頁範圍] 按鈕時,會變更頁面索引,同時適當地設定並顯示目前頁面。

SortClicked

按一下欄位 (資料行) 標題時,會依照該欄位排序 ItemsGrid 元件中的項目 (資料列)。再按一下該欄位時,排序順序會反轉過來。

如果 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