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;

パラメータ

表「TEXTパラメータ」に、TEXTファンクションで使用可能なパラメータを示します。

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