listOfValuesについて

listOfValuesコンポーネントは、一般的な説明を含むヘッダー、検索条件ブロックおよび結果表を表示するレイアウトを定義します。listOfValuesコンポーネントは、適切な値を検索して選択するために使用される値リスト(LOV)のダイアログ・ウィンドウのコンテンツを移入するために使用します。listOfValuesコンポーネントは、lovInputコンポーネントとともに使用するように設計されています。

listOfValuesコンポーネントで表示可能なコンテンツは、proxiedおよびformsubmittedが指定された表に限定する必要があります。この表は、有効値のデータセット全体に現行の検索条件をフィルタとして使用することによって決定される有効な値がすべて表示されます。この表にデータを移入する必要があります。listOfValuesコンポーネントは、表をそのまま表示するだけです。詳細な情報の追跡が必要な場合、開発者は表コンポーネントとともに1つ以上のformValue要素(非表示フィールド)をflowLayoutで指定できます。

LOVウィンドウが開くと、ユーザーが最初に入力したテキストに基づいて予想された完成表が表示されます。ユーザーは次の処理を選択できます。

List Of Values layout with basic search block

次のUIX XMLコードSnippetはlistOfValuesコンポーネントを示します。


...
<listOfValues title="Available peak values"
              id="lovHandler"
              searchText="${uix.data.fieldData}">
  <headerInstructions>
    <styledText text="Choose a peak"
                styleClass="OraInstructionText"/>
  </headerInstructions>
  <searchInstructions>
    <styledText text="You can also change or refine your search.
                      Try searching on peaks using a search text of 'A',
                      'K', or 'M'. Try searching locations using an 'N'."
                styleClass="OraInstructionText"/>
  </searchInstructions>
  <filterChoice>
    <choice name="categoryChoice">
      <!-- fill in the choices from the column headers -->
    </choice>
  </filterChoice>
  <contents>
    <!-- Here's the table definition -->
    <!-- This must be a form submitted proxied table -->
    <table id="lovTbl"
           formSubmitted="true"
           proxied="true" ... >
      <!-- Populate with some data -->
    </table>
  </contents>
</listOfValues>
...    

listOfValuesの索引付けされた子はtableコンポーネントのみであり、これはユーザーのsearchTextを使用したベース・データのフィルタリングから戻された一致の表示に使用されます。

通常、listOfValuesのコンテンツ要素はtableコンポーネントを取りますが、任意のノードを取るため、次のようなコンテンツを設定することにより、表(または検索の選択項目)で得られる送信に追加データを追加できます。

...
<contents>
  <flowLayout>
    <contents>
      <table>
        ...
      </table>
      <formValue name="extraParam" value="${uix.current.secretParam}"/>
    </contents>
  </flowLayout>
</contents>
...    

listOfValuesに設定できる属性は次のとおりです。

listOfValuesでサポートされる名前付きの子は次のとおりです。

場合によっては、選択値をテキスト入力フィールドに送信する以外の操作の実行が必要な場合があります。このような場合は、lovOpenWindowActionクライアント・アクションを使用します。詳細は、「lovOpenWindowActionクライアント・アクションについて」を参照してください。

lovInput、listOfValuesおよびlovOpenWindowActionを使用したLOVの作成は、「ADF UIX開発者ガイド」を参照してください。


messageLovInputについて

listOfValuesの挿入
レイアウト・コンポーネントの使用

 

Copyright © 1997, 2004, Oracle. All rights reserved.