org.opengion.hayabusa.taglib

## クラス ChartDatasetTag

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

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

      public class ChartDatasetTag
      extends CommonTagSupport

  BODY部に指定のSQLの検索結果をグラフ(円、棒、線)で表示するタグです。 グラフ化には、JFreeChart (http://www.jfree.org/jfreechart/) を使用しています。 chartType 属性には、ChartFactoryクラスで定義された変換表に基づく、チャートの 種類を指定します。このキーから、レンデラーやデータセットクラスを求めます。 それぞれのクラス毎に細かい設定値がありますが、初期レベルとしましては、主要チャートの 主要属性のみサポートします。また、指定の chartType では使用しない属性を指定した場合でも 単に無視するだけで、警告等はありませんので、ご注意ください。 各属性は、{@XXXX} 変数が使用できます。 これは、ServletRequest から、XXXX をキーに値を取り出し,この変数に割り当てます。 つまり、このXXXXをキーにリクエストすれば、この変数に値をセットすることができます。 useTableData="false"(初期値)の場合は、BODY部に書かれた SQL 文を実行してデータを取得します。 useTableData="true" にすると、その前の query タグ等で作成した DBTableModel を利用して グラフ化します。その場合は、BODY部の SQL 文は、無視されます。 利用する DBTableModel は、tableId と scope 属性から取得します。
  関連項目:
    直列化された形式
  形式サンプル:

         ●形式：<og:chartDataset renderer="…" … />
         ●body：あり

         ●Tag定義：
           <og:chartDataset
               chartType        ○【TAG】ChartDataset のデータタイプを指定します。(必須)
               dbid               【TAG】(通常は使いません)Datasetオブジェクトを作成する時のDB接続IDを指定します
               useTableData       【TAG】グラフ化するデータを DBTableModel から作成するかどうか(初期値:false)
               tableId            【TAG】(通常使いません)sessionから所得する DBTableModelオブジェクトの ID (初期値:HybsSystem#TBL_MDL_KEY[=h_tblmdl])
               scope              【TAG】キャッシュする場合のスコープ[request/page/session/applicaton]を指定します(初期値:session)
               baseLegend         【TAG】シリーズ単位の凡例 の表示可否を設定します
               valueLabel         【TAG】縦軸の表示名称を指定します
               markValues         【TAG】マーカーラインの設定値をカンマ区切り形式で複数指定します
               markColors         【TAG】マーカーラインの色をカンマ区切り形式で複数指定します
               markOverColors     【TAG】マーカーラインの超過時のShape色をカンマ区切り形式で複数指定します
               dynamicOCNo        【TAG】動的なマーカーラインの基準シリーズ番号を設定します(初期値:null)
               useMarkAnchor      【TAG】マーカーライン描画時に、その設定値を表示します
               lowerBound         【TAG】チャートの縦軸の最小値をセットします(初期値:自動計算)
               upperBound         【TAG】チャートの縦軸の最大値をセットします(初期値:自動計算)
               tickSize           【TAG】チャートの縦軸の目盛の幅をセットします(初期値:自動計算)
               useGradient        【TAG】バーチャートのグラデーション処理を行うかどうか[true/false]をセットします(初期値:false)
               shapesVisible      【TAG】ラインチャートのポイントを四角表示するかどうかを指定します(初期値:true)
               shapeColors        【TAG】データ毎にShapeを切り替える時の色の繰返しパターンを文字列配列で指定します
               shapeScale         【TAG】shapeの大きさを倍率指定で変更します(初期値:null)
               useDottedLine      【TAG】ラインチャートの線をドットラインにするかどうか[true/false]を指定します(初期値:false 線分)
               seriesColors       【TAG】複数チャート描画時のチャート色の繰返しパターンをCVS形式で複数指定します
               valueLabelsVisible 【TAG】Value(縦軸)のラベルを表示するかどうかを指定します(初期値:true[表示する])
               valueMarksVisible  【TAG】Value(縦軸)のマーカーを表示するかどうかを指定します(初期値:true[表示する])
               itemLabelVisible   【TAG】データの値(itemText)を表示するかどうか[true/false/last]を指定します(初期値:false[表示しない])
               useItemLabelSep    【TAG】データの値(itemText)の表示に、桁区切り文字を使用するかどうか[true/false]を指定します(初期値:true[使用する])
               valueInset         【TAG】縦軸の表示領域INSET値(double)を指定します
               barMaxWidth        【TAG】BOXチャートのバー幅の最大値(0.0～1.0)を指定します
               barItemMargin      【TAG】BOXチャートのバーアイテムのマージン(0.0～1.0)を指定します
               barWidth           【TAG】BOXチャートのバー幅(double)を指定します
               visibleLimit       【TAG】表示下限値(これ以下のデータは未表示)の値(double)を指定します
               domainMargin       【TAG】グラフの書き出し位置の調整比率を指定します
               timeFormatType     【TAG】時刻を表す場合の表現の仕方[E1/E2/E3/H1/H2/H3]を指定します(初期値:null)
               useVerticalLabels  【TAG】ラベルの表示向きを縦にするかどうか[false/true]を指定します(初期値:false)
               debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
           >   ... Body ...
           </og:chartDataset>

         ●使用例
              <og:chartCreate
                  command     = "{@command}"
                  title       = "{@title}"
                  domainLabel = "{@domainLabel}"
                  width       = "{@width}"
                  height      = "{@height}"
                  rectangleEdge   = "{@rectangleEdge}"
                  plotOrientation = "{@plotOrientation}"
                  chartBackColor  = "{@chartBackColor}"
                  plotBackColor   = "{@plotBackColor}"
                  domainMarker    = "{@domainMarker}"
                  useMarkerLabel  = "{@useMarkerLabel}" >
                      <og:chartDataset
                          chartType   = "[Bar|LineAndShape|･･･]"      チャートの種類
                          baseLegend  = "[true|false]"                シリーズ単位の凡例 の表示可否
                          valueLabel  = "縦軸"                        縦軸のラベル
                          lowerBound  = "0"                           下限値
                          upperBound  = "5000"                        上限値
                          tickSize    = "1000"                        縦軸の目盛の幅
                          markValues  = "2500,2800"                   縦軸設定値(横棒)
                          markColors  = "RED,GREEN"                   縦軸設定ライン色
                          markOverColors = "BLUE,YELLOW,RED"          マーカーラインの超過時のShape色
                          dynamicOCNo   = "2"                         動的なマーカーラインの基準シリーズ番号
                          useMarkAnchor = "[true|false]"              縦軸設定値(横棒)を表示するかどうか
                          useGradient   = "[false|true]"              バーチャートのグラデーション処理
                          shapesVisible = "[true|false]"              ラインの四角表示
                          shapeColors   = "RED,GREEN,BLUE"            データ毎のShapeの色
                          shapeScale    = "0.8"                       shapeの大きさの倍率(double)
                          useDottedLine = "[false|true]"              点線使用有無
                          seriesColors  = "RED,GREEN,BLUE"            シリーズの色サイクル指定
                          valueLabelsVisible = "[true|false]"         縦軸のラベルの表示有無
                          valueMarksVisible  = "[true|false]"         縦軸のマーカーの表示有無
                          itemLabelVisible   = "[false|true|last]"    データの値の表示有無
                          useItemLabelSep    = "[true|false]"         データの桁区切り文字の使用有無
                          valueInset         = "15"                   縦軸の表示領域INSET値
                          barMaxWidth        = "[0.0～1.0]"           バー幅の最大値(0.0～1.0)
                          barItemMargin      = "[0.0～1.0]"           バーアイテムのマージン(0.0～1.0)
                          barWidth           = "10"                   バー幅の実幅(double)
                          visibleLimit       = "0"                    表示下限値(これ以下のデータは未表示))
                          domainMargin       = "1.0"                  グラフの書き出し位置の調整比率
                          useTableData       = "[false|true]"         SQLではなく、DBTableModelからグラフを作成するかどうか
                          timeFormatType     = "[1|2]"                時間軸の設定(00:00表示)
                          useVerticalLabels  = "[false|true]"         時間軸の設定(ラベルの縦書き)
                          tableId            = "AAA"                  useTableData="true"の場合のDBTableModelの取得先ID
                          scope              = "[session|request]"    useTableData="true"の場合のDBTableModelの取得先scope
                      >
                                 {@SQL}
                      </og:chartDataset>
              </og:chartCreate>

            複数のグラフを重ね合わせる場合は、chartDataset タグを chartCreate のBODY部に
            複数記述します。
              <og:chartCreate
                  title       = "{@title}"
                  domainLabel = "{@domainLabel}"
                  width       = "{@width}"
                  height      = "{@height}" >
                  rectangleEdge   = "{@rectangleEdge}" >
                  plotOrientation = "{@plotOrientation}" >
                      <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>

            chartType属性 は、チャートの種類を指定する、固有IDです。
            [chartType属性]
              Area            , Bar               , Bar3D          , BoxAndWhisker    , CategoryStep  ,
              Gantt           , GroupedStackedBar , IntervalBar    , LayeredBar       , Level         ,
              LineAndShape    , Line3D            , MinMax         , StackedArea      , StackedBar    ,
              StackedBar3D    , WaterfallBar      , CyclicXYItem   , HighLow          , StackedXYArea ,
              StackedXYArea2  , StandardXYItem    , XYBubble       , XYDifference     , XYDot         ,
              XYError         , XYLine3D          , XYLineAndShape , XYStepArea       , XYStep        ,
              Meter           , MultiplePie       , Pie            , Pie3D            , Ring          ,
              SpiderWeb       , Thermometer

            markColors属性 は、マーカーラインの色を指定します
            java.awt.Color クラスのstatic フィールド名の文字列で指定します。
            [renderer属性]
              BLACK   , BLUE   , CYAN , DARK_GRAY , GRAY  , GREEN , LIGHT_GRAY ,
              MAGENTA , ORANGE , PINK , RED       , WHITE , YELLOW
              #XXXXXX形式の16bitRGB表記

  機能階層
    画面表示
  バージョン
    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`

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

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

  - ### メソッドの概要

    メソッド
    修飾子とタイプ | メソッドと説明
    --- | ---
    `int` | `doAfterBody()` Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。
    `int` | `doEndTag()` Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
    `int` | `doStartTag()` Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
    `protected void` | `release2()` タグリブオブジェクトをリリースします。
    `void` | `setBarItemMargin(String margin)` 【TAG】BOXチャートのバーアイテムのマージン(0.0～1.0)を指定します。
    `void` | `setBarMaxWidth(String barWidth)` 【TAG】BOXチャートのバー幅の最大値(0.0～1.0)を指定します。
    `void` | `setBarWidth(String width)` 【TAG】BOXチャートのバー幅(double)を指定します。
    `void` | `setBaseLegend(String baseLegend)` 【TAG】シリーズ単位の凡例 の表示可否を設定します。
    `void` | `setChartType(String chartType)` 【TAG】ChartDataset のデータタイプを指定します。
    `void` | `setDbid(String id)` 【TAG】(通常は使いません)Datasetオブジェクトを作成する時のDB接続IDを指定します。
    `void` | `setDomainMargin(String margin)` 【TAG】グラフの書き出し位置の調整比率を指定します。
    `void` | `setDynamicOCNo(String dynamicOCNo)` 【TAG】動的なマーカーラインの基準シリーズ番号を設定します(初期値:null)。
    `void` | `setItemLabelVisible(String itemLabelVisible)` 【TAG】データの値(itemText)を表示するかどうか[true/false/last]を指定します(初期値:false[表示しない])。
    `void` | `setLowerBound(String lowerBound)` 【TAG】チャートの縦軸の最小値をセットします(初期値:自動計算)。
    `void` | `setMarkColors(String markColors)` 【TAG】マーカーラインの色をカンマ区切り形式で複数指定します。
    `void` | `setMarkOverColors(String overColors)` 【TAG】マーカーラインの超過時のShape色をカンマ区切り形式で複数指定します。
    `void` | `setMarkValues(String markValues)` 【TAG】マーカーラインの設定値をカンマ区切り形式で複数指定します。
    `void` | `setSeriesColors(String colors)` 【TAG】複数チャート描画時のチャート色の繰返しパターンをCVS形式で複数指定します。
    `void` | `setShapeColors(String colors)` 【TAG】データ毎にShapeを切り替える時の色の繰返しパターンを文字列配列で指定します。
    `void` | `setShapeScale(String scale)` 【TAG】shapeの大きさを倍率指定で変更します(初期値:null)。
    `void` | `setShapesVisible(String shapesVisible)` 【TAG】ラインチャートのポイントを四角表示するかどうかを指定します(初期値:true)。
    `void` | `setTableId(String tableId)` 【TAG】(通常使いません)sessionから所得する DBTableModelオブジェクトの ID (初期値:HybsSystem#TBL_MDL_KEY[=h_tblmdl])。
    `void` | `setTickSize(String size)` 【TAG】チャートの縦軸の目盛の幅をセットします(初期値:自動計算)。
    `void` | `setTimeFormatType(String type)` 【TAG】時刻を表す場合の表現の仕方[E1/E2/E3/H1/H2/H3]を指定します(初期値:null)。
    `void` | `setUpperBound(String upperBound)` 【TAG】チャートの縦軸の最大値をセットします(初期値:自動計算)。
    `void` | `setUseDottedLine(String useDottedLine)` 【TAG】ラインチャートの線をドットラインにするかどうか[true/false]を指定します(初期値:false 線分)。
    `void` | `setUseGradient(String useGradient)` 【TAG】バーチャートのグラデーション処理を行うかどうか[true/false]をセットします(初期値:false)。
    `void` | `setUseItemLabelSep(String used)` 【TAG】データの値(itemText)の表示に、桁区切り文字を使用するかどうか[true/false]を指定します(初期値:true[使用する])。
    `void` | `setUseMarkAnchor(String useAnchor)` 【TAG】マーカーライン描画時に、その設定値を表示します。
    `void` | `setUseTableData(String flag)` 【TAG】グラフ化するデータを DBTableModel から作成するかどうか(初期値:false)。
    `void` | `setUseVerticalLabels(String useVLavels)` 【TAG】ラベルの表示向きを縦にするかどうか[false/true]を指定します(初期値:false)。
    `void` | `setValueInset(String inset)` 【TAG】縦軸の表示領域INSET値(double)を指定します。
    `void` | `setValueLabel(String valueLabel)` 【TAG】縦軸の表示名称を指定します。
    `void` | `setValueLabelsVisible(String labelsVisible)` 【TAG】Value(縦軸)のラベルを表示するかどうかを指定します(初期値:true[表示する])。
    `void` | `setValueMarksVisible(String marksVisible)` 【TAG】Value(縦軸)のマーカーを表示するかどうかを指定します(初期値:true[表示する])。
    `void` | `setVisibleLimit(String limit)` 【TAG】表示下限値(これ以下のデータは未表示)の値(double)を指定します。
    `String` | `toString()` このオブジェクトの文字列表現を返します。

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

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

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

    - #### ChartDatasetTag

          public ChartDatasetTag()

  - ### メソッドの詳細

    - #### doStartTag

          public int doStartTag()

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

        5.3.0.0 (2010/12/01) useTableDataによるデータ取得方法の機能追加

    - #### doAfterBody

          public int doAfterBody()

      Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。
      定義:
        `doAfterBody` インタフェース内 `IterationTag`
      オーバーライド:
        `doAfterBody` クラス内 `CommonTagSupport`
      戻り値:
        後続処理の指示(SKIP_BODY)
      変更履歴:

        5.3.0.0 (2010/12/01) データベース検索処理を、doEndTag() メソッドから移動

    - #### doEndTag

          public int doEndTag()

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

        4.0.0.1 (2007/12/03) try ～ catch ～ finally をきちんと行う。
        5.2.1.0 (2010/10/01) debugPrint() メソッド追加
        5.3.0.0 (2010/12/01) データベース検索処理を、doAfterBody() へ移動

    - #### release2

          protected void release2()

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

        4.0.0.0 (2007/10/10) dbid の初期値を、"DEFAULT" から null に変更
        5.3.0.0 (2010/12/01) useTableData,tableId 属性追加

    - #### setDbid

          public void setDbid(String id)

      【TAG】(通常は使いません)Datasetオブジェクトを作成する時のDB接続IDを指定します。
      パラメータ:
        `id` - データベース接続ID
      説明:

             Datasetオブジェクトを作成する時のDB接続IDを指定します。
             これは、システムリソースで、DEFAULT_DB_URL 等で指定している データベース接続先
             情報に、XX_DB_URL を定義することで、 dbid="XX" とすると、この 接続先を使用して
             データベースにアクセスできます。

    - #### setChartType

          public void setChartType(String chartType)

      【TAG】ChartDataset のデータタイプを指定します。
      パラメータ:
        `chartType` - チャートタイプ
      関連項目:
        `CategoryItemRenderer`, `XYItemRenderer`
      説明:

             チャートタイプ は、外部からチャートを指定するのに便利なように、キー化
             されています。このキーに基づいて、ChartFactory クラスの
             チャートタイプ変換表に基づいて、レンデラーや、データセットを作成します。
             基本的には、チャートタイプ は、この、レンデラー名称から決定しています。

              Area            , Bar               , Bar3D          , BoxAndWhisker    , CategoryStep  ,
              Gantt           , GroupedStackedBar , IntervalBar    , LayeredBar       , Level         ,
              LineAndShape    , Line3D            , MinMax         , StackedArea      , StackedBar    ,
              StackedBar3D    , WaterfallBar      , CyclicXYItem   , HighLow          , StackedXYArea ,
              StackedXYArea2  , StandardXYItem    , XYBubble       , XYDifference     , XYDot         ,
              XYError         , XYLine3D          , XYLineAndShape , XYStepArea       , XYStep        ,
              Meter           , MultiplePie       , Pie            , Pie3D            , Ring          ,
              SpiderWeb       , Thermometer

    - #### setUseTableData

          public void setUseTableData(String flag)

      【TAG】グラフ化するデータを DBTableModel から作成するかどうか(初期値:false)。
      パラメータ:
        `flag` - データをDBTableModelを利用する場合、true
      説明:

             useTableData="false"(初期値)の場合は、BODY部に書かれた SQL 文を実行してデータを取得します。
             useTableData="true" にすると、その前の query タグ等で作成した DBTableModel を利用して
             グラフ化します。その場合は、BODY部の SQL 文は、無視されます。
             利用する DBTableModel は、tableId と scope 属性から取得します。

      変更履歴:

        5.3.0.0 (2010/12/01) 新規追加

    - #### setTableId

          public void setTableId(String tableId)

      【TAG】(通常使いません)sessionから所得する DBTableModelオブジェクトの ID (初期値:HybsSystem#TBL_MDL_KEY[=h_tblmdl])。
      パラメータ:
        `tableId` - sessionに登録する時の ID
      関連項目:
        `HybsSystem.TBL_MDL_KEY`
      説明:

             表示処理後に，(内部ポインタを書き換えた)DBTableModelオブジェクトを
             同じキーで、sessionに登録します。
             (初期値:システム定数のHybsSystem#TBL_MDL_KEY[={@og.value org.opengion.hayabusa.common.HybsSystem#TBL_MDL_KEY}])。

      変更履歴:

        5.3.0.0 (2010/12/01) 新規追加

    - #### setBaseLegend

          public void setBaseLegend(String baseLegend)

      【TAG】シリーズ単位の凡例 の表示可否を設定します。
      パラメータ:
        `baseLegend` - シリーズ単位の凡例 の表示可否
      説明:

             シリーズ単位の凡例 の表示可否を設定します。

    - #### setValueLabel

          public void setValueLabel(String valueLabel)

      【TAG】縦軸の表示名称を指定します。
      パラメータ:
        `valueLabel` - 縦軸の表示名称
      説明:

             縦軸の表示名称を指定します。

    - #### setMarkValues

          public void setMarkValues(String markValues)

      【TAG】マーカーラインの設定値をカンマ区切り形式で複数指定します。
      パラメータ:
        `markValues` - マーカーラインの設定値(CSV形式)
      関連項目:
        `setMarkColors( String )`
      説明:

             指定の値にマーカーラインを引きます。
             色は、setMarkColors( String ) で指定します。
             markColors と、個数をあわせて設定する必要があります。
             どちらかが、指定されていない場合は、マーカー表示されません。
             dynamicOCNo を使用する場合は、そのValues の並びの箇所に、
             "G"  という文字列を設定して下さい。
             例：2000,G  基準１は、2000の直線、基準２は、グラフ という意味。

    - #### setUseMarkAnchor

          public void setUseMarkAnchor(String useAnchor)

      【TAG】マーカーライン描画時に、その設定値を表示します。
      パラメータ:
        `useAnchor` - true:設定値を表示する。
      説明:

             マーカーラインの縦軸の設定値(markValues)に、設定値をラベル表示します。
             位置は、TextAnchor.BASELINE_LEFT 固定です。
             初期値は、表示する(true)です。

      変更履歴:

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

    - #### setMarkColors

          public void setMarkColors(String markColors)

      【TAG】マーカーラインの色をカンマ区切り形式で複数指定します。
      パラメータ:
        `markColors` - マーカーラインの色(CSV形式)
      関連項目:
        `Color.BLACK`, `setMarkValues( String )`
      説明:

             マーカーラインとは、縦軸設定のラインの事で、縦軸の設定値(markValues)に
             横方向にラインを付与します。このラインの色を、カンマ区切り形式で
             指定します。
             markValues と、あわせて設定する必要があります。
             個数が異なる場合は、markValues が優先され、無指定の場合は、Color.REDで
             表示されます。

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

                  BLACK   , BLUE   , CYAN , DARK_GRAY , GRAY  , GREEN , LIGHT_GRAY ,
                  MAGENTA , ORANGE , PINK , RED       , WHITE , YELLOW , (PURPLE)
                  #XXXXXX形式の16bitRGB表記 でも指定可能です。

    - #### setMarkOverColors

          public void setMarkOverColors(String overColors)

      【TAG】マーカーラインの超過時のShape色をカンマ区切り形式で複数指定します。
      パラメータ:
        `overColors` - マーカーラインの超過時のShape色(CSV形式)
      関連項目:
        `Color.BLACK`
      説明:

             HybsLine でのみ使用可能です。
             マーカーラインを使用する場合に、そのラインを超えない色、超える色を指定します。
             この色の指定は、マーカーラインの色やマーカーラインの設定値の個数＋１に
             なります。つまり、色１：設定値１：色２：設定値２：色３ となります。
             色１は、設定値１より小さい場合に使用され、色２は、設定値１より大きく、
             設定値２より小さい場合、色３は、設定値２より大きい場合になります。

             指定文字列は、java.awt.Color クラスのstatic フィールド名で指定します。
             BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY ,
             MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できます。
             また、#XXXXXX形式の16bitRGB表記 でも指定可能です。
             markValues と、あわせて設定する必要があります。
             どちらかが、指定されていない場合は、マーカー表示されません。

                  BLACK   , BLUE   , CYAN , DARK_GRAY , GRAY  , GREEN , LIGHT_GRAY ,
                  MAGENTA , ORANGE , PINK , RED       , WHITE , YELLOW , (PURPLE)
                  #XXXXXX形式の16bitRGB表記 でも指定可能です。

      変更履歴:

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

    - #### setDynamicOCNo

          public void setDynamicOCNo(String dynamicOCNo)

      【TAG】動的なマーカーラインの基準シリーズ番号を設定します(初期値:null)。
      パラメータ:
        `dynamicOCNo` - true:動的なマーカーラインの基準シリーズ番号
      説明:

             動的なマーカーラインを使用する場合は、基準値となるシリーズ番号を指定します。

             マーカーラインの最下位閾値に相当します。これは、グラフ化されますが、
             Shape は自動的に削除されます。
             この設定を使用する場合、最初のデータには、必ずShapeが付きます。それ以外の
             データに、Shape を付けるかどうかは、shapesVisible 属性で指定します。
             この線の色は、markColors で指定した、最下位の色になります。また、
             markValues で指定した、最下位の値は、使用されません。ただし、色指定の
             関係上、設定しておく必要があります。
             また、isValueVisible == true で、設定値の値表示を行う場合も、最下位の
             値は表示しないようにします。
             初期値は、使用しない(null)です。

      変更履歴:

        4.1.1.0 (2008/02/04) 新規追加
        4.1.1.0 (2008/02/19) setUseDynamicOC ⇒ setDynamicOCNo

    - #### setLowerBound

          public void setLowerBound(String lowerBound)

      【TAG】チャートの縦軸の最小値をセットします(初期値:自動計算)。
      パラメータ:
        `lowerBound` - 縦軸の最小値
      説明:

             何も指定しない場合は、データの最小値から、自動的に計算します。

    - #### setUpperBound

          public void setUpperBound(String upperBound)

      【TAG】チャートの縦軸の最大値をセットします(初期値:自動計算)。
      パラメータ:
        `upperBound` - 縦軸の最大値
      説明:

             何も指定しない場合は、データの最大値から、自動的に計算します。

    - #### setTickSize

          public void setTickSize(String size)

      【TAG】チャートの縦軸の目盛の幅をセットします(初期値:自動計算)。
      パラメータ:
        `size` - 縦軸のチック(目盛)の幅
      説明:

             何も指定しない場合は、データの範囲から、自動的に計算します。

      変更履歴:

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

    - #### setUseGradient

          public void setUseGradient(String useGradient)

      【TAG】バーチャートのグラデーション処理を行うかどうか[true/false]をセットします(初期値:false)。
      パラメータ:
        `useGradient` - グラデーション処理 [true:する/false:しない]
      説明:

             通常のバーチャートは、単一色表示で表されますが、これにグラデーション効果を
             付加するかどうかを指定します。
             通常のバーチャートが、少しきれいに見えます。
             初期値は、false(使用しない)です。

    - #### setShapesVisible

          public void setShapesVisible(String shapesVisible)

      【TAG】ラインチャートのポイントを四角表示するかどうかを指定します(初期値:true)。
      パラメータ:
        `shapesVisible` - ポイントを四角表示するかどうか
      説明:

             ラインチャートは、通常、線分で表され、各ポイントについても、線分で接続されます。
             shapesVisible を true に設定すると、各ポイントが、線上に四角く表示され、
             そのポイントの位置を、容易に判断出来るようになります。
             初期値は、true( LineAndShape )です。

    - #### setShapeColors

          public void setShapeColors(String colors)

      【TAG】データ毎にShapeを切り替える時の色の繰返しパターンを文字列配列で指定します。
      パラメータ:
        `colors` - データ毎の色の繰返しパターン(文字列配列)
      関連項目:
        `Color.BLACK`
      説明:

             HybsLine でのみ使用可能です。
             これは、データそのものが、繰返し性のある場合に、その繰返し性に対応した
             形状のShape を表示させる場合に使用します。
             繰返しShapeの形状は、JFreeChart のシリーズ毎の繰返し標準形状を使用します。
             現在のバージョンでは、１０個までの繰返しに対応可能です。
             繰返し色を、指定した分だけ、順に使用されていきます。

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

      変更履歴:

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

    - #### setShapeScale

          public void setShapeScale(String scale)

      【TAG】shapeの大きさを倍率指定で変更します(初期値:null)。
      パラメータ:
        `scale` - shapeの大きさの倍率
      説明:

             ラインチャートのShape(各グラフのポイントのマーカー)の大きさは、通常は、
             自動設定されます。
             この大きさを、倍率指定で、変更可能です。
             指定は、double 型です。
             初期値は、null は、スケール変更しません(自動設定のままの大きさ)

      変更履歴:

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

    - #### setUseDottedLine

          public void setUseDottedLine(String useDottedLine)

      【TAG】ラインチャートの線をドットラインにするかどうか[true/false]を指定します(初期値:false 線分)。
      パラメータ:
        `useDottedLine` - ドットラインにするかどうか [true:点線/false:線分]
      説明:

             ラインチャートは、通常、線分で表されます。
             これに、点線で表すことで、グラフの違いを、色だけでなく形状でも識別
             しやすくすることが可能です。
             初期値は、false(線分)です。

    - #### setSeriesColors

          public void setSeriesColors(String colors)

      【TAG】複数チャート描画時のチャート色の繰返しパターンをCVS形式で複数指定します。
      パラメータ:
        `colors` - チャート色の繰返しパターン(CVS形式)
      関連項目:
        `Color.BLACK`
      説明:

             通常、複数のチャートを同時に表示させる場合は、縦軸が共通であれば、
             １回のSelect分で複数データを取得します。
             この、データをシリーズと呼んでおり、これを区別する為に、色を分けます。
             初期値は、JFreeChart が自動で割り振ります。
             これを、外部からCVS形式で、カンマ区切りで色コードを指定します。
             指定データが多い場合は、多い分の色は使用されません。少ない場合は、
             順番に繰り返して使用されます。
             例えば、１色だけ指定した場合は、すべてのシリーズが同じ色で表されます。

             指定文字列は、java.awt.Color クラスのstatic フィールド名で指定します。
             BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY ,
             MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できます。

             また、#XXXXXX形式の16bitRGB表記 でも指定可能です。

    - #### setValueLabelsVisible

          public void setValueLabelsVisible(String labelsVisible)

      【TAG】Value(縦軸)のラベルを表示するかどうかを指定します(初期値:true[表示する])。
      パラメータ:
        `labelsVisible` - Value(縦軸)のラベルを表示するかどうか
      説明:

             ValueAxis にて設定される、縦軸情報の、ラベルを表示するかどうか指定します。
             初期値は、true(表示する)です。

      変更履歴:

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

    - #### setValueMarksVisible

          public void setValueMarksVisible(String marksVisible)

      【TAG】Value(縦軸)のマーカーを表示するかどうかを指定します(初期値:true[表示する])。
      パラメータ:
        `marksVisible` - Value(縦軸)のマーカーを表示するかどうか
      説明:

             ValueAxis にて設定される、縦軸情報の、マーカーを表示するかどうか指定します。
             初期値は、true(表示する)です。

      変更履歴:

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

    - #### setItemLabelVisible

          public void setItemLabelVisible(String itemLabelVisible)

      【TAG】データの値(itemText)を表示するかどうか[true/false/last]を指定します(初期値:false[表示しない])。
      パラメータ:
        `itemLabelVisible` - データの値の表示のさせ方(true,false,last)
      説明:

             CategoryItemRenderer 関連のグラフの設定値をグラフ上に表示するかどうかを
             指定します。
             true に設定した場合、通常の場合は、すべてのシリーズにラベル表示されます。
             false に設定すると、表示されません。
             last を設定すると、各シリーズの最後の値のみ表示されます。
             ChartCreate クラスに、seriesPikup が設定されている場合は、指定のシリーズ
             のみの設定値を表示し、他の値は、表示しません。
             同様に、dynamicOCNo が指定されている場合(動的なマーカーライン)
             最下位のシリーズは、閾値として使用されるため、設定値は表示されません。
             ラベルの表示位置は、表示する線グラフの傾きに応じてラベルの表示場所を
             変えます。山形、右坂、谷形、左坂 に応じて、上中、下右、下中、上右 に
             位置を設定します。右にずらすのは、10 ピクセル固定です。
             初期値は、false(表示しない)です。

      変更履歴:

        4.1.1.0 (2008/02/04) 新規追加
        4.1.2.0 (2008/03/12) 文字列のまま、渡すように変更

    - #### setUseItemLabelSep

          public void setUseItemLabelSep(String used)

      【TAG】データの値(itemText)の表示に、桁区切り文字を使用するかどうか[true/false]を指定します(初期値:true[使用する])。
      パラメータ:
        `used` - データの桁区切り文字の使用有無
      説明:

             itemLabelVisible=true 時に、表示されるデータ値ラベルで、
             NumberFormat していますが、３桁区切り文字(123,456,789.0) の
             区切り記号を表示するかどうかを指定します。
             true を指定すると、表示します。false では、表示しません。
             初期値は、true(使用する)です。

      変更履歴:

        4.1.2.0 (2008/03/12) 新規追加

    - #### setValueInset

          public void setValueInset(String inset)

      【TAG】縦軸の表示領域INSET値(double)を指定します。
      パラメータ:
        `inset` - Value(縦軸)の表示領域INSET値
      説明:

             縦軸文字表示領域(NumberAxis)の幅の追加値を設定します。
             これは、通常の表示領域の左側にスペースを挿入します。
             あくまで、追加する値なので、文字の長さは含まれません。
             何も指定しない場合は、設定しません。

      変更履歴:

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

    - #### setBarWidth

          public void setBarWidth(String width)

      【TAG】BOXチャートのバー幅(double)を指定します。
      パラメータ:
        `width` - BOXチャートのバー幅(double)
      説明:

             BOXチャートのバー幅(double)を指定します。
             設定されるのは、org.jfree.chart.renderer.category.BarRenderer を
             使用した描画のみです。
             棒グラフのバー幅指定は、直接、CategoryItemRendererState に設定しています。
             通常は、barMaxWidth(0.0～1.0)とbarItemMargin(0.0～1.0)を用いて比率で指定します。
             何も指定しない場合は、設定しません。

      変更履歴:

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

    - #### setBarMaxWidth

          public void setBarMaxWidth(String barWidth)

      【TAG】BOXチャートのバー幅の最大値(0.0～1.0)を指定します。
      パラメータ:
        `barWidth` - BOXチャートのバー幅の最大値(0.0～1.0)
      説明:

             BOXチャートのバー幅の比率の最大値を指定します。
             表示領域を１として小数点以下の数値で棒の幅を設定します。
             設定した幅に無理がある時は適当なサイズに調整されます。
             (小さくしたときには棒が線のようになる)
             設定されるのは、org.jfree.chart.renderer.category.BarRenderer を
             使用した描画のみです。
             何も指定しない場合は、設定しません。

      変更履歴:

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

    - #### setBarItemMargin

          public void setBarItemMargin(String margin)

      【TAG】BOXチャートのバーアイテムのマージン(0.0～1.0)を指定します。
      パラメータ:
        `margin` - BOXチャートのバーアイテムのマージン(0.0～1.0)
      説明:

             BOXチャートのバーアイテムのマージンの比率を指定します。
             棒の間を表示領域を１として小数点以下の数値で幅を設定します。
             無理がある時は適当なサイズに調整されます。
             barMaxWidth より優先されます。
             設定されるのは、org.jfree.chart.renderer.category.BarRenderer を
             使用した描画のみです。
             何も指定しない場合は、設定しません。

      変更履歴:

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

    - #### setVisibleLimit

          public void setVisibleLimit(String limit)

      【TAG】表示下限値(これ以下のデータは未表示)の値(double)を指定します。
      パラメータ:
        `limit` - 表示下限値(これ以下のデータは未表示)
      説明:

             HybsLine でのみ使用可能です。
             この設定値以下のデータは、存在しない扱いとします。
             Lineを引くとき、このデータと、存在しているデータ間にラインは引かれません。
             何も指定しない場合は、設定しません。

      変更履歴:

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

    - #### setDomainMargin

          public void setDomainMargin(String margin)

      【TAG】グラフの書き出し位置の調整比率を指定します。
      パラメータ:
        `margin` - double グラフの書き出し位置の調整比率
      説明:

             HybsStackedBar でのみ使用可能です。
             グラフを描画する場合の、書き出し位置を少しずらします。
             これは、グラフの幅に対して、比率で指定します。
             0.0(初期値)の場合は、初期描画位置である、CategoryAnchor.Middle と
             同じ箇所から、書き出されます。
             1.0 の場合、中心から、グラフ幅の半分が加算され、END位置に寄ります。
             同様に、-1.0 の場合は、グラフ幅の半分が減算され、START 位置になります。
             つまり、中心から、グラフ幅の半分単位で、前方/後方にずらす事が出来ます。
               書き出し位置 ＝ 中心(Middle) + (domainMargin)＊幅/２
             初期値は、0.0(真ん中:MIDDLE)です。

      変更履歴:

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

    - #### setTimeFormatType

          public void setTimeFormatType(String type)

      【TAG】時刻を表す場合の表現の仕方[E1/E2/E3/H1/H2/H3]を指定します(初期値:null)。
      パラメータ:
        `type` - 時刻の表示方法(E1,E2,E3,H1,H2,H3)
      説明:

             HybsNumberAxis にオーバーライドする 時間を表示する DecimalFormat の内部クラスを利用するに当たり、
             時刻の表示方法を指定します。
             外部から与える数字は、連続している必要があるため、１０進数です。
             たとえば、1700 → 17:00 , 2150 → 21:30 という感じです。
             2400 を超えると日付違いになります。

             英語表記(:)と日本語表記(時)の区別と、24時間を超える場合の表示方法によって、６種類のパターンが存在します。
             　E1:そのまま、24:00 となり、加算されていく。
             　E2:そのまま、0:00 に戻る。(日付は無視)
             　E3:そのまま、1 00:00 と日付が付与される。
             　H1:そのまま、24時00分 となり、加算されていく。
             　H2:そのまま、00時00分 に戻る。(日付は無視)
             　H3:そのまま、1日 00時00分 と日付が付与される。
             初期値は、使用しない(-1)です。

      変更履歴:

        5.5.2.1 (2012/05/07) 新規追加

    - #### setUseVerticalLabels

          public void setUseVerticalLabels(String useVLavels)

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

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

      変更履歴:

        5.5.2.1 (2012/05/07) 新規追加

    - #### toString

          public String toString()

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

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