テンプレート
リッチ・クライアント変換と同様に、リッチ・クライアント・テンプレートは Java™ クラスです。これは、org.eclipse.swt.widgets.Composite から 拡張する com.ibm.hats.rcp.ui.templates.RcpTemplate クラスから 拡張します。テンプレートは、SWT ウィジェット、 マクロ・コントロール、ホスト・キー、および アプリケーション・キーを含むことができます。テンプレートは SWT コンポジットであるため、テンプレートには非 ZIETrans ウィジェットを追加できます。
テンプレートにホスト・コンポーネント (ComponentRendering コンポジット)、 デフォルト・レンダリング・コンポジット、グローバル変数コントロールを 含めることはできませんが、変換にはこれらを含めることができます。
テンプレートは、ZIETrans が提供するいずれかの定義済みテンプレートを拡張することで作成できます。テンプレートは、以下のような アプリケーションの基本的レイアウトおよびスタイルを定義します。
- 変換に使用する前景色および背景色
- 変換に使用するフォント
- 静的ラベル (ロゴ・イメージなど)
- リンク (企業のホーム・ページなど)
表 1 に、RcpTemplate クラスによってオーバーライド可能なメソッドをリストします。
メソッド | 説明 |
---|---|
getDefaultFont() | ウィジェットが使用するデフォルトのフォントを戻します。 |
getDefaultMonospacedFont() | テンプレート・レベルでデフォルトのモノスペース・フォントをオーバーライドできるようにします。 |
getDefaultBackgroundColor() | テンプレートのデフォルト背景色を戻します。 |
getDefaultForegroundColor() | テンプレートのデフォルト前景色を戻します。 |
getColorMapper() | ホスト色がビュー上の色にマップされる方法を制御する IColorMapper オブジェクトを戻します。 |
getTableColorProvider() | テーブル制御でどの色を使用するかを制御する ITableColorProvider オブジェクトを戻します。 |
getContentContainer() | テンプレートに表示される変換やコンポジットの親になる コンポジットを戻します。 |
これらのメソッドについて詳しくは、「ZIETrans リッチ・クライアント・プラットフォーム API リファレンス」を参照してください。
ZIETrans ランタイムは、テンプレートの構成と廃棄を担当します。ZIETrans ランタイムは、以下のステップを実行します。
- 指定したテンプレート・クラスのインスタンスを新規構成します。このクラスは、RcpTemplate から派生させる必要があります。これは、RcpTemplate から拡張するか、RcpTemplate から拡張するクラスから拡張する必要があるということを意味します。
- 変換クラスのインスタンスを新規構成します。
- テンプレート・インスタンスの setContent() メソッドに変換インスタンスを渡して、このメソッドを呼び出します。このメソッドは、変換インスタンスの applyStyleToComposite() メソッドを呼び出します。
- 変換ビュー・インスタンスの setContent() メソッドにテンプレート・インスタンスを渡して、このメソッドを呼び出します。