25.19 TEXTファンクション

このファンクションは、SQL問合せからテキスト・フィールド(またはテキスト入力フォーム・アイテム)を生成します。

構文

APEX_ITEM.TEXT(
    p_idx         IN    NUMBER,
    p_value       IN    VARCHAR2 DEFAULT NULL,
    p_size        IN    NUMBER DEFAULT NULL,
    p_maxlength   IN    NUMBER DEFAULT NULL,
    p_attributes  IN    VARCHAR2 DEFAULT NULL,
    p_item_id     IN    VARCHAR2 DEFAULT NULL,
    p_item_label  IN    VARCHAR2 DEFAULT NULL)
    RETURN VARCHAR2;

パラメータ

表25-19 TEXTのパラメータ

パラメータ	説明
p_idx	生成するアイテムの識別番号。この番号によって、どのG_FXXグローバルが移入されるかが決定されます。 「APEX_APPLICATION」も参照してください。
p_value	テキスト・フィールド・アイテムの値。
p_size	HTMLタグ属性を制御(無効にするなど)します。
p_maxlength	テキスト・ボックスに入力可能な最大文字数。
p_attributes	追加するHTMLパラメータ。
p_item_id	<input>タグのHTML属性のID。
p_item_label	アイテムに対して作成された非表示のラベル。

例

次の問合せの例に、各行に1つの更新フィールドを生成する方法を示します。ename、salおよびcomm列では、APEX_ITEM.TEXTファンクションを使用して行ごとにHTMLテキスト・フィールドを生成します。また、各列がそれぞれの配列に格納されるように問合せ内のアイテムごとに一意のp_idxパラメータが渡されます。

SELECT 
  empno, 
  APEX_ITEM.HIDDEN(1,empno)||
  APEX_ITEM.TEXT(2,ename) ename, 
  APEX_ITEM.TEXT(3,job) job, 
  mgr, 
  APEX_ITEM.DATE_POPUP(4,rownum,hiredate,'dd-mon-yyyy') hiredate,
  APEX_ITEM.TEXT(5,sal) sal, 
  APEX_ITEM.TEXT(6,comm) comm,
  deptno
FROM emp
ORDER BY 1