org.opengion.hayabusa.taglib

## クラス FrameTag

- java.lang.Object
- - javax.servlet.jsp.tagext.TagSupport
  - - javax.servlet.jsp.tagext.BodyTagSupport
    - - org.opengion.hayabusa.taglib.CommonTagSupport
      - - org.opengion.hayabusa.taglib.HTMLTagSupport
        - - org.opengion.hayabusa.taglib.FrameTag

- すべての実装されたインタフェース:
    Serializable, BodyTag, IterationTag, JspTag, Tag, TryCatchFinally
  直系の既知のサブクラス:
    IframeTag

      public class FrameTag
      extends HTMLTagSupport

       フレームを作成するHTML拡張タグで、引数の受け渡しが可能です。

  関連項目:
    直列化された形式
  形式サンプル:

         ●形式：<og:frame src="…" name="…" />
         ●body：なし

         ●Tag定義：
           <og:frame
               src              ○【HTML】フレームに表示するソースファイルを指定します(必須)。
               name             ○【HTML】フレーム名を指定します(例：QUERY,RESULT,CONTENTS など)(必須)。
               changeGamen        【TAG】ソース指定の画面を変更します
               keys               【TAG】引数を指定します
               dbTable            【TAG】前ページで選択したデータ列の情報を次のページに渡すかどうか[true/false]を指定します(初期値:false)
               longdesc           【HTML】フレームに関する詳しい説明のあるURL(lobgdesc)を指定します
               marginwidth        【廃止】フレームの左右余白サイズ(marginwidth)を指定します(HTML5廃止属性)
               marginheight       【廃止】フレームの上下余白サイズ(marginheight)を指定します(HTML5廃止属性)
               noresize           【廃止】フレームサイズを変更できないよう(noresize)に指定します(HTML5廃止属性)
               scrolling          【廃止】スクロールバー(scrolling)の表示/非表示[auto/yes/no]を指定します(初期値:auto)(HTML5廃止属性)
               frameborder        【廃止】フレームの境界線(frameborder)の[0:非表示/1:表示]を指定します(初期値:1)(HTML5廃止属性)
               id                 【HTML】要素に対して固有の名前(id)をつける場合に設定します
               clazz              【HTML】要素に対して class 属性を設定します
               title              【HTML】要素に対する補足的情報(title)を設定します
               style              【HTML】この要素に対して適用させるスタイルシート(style)を設定します
               caseKey            【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null) 5.7.7.2 (2014/06/20)
               caseVal            【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null) 5.7.7.2 (2014/06/20)
               caseNN             【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます(初期値:判定しない) 5.7.7.2 (2014/06/20)
               caseNull           【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:判定しない) 5.7.7.2 (2014/06/20)
               caseIf             【TAG】指定の値が、true/TRUE文字列の場合は、このタグは使用されます(初期値:判定しない)
               debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
           />

         ●使用例：
            ・一般的な例：フレーム分割する構文は、HTML準拠。リクエスト変数は各フレームまで転送されます。
            <frameset>
                <og:frame src="query.jsp"   name="QUERY"  />
                <og:frame src="forward.jsp" name="RESULT" />
            </frameset>

            ・DBTableModel の値(例ではPN)を、取り出して、リクエスト変数として利用します。
              現状では、commonForward タグ の useTableData="true" dbkeys="{@dbkeys}" 属性を利用します。
            <frameset>
                <og:frame src="query.jsp"   name="QUERY"  keys="PN" dbTable="true" />
                <og:frame src="forward.jsp" name="RESULT" keys="PN" dbTable="true" />
            </frameset>

            ・changeGamen 属性を利用して、ソース指定の画面を切り替えます。
              たとえば、jsp/index.jsp では、GAMENID属性がURLに存在する場合、直接その画面を
              表示させることができます。
            <frameset cols="160,*,0" frameborder="1" framespacing="1">
                <og:frame src="menu/menu.jsp"    name="MENU" />
                <og:frame src="GE0000/index.jsp" name="CONTENTS"
                                                            changeGamen="{@GAMENID}" />
            </frameset>

  機能分類
    画面部品
  バージョン
    4.0
  作成者
    Kazuhiko Hasegawa
  導入されたバージョン:
    JDK5.0,

- - ### フィールドのサマリー

    - ### クラスから継承されたフィールド org.opengion.hayabusa.taglib.CommonTagSupport

      `BR, BUFFER_MIDDLE, CR`

    - ### クラスから継承されたフィールド javax.servlet.jsp.tagext.BodyTagSupport

      `bodyContent`

    - ### クラスから継承されたフィールド javax.servlet.jsp.tagext.TagSupport

      `id, pageContext`

    - ### インタフェースから継承されたフィールド javax.servlet.jsp.tagext.BodyTag

      `EVAL_BODY_BUFFERED, EVAL_BODY_TAG`

    - ### インタフェースから継承されたフィールド javax.servlet.jsp.tagext.IterationTag

      `EVAL_BODY_AGAIN`

    - ### インタフェースから継承されたフィールド javax.servlet.jsp.tagext.Tag

      `EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE`

  - ### コンストラクタのサマリー

    コンストラクタ
    コンストラクタと説明
    `FrameTag()` デフォルトコンストラクター

  - ### メソッドのサマリー

    すべてのメソッド インスタンス・メソッド concreteメソッド
    修飾子とタイプ | メソッドと説明
    --- | ---
    `protected String` | `makeTag()` リンクを作成します。
    `protected String` | `makeTagFrame(String urlEnc)` リンクを作成します。
    `protected void` | `release2()` タグリブオブジェクトをリリースします。
    `void` | `setChangeGamen(String src)` 【TAG】ソース指定の画面を変更します。
    `void` | `setDbTable(String db)` 【TAG】前ページで選択したデータ列の情報を次のページに渡すかどうか[true:渡す/false:渡さない]を指定します(初期値:false)。
    `void` | `setFrameborder(String frameborder)` 【廃止】フレームの境界線(frameborder)の[0:非表示/1:表示]を指定します(初期値:1)。
    `void` | `setKeys(String key)` 【TAG】引数を指定します。
    `void` | `setLongdesc(String longdesc)` 【HTML】フレームに関する詳しい説明のあるURL(lobgdesc)を指定します。
    `void` | `setMarginheight(String marginheight)` 【廃止】フレームの上下余白サイズ(marginheight)を指定します。
    `void` | `setMarginwidth(String marginwidth)` 【廃止】フレームの左右余白サイズ(marginwidth)を指定します。
    `void` | `setName(String name)` 【HTML】フレーム名を指定します(例：QUERY,RESULT,CONTENTS など)。
    `void` | `setNoresize(String noresize)` 【廃止】フレームサイズを変更できないよう(noresize)に指定します。
    `void` | `setScrolling(String scrolling)` 【廃止】スクロールバー(scrolling)の表示/非表示[auto/yes/no]を指定します(初期値:auto)。
    `void` | `setSrc(String src)` 【HTML】フレームに表示するソースファイルを指定します。
    `String` | `toString()` このオブジェクトの文字列表現を返します。

    - ### クラスから継承されたメソッド org.opengion.hayabusa.taglib.HTMLTagSupport

      `doEndTag, getMustType, makeAimaiPicker, makeMustHidden, setAccesskey, setAimai, setAutocomplete, setAutofocus, setClazz, setDir, setDisabled, setId, setLang, setList, setMax, setMin, setMust, setMustAny, setOnBlur, setOnChange, setOnClick, setOndblClick, setOnFocus, setOnKeydown, setOnKeypress, setOnKeyup, setOnMouseDown, setOnMouseMove, setOnMouseOut, setOnMouseOver, setOnMouseUp, setOnSelect, setOptionAttributes, setPattern, setPlaceholder, setReadonly, setRequired, setRoles, setStep, setStyle, setTabindex, setTitle, setUseMustHidden`

    - ### クラスから継承されたメソッド org.opengion.hayabusa.taglib.CommonTagSupport

      `add, add, addEventColumn, addEventColumn, check, commitTableObject, debugPrint, doAfterBody, doCatch, doFinally, doStartTag, get, getApplicationInfo, getAttributes, getBodyRawString, getBodyString, getContextAttribute, getContextPath, getCookie, getCSVParameter, getCSVParameter, getDataCondition, getDateFormat, getDBColumn, getDBFunctionName, getDocumentLink, getGUIInfo, getGUIInfoAttri, getHostName, getLabel, getLabelInterface, getLanguage, getLASTAttri, getLongLabel, getMsg, getMsglbl, getNVLAttri, getObject, getParameterNames, getParameterRows, getRequest, getRequestAttribute, getRequestCacheData, getRequestMethod, getRequestParameter, getRequestParameterValues, getRequestValue, getRequestValue, getRequestValues, getReservedParameter, getReservedValue, getResource, getSanitizedBodyString, getScope, getSessionAttribute, getSumRequestValue, getTagName, getTransaction, getUser, getUserEditInfo, getUserInfo, isAjaxSubmitRequest, isDebug, isNoTransitionRequest, isNull, jspPrint, makeUrl, removeContextAttribute, removeObject, removeRequestAttribute, removeSessionAttribute, set, setAjaxSubmitRequest, setCaseIf, setCaseKey, setCaseNN, setCaseNull, setCaseVal, setContextAttribute, setCookie, setDebug, setLanguage, setLbl, setNoTransitionRequest, setObject, setObject, setParameterNames, setParameterRows, setRequestAttribute, setRequestCacheData, setScope, setSessionAttribute, setUserInfo, startQueryTransaction, sys, sysBool, sysInt, useMainTrans, useQuotCheck, useTag, useXssCheck`

    - ### クラスから継承されたメソッド javax.servlet.jsp.tagext.BodyTagSupport

      `doInitBody, getBodyContent, getPreviousOut, release, setBodyContent`

    - ### クラスから継承されたメソッド javax.servlet.jsp.tagext.TagSupport

      `findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setPageContext, setParent, setValue`

    - ### クラスから継承されたメソッド java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

    - ### インタフェースから継承されたメソッド javax.servlet.jsp.tagext.Tag

      `getParent, setPageContext, setParent`

- - ### コンストラクタの詳細

    - #### FrameTag

          public FrameTag()

      デフォルトコンストラクター
      変更履歴:

        6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.

  - ### メソッドの詳細

    - #### release2

          protected void release2()

      タグリブオブジェクトをリリースします。 キャッシュされて再利用されるので、フィールドの初期設定を行います。
      オーバーライド:
        `release2` クラス内 `HTMLTagSupport`
      変更履歴:

        2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加
        3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。

    - #### makeTag

          protected String makeTag()

      リンクを作成します。
      定義:
        `makeTag` クラス内 `HTMLTagSupport`
      戻り値:
        リンクタグ文字列
      変更履歴:

        3.5.4.0 (2003/11/25) comand="RENEW" 時には、dbTable 属性は、強制的に false とします。
        5.9.1.2 (2015/10/23) iframeとの継承関係で、共通的に呼び出すメソッドを追加します。

      このメソッドは、nullを返しません

    - #### makeTagFrame

          protected String makeTagFrame(String urlEnc)

      リンクを作成します。
      パラメータ:
        `urlEnc` - エンコードされたURL
      戻り値:
        リンクタグ文字列
      変更履歴:

        5.9.1.2 (2015/10/23) iframeとの継承関係で、共通的に呼び出すメソッドを追加します。

      このメソッドは、nullを返しません

    - #### setSrc

          public void setSrc(String src)

      【HTML】フレームに表示するソースファイルを指定します。
      パラメータ:
        `src` - ソースファイル
      説明:

             フレームに表示するソースファイルを指定します。

    - #### setName

          public void setName(String name)

      【HTML】フレーム名を指定します(例：QUERY,RESULT,CONTENTS など)。
      パラメータ:
        `name` - フレーム名
      説明:

             フレーム名を指定します。

    - #### setLongdesc

          public void setLongdesc(String longdesc)

      【HTML】フレームに関する詳しい説明のあるURL(lobgdesc)を指定します。
      パラメータ:
        `longdesc` - 詳しい説明のあるURL
      説明:

             lobgdescを指定します。

    - #### setMarginwidth

          public void setMarginwidth(String marginwidth)

      【廃止】フレームの左右余白サイズ(marginwidth)を指定します。 HTML5では廃止されている属性のため、可能であればCSSを利用してください。
      パラメータ:
        `marginwidth` - 左右余白サイズ
      説明:

             フレームの左右余白サイズを指定します。

    - #### setMarginheight

          public void setMarginheight(String marginheight)

      【廃止】フレームの上下余白サイズ(marginheight)を指定します。 HTML5では廃止されている属性のため、可能であればCSSを利用してください。
      パラメータ:
        `marginheight` - 上下余白サイズ
      説明:

             フレームの上下余白サイズを指定します。

    - #### setNoresize

          public void setNoresize(String noresize)

      【廃止】フレームサイズを変更できないよう(noresize)に指定します。 HTML5では廃止されている属性のため、可能であればCSSを利用してください。
      パラメータ:
        `noresize` - フレームサイズ変更不可指定
      説明:

             フレームサイズを変更させない場合は、"noresize" を指定します。
             処理自体は、空文字列以外であれば、内部的に"noresize" を設定します。

    - #### setScrolling

          public void setScrolling(String scrolling)

      【廃止】スクロールバー(scrolling)の表示/非表示[auto/yes/no]を指定します(初期値:auto)。 HTML5では廃止されている属性のため、可能であればCSSを利用してください。
      パラメータ:
        `scrolling` - スクロールバーの表示方法指定 [auto:自動/yes:常時表示/no:非表示]
      説明:

             auto:必要に応じてスクロールバーを表示(初期値)
             yes:常にスクロールバーを表示
             no:常にスクロールバーを表示しない

    - #### setFrameborder

          public void setFrameborder(String frameborder)

      【廃止】フレームの境界線(frameborder)の[0:非表示/1:表示]を指定します(初期値:1)。 HTML5では廃止されている属性のため、可能であればCSSを利用してください。
      パラメータ:
        `frameborder` - フレームの境界線 [0:枠非表示/1:枠表示]
      説明:

             0:枠を表示しない
             1:枠を表示する。
             初期値は、1:枠を表示する です。

    - #### setChangeGamen

          public void setChangeGamen(String src)

      【TAG】ソース指定の画面を変更します。
      パラメータ:
        `src` - 置換えソース
      説明:

             src 指定がデフォルト設定で、changeGamen属性が設定されている
             場合には、この値が優先されます。
             changeGamen は、画面IDのみ指定してください。src には、このID＋"/index.jsp" が
             追加されます。つまり、changeGamen="{@GAMENID}" という指定をしておけば、
             FavoriteLinkTag 等で引数に GAMENID が指定された場合のみ、この属性が有効になり、
             src="実画面ID/index.jsp" が指定されたことと同じ結果になります。

      変更履歴:

        3.1.2.0 (2003/04/07) 画面IDと実画面ディレクトリとの関連見直し(DIRの代りにGAMENIDを推奨)
        4.2.1.1 (2008/04/30) 画面切り替えをするのは、アドレスが設定されいる場合に限る

    - #### setKeys

          public void setKeys(String key)

      【TAG】引数を指定します。
      パラメータ:
        `key` - 引数
      説明:

             URL の引数にセットするキーを CSV形式でセットします。

    - #### setDbTable

          public void setDbTable(String db)

      【TAG】前ページで選択したデータ列の情報を次のページに渡すかどうか[true:渡す/false:渡さない]を指定します(初期値:false)。
      パラメータ:
        `db` - 選択データを渡すかどうか [true:渡す/false:渡さない]
      説明:

             ただし、１行分のデータのみです。(複数選択時は、最初の１件目)
             trueを指定すると、データを渡します。falseの場合は、渡しません。
             初期値は、false:渡さない です。

    - #### toString

          public String toString()

      このオブジェクトの文字列表現を返します。 基本的にデバッグ目的に使用します。
      オーバーライド:
        `toString` クラス内 `CommonTagSupport`
      戻り値:
        このクラスの文字列表現
      このメソッドは、nullを返しません

Webアプリケーションフレームワーク openGion
Copyright (c) 2009 The openGion Project.