24.14 SELECT_LIST_FROM_LOVファンクション

このファンクションは、共有の値リスト(LOV)から選択リストを動的に生成します。APEX_ITEMパッケージで使用可能な他のファンクションと同様に、これらの選択リストのファンクションはF01からF50のフォームの配列要素でフォームを生成するように設計されています。このファンクションはSELECT_LIST_FROM_LOVと同じですが、戻り値はVARCHAR2になります。4000文字を超える列値を処理する必要があるSQL問合せで、このファンクションを使用します。

構文

APEX_ITEM.SELECT_LIST_FROM_LOV(
    p_idx           IN   NUMBER,
    p_value         IN   VARCHAR2 DEFAULT NULL,
    p_lov           IN   VARCHAR2,
    p_attributes    IN   VARCHAR2 DEFAULT NULL,
    p_show_null     IN   VARCHAR2 DEFAULT 'YES',
    p_null_value    IN   VARCHAR2 DEFAULT '%NULL%',
    p_null_text     IN   VARCHAR2 DEFAULT '%',
    p_item_id       IN   VARCHAR2 DEFAULT NULL,
    p_item_label    IN   VARCHAR2 DEFAULT NULL,
    p_show_extra    IN   VARCHAR2 DEFAULT 'YES')
    RETURN VARCHAR2;

パラメータ

表24-14 SELECT_LIST_FROM_LOVのパラメータ

パラメータ	説明
p_idx	フォーム要素名。たとえば、1はF01、2はF02です。通常、p_idxパラメータは指定した列の定数です。
p_value	現在の値。この値はp_lovパラメータの値である必要があります。
p_lov	アプリケーションLOVのテキストの名前。このLOVはアプリケーションで定義する必要があります。このパラメータは、select_list_from_lovファンクションでのみ使用されます。
p_attributes	追加するHTMLパラメータ。
p_show_null	NULLの選択を有効にするための追加の選択オプション。値の範囲はYESおよびNOです。
p_null_value	ユーザーがNULLのオプションを選択すると戻される値。p_show_nullがYESの場合にのみ使用できます。
p_null_text	ユーザーがNULLのオプションを選択すると表示される値。p_show_nullがYESの場合にのみ使用できます。
p_item_id	<select>タグのHTML属性のID。
p_item_label	アイテムに対して作成された非表示のラベル。
p_show_extra	p_valueの値が選択リストで指定されていない場合でも、現在の値を表示します。

例

次の例に、アプリケーションで定義されたLOVに基づく選択リストを示します。

SELECT APEX_ITEM.SELECT_LIST_FROM_LOV(2,job,'JOB_FLOW_LOV')job 
FROM emp