24.8 POPUP_FROM_LOVファンクション

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

構文

APEX_ITEM.POPUP_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;

パラメータ

表24-8 POPUP_FROM_LOVのパラメータ

パラメータ	説明
p_idx	フォーム要素名。たとえば、1はF01、2はF02です。通常、p_idxは指定した列の定数です。
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; 値の範囲はYESおよびNOです。YESの場合は、特殊文字がエスケープされます。このパラメータは、問合せが無効なHTMLを戻すことがわかっている場合に有効です。
p_max_elements	問合せで戻せる行数の制限。ユーザー検索によるパフォーマンスの影響を制限します。このパラメータに値を入力することで、ユーザーがより限定された結果セットを検索するように強制できます。
p_attributes	フォーム・アイテムで使用する追加のHTML属性。
p_ok_to_query	値の範囲はYESおよびNOです。YESの場合、ポップアップはLOVに最初の行セットを戻します。NOの場合、行を戻すために検索が開始されます。
p_item_id	フォーム要素のID属性。
p_item_label	アイテムに対して作成された非表示のラベル。

例

次の例に、DEPT_LOVというLOVからポップアップを生成する問合せの例を示します。

SELECT APEX_ITEM.POPUP_FROM_LOV (1,deptno,'DEPT_LOV') dt 
FROM emp