org.opengion.hayabusa.taglib

## クラス ChartCreateTag

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

- すべての実装されたインタフェース:
    Serializable, BodyTag, IterationTag, JspTag, Tag, TryCatchFinally

      public class ChartCreateTag
      extends CommonTagSupport

  BODY部に指定のSQLの検索結果をチャート(円、棒、線)で表示するタグです。 チャート化には、JFreeChart (http://www.jfree.org/jfreechart/) を使用しています。 チャートの種類は、chartDataset タグで指定します。これは、複数の異なるチャートを 合成表示する機能が、JFreeChart にある為です。ただし、専門的には、CategoryDataset のみ いまは、合成が可能です。 処理の実行にあたり、キャッシュが有効(useCache="true")であれば、キャッシュデータを 使用します。キャッシュは、masterKey 属性で指定されたキーワード毎に、JFreeChart オブジェクトをキャッシュします。また、seriesPikup 違いの場合は、再検索せずに、 キャッシュが使用できます。さらに、seriesPikup が同じ場合(masterKey も同じ)は、 すでに画像ファイルが作成済みなので、画像ファイルのみを返します。 各属性は、{@XXXX} 変数が使用できます。 これは、ServletRequest から、XXXX をキーに値を取り出し,この変数に割り当てます。 つまり、このXXXXをキーにリクエストすれば、この変数に値をセットすることができます。
  関連項目:
    直列化された形式
  形式サンプル:

         ●形式：<og:chartCreate title="…" … />
         ●body：あり(EVAL_BODY_BUFFERED:BODYを評価し、{@XXXX} を解析します)

         ●Tag定義：
           <og:chartCreate
               title              【TAG】チャートのタイトルをセットします
               width              【TAG】チャートの横幅をセットします(初期値:200)
               height             【TAG】チャートの縦幅をセットします(初期値:200)
               domainLabel        【TAG】チャートのドメインラベルを指定します
               showLegend         【TAG】チャートの凡例の表示可否[true/false]をセットします(初期値:true[表示する])
               rectangleEdge      【TAG】チャートの表示箇所を、[TOP/BOTTOM/RIGHT/LEFT]で指定します(初期値:BOTTOM)
               plotOrientation    【TAG】チャートのプロット(Plot)表示方向を、[VERTICAL(or V),HORIZONTAL(or H)]で指定します
               chartBackColor     【TAG】チャートの背景色を指定します
               plotBackColor      【TAG】チャートの描画領域の色を指定します
               rotationLabel      【TAG】チャートのカテゴリーラベルの方向を指定します[1:180度 、2:90度 、3:60度 、4:45度 、6:30度 ･･･ ](初期値:3:60度)
               useVerticalLabels  【TAG】横軸ラベルの表示向きを縦にするかどうか[false/true]を指定します(初期値:false)
               domainMarker       【TAG】チャートの横軸の値(ドメイン)に合致する位置にマーカーラインを設定します
               useDomainLabel     【TAG】横軸ラベルのラベルを表示するかどうか[true/false]を指定します(初期値:true)
               useMarkerLabel     【TAG】マーカーラインに、その設定値を表示するかどうか[true/false]を指定します(初期値:true)
               useCache           【TAG】JFreeChart オブジェクトをキャッシュするかどうか[true/false]を指定します(初期値:false)
               masterKey          【TAG】キャッシュ用マスタキーを指定します
               seriesPikup        【TAG】複数シリーズのピックアップを行う場合のシリーズ番号を指定します
               imageMapUrl        【TAG】クリッカブル・マップ用URLを指定します
               imageMapTarget     【TAG】クリッカブル・マップ用TARGETを指定します
               categoryMargin     【TAG】カテゴリマージン(0.0～1.0)を指定します
               lowerMargin        【TAG】下方マージン(0.0～1.0)を指定します
               upperMargin        【TAG】上方マージン(0.0～1.0)を指定します
               useDomainLine      【TAG】横軸のグリッド表示有無(垂直線)を指定します(初期値:false)
               domainLineColor    【TAG】横軸のグリッド線の色を指定します
               categorySkip       【TAG】横軸ラベルをスキップする間隔を指定します
               categoryCutNo      【TAG】横軸ラベルの文字位置指定のキーブレイクを指定します
               categoryAnchor     【TAG】横軸のグリッド(垂直線)の書き出し位置(START,MIDDLE,END)を指定します
               useRangeLine       【TAG】縦軸のグリッド表示有無(水平線)を指定します(初期値:true)
               useToolTip         【TAG】ツールチップスの使用可否[true:利用する/false:利用しない]を指定します(初期値:false)
               rangeLineColor     【TAG】縦軸のグリッド線の色を指定します
               rangeSkip          【TAG】縦軸のグリッド線(水平線)をスキップする間隔を指定します
               dateAxisFormat     【TAG】Time,XYTime Polt関係の時間軸を表す場合のフォーマットを指定します(初期値:MM/dd)
               debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
           >   ... Body ...
           </og:chartCreate>

         ●使用例
              <og:chartCreate
                  title       = "JFreeChart Test"             チャートタイトル
                  domainLabel = "ドメインラベル"              横軸ラベル
                  width       = "200"                         チャート表示幅
                  height      = "200"                         チャート表示高さ
                  showLegend  = "[true/false]"                凡例の表示可否[true/false]
                  rectangleEdge   = "[TOP|BOTTOM|RIGHT|LEFT]" 凡例の表示箇所
                  plotOrientation = "[VERTICAL|HORIZONTAL]"   チャートの軸表示方向
                  chartBackColor  = "WHITE"                   背景色
                  plotBackColor   = "LIGHT_GRAY"              描画領域色
                  rotationLabel   = "3"                       横軸ラベルの傾き
                  useVerticalLabels = "false"					横軸ラベルの向き(true:縦/false:横)
                  domainMarker    = "KING"                    横軸のマーカーライン(縦棒)
                  useMarkerLabel  = "[true/false]"            マーカーラインの文字有無
                  useDomainLabel  = "[true/false]"            横軸ラベルの表示有無
                  categorySkip    = "3"                       横軸ラベルをスキップする間隔
                  categoryCutNo   = "6"                       横軸ラベルの文字位置指定のキーブレイク
                  categoryAnchor  = "[START|MIDDLE|END]"      横軸のグリッド(垂直線)の書き出し位置
                  useDomainLine   = "[false/true]"            横軸のグリッド表示有無(垂直線)
                  domainLineColor = "LIGHT_GRAY"              横軸のグリッド線の色
                  useRangeLine    = "[true/false]"            縦軸のグリッド表示有無(水平線)
                  rangeLineColor  = "LIGHT_GRAY"              縦軸のグリッド線の色
                  rangeSkip       = "-5"                      縦軸のグリッド(水平線)をスキップする間隔
                  useCache        = "[false|true]"            キャッシュの有無
                  masterKey       = "{@XXXX}"            キャッシュ用マスタキー
                  seriesPikup     = "2"                       ピックアップするシリーズNo
                  imageMapUrl     = "link.jsp,BLOCK"          クリッカブル・マップ用URL
                  imageMapTarget  = "CONTENTS"                クリッカブル・マップ用TARGET
                  categoryMargin  = "[0.0～1.0]"              カテゴリマージン(0.0～1.0)
                  lowerMargin     = "[0.0～1.0]"              下方マージン(0.0～1.0)
                  upperMargin     = "[0.0～1.0]"              上方マージン(0.0～1.0)
               >
                      <og:chartDataset
                          chartType   = "{@chartType}"
                          valueLabel  = "{@valueLabel}"
                          lowerBound  = "{@lowerBound}"
                          upperBound  = "{@upperBound}"
                          markValues  = "{@markValues}"
                          markColors  = "{@markColors}"
                          useGradient   = "{@useGradient}"
                          shapesVisible = "{@shapesVisible}"
                          useDottedLine = "{@useDottedLine}"
                          seriesColors  = "{@seriesColors}"
                          valueLabelsVisible = "[true|false]"
                          valueMarksVisible  = "[true|false]"
                      >
                                 {@SQL}
                      </og:chartDataset>
              </og:chartCreate>

            複数のグラフを重ね合わせる場合は、chartDataset タグを chartCreate のBODY部に
            複数記述します。
              <og:chartCreate
                  title       = "{@title}"
                  domainLabel = "{@domainLabel}"
                  width       = "{@width}"
                  height      = "{@height}" >
                      <og:chartDataset
                          chartType   = "{@chartType1}"
                          valueLabel  = "{@valueLabel1}"
                          lowerBound  = "{@lowerBound1}"
                          upperBound  = "{@upperBound1}"
                          markValues  = "{@markValues1}"
                          markColors  = "{@markColors1}"
                      >
                                 {@SQL1}
                      </og:chartDataset>
                      <og:chartDataset
                          chartType   = "{@chartType2}"
                          valueLabel  = "{@valueLabel2}"
                          lowerBound  = "{@lowerBound2}"
                          upperBound  = "{@upperBound2}"
                          markValues  = "{@markValues2}"
                          markColors  = "{@markColors2}"
                      >
                                 {@SQL2}
                      </og:chartDataset>
              </og:chartCreate>

            rectangleEdge属性 は、凡例の表示箇所を示す、RectangleEdge クラスの値を設定します。
            [rectangleEdge属性]
              TOP      上側
              BOTTOM   下側
              RIGHT    右側
              LEFT     左側

            plotOrientation属性 は、チャートの軸表示方向を設定します。
            [renderer属性]
              VERTICAL    縦方向
              HORIZONTAL  横方向

  機能分類
    画面表示
  バージョン
    0.9.0 2007/06/19
  作成者
    Nakamura
  導入されたバージョン:
    JDK1.4,

- - ### フィールドの概要

    - ### クラスから継承されたフィールド 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`

  - ### コンストラクタの概要

    コンストラクタ
    コンストラクタと説明
    `ChartCreateTag()`

  - ### メソッドの概要

    メソッド
    修飾子とタイプ | メソッドと説明
    --- | ---
    `protected void` | `addChartDataset(ChartDataset chDataset)` BODY要素に記述した、chartDataset タグの属性設定クラスをListに追加します。
    `int` | `doEndTag()` Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
    `int` | `doStartTag()` Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
    `protected void` | `release2()` タグリブオブジェクトをリリースします。
    `void` | `setCategoryAnchor(String anchor)` 【TAG】横軸のグリッド(垂直線)の書き出し位置(START,MIDDLE,END)を指定します。
    `void` | `setCategoryCutNo(String cutNo)` 【TAG】横軸ラベルの文字位置指定のキーブレイクを指定します。
    `void` | `setCategoryMargin(String margin)` 【TAG】カテゴリマージン(0.0～1.0)を指定します。
    `void` | `setCategorySkip(String step)` 【TAG】横軸ラベルをスキップする間隔を指定します。
    `void` | `setChartBackColor(String chBackClr)` 【TAG】チャートの背景色を指定します。
    `void` | `setDateAxisFormat(String dtFormat)` 【TAG】Time,XYTime Polt関係の時間軸を表す場合のフォーマットを指定します(初期値:MM/dd)。
    `void` | `setDomainLabel(String dmLbl)` 【TAG】チャートのドメインラベルを指定します。
    `void` | `setDomainLineColor(String color)` 【TAG】横軸のグリッド線の色を指定します。
    `void` | `setDomainMarker(String marker)` 【TAG】チャートの横軸の値(ドメイン)に合致する位置にマーカーラインを設定します。
    `void` | `setHeight(String ht)` 【TAG】チャートの縦幅をセットします(初期値:200)。
    `void` | `setImageMapTarget(String target)` 【TAG】クリッカブル・マップ用TARGETを指定します。
    `void` | `setImageMapUrl(String imap)` 【TAG】クリッカブル・マップ用URLを指定します。
    `void` | `setLowerMargin(String margin)` 【TAG】下方マージン(0.0～1.0)を指定します。
    `void` | `setMasterKey(String mkey)` 【TAG】キャッシュ用マスタキーを指定します。
    `void` | `setPlotBackColor(String plBackClr)` 【TAG】チャートの描画領域の色を指定します。
    `void` | `setPlotOrientation(String orientation)` 【TAG】チャートのプロット(Plot)表示方向を、[VERTICAL(or V),HORIZONTAL(or H)]で指定します(初期値:VERTICAL)。
    `void` | `setRangeLineColor(String color)` 【TAG】縦軸のグリッド線の色を指定します。
    `void` | `setRangeSkip(String rngSkip)` 【TAG】縦軸のグリッド線(水平線)をスキップする間隔を指定します。
    `void` | `setRectangleEdge(String rectEdge)` 【TAG】チャートの表示箇所を、[TOP/BOTTOM/RIGHT/LEFT]で指定します(初期値:BOTTOM)。
    `void` | `setRotationLabel(String rttLabel)` 【TAG】チャートのカテゴリーラベルの方向を指定します(3:60度)。
    `void` | `setSeriesPikup(String pikup)` 【TAG】複数シリーズのピックアップを行う場合のシリーズ番号を指定します。
    `void` | `setShowLegend(String swLegend)` 【TAG】チャートの凡例の表示可否[true/false]をセットします(初期値:true[表示する])。
    `void` | `setTitle(String ttl)` 【TAG】チャートのタイトルをセットします。
    `void` | `setUpperMargin(String margin)` 【TAG】上方マージン(0.0～1.0)を指定します。
    `void` | `setUseCache(String flag)` 【TAG】JFreeChart オブジェクトをキャッシュするかどうか[true/false]を指定します(初期値:false)。
    `void` | `setUseDomainLabel(String flag)` 【TAG】横軸ラベルのラベルを表示するかどうか[true/false]を指定します(初期値:true)。
    `void` | `setUseDomainLine(String useLine)` 【TAG】横軸のグリッド表示有無(垂直線)を指定します(初期値:false)。
    `void` | `setUseMarkerLabel(String flag)` 【TAG】マーカーラインに、その設定値を表示するかどうか[true/false]を指定します(初期値:true)。
    `void` | `setUseRangeLine(String useLine)` 【TAG】縦軸のグリッド表示有無(水平線)を指定します(初期値:true)。
    `void` | `setUseToolTip(String toolTip)` 【TAG】ツールチップスの使用可否[true:利用する/false:利用しない]を指定します(初期値:false)。
    `void` | `setUseVerticalLabels(String useVLavels)` 【TAG】ラベルの表示向きを縦にするかどうか[false/true]を指定します(初期値:false)。
    `void` | `setWidth(String wd)` 【TAG】チャートの横幅をセットします(初期値:200)。
    `String` | `toString()` このオブジェクトの文字列表現を返します。

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

      `add, add, addEventColumn, addEventColumn, check, check, commitTableObject, debugPrint, doAfterBody, doCatch, doFinally, get, getApplicationInfo, getAttributes, getBodyRawString, getBodyString, getContextAttribute, getContextPath, getCookie, getCSVParameter, getDataCondition, getDateFormat, getDBColumn, getDBFunctionName, getDocumentLink, getGUIInfo, getGUIInfoAttri, getHostName, getLabel, getLabelInterface, getLanguage, getLASTAttri, getLongLabel, getMsglbl, getNVLAttri, getObject, getParameterNames, getParameterRows, getRequest, getRequestAttribute, getRequestCacheData, getRequestMethod, getRequestParameter, getRequestParameterValues, getRequestValue, getRequestValue, getRequestValues, getReservedParameter, getReservedValue, getResource, getSanitizedBodyString, getScope, getSessionAttribute, getTagName, getUser, getUserEditInfo, getUserInfo, isAjaxSubmitRequest, isDebug, isNoTransitionRequest, isNull, jspPrint, removeContextAttribute, removeObject, removeRequestAttribute, removeSessionAttribute, set, setAjaxSubmitRequest, 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, setId, setPageContext, setParent, setValue`

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

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

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

      `getParent, setPageContext, setParent`

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

    - #### ChartCreateTag

          public ChartCreateTag()

  - ### メソッドの詳細

    - #### doStartTag

          public int doStartTag()

      Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
      定義:
        `doStartTag` インタフェース内 `Tag`
      オーバーライド:
        `doStartTag` クラス内 `CommonTagSupport`
      戻り値:
        後続処理の指示

    - #### doEndTag

          public int doEndTag()

      Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
      定義:
        `doEndTag` インタフェース内 `Tag`
      オーバーライド:
        `doEndTag` クラス内 `CommonTagSupport`
      戻り値:
        後続処理の指示
      変更履歴:

        5.2.1.0 (2010/10/01) debugPrint() メソッドの処理条件見直し

    - #### release2

          protected void release2()

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

        4.0.1.0 (2007/12/13) categoryMargin、lowerMargin、upperMargin 属性を追加
        4.1.1.0 (2008/02/04) categoryCutNo , categoryAnchor , rangeSkip 属性を追加
        5.6.1.0 (2013/02/01) dateAxisFormat 属性を追加
        5.6.4.3 (2013/05/24) useVerticalLabels 属性を追加

    - #### setTitle

          public void setTitle(String ttl)

      【TAG】チャートのタイトルをセットします。
      パラメータ:
        `ttl` - タイトル
      説明:

             チャートのタイトルをセットします。

    - #### setWidth

          public void setWidth(String wd)

      【TAG】チャートの横幅をセットします(初期値:200)。
      パラメータ:
        `wd` - 横幅
      説明:

             タイトルや凡例も含んだ大きさです。データ領域は自動計算されます。

      変更履歴:

        4.0.1.0 (2007/12/13) 引数に "px" を使用できるようにする。

    - #### setHeight

          public void setHeight(String ht)

      【TAG】チャートの縦幅をセットします(初期値:200)。
      パラメータ:
        `ht` - 縦幅
      説明:

             タイトルや凡例も含んだ大きさです。データ領域は自動計算されます。

      変更履歴:

        4.0.1.0 (2007/12/13) 引数に "px" を使用できるようにする。

    - #### setDomainLabel

          public void setDomainLabel(String dmLbl)

      【TAG】チャートのドメインラベルを指定します。
      パラメータ:
        `dmLbl` - チャートのドメインラベル
      説明:

             チャートのドメインラベルを指定します。

    - #### setShowLegend

          public void setShowLegend(String swLegend)

      【TAG】チャートの凡例の表示可否[true/false]をセットします(初期値:true[表示する])。
      パラメータ:
        `swLegend` - 凡例の表示可否 [true:表示する/それ以外:しない]
      説明:

             初期値は、表示する(true) です。

    - #### setRectangleEdge

          public void setRectangleEdge(String rectEdge)

      【TAG】チャートの表示箇所を、[TOP/BOTTOM/RIGHT/LEFT]で指定します(初期値:BOTTOM)。
      パラメータ:
        `rectEdge` - 凡例表示方向 ： (TOP、BOTTOM、RIGHT、LEFT)
      説明:

             表示箇所は、org.jfree.ui.RectangleEdge クラスの設定値を使用します。
             指定できるのは、TOP、BOTTOM、RIGHT、LEFT で、各文字の頭一文字で
             判定してます。つまり、T,B,R,L で、判定を行い、それ以外はエラーになります。
             初期値は、BOTTOM です。

    - #### setPlotOrientation

          public void setPlotOrientation(String orientation)

      【TAG】チャートのプロット(Plot)表示方向を、[VERTICAL(or V),HORIZONTAL(or H)]で指定します(初期値:VERTICAL)。
      パラメータ:
        `orientation` - プロット表示方向 ： VERTICAL(or V) , HORIZONTAL(or H)
      説明:

             軸表示方向は、org.jfree.chart.plot.PlotOrientation クラスの設定値を使用します。
             指定できるのは、VERTICAL、HORIZONTALで、各文字の頭一文字で
             判定してます。つまり、V,H で、判定を行い、それ以外はエラーになります。
             初期値は、VERTICAL です。

    - #### setChartBackColor

          public void setChartBackColor(String chBackClr)

      【TAG】チャートの背景色を指定します。
      パラメータ:
        `chBackClr` - チャートの背景色
      関連項目:
        `Color.BLACK`
      説明:

             指定文字列は、java.awt.Color クラスのstatic フィールド名で指定します。
             BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY ,
             MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できます。
             また、#XXXXXX形式の16bitRGB表記 でも指定可能です。

    - #### setPlotBackColor

          public void setPlotBackColor(String plBackClr)

      【TAG】チャートの描画領域の色を指定します。
      パラメータ:
        `plBackClr` - チャートの描画領域色
      関連項目:
        `Color.BLACK`
      説明:

             指定文字列は、java.awt.Color クラスのstatic フィールド名で指定します。
             BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY ,
             MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できます。
             また、#XXXXXX形式の16bitRGB表記 でも指定可能です。

    - #### setRotationLabel

          public void setRotationLabel(String rttLabel)

      【TAG】チャートのカテゴリーラベルの方向を指定します(3:60度)。
      パラメータ:
        `rttLabel` - カテゴリーラベルの方向
      説明:

             方向は、上方向に対して、(PI / 指示数) で求まる値に設定します。
             この指示数に相当する値を設定します。
             1:180度 、2:90度 、3:60度 、4:45度 、6:30度 ･･･
             マイナスは、した方向に回転させます。
             0 を指定した場合は、何も設定しません。
             初期値は、3:60度です。

    - #### setUseVerticalLabels

          public void setUseVerticalLabels(String useVLavels)

      【TAG】ラベルの表示向きを縦にするかどうか[false/true]を指定します(初期値:false)。
      パラメータ:
        `useVLavels` - ラベルの表示向き [false:横書き/true:縦書き]
      説明:

             ChartCreate の rotationLabel は、角度を指定できましたが、NumberAxis,DateAxis では、
             縦にするかどうかの指定しかできません。
             ここでは、true を指定するとラベルは、縦書きになります。
             初期値は、false(横書き)です。

      変更履歴:

        5.6.4.3 (2013/05/24)) 新規追加

    - #### setDomainMarker

          public void setDomainMarker(String marker)

      【TAG】チャートの横軸の値(ドメイン)に合致する位置にマーカーラインを設定します。
      パラメータ:
        `marker` - ドメインのマーカーライン
      説明:

             この属性には、マーカーラインを設定する値を記述します。

    - #### setUseDomainLabel

          public void setUseDomainLabel(String flag)

      【TAG】横軸ラベルのラベルを表示するかどうか[true/false]を指定します(初期値:true)。
      パラメータ:
        `flag` - 横軸ラベルの表示有無 [true:表示する/false:表示しない]
      説明:

             ドメイン(横軸)が、多数存在する場合、ドメインラベルが見えにくくなります。
             そのようなケースで、横軸のラベルそのものを表示しない場合に、false を
             設定します。
             初期値は、表示する(true)です。

    - #### setUseMarkerLabel

          public void setUseMarkerLabel(String flag)

      【TAG】マーカーラインに、その設定値を表示するかどうか[true/false]を指定します(初期値:true)。
      パラメータ:
        `flag` - マーカーラインの設定値表示 true:表示する/false:表示しない]
      説明:

             ドメイン(横軸)が、多数存在する場合、ドメインラベルが見えない場合があります。
             そのようなケースで、見たい値にマーカーラインを設定し、その横に、ドメインラベル
             を表示する事で、ピックアップしている軸の値を容易に知ることが可能です。
             初期値は、表示する(true)です。

    - #### setUseCache

          public void setUseCache(String flag)

      【TAG】JFreeChart オブジェクトをキャッシュするかどうか[true/false]を指定します(初期値:false)。
      パラメータ:
        `flag` - JFreeChartをキャッシュするかどうか true:キャッシュする/false:キャッシュしない]
      関連項目:
        `setDomainMarker( String )`, `setSeriesPikup( String )`
      説明:

             useCache="true" を設定すると、session に、HybsSystem.JF_CHART_CACHE_KEY
             キーで、キャッシュされます。
             そのときに、domainMarker 属性と、seriesPikup 属性だけ、再設定可能になっています。

             初期値は、キャッシュしない(false)です。

    - #### setSeriesPikup

          public void setSeriesPikup(String pikup)

      【TAG】複数シリーズのピックアップを行う場合のシリーズ番号を指定します。
      パラメータ:
        `pikup` - シリーズ番号
      説明:

             複数シリーズ(検索時に複数項目を同時に検索する場合)では、チャート上に
             複数のグラフが表示されますが、その中の一つをピックアップする場合に、
             シリーズ番号を指定します。
             シリーズ番号は、0 から始まる数字です。
             ここでは、ピックアップされたシリーズは、赤色で表示されます。
             それ以外は、グレー色での表示になります。
             seriesPikup を使用すると、chartDataset タグの useValueVisible 属性が
             影響を受けます。この属性は、データの値(itemText)を表示しますが、
             seriesPikup が指定された場合は、そのシリーズのみにラベル表示します。

    - #### setMasterKey

          public void setMasterKey(String mkey)

      【TAG】キャッシュ用マスタキーを指定します。
      パラメータ:
        `mkey` - キャッシュ用マスタキー
      説明:

             useCache="true" に設定した場合、キャッシュを使用できるか確認します。
             この場合、seriesPikup 違いの場合は、JFreeChart オブジェクトそのものを
             キャッシュしておけば、データベースアクセスなしで、グラフを再描画
             させることが可能です。
             この、同一 JFreeChart を指定するためのキーを、ここで設定します。
             このキーの個数だけ、JFreeChart がキャッシュされます。
             なお、キャッシュ保持時間は、５分固定です。

    - #### setImageMapUrl

          public void setImageMapUrl(String imap)

      【TAG】クリッカブル・マップ用URLを指定します。
      パラメータ:
        `imap` - クリッカブル・マップ用URL
      関連項目:
        `setImageMapTarget( String )`
      説明:

             画像に、クリッカブル・マップを作成する場合の、URL を指定します。
             これは、画像上にエリア指定でリンク引数を作成することが可能です。
             URL 自身は、? 付きで固定値の引数を連結することが可能です。
             クリックしたエリアのカテゴリやインデックスの値(引数)は、自動的に
             設定されます。(指定しない場合はチャートによって異なります)

             ・Pie      ：category、pieIndex
             ・XY       ：series、item
             ・Category ：series、category

             この引数の URL の名称を変更したい場合は、URL に続けて、カンマ(,) で、
             名称を記述してください。
             例：link.jsp,BLOCK

    - #### setImageMapTarget

          public void setImageMapTarget(String target)

      【TAG】クリッカブル・マップ用TARGETを指定します。
      パラメータ:
        `target` - クリッカブル・マップ用TARGET
      関連項目:
        `setImageMapUrl( String )`
      説明:

             画像に、クリッカブル・マップを作成する場合の、TARGET を指定します。
             これは、画像上にエリア指定でリンクを作成する場合のフレーム指定です。

    - #### setCategoryMargin

          public void setCategoryMargin(String margin)

      【TAG】カテゴリマージン(0.0～1.0)を指定します。
      パラメータ:
        `margin` - カテゴリマージン(0.0～1.0)
      説明:

             カテゴリ(グラフの横軸に相当)の表示間隔(マージン)の比率を指定します。
             この比率は、％ ではなく、数字(double)での設定になります。
             何も指定しない場合は、デフォルトで自動調整されます。

      変更履歴:

        4.0.2.0 (2007/12/20) 新規追加

    - #### setLowerMargin

          public void setLowerMargin(String margin)

      【TAG】下方マージン(0.0～1.0)を指定します。
      パラメータ:
        `margin` - 下方マージン(0.0～1.0)
      説明:

             カテゴリ(グラフの横軸に相当)の下方側(左側)のマージンの比率を指定します。
             この比率は、％ ではなく、数字(double)での設定になります。
             何も指定しない場合は、デフォルトで自動調整されます。

      変更履歴:

        4.0.2.0 (2007/12/20) 新規追加

    - #### setUpperMargin

          public void setUpperMargin(String margin)

      【TAG】上方マージン(0.0～1.0)を指定します。
      パラメータ:
        `margin` - 上方マージン(0.0～1.0)
      説明:

             カテゴリ(グラフの横軸に相当)の上方側(右側)のマージンの比率を指定します。
             この比率は、％ ではなく、数字(double)での設定になります。
             何も指定しない場合は、デフォルトで自動調整されます。

      変更履歴:

        4.0.2.0 (2007/12/20) 新規追加

    - #### setUseDomainLine

          public void setUseDomainLine(String useLine)

      【TAG】横軸のグリッド表示有無(垂直線)を指定します(初期値:false)。
      パラメータ:
        `useLine` - 横軸のグリッド表示有無(垂直線)
      説明:

             ドメイン(横軸)に対する、グリッドラインを表示するかどうか指定します。

             何も指定しない場合は、表示しません。(false)

      変更履歴:

        4.0.3.0 (2008/01/07) 新規追加

    - #### setDomainLineColor

          public void setDomainLineColor(String color)

      【TAG】横軸のグリッド線の色を指定します。
      パラメータ:
        `color` - 横軸のグリッド線の色
      説明:

             ドメイン(横軸)に対する、グリッドラインの表示色を指定します。
             何も指定しない場合は、デフォルトで自動設定されます。

      変更履歴:

        4.0.3.0 (2008/01/07) 新規追加

    - #### setCategorySkip

          public void setCategorySkip(String step)

      【TAG】横軸ラベルをスキップする間隔を指定します。
      パラメータ:
        `step` - スキップする間隔
      関連項目:
        `setCategoryCutNo( String )`
      説明:

             横軸ラベル(カテゴリラベル表示)する際に、スキップする間隔を指定します。
             "1" (初期値)では、１つづつ表示(つまり、すべて表示する)します。
             "2" とすると、１つおきに、"3" とすると、２つおきに表示します。
             初期値は、"1" (すべて表示)です。
             なお、先頭から表示を開始します。

             注意：これとは別に、ラベル先頭に "_" を付けた場合は、ラベルを表示しません。
             また、categoryCutNo が指定された場合は、categorySkip は使用されません。

    - #### setCategoryCutNo

          public void setCategoryCutNo(String cutNo)

      【TAG】横軸ラベルの文字位置指定のキーブレイクを指定します。
      パラメータ:
        `cutNo` - キーブレイク位置
      関連項目:
        `setCategorySkip( String )`
      説明:

             横軸ラベル(カテゴリラベル表示)する際に、ラベルの先頭から、この指定文字数だけ
             カットして、表示します。
             その際、前回作成したカットラベルと、同一ラベルの場合は、表示しません。
             例えば、データは、年月日で、年と月のみ(先頭６文字)を指定すると、
             日のデータは、ラベルが表示されません。
             指定される数字は、１以上の整数としてください。
             初期値は、すべて表示です。

             注意：これとは別に、ラベル先頭に "_" を付けた場合は、ラベルを表示しません。

      変更履歴:

        4.1.1.0 (2008/02/04) 新規追加

    - #### setCategoryAnchor

          public void setCategoryAnchor(String anchor)

      【TAG】横軸のグリッド(垂直線)の書き出し位置(START,MIDDLE,END)を指定します。
      パラメータ:
        `anchor` - 横軸のグリッド(垂直線)の書き出し位置(START,MIDDLE,END)
      説明:

             横軸のグリッド(垂直線)を、グラフのどの位置に記述するかを指定します。
             具体的な値は、CategoryAnchor オブジェクトの値になります。
             ここでは、文字列で(START,MIDDLE,END)を指定します。(先頭一文字で判定)
             何も指定しない場合は、デフォルト(MIDDLE)です。

      変更履歴:

        4.1.1.0 (2008/02/14) 新規追加

    - #### setUseRangeLine

          public void setUseRangeLine(String useLine)

      【TAG】縦軸のグリッド表示有無(水平線)を指定します(初期値:true)。
      パラメータ:
        `useLine` - 横軸のグリッド表示有無(垂直線)
      説明:

             レンジ(縦軸)に対する、グリッドラインを表示するかどうか指定します。

             何も指定しない場合は、表示しません。(false)

      変更履歴:

        4.0.3.0 (2008/01/07) 新規追加

    - #### setRangeLineColor

          public void setRangeLineColor(String color)

      【TAG】縦軸のグリッド線の色を指定します。
      パラメータ:
        `color` - 縦軸のグリッド線の色
      説明:

             レンジ(縦軸)に対する、グリッドラインの表示色を指定します。
             何も指定しない場合は、デフォルトで自動設定されます。

      変更履歴:

        4.0.3.0 (2008/01/07) 新規追加

    - #### setRangeSkip

          public void setRangeSkip(String rngSkip)

      【TAG】縦軸のグリッド線(水平線)をスキップする間隔を指定します。
      パラメータ:
        `rngSkip` - 縦軸のグリッド線(水平線)をスキップする間隔
      説明:

             縦軸のグリッド線(水平線)を表示する際に、スキップする間隔を指定します。
             通常は、ラベルと同じだけのグリッド線が掛かれますが、ラベルよりも
             少ない数のグリッド線(例えば、２つおき)を出す場合に、値を設定します。
             "1" (初期値)では、１つづつ表示(つまり、すべて表示する)します。
             "2" とすると、１つおきに、"3" とすると、２つおきに表示します。
             初期値は、"1" (すべて表示)です。
             なお、先頭から表示を開始します。

      変更履歴:

        4.1.1.0 (2008/02/04) 新規追加

    - #### setUseToolTip

          public void setUseToolTip(String toolTip)

      【TAG】ツールチップスの使用可否[true:利用する/false:利用しない]を指定します(初期値:false)。
      パラメータ:
        `toolTip` - ツールチップス [true:利用/false:利用しない]
      説明:

             ラベルを利用する際に、ラベルと図面、隣のラベル同士が重なることがあります。
             この場合、ツールチップスの利用をお勧めします。
             初期値は'false'です。

      変更履歴:

        4.3.1.0 (2008/08/09) 新規追加

    - #### setDateAxisFormat

          public void setDateAxisFormat(String dtFormat)

      【TAG】Time,XYTime Polt関係の時間軸を表す場合のフォーマットを指定します(初期値:MM/dd)。
      パラメータ:
        `dtFormat` - Time,XYTime Polt関係の時間軸を表す場合のフォーマット
      説明:

             TimeSeries 関連のデータを扱う場合の横軸の日付フォーマットを指定します。
             日付フォーマットは、java.text.SimpleDateFormat で使われる yyyy/MM/dd HH:mm:ss 表記です。

             初期値は、"MM/dd" です。

      変更履歴:

        5.6.1.0 (2013/02/01) 新規追加
        5.6.1.0 (2013/02/01) 新規追加

    - #### addChartDataset

          protected void addChartDataset(ChartDataset chDataset)

      BODY要素に記述した、chartDataset タグの属性設定クラスをListに追加します。 BODY部に記述された、chartDataset タグの属性は、チャートのデータ取得Queryや、 チャートの種類などの情報を管理しています。 チャートの種類(Category系)によっては、チャートを合成して表示させることが可能です。 それらの複数のチャートの指定が、chartDataset タグ で行われます。
      パラメータ:
        `chDataset` - chartDatasetタグの属性設定クラス

    - #### toString

          public String toString()

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

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