顯示資料夾項目

若要向使用者列出並顯示資料夾清單，您可以將 ItemsGrid 和 ItemsColumn 元件 加至頁面。ItemsGrid 元件會在具有資料列及資料行的格線中建構重複的資訊 (如資料夾或報表的清單)。格線中的每一資料列代表不同的項目；在本教學課程中，每一個項目就是一個資料夾。格線的每一資料行就是個別的 ItemsColumn 元件，代表著項目的不同欄位。

您稍後會將 Path 元件加至頁面頂端，以便加入導覽能力。

加入 ItemsGrid 元件

1. 開啟 contents.jsp 頁面。
2. 若要為 Path 元件預留空間，請在頁面頂端插入游標，並加入換行字元 (Carriage Return)。
3. 在 [調色盤] 檢視的 [Crystal Reports Faces 元件] 索引標籤之下，按一下 [Enterprise ItemsGrid]，並拖曳 [ItemsGrid] 元件到視覺化設計工具的頁面上。

在此步驟中會提示您指定用於 ItemsGrid 元件中的項目來源。

您必須建立一個 EnterpriseItems Bean，並將其繫結至 ItemsGrid 元件。EnterpriseItems Bean 代表要在格線中顯示的資料夾集合。

4. 在 [新建 ItemsGrid] 視窗中，將 [項目來源] 欄位保留空白，並按一下 [新增]。

然後會提示您選擇一個 Identity Bean。EnterpriseItems Bean 具有 identity 屬性；您必須將其初始化為 Identity Bean，以提供 Enterprise 工作階段及使用者憑證。

5. 從清單中選擇現有的 Bean [identity]，然後按一下 [Folders only]，再按 [完成]。

這個步驟將 EnterpriseItems Bean 加入到 [新建 ItemsGrid] 視窗中的 [項目來源] 欄位。選取，接著按一下 [完成]。

6. 在 [屬性] 檢視中，設定 id 屬性為 foldersList。
7. 在 [屬性] 檢視中，清除 [showDrillUpLink] 核取方塊。

因為 Path 元件會處理向上導覽項目階層的行為，所以不需要連結。

8. 在 [屬性] 檢視中，清除 [showHeader] 核取方塊。

這個屬性會控制頁首欄位的可視性。在本教學課程中，會隱藏頁首欄位；但可以設定 showHeader 屬性為 True，以顯示資料行標題 (該標題描述格線中的每個欄位)。

9. 在 [屬性] 檢視中，設定 showImages 屬性為 Icon。

在格線的每個項目旁邊，都會顯示代表性的圖示影像。

注意:
   Icon 欄位是 com.businessobjects.jsf.sdk.properties.Image 類別成員。

建立 ItemsGrid 元件時，也會建立一個或多個代表格線資料行的 ItemsColumn 子元件 (您可以自訂代表依照預設建立之欄位的資料行數；如需詳細資料，請參閱我要如何變更 UI 元件的預設偏好設定？)。您可以在視覺化設計工具中選取並編輯那些個別資料行。

對於此格線，您只想要顯示單一資料行：每個資料夾的名稱。因此，您必須保留顯示項目之 [SI_NAME] 欄位的資料行，然後移除所有其他資料行 (例如 [SI_PROGID] 或 [SI_DESCRIPTION] 欄位資料行)。

從 ItemsGrid 元件移除資料行 (ItemsColumn 元件)

• 以滑鼠右鍵按一下 ItemsGrid 元件中的個別資料行，再按 [刪除]。

重複這個步驟以移除 ItemsGrid 元件中，除了 [SI_NAME] 資料行以外的所有其他資料行。如需有關如何操作資料行的詳細資訊，請參閱我要如何操作 ItemsGrid 元件中的資料行？。