Faces Client コンポーネントのイベント・ハンドラーは、クイック編集ビューで作成されます。Faces Client コンポーネントのプロパティー・ビューには、クイック編集ビューへのリンクを含みます。データ・ツリー・ビューおよびデータ・グリッド・コンポーネントの場合は、提供されているイベント・ハンドラーを使用することも、あるいはカスタマイズした独自のイベント・ハンドラーを作成することもできます。
2 個の out-of-box イベント・ハンドラーがあります。
注: 一部の Faces Client コンポーネントおよびクライアント・データの使用は推奨されません。
以下については、使用を推奨しません。
- クライアント・データおよびその関連ツール (「クライアント・データ」ビューなど)
- Faces Client コンポーネント
- <odc:dataGrid> (データ・グリッド)
- <odc:webService> (Web サービス)
- <odc:clientData>
- <odc:clientBinder>
- 選択したオブジェクトをターゲット・コンポーネント内のルートとして設定 -
このハンドラーは、現在のコントロールで選択されたオブジェクト (オプションで、そのオブジェクト内の特定の参照) を受け取り、
それをターゲット・コントロールのルート・オブジェクトにします。
このタイプのイベント・ハンドラーで
ターゲット・コントロールにできるのは、
任意の Faces Client コンポーネント (Web サービスは除く)
と、Faces Client がサポートする標準の JSF コンポーネントです。
ターゲット・コントロールにできるもののリストが、表示される構成ダイアログに示されます。 データ・ツリー (ソース) で選択されたオブジェクトによって、
データ・グリッド (ターゲット) に表示する内容を決定したい場合に、このイベント・ハンドラーを使用します。このハンドラーは、データ・ソースのデータ値は全く変更しませんが、
選択されたコントロールに何を表示するのかを設定します。
- 選択したオブジェクトを別のオブジェクトにバインド - このハンドラーは、
選択されたオブジェクトの値 (オプションで、そのオブジェクト内の特定の参照) を受け取り、
それを別のデータ・オブジェクトにバインドします。 このイベント・ハンドラーによって、
データ・オブジェクトに保管されるデータ値を設定します。
ポートフォリオ・サンプルでは、ユーザーがデータ・グリッドから特定の株式を選ぶと、
その株式オブジェクト内のフィールドの値が placeHolderStock データ・オブジェクトに
コピーされます。これは後に、Web サービスへの入力パラメーターとして使用されます。ハンドラーは、そのオブジェクト内に保管された値を変更します。