プライマリ・コンテンツに移動

Oracle® Application Express APIリファレンス リリース5.1 E85937-02 |
| 目次 | 索引

前 | 次 |

# 13.10 POPUPKEY_FROM_LOVファンクション

このファンクションは、共有LOVからポップアップ・キー選択リストを生成します。`APEX_ITEM`パッケージで使用可能な他のファンクションと同様に、`POPUPKEY_FROM_LOV`ファンクションは、`F01`から`F50`のフォームの配列要素でフォームを生成するように設計されています。

構文

    APEX_ITEM.POPUPKEY_FROM_LOV(
        p_idx              IN    NUMBER,
        p_value            IN    VARCHAR2 DEFAULT NULL,
        p_lov_name         IN    VARCHAR2,
        p_width            IN    VARCHAR2 DEFAULT NULL,
        p_max_length       IN    VARCHAR2 DEFAULT NULL,
        p_form_index       IN    VARCHAR2 DEFAULT '0',
        p_escape_html      IN    VARCHAR2 DEFAULT NULL,
        p_max_elements     IN    VARCHAR2 DEFAULT NULL,
        p_attributes       IN    VARCHAR2 DEFAULT NULL,
        p_ok_to_query      IN    VARCHAR2 DEFAULT 'YES',
        p_item_id          IN    VARCHAR2 DEFAULT NULL,
        p_item_label       IN    VARCHAR2 DEFAULT NULL)
        RETURN VARCHAR2;

ポップアップに関連付けられたテキスト・フィールドはLOV問合せの1列目に表示されますが、実際の値は問合せの2列目で指定されます。

パラメータ

表13-10 POPUPKEY_FROM_LOVのパラメータ

パラメータ | 説明
--- | ---
`p_idx` | フォーム要素名を示します。たとえば、`1`は`F01`、`2`は`F02`です。通常、`p_idx`は指定した列の定数です。 `POPUPKEY_FROM_QUERY`の動作のため、次の索引の値は`p_idx + 1`である必要があります。次に例を示します。
    SELECT APEX_ITEM.POPUPKEY_FROM_LOV (1,deptno,'DEPT') dt,
    APEX_ITEM.HIDDEN(3,empno) eno
`p_value` | 現行の値を示します。この値は、`P_LOV_NAME`パラメータのいずれかの値である必要があります。
`p_lov_name` | このポップアップで使用される名前付きLOVを示します。
`p_width` | テキスト・ボックスの幅。
`p_max_length` | テキスト・ボックスに入力可能な最大文字数。
`p_form_index` | アイテムが含まれるページのHTMLフォーム。デフォルトは0ですが、ほとんど使用しません。 このパラメータは、ページ・テンプレートにカスタム・フォーム(別のWebサイトにポストする検索フィールドなど)を埋め込む必要がある場合にのみ使用します。このフォームが`#FORM_OPEN#`置換文字列の前にある場合、この索引は0 (ゼロ)で、Oracle Application Expressによって自動的にオープンされるフォームはフォーム1として参照される必要があります。この機能では、フォーム要素に値を戻すポップアップLOVで使用されるJavaScriptがサポートされています。
`p_escape_html` | 同等のものにエスケープする必要がある特殊文字の置換文字。 `<`に対する`&lt;` `>`に対する`&gt;` `&`に対する`&amp;` このパラメータは、問合せが無効なHTMLを戻すことがわかっている場合に有効です。
`p_max_elements` | 問合せで戻せる行数の制限。ユーザー検索によるパフォーマンスの影響を制限します。このパラメータに値を入力することで、ユーザーがより限定された結果セットを検索するように強制できます。
`p_attributes` | フォーム・アイテムで使用する追加のHTML属性。
`p_ok_to_query` | 値の範囲は`YES`および`NO`です。`YES`の場合、ポップアップはLOVに最初の行セットを戻します。`NO`の場合、行を戻すために検索が開始されます。
`p_item_id` | <input>タグのHTML属性のID
`p_item_label` | アイテムに対して作成された非表示のラベル

例

次の例に、共有LOVからポップアップ・キー選択リストを生成する方法を示します。

    SELECT APEX_ITEM.POPUPKEY_FROM_LOV (1,deptno,'DEPT') dt
    FROM emp