<uix:multipleSelection>タグ |
![]() |
ネームスペース: | http://xmlns.oracle.com/uix/ui |
派生元: | <uix:base>タグ |
グループ: | UIX Components |
タグの型: | UINode |
構文 |
![]() |
<uix:multipleSelection
[ disabled="boolean"
]
[ disabledBinding="data binding to boolean"
]
[ selected="boolean"
]
[ selectedBinding="data binding to boolean"
]
[ text="string"
]
[ textBinding="data binding to string"
]
[ selectionBinding ="data binding to oracle.cabo.ui.data.DataObjectList" ] >
<uix:contents> <!-- indexed children --> </uix:contents>
</uix:multipleSelection>
説明 |
![]() |
MultipleSelectionBeanは、TableBeanに複数選択を提供します。TableBeanのコンテキストにおいてのみ有効で、TableBeanで初期化し、tableSelectionプロパティとして設定する必要があります。単一選択の表には、かわりにSingleSelectionBeanを使用します。 表にMultipleSelectionBeanを追加すると、(Oracle UIガイドラインに基づいて)Tableに選択列がレンダリングされ、表のコンテンツのまわりにコントロール・バーがレンダリングされます。選択は、表内にレンダリングされたチェックボックス列により表されます。クライアントでの追加の作業は必要ありません。 Tableの上および下にレンダリングされるコントロール・バーは、Table内にMultipleSelectionBeanがある場合に自動的に表示されます。コントロール・バーに表示されるテキストは、MultipleSelectionBeanのtextプロパティの値です。さらに、MultipleSelectionBeanの索引付けされた子が、右側のコントロール・バー内にレンダリングされます。これらのプロパティによって、クライアントはOracle UIガイドラインで指定されているコントロール・バーを容易に作成できます。ここには、たとえば、選択された行に対して機能するボタンと、それに対する説明テキストを追加したりすることができます。 MultipleSelectionBeanの初期選択状態は、表の行にマップされているDataObjectの集合体であるDataObjectListにより取得されます。このDataObjectListは、selectionプロパティを設定することにより指定します。このDataObjectListが指定されていない場合、表自体のデータの生成に使用されるものと同じDataObjectListが使用されます。 表の行ごとに、selectionプロパティのDataObjectListは、対応する行の選択状態を問い合せることのできるDataObjectを返す必要があります。各DataObjectの問合せに使用されるキーは、selectedバインド・プロパティを使用して設定する必要があります。行DataObjectが、selectedバインド・プロパティの値による問合せにBoolean.TRUEを返した場合、その行は初期状態では選択されています。それ以外の場合、その行は初期状態では選択されていません。 選択内の行は使用不可にできます。これによって、行は選択できなくなります。これを行うには、単にdisabledプロパティがtrueを返すよう設定します。ただし、ほとんどの場合、選択不可にする必要があるのは特定の行のみです。この場合は、使用不可にするDataObject行に対してtrueを返すdisabledプロパティをバインドします。前述のとおり、このプロパティについても、まずselectionプロパティで指定されたDataObjectListがチェックされ、selectionで指定されていない場合、表自身のDataObjectListが問い合されることに注意してください。 ユーザーの選択結果は、行およびこれが含まれている表名に基づくフォーム要素によりページ内に格納されます。これにより、ユーティリティ・クラスServletRequestDataSetを使用し、フォーム送信時にユーザーが選択した行を容易に判断できます。クライアントはServletRequestおよびTableBeanの名前を使用してServletRequestDataSetを作成し、そのDataSetによりgetSelectedIndices()をコールすることで、選択されたゼロから始まる行番号を取得できます。
選択領域の外観
初期状態での選択
選択の使用不可
選択の結果
属性 |
![]() |
子タグ |
![]() |
|