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

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

前 | 次 |

# 20.3 GET_INPUT_NAME_FOR_PAGE_ITEMファンクション

アイテム・タイプのプラグインのレンダリング・ファンクションでHTML入力要素をレンダリングする場合に、このファンクションを使用します。HTML入力要素(<`input type="text" id="P1_TEST" name="xxx">`など)の`name`属性の値を提供して、Oracle Application Expressが送信された値をセッション・ステートの実際のページ・アイテムにマップできるようにする必要があります。このファンクションは、ページ・アイテムにマップする`name`を戻します。HTML入力要素が複数の値を持つ場合は(`multiple="multiple"`を含む選択リストなど)、`p_is_multi_value`をTRUEに設定します。

注意:

このファンクションは、アイテム・タイプのプラグインのレンダリング・ファンクションでコールされる場合にのみ役立ちます。

構文

    APEX_PLUGIN.GET_INPUT_NAME_FOR_PAGE_ITEM (
        p_is_multi_value  IN BOOLEAN)
    RETURN VARCHAR2;

パラメータ

表20-1 GET_INPUT_NAME_FOR_PAGE_ITEMのパラメータ

パラメータ | 説明
--- | ---
`p_is_multi_value` | HTML入力要素が複数の値を持つ場合は、`TRUE`を設定します。そうでない場合は、`FALSE`を設定します。複数の値を持つHTML入力要素には、チェック・ボックスおよび複数選択リストがあります。

例

次の例では、ページの送信時にセッション・ステートで値が格納されるテキスト・フィールドをレンダリングするために必要なHTMLコードを出力します。

    sys.htp.prn (
        '<input type="text" id="'||p_item.name||'" '||
        'name="'||apex_plugin.get_input_name_for_page_item(false)||'" '||
        'value="'||sys.htf.escape_sc(p_value)||'" '||
        'size="'||p_item.element_width||'" '||
        'maxlength="'||p_item.element_max_length||'" '||
        coalesce(p_item.element_attributes, 'class="text_field"')||' />' );