44.5 GET_INPUT_NAME_FOR_PAGE_ITEMファンクション(非推奨)

注意:

このAPIは非推奨であり、将来のリリースで削除される予定です。

このファンクションは、アイテム・タイプ・プラグインのレンダリング機能でHTML入力要素をレンダリングする場合に使用します。<input type="text" id="P1_TEST" name="xxx">などのHTML入力要素の場合、Oracle APEXがセッション・ステートの実際のページ・アイテムに送信値をマップできるように、name属性の値を指定する必要があります。このファンクションは、ページ・アイテムにマップするnameを戻します。

ノート:

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

構文

FUNCTION GET_INPUT_NAME_FOR_PAGE_ITEM (
    P_IS_MULTI_VALUE IN BOOLEAN )
    RETURN VARCHAR2;

パラメータ

パラメータ 説明
p_is_multi_value HTML入力要素が複数の値を持つ場合は(multiple="multiple"を含む選択リストなど)、p_is_multi_valueをTRUEに設定します。

次の例では、ページの送信時にセッション・ステートで値が格納されるテキスト・フィールドをレンダリングするために必要な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"')||' />' );