<uix:singleSelection>タグ
ネームスペース: http://xmlns.oracle.com/uix/ui
派生元: <uix:base>タグ
タグの型: UINode

このタグは、tableのtableSelectionの子として使用し、単一選択を実装します。
このBeanは、エージェントのタイプがPDA、携帯電話、音声の場合にはサポートされません。

構文
<uix:singleSelection
    [ disabled="boolean" ]
    [ selected="boolean" ]
    [ selectedIndex="unsignedInt" ]
    [ text="string" ]
    [ primaryClientActionBinding ="data binding to oracle.cabo.ui.action.ClientAction" ]
>
   <uix:contents><!-- indexed children --></uix:contents>
</uix:singleSelection>

注意:
  • このタグは派生元タグのすべての属性と子タグを持つことができます。

  • 説明

    このタグは、TableBeanに単一選択を提供します。 TableBeanのコンテキストにおいてのみ有効で、TableBeanで初期化し、tableSelectionプロパティとして設定する必要があります。 複数選択の表には、かわりにMultipleSelectionBeanを使用します。

    選択領域の外観

    表にSingleSelectionBeanを追加すると、(Oracle UIガイドラインに基づいて)Tableに選択列がレンダリングされ、表のコンテンツのまわりにコントロール・バーがレンダリングされます。 選択は、表内にレンダリングされたラジオ・ボタン列により表されます。クライアントでの追加の作業は必要ありません。

    Tableの上および下にレンダリングされるコントロール・バーは、Table内にSingleSelectionBeanがある場合に自動的に表示されます。 コントロール・バーに表示されるテキストは、SingleSelectionBeanのtextプロパティの値です。 さらに、SingleSelectionBeanの索引付けされた子が、右側のコントロール・バー内にレンダリングされます。 これらのプロパティによって、クライアントはOracle UIガイドラインで指定されているコントロール・バーを容易に作成できます。ここには、たとえば、選択された行に対して機能するボタンと、それに対する説明テキストを追加したりすることができます。

    初期状態での選択

    SingleSelectionBeanの初期選択状態は、selectedIndexプロパティにより指定されます。 これは、初期状態で選択される表の行を示すゼロから始まる索引か、またはselectedIndexBindingプロパティで設定されたキーを使用して取得できるバインド整数のいずれかに設定します。 選択状態は、selectedプロパティによっても設定できます。 このプロパティはブール値にバインドされている必要があります(1行が選択されている場合はTRUE、それ以外の場合はFALSE)。

    選択の使用不可

    選択内の行は使用不可にできます。これによって、行は選択できなくなります。 これを行うには、単にdisabledプロパティがtrueを返すよう設定します。 ただし、ほとんどの場合、選択不可にする必要があるのは特定の行のみです。 この場合は、使用不可にするDataObject行に対してtrueを返すdisabledプロパティをバインドします。 使用不可の状態を問い合されるDataObjectは、表のデータ・コンテンツDataObjectListです。

    選択の結果

    ユーザーの選択結果は、行およびこれが含まれている表名に基づくフォーム要素によりページ内に格納されます。 これにより、staticメソッドgetSelectedIndex()を使用し、フォーム送信時にユーザーが選択した行を容易に判断できます。 クライアントはServletRequestおよびTableBeanの名前を使用してServletRequestDataSetを作成し、そのDataSetによりgetSelectedIndex()をコールすることで、選択されたゼロから始まる行番号を取得できます。


    属性

    説明
    disabled 単一選択を使用不可にするかどうか。
    boolean
    selected ボタンを選択してレンダリングするかどうか。 この属性へのバインディングは、selectedIndex属性の設定より優先されます。
    boolean
    selectedIndex 初期状態で選択されるゼロから始まる索引。
    unsignedInt
    text コントロール・バーに表示するテキスト。
    string
    primaryClientActionBinding ラジオ・ボタンを選択した場合に、クライアント上で起動するclientAction。
    oracle.cabo.ui.action.ClientActionへのデータ・バインディング

    子タグ

    説明 必須 組込み可能な数
    <uix:contents>
    Beanの索引付けされた子。
    いいえ 1