<totalRow>要素
ネームスペース: http://xmlns.oracle.com/uix/ui
派生元: <ui:base>要素
グループ: UIX Components
要素の型: UINode

<totalRow>要素は、表のcolumnFooterに追加され、合計行を作成します。
このBeanは、エージェントのタイプがPDA、携帯電話、音声の場合にはサポートされません。

構文
<totalRow
    [ destination="anyURI" ]
    [ readOnly="boolean" ]
    [ text="string" ]
>
   <contents><!-- indexed children --></contents>
</totalRow>

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

  • 説明

    TotalRowBeanを使用すると、ユーザーはボタンをクリックして1つ以上の列の合計を更新できます。 TotalRowBeanを使用するには、TableBeanのfooterとして設定し、ColumnBeanのfooterを更新する合計フィールドに設定します。

    クライアントがTotalRowBeanに対して行えるカスタマイズが2種類あります。 まず、更新ボタンのテキストをカスタマイズできます。 デフォルトでは、ボタンに「更新」のテキストが表示されます。 必要に応じて、クライアントはtextプロパティを任意のテキストに設定することにより、ボタンのテキストを変更できます。

    もう1つのカスタマイズは、クリックしたときのボタンのリンク先です。 デフォルトでは、リンク先は、フォーム送信またはURL引数のいずれかが使用されます。これは、親表でどちらをオンにするかによって決まります。 フォーム送信を使用する場合、TotalRowBeanでは、eventフォームの値をupdateに、sourceフォームの値を表名に設定した表のフォームが、TotalRowBeanにより送信されます。 URL引数リンクを使用する場合は、同じ2つのキーと値のペアがパラメータとして送られます。 詳細は、TableBeanのドキュメントを参照してください。

    標準のリンク先が適切でない場合、クライアントはTotalRowBeanのdestinationプロパティを任意の値に設定することにより、リンク先をオーバーライドできます。

    また、TotalRowBeanで実際の合計データ・セルを表示するには、クライアントでColumnBeanのfooterにノードを追加する必要があります。


    次の例では、表のフッターに合計行を作成します。 また、要素を配置して合計を右端の列に表示します。

    <table ... >
      <contents>
        <column>
          <columnHeader>First Header</columnHeader>
          <contents>
            <!-- the first column stamp, a text node -->
            <textInput name="foo" text="${uix.current.firstColumnText}"/>
          </contents>
        </column>
        <column>
          <!-- column footer is a textInput. This is used with totalRow -->
          <footer>
            <textInput columns="5" name="total" text="42"/>
          </footer>
          <columnHeader>Second Header</columnHeader>
          <!-- the second column stamp, a button -->
          <contents>
            <button destination="http://www.oracle.com"
                    text="${uix.current.secondColumnText}"/>
          </contents>
        </column>
      </contents>
      <!-- table footer is a totalRow -->
      <footer>
        <tableLayout hAlign="right">
          <contents>
            <rowLayout>
              <contents>
                <cellFormat>
                  <contents>
                    <totalRow/>
                  </contents>
                </cellFormat>
              </contents>
            </rowLayout>
          </contents>
        </tableLayout>
      </footer>
    </table>

    属性

    説明
    destination このボタンが参照するURI。
    URI
    readOnly trueに設定されている場合、ボタンはレンダリングされません。
    boolean
    text ボタンに表示するテキスト。
    string

    子要素

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