通用元件屬性

有幾個屬性是一個以上的 JSF 元件標示所共同具備的,而且必須設定為類似的值。表中所列屬性適用於一個以上的元件:

autoHandleEvents

包含 autoHandleEvents 屬性的元件標示為:

  • itemsGrid
  • logon
  • path

若設定為 True,就會執行在特定用戶端動作之後,叫用元件的預設事件處理常式。根據預設,此屬性設定為 True。

每個元件有立即可用的商務邏輯,在 autoHandleEvents 屬性設定為 True 時會自動執行。這可讓您快速且容易地建立 Crystal Enterprise Web 應用程式。

在這種情況下,當元件觸發特定動作事件時,就會在伺服器上自動處理用戶端與元件的互動。

在適當的 JSF 元件 節中,將會解說每個元件所實作的這些事件處理常式的個別行為。

autoHandleEvents 屬性設定為 False 時,用戶端與元件的互動所觸發的事件 (例如:使用者按一下按鈕或連結時) 會導致伺服器端不發生元件的行為。在這種情況下,您可以用程式碼後置 (Code-Behind) 的方式實作自訂事件處理常式。然後將那些處理常式連接至適當的事件,以執行所要的商務邏輯。

identity

包含 identity 屬性的元件標示為:

  • logon

指定要與元件資料繫結的驗證憑證及工作階段資訊。這個屬性所指定的 Identity Bean 代表一組特定的使用者憑證,要與在用戶端執行動作的使用者產生關聯。因此,這個 Bean 會封裝使用者的識別身分。

itemSource

包含 itemSource 屬性的元件標示為:

  • itemsGrid
  • path

指定要與元件資料繫結的項目或一組項目,例如報表、資料夾或報表執行個體。元件會將 EnterpriseItem BeanEnterpriseItems Bean 拿來作為 itemSource 屬性值。

labelAlignment

包含 labelAligment 屬性的元件標示為:

  • logon

指定元件內所有標籤的對齊方式。可能的值為 com.businessobjects.jsf.sdk.properties.HorizontalAlign 類別的欄位:

  • Center
  • Justify
  • Left
  • NotSet
  • Right

submitButton

包含 submitButton 屬性,或包含繼承自相同 SubmitButton 類別之屬性的元件標示為:

  • logon

submitButton 屬性存取 SubmitButton 類別的執行個體,此類別包含 alignmentimageUrltexttype、以及 visible 屬性。

alignment 屬性指定提交按鈕相對於元件輸入欄位的水平對齊方式。可能的值為 com.businessobjects.jsf.sdk.properties.HorizontalAlign 類別的欄位:

  • Center
  • Justify
  • Left
  • Not Set
  • Right

type 屬性指定可用於元件提交動作的按鈕種類。可能的值為 com.businessobjects.jsf.sdk.properties.ButtonType 類別的欄位:

  • Button
  • ImageButton
  • LinkButton

text 屬性指定顯示在 ButtonLinkButton 類型提交按鈕上的文字,或顯示為 ImageButton 類型提交按鈕工具提示的文字。

imageUrl 屬性指定要顯示為 ImageButton 類型按鈕的影像 URL。

visible 屬性可以設定為顯示或隱藏按鈕。



Business Objects
http://www.taiwan.businessobjects.com/
支援服務
http://www.businessobjects.com/services/support/