このダイアログでは、リスト項目を表示するコンポーネントの「 items 」プロパティーにデータプロバイダまたはオブジェクトを関連付けることができます。この関連付けを作成することによって、コンポーネントのリスト内の項目を実行時に変更することができます。
このダイアログは、Visual Web JSF ページに追加した基本リストボックス、チェックボックスグループ、ラジオボタングループ、ドロップダウンリストいずれかのコンポーネントを右クリックし、「データにバインド」を選択した場合に開きます。
ダイアログの一番上のフィールドは、コンポーネントの「 items 」プロパティーの現在の設定を示します。デフォルトでは、このプロパティーは、リストを埋めているデフォルトオブジェクトの「 options 」プロパティーにバインドされています。たとえば dropDown1 というドロップダウンリストの場合、このオブジェクトは dropDown1DefaultOptions です。
selected 」プロパティーなどの、コンポーネントの別のプロパティーをバインドする場合は、このダイアログを閉じて、ページでコンポーネントを右クリックし、「プロパティーのバインド」を選択して、 「プロパティーのバインド」ダイアログ を開きます。 バインドを設定するには、目的の種類のバインドを行うタブ、すなわち「データプロバイダにバインド」または「オブジェクトにバインド」のいずれかを選択します。
このタブでは、コンポーネントのプロパティーを、このダイアログを開く前にページに追加した データベース列 にバインドできます。
表示されたデータプロバイダに使用するプロバイダがない場合は、「<コンポーネント名>にバインドするデータプロバイダを選択」ドロップダウンリストから別のデータプロバイダを選択します。このドロップダウンリストにも使用するプロバイダがない場合は、アプリケーションに応じて、データベース表をページに追加する必要があります。
データプロバイダを選択すると、そのデータプロバイダからの項目を使用して「値フィールド」および「表示フィールド」リストが生成されます。データプロバイダが表すオブジェクトに応じて、これらリスト内の項目は、データベース列か Web サービスメソッド、またはエンタープライズ Bean メソッドを表すことができます。2 つの列はそれぞれ、ページ上のコンポーネントが表示するリスト項目の異なる側面を表します。
コンポーネントのリストを埋めるのに使用するすべての項目を選択します。
項目を選択すると、ダイアログの一番上の入力フィールドに、選択された項目を参照する JavaServer Faces 式が自動的に設定されます。
選択に問題がなければ、「了解」をクリックして、コンポーネントの「 items 」プロパティーにバインドを適用します。
このタブでは、コンポーネントのプロパティーを JavaBean プロパティーにバインドできます。必要に応じて独自の JavaBeans オブジェクトを作成し、リスト項目を制御できます。プロパティーを選択し、「了解」をクリックするとプロパティーをバインドできます。
デフォルトでは、リストコンポーネントの「items」プロパティーは、リストを生成するために IDE が生成するオブジェクトの「options」プロパティーにバインドされています。一般には、このオブジェクトは、ページ上でコンポーネントを右クリックし、「デフォルトオプションを設定」を選択することによって操作します。また、独自のオブジェクトを作成して、リストを生成することもできます。
たとえば dropDown1 という JavaServer Faces 1.2 のドロップダウンリスト用に作成した JavaBeans オブジェクトの名前は、dropDown1DefaultOptions です。このオブジェクトの「Options」プロパティーは com.sun.webui.jsf.model.Option オブジェクトからなる配列で、これらのオブジェクトにはそれぞれに String 型の「ラベル」(リスト内の表示値) と Object 型の「値」(リスト項目の値) の 2 つのフィールドがあります。
com.sun.rave.web.ui.model.Option パッケージ内にあります。