ビジュアルデザイナーで編集中のページでチェックボックスグループコンポーネント
を選択すると、そのプロパティーが「プロパティー」ウィンドウに表示されます。この JavaServer Faces 1.2 コンポーネントには、次のプロパティーがあります。
型: Stringid 属性の値になります。ページ Bean では、このプロパティーの値が CheckboxGroup オブジェクトの名前になります。型: int<table> 要素で表形式で描画されます。行数は items 配列の長さで定義します。列数は columns 属性で定義します。デフォルトのレイアウトは 1 列です。 型: Stringfor」プロパティーには、グループ内の最初のチェックボックスが設定されます。
label」プロパティーはラベルコンポーネントほど柔軟ではありません。コンポーネントに対するラベルの位置など、ラベルの外観をより制御したい場合は、ラベルコンポーネントを使用できます。型: intlabel」プロパティーを設定した場合にのみ有効です。 型: String position: absolute; left: 288px; top: 312px
値を直接入力するか、省略符号ボタン (...) をクリックしてスタイルエディタを使用して入力します。
CSS2 スタイル属性の一覧は、次の Web ページを参照してください。
型: Stringstyle」プロパティーの注を参照してください。 型: Converterenum クラスを使用する必要があります。型: Objectcom.sun.webui.jsf.model.Option のサブクラスである配列、コレクション、またはマップに関連付けます。Option の各インスタンスは 1 つのチェックボックスを表します。Option インスタンスの「value」プロパティーは、選択されたチェックボックスの値を表します。「items」プロパティーに何も指定されていないか、配列、マップ、またはコレクションが空の場合は、何も描画されません。
com.sun.webui.jsf.model.Option については、Javadoc の説明を参照してください。説明を表示するには、このクラスをページの Java ビューに追加し、クラス名の上にカーソルを置いて、Alt-F1 キーを押します。
デフォルトでは、このプロパティーは、checkboxGroup1DefaultOptions などの名前の com.sun.webui.jsf.model.MultipleSelectOptionsList オブジェクトに関連付けられています。そのオブジェクトのノードはに表示されます。このオブジェクトの目的は、デフォルトのチェックボックスをグループに追加することです。このオブジェクトはページ Bean 内にあります。
型: booleanfor」プロパティーをこのコンポーネントにリンクした場合、ユーザーが項目を選択しないでページを送信しようとするとエラーメッセージが表示されます。
型: Object チェックボックスグループコンポーネントは複数の値を持つことができます。このことは、使用できる値の型に関係します。
Object 配列、またはプリミティブの配列を参照する必要があります。この配列の個々の要素は、取り得るすべての選択肢から現在選択されている値を表します。 checkboxGroup.getValue() を呼び出したときに返されるオブジェクトは Object 配列になります。ユーザーが選択した値を処理する一般的な方法として、このコンポーネントを Object 配列にバインドし、ユーザーがページを送信したときにその配列値を検査する方法があります。「selected」プロパティーは、評価すると Object 型の値の読み取りと書き込みを行う値バインド式である必要があります。値バインド式から読み取られる Object 型の値によって、選択されたチェックボックスが識別されます。Object 型の値は、「items」プロパティーに割り当てられた値バインド式から取得される配列で指定されている 1 つ以上の Option インスタンスの value 属性と同じである必要があります。
「selected」プロパティーの値バインド式の書き込みメソッドは、JavaServer Faces ライフサイクルの UPDATE_MODEL_PHASE で呼び出されます。チェックボックスが選択されると、Object 型の値が write メソッドへの引数として渡されます。Object 型の値は、選択されたラジオボタンの値です。
詳細は、ページの最後にある「リストボックスコンポーネント」のチュートリアルへのリンクをクリックしてください。
型: MethodExpressionドロップダウンリストからバリデータを選択します。空白 (null) を選択すると、バリデータは呼び出されません。バリデータを選択する場合、「required」プロパティーを選択して、ユーザーが必ず値を入力するようにできます。
ビジュアルデザイナーでコンポーネントを右クリックして、「イベントハンドラを編集」>「<イベント名>」選択することによってイベントのプロパティーを設定できます。
null です。一般に、こうしたメソッドを定義するには、ビジュアルデザイナーでコンポーネントを右クリックして、「イベントハンドラを編集」>「processValueChange」を選択します。このメソッドのデフォルト名は component-id_processValueChange で、component-id はコンポーネントの「id」プロパティーの値です。validatorExpression」プロパティーに JavaServer Faces バリデータを選択するのではなく、バリデータメソッドをコーディングする場合は、コンポーネントを右クリックして「イベントハンドラを編集」>「validate」を選択します。このメソッドのデフォルト名は component-id_validate で、component-id はコンポーネントの「id」プロパティーの値です。この方法でメソッドを定義すると、「validator」プロパティーと「validate」プロパティーは自動的に設定されます。バリデータを定義する場合は、「required」プロパティーを選択して、ユーザーが必ず値を入力するようにできます。
validatorExpression」プロパティーの値も設定されます。独自のバリデータメソッドを定義する場合は、「validatorExpression」プロパティーの値を変更しないでください。変更した場合、定義したバリデータメソッドとの関連付けが失われる可能性があります。型: booleandisabled」プロパティーを使用したときの働きと「readOnly」プロパティーを使用したときの働きについては、「readOnly」プロパティーの注を参照してください。型: booleandisabled」プロパティーを使用した場合、JavaServer Faces は値が送信されたことを検出しません。型: Stringtitle 属性を設定します。ユーザーがチェックボックスグループのラベルの上にマウスカーソルを置くと、このプロパティーに設定したテキストが表示されます。
型: booleanrendered」プロパティーを選択解除します。型: String型: String型: String型: String型: String型: String型: String型: String型: String型: String型: String型: booleanimmediate アクションの最も一般的な例は、「取消し」ボタンです。「取消し」ボタンを immediate にして通常の妥当性検査や更新を飛ばすことができますが、アクションハンドラは引き続き必要なことをすべて行うことができます。一般には、アクションハンドラは前のページに戻ります。デザインによっては、アクションハンドラが「トランザクションが取り消されました」などの情報メッセージをキューに入れるものもあります。より多くのことを行うことも可能です。たとえば、ユーザーが現在の操作を取り消した事実を記録することもできます。
型: booleanvisible」プロパティーを選択解除します。
このプロパティーは、コンポーネントをいつ描画するかを決定する JavaBean プロパティーにバインドできます。たとえば航空機の予約フォームで、頻繁に利用する顧客にはコンポーネントを表示し、一般の利用客には表示しないようにできます。このプロパティーをバインドするには、プロパティーの右側にある省略符号ボタン (...) をクリックし、ダイアログで「バインドを使用」を選択します。