org.opengion.hayabusa.io

## クラス ChartDataset

- java.lang.Object
- - org.opengion.hayabusa.io.ChartDataset

-     public class ChartDataset
      extends Object

       ChartDataset は、Dataset および、JFreeChart の個別属性を管理しているデータ管理クラスです。
       JFreeChart のグラフ合成機能のための、個別のグラフ描画属性を管理しています。
       内部的に、引数の文字列を JFreeChart の各オブジェクトへの変換なども行っています。

  バージョン
    0.9.0 2007/06/21
  作成者
    Kazuhiko Hasegawa
  導入されたバージョン:
    JDK1.1,

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

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

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

    すべてのメソッド インスタンス・メソッド concreteメソッド
    修飾子とタイプ | メソッドと説明
    --- | ---
    `protected String` | `getBarWidth()` BOXチャートのバー幅(double)を取得します。
    `protected String` | `getChartType()` Dataset オブジェクトを作成する時のチャートタイプを取得します。
    `protected org.jfree.data.general.Dataset` | `getDataset()` Dataset オブジェクトを取得します。
    `String` | `getQuery()` 検索を行う クエリー文字列を返します。
    `protected org.jfree.chart.renderer.category.CategoryItemRenderer` | `getRenderer(int serNo, org.jfree.chart.urls.CategoryURLGenerator urlGen)` Renderer 関連の共通インターフェースを返します。
    `protected Color[]` | `getSeriesColors()` 複数チャート描画時のチャート色の繰返しパターンをColor配列で指定します。
    `protected String` | `getValueLabel()` 縦軸の表示名称を取得します。
    `protected org.jfree.chart.plot.ValueMarker[]` | `getValueMarkers()` マーカーラインの ValueMarker オブジェクト配列を返します。
    `protected boolean` | `isShapesVisible()` ラインチャートのポイントを四角表示するかどうかを取得します。
    `protected boolean` | `isUseDottedLine()` ラインチャートの線をドットラインにするかどうかを取得します。
    `protected boolean` | `isUseGradient()` バーチャートのグラデーション処理を行うかどうかを取得します。
    `protected org.jfree.chart.plot.Plot` | `makeCompassPlot()` CompassPlot に必要な情報を設定します。
    `void` | `makeDataset(Connection conn, String sql)` Connection と query 文字列から、Dataset オブジェクトを作成します。
    `void` | `makeDataset(DBTableModel table)` DBTableModelオブジェクトから、Dataset オブジェクトを作成します。
    `protected org.jfree.chart.plot.Plot` | `makeMeterPlot()` MeterPlot に必要な情報を設定します。
    `protected org.jfree.chart.axis.NumberAxis` | `makeNumberAxis()` NumberAxis オブジェクトを作成します。
    `protected org.jfree.chart.plot.Plot` | `makeThermometerPlot()` ThermometerPlot に必要な情報を設定します。
    `void` | `setBarItemMargin(String margin)` BOXチャートのバーアイテムのマージン(0.0～1.0)を指定します。
    `void` | `setBarMaxWidth(String barWidth)` BOXチャートのバー幅の最大値(0.0～1.0)を指定します。
    `void` | `setBarWidth(String width)` BOXチャートのバー幅(double)を指定します。
    `void` | `setBaseLegend(boolean baseLeg)` シリーズ単位の凡例 の表示可否を設定します。
    `void` | `setChartType(String type)` Dataset オブジェクトを作成する時のチャートタイプを指定します。
    `void` | `setDomainMargin(double margin)` グラフの書き出し位置の調整比率を指定します。
    `void` | `setDynamicOCNo(int ocNo)` 動的なマーカーラインの基準シリーズ番号を設定します(初期値:-1)。
    `void` | `setItemLabelVisible(String visible)` データの値(itemText)を表示するかどうか[true/false/last]を指定します(初期値:false[表示しない])。
    `void` | `setLowerBound(String lowBnd)` チャートの縦軸の最小値をセットします(初期値:自動計算)。
    `void` | `setMarkColors(String[] mkCol)` マーカーラインの色を配列指定します。
    `void` | `setMarkOverColors(String[] ovCol)` マーカーラインの超過時のShape色をCSV形式形式で複数指定します。
    `void` | `setMarkValues(String[] mkVal)` マーカーラインの設定値配列を指定します。
    `void` | `setNeedleType(String type)` Dataset オブジェクトを作成する時のNeedleタイプを指定します。
    `void` | `setSeriesColors(String[] colors)` 複数チャート描画時のチャート色の繰返しパターンを文字列配列で指定します。
    `void` | `setSeriesLabels(String[] labels)` 複数チャート(series)描画時のラベル名配列を指定します。
    `void` | `setShapeColors(String[] colors)` データ毎にShapeを切り替える時の色の繰返しパターンを文字列配列で指定します。
    `void` | `setShapeScale(String scale)` shapeの大きさを倍率指定で変更します(初期値:null)。
    `void` | `setShapesVisible(boolean shVisible)` ラインチャートのポイントを四角表示するかどうかを指定します(初期値:false)。
    `void` | `setTickSize(String size)` チャートの縦軸の目盛の幅をセットします(初期値:自動計算)。
    `void` | `setTimeFormatType(String type)` 時刻を表す場合の表現の仕方を指定します(初期値:null)。
    `void` | `setUpperBound(String upBnd)` チャートの縦軸の最大値をセットします(初期値:自動計算)。
    `void` | `setUseCategoryColor(boolean useCateColor)` カテゴリのカラー名指定があるかどうか[true/false]を指定します(初期値:false)。
    `void` | `setUseDottedLine(boolean useDotLine)` ラインチャートの線をドットラインにするかどうかを指定します(初期値:false)。
    `void` | `setUseGradient(boolean useGrad)` バーチャートのグラデーション処理を行うかどうか[true/false]をセットします(初期値:true)。
    `void` | `setUseItemLabelSep(boolean used)` データの値(itemText)の表示に桁区切り文字を使用するかどうかを指定します。
    `void` | `setUseMarkAnchor(boolean useAnchor)` マーカーライン描画時に、その設定値を表示します。
    `void` | `setUseVerticalLabels(boolean useVLavels)` ラベルの表示向きを縦にするかどうか[true/false]を指定します(初期値:false)。
    `void` | `setValueInset(String inset)` 縦軸の表示領域INSET値(double)を指定します。
    `void` | `setValueLabel(String valLbl)` 縦軸の表示名称を指定します。
    `void` | `setValueLabelsVisible(boolean labelsVisible)` Value(縦軸)のラベルを表示するかどうかを指定します(初期値:true[表示する])。
    `void` | `setValueMarksVisible(boolean marksVisible)` Value(縦軸)のマーカーを表示するかどうかを指定します(初期値:true[表示する])。
    `void` | `setVisibleLimit(String limit)` 表示下限値(これ以下のデータは未表示)の値(double)を指定します。
    `String` | `toString()` このオブジェクトの文字列表現を返します。

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

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

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

    - #### ChartDataset

          public ChartDataset()

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

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

  - ### メソッドの詳細

    - #### makeDataset

          public void makeDataset(Connection conn,
                                  String sql)
                           throws SQLException

      Connection と query 文字列から、Dataset オブジェクトを作成します。 setChartType( String ) で指定されたチャートタイプに応じて、Datasetオブジェクト を構築します。 Dataset クラスは、"org.jfree.data.jdbc.JDBCXXXXDataset" の XXXX の箇所を ChartFactory クラスのチャートタイプ変換表に基づいて求めます。 現状は、Category , Pie , XY の３種類と、Value が指定可能です。 ※ Value は、conn や sql を使用していません。値は、markValues を使用しています。 これは、現状の暫定方法であり、今後は変わる可能性があります。
      パラメータ:
        `conn` - Datasetの取得先のコネクション
        `sql` - 取得するクエリー文字列
      例外:
        `SQLException` - データベース実行エラーが発生した場合
      変更履歴:

        4.0.0.0 (2007/11/28) new Double(double) ⇒ Double.valueOf(double) 変更
        6.0.2.0 (2014/09/19) シリーズのラベル名配列追加
        6.0.2.2 (2014/10/03) カテゴリのカラー名指定 useCategoryColor 追加

    - #### makeDataset

          public void makeDataset(DBTableModel table)

      DBTableModelオブジェクトから、Dataset オブジェクトを作成します。 setChartType( String ) で指定されたチャートタイプに応じて、Datasetオブジェクト を構築します。 現状は、Category , Pie , XY の３種類と、Value が指定可能です。 ※ Value は、DBTableModel を使用していません。値は、markValues を使用しています。 これは、現状の暫定方法であり、今後は変わる可能性があります。
      パラメータ:
        `table` - Datasetの取得先のテーブルモデル
      変更履歴:

        5.3.0.0 (2010/12/01) 新規追加
        6.0.2.0 (2014/09/19) シリーズのラベル名配列追加
        6.0.2.2 (2014/10/03) カテゴリのカラー名指定 useCategoryColor 追加

    - #### makeNumberAxis

          protected org.jfree.chart.axis.NumberAxis makeNumberAxis()

      NumberAxis オブジェクトを作成します。 NumberAxis オブジェクトは、Value(縦軸)の属性を設定する為に使用される オブジェクトです。 これに、各種属性を設定して、値を返します。 属性としては、isLineVisible、isLabelsVisible、isMarksVisible、 range(lowerBound、upperBound) です。
      戻り値:
        縦軸の属性(NumberAxisオブジェクト)
      変更履歴:

        4.0.2.0 (2007/12/20) 新規追加
        4.0.3.0 (2008/01/07) 縦軸レンジを個別設定、チック幅指定
        4.1.1.0 (2008/02/04) HybsNumberAxis 採用
        4.1.1.0 (2008/02/04) setAxisLineVisible を、isMarksVisible 値で設定する。
        5.5.2.1 (2012/05/07) timeFormatType 、useVerticalLabels 属性を追加する。
        6.0.3.0 (2014/11/13) lowerBound だけ設定すると、upperBound がおかしくなる。
        6.2.0.0 (2015/02/27) グラフの重ね合わせ時に、縦軸表示が崩れる対応(暫定)

    - #### getQuery

          public String getQuery()

      検索を行う クエリー文字列を返します。 これは、makeDataset( Connection ,String ) メソッドで指定した、 sql 属性の設定値そのものです。
      戻り値:
        取得するクエリー文字列

    - #### getDataset

          protected org.jfree.data.general.Dataset getDataset()

      Dataset オブジェクトを取得します。 makeDataset( Connection,String ) で、予めオブジェクトを構築しておく 必要があります。 Dataset クラスは、"org.jfree.data.jdbc.JDBCXXXXDataset" の XXXX の箇所を ChartFactory クラスのチャートタイプ変換表に基づいて求めます。 現状は、Category , Pie , XY の３種類と、Value が指定可能です。
      戻り値:
        Datasetオブジェクト
      関連項目:
        `makeDataset( Connection ,String )`

    - #### setChartType

          public void setChartType(String type)

      Dataset オブジェクトを作成する時のチャートタイプを指定します。 チャートタイプ は、外部からチャートを指定するのに便利なように、キー化 されています。このキーに基づいて、ChartFactory クラスの チャートタイプ変換表に基づいて、レンデラーや、データセットを作成します。
      パラメータ:
        `type` - チャートタイプ

    - #### setNeedleType

          public void setNeedleType(String type)

      Dataset オブジェクトを作成する時のNeedleタイプを指定します。 Needleタイプ は、MeterPlot,Compassチャートを使用する場合に指定します。 MeterPlot org.jfree.chart.plot.DialShape の指定ｷｰﾜｰﾄﾞとして、CHORD,CIRCLE,PIE が指定可能です。 初期値は、CIRCLE です。 Compass org.jfree.chart.needle.MeterNeedle の指定ｷｰﾜｰﾄﾞとして、下記の９種類が指定可能です。 指定は、Arrow,Line,Long,Pin,Plum,Pointer,Ship,Wind,Arrow,MiddlePin という文字列です。 初期値は、Pointer です。 0 = ArrowNeedle; 1 = LineNeedle; 2 = LongNeedle; 3 = PinNeedle; 4 = PlumNeedle; 5 = PointerNeedle; 6 = ShipNeedle; 7 = WindNeedle; 8 = ArrowNeedle; 9 = MiddlePinNeedle;
      パラメータ:
        `type` - Needleタイプ
      変更履歴:

        5.7.8.0 (2014/07/04) 新規追加

    - #### getChartType

          protected String getChartType()

      Dataset オブジェクトを作成する時のチャートタイプを取得します。 チャートタイプ は、外部からチャートを指定するのに便利なように、キー化 されています。このキーに基づいて、ChartFactory クラスの チャートタイプ変換表に基づいて、レンデラーや、データセットを作成します。
      戻り値:
        チャートタイプ

    - #### setBaseLegend

          public void setBaseLegend(boolean baseLeg)

      シリーズ単位の凡例 の表示可否を設定します。
      パラメータ:
        `baseLeg` - シリーズ単位の凡例 の表示可否

    - #### getRenderer

          protected org.jfree.chart.renderer.category.CategoryItemRenderer getRenderer(int serNo,
                                                                                       org.jfree.chart.urls.CategoryURLGenerator urlGen)

      Renderer 関連の共通インターフェースを返します。 setChartType( String )で設定された、チャートタイプに応じた、レンデラーを 返します。 対応表は、ChartFactory クラスに持っています。 基本的には、チャートタイプ は、この、レンデラー名称から決定しています。
      パラメータ:
        `serNo` - シリアルNo
        `urlGen` - CategoryURLGeneratorオブジェクト
      戻り値:
        レンデラーの共通インターフェース
      関連項目:
        `CategoryItemRenderer`, `XYItemRenderer`
      変更履歴:

        4.1.1.0 (2008/02/04) useDynamicOC , isItemValVisible , shapeScale 属性追加
        4.1.1.0 (2008/02/04) クリッカブル・マップの設定を移動、serNo 引数追加
        4.1.1.0 (2008/02/04) 返す型を CategoryItemRenderer に変更
        4.1.1.0 (2008/02/16) HybsStackedBarRenderer に domainMargin を設定
        4.1.1.0 (2008/02/19) Shapes の設定をこちらに移動。
        4.1.2.0 (2008/03/12) isItemLastVisible の設定

    - #### setValueLabel

          public void setValueLabel(String valLbl)

      縦軸の表示名称を指定します。
      パラメータ:
        `valLbl` - 縦軸の表示名称

    - #### getValueLabel

          protected String getValueLabel()

      縦軸の表示名称を取得します。
      戻り値:
        縦軸の表示名称

    - #### setMarkValues

          public void setMarkValues(String[] mkVal)

      マーカーラインの設定値配列を指定します。 指定の値にマーカーラインを引きます。 色は、setMarkColor( String ) で指定します。 markColors と、あわせて設定する必要があります。 markColorsが、指定されていない場合は、Color.RED で マーカーされます。 dynamicOCNo を使用する場合は、そのValues の並びの箇所に、 "G" という文字列を設定して下さい。 例：2000,G 基準１は、2000の直線、基準２は、グラフ という意味。
      パラメータ:
        `mkVal` - マーカーラインの設定値配列(可変長引数)
      関連項目:
        `setMarkColors( String[] )`
      変更履歴:

        4.1.1.0 (2008/02/21) 基準ラインにグラフを使用する場合の位置指定

    - #### setMarkColors

          public void setMarkColors(String[] mkCol)

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

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

      パラメータ:
        `mkCol` - マーカーラインの色配列(可変長引数)
      関連項目:
        `Color.BLACK`, `setMarkValues( String[] )`
      変更履歴:

        6.0.2.1 (2014/09/26) StringUtil → ColorMap

    - #### setUseMarkAnchor

          public void setUseMarkAnchor(boolean useAnchor)

      マーカーライン描画時に、その設定値を表示します。 マーカーラインの縦軸の設定値(markValues)に、設定値をラベル表示します。 位置は、TextAnchor.BASELINE_LEFT 固定です。 初期値は、表示する(true)です。
      パラメータ:
        `useAnchor` - true:設定値を表示する。
      変更履歴:

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

    - #### setMarkOverColors

          public void setMarkOverColors(String[] ovCol)

      マーカーラインの超過時のShape色をCSV形式形式で複数指定します。 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表記 でも指定可能です。

      パラメータ:
        `ovCol` - マーカーラインの超過時のShape色配列(可変長引数)
      関連項目:
        `Color.BLACK`
      変更履歴:

        4.0.3.0 (2008/01/07) 新規追加
        6.0.2.1 (2014/09/26) StringUtil → ColorMap

    - #### setDynamicOCNo

          public void setDynamicOCNo(int ocNo)

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

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

    - #### getValueMarkers

          protected org.jfree.chart.plot.ValueMarker[] getValueMarkers()

      マーカーラインの ValueMarker オブジェクト配列を返します。 マーカーライン は、markValues(double配列) と markColors(Color配列) より、ValueMarker オブジェクトを、順次配列化していきます。 useMarkAnchor == true の場合は、設定値(markValues) の Anchor を 表示します。位置は、TextAnchor.BASELINE_LEFT 固定です。 dynamicOCNo が指定された場合は、最下位の閾値は使用しません。
      戻り値:
        マーカーラインのオブジェクト配列(not null)
      関連項目:
        `Color.BLACK`, `setMarkValues( String[] )`, `setMarkColors( String[] )`, `setUseMarkAnchor( boolean )`
      変更履歴:

        4.1.1.0 (2008/02/04) useMarkAnchor 属性追加
        4.1.1.0 (2008/02/04) 動的なオーバーカラー useDynamicOC 属性追加

    - #### setLowerBound

          public void setLowerBound(String lowBnd)

      チャートの縦軸の最小値をセットします(初期値:自動計算)。 何も指定しない場合は、データの最小値から、自動的に計算します。
      パラメータ:
        `lowBnd` - 縦軸の最小値
      関連項目:
        `setUpperBound( String )`

    - #### setUpperBound

          public void setUpperBound(String upBnd)

      チャートの縦軸の最大値をセットします(初期値:自動計算)。 何も指定しない場合は、データの最大値から、自動的に計算します。
      パラメータ:
        `upBnd` - 縦軸の最大値
      関連項目:
        `setLowerBound( String )`

    - #### setTickSize

          public void setTickSize(String size)

      チャートの縦軸の目盛の幅をセットします(初期値:自動計算)。 何も指定しない場合は、データの範囲から、自動的に計算します。
      パラメータ:
        `size` - 縦軸のチック(目盛)の幅
      変更履歴:

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

    - #### setUseGradient

          public void setUseGradient(boolean useGrad)

      バーチャートのグラデーション処理を行うかどうか[true/false]をセットします(初期値:true)。 通常のバーチャートは、単一色表示で表されますが、これにグラデーション効果を 付加するかどうかを指定します。 通常のバーチャートが、少しきれいに見えます。 初期値は、true(グラデーション効果を付与する)です。
      パラメータ:
        `useGrad` - グラデーション処理 [true:する/false:しない]

    - #### isUseGradient

          protected boolean isUseGradient()

      バーチャートのグラデーション処理を行うかどうかを取得します。 通常のバーチャートは、単一色表示で表されますが、これにグラデーション効果を 付加するかどうかを指定します。 通常のバーチャートが、少しきれいに見えます。 初期値は、false(使用しない)です。
      戻り値:
        グラデーション処理(する:true/しない:false)
      関連項目:
        `setUseGradient( boolean )`

    - #### setShapesVisible

          public void setShapesVisible(boolean shVisible)

      ラインチャートのポイントを四角表示するかどうかを指定します(初期値:false)。 ラインチャートは、通常、線分で表され、各ポイントについても、線分で接続されます。 shapesVisible を true に設定すると、各ポイントが、線上に四角く表示され、 そのポイントの位置を、容易に判断出来るようになります。 初期値は、マーカーを入れません。
      パラメータ:
        `shVisible` - ポイントを四角表示するかどうか

    - #### isShapesVisible

          protected boolean isShapesVisible()

      ラインチャートのポイントを四角表示するかどうかを取得します。 ラインチャートは、通常、線分で表され、各ポイントについても、線分で接続されます。 shapesVisible を true に設定すると、各ポイントが、線上に四角く表示され、 そのポイントの位置を、容易に判断出来るようになります。 初期値は、マーカーを入れません。
      戻り値:
        ポイントを四角表示するかどうか
      関連項目:
        `setShapesVisible( boolean )`

    - #### setShapeColors

          public void setShapeColors(String[] colors)

      データ毎にShapeを切り替える時の色の繰返しパターンを文字列配列で指定します。 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表記 でも指定可能です。
      パラメータ:
        `colors` - データ毎の色の繰返しパターン配列(可変長引数)
      関連項目:
        `Color.BLACK`
      変更履歴:

        4.0.3.0 (2008/01/07) 新規追加
        6.0.2.1 (2014/09/26) StringUtil → ColorMap

    - #### setShapeScale

          public void setShapeScale(String scale)

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

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

    - #### setUseDottedLine

          public void setUseDottedLine(boolean useDotLine)

      ラインチャートの線をドットラインにするかどうかを指定します(初期値:false)。 ラインチャートは、通常、線分で表されます。 これに、点線で表すことで、グラフの違いを、色だけでなく形状でも識別 しやすくすることが可能です。 初期値は、線分です。
      パラメータ:
        `useDotLine` - ドットラインにするかどうか

    - #### isUseDottedLine

          protected boolean isUseDottedLine()

      ラインチャートの線をドットラインにするかどうかを取得します。 ラインチャートは、通常、線分で表されます。 これに、点線で表すことで、グラフの違いを、色だけでなく形状でも識別 しやすくすることが可能です。 初期値は、線分です。
      戻り値:
        ドットラインにするかどうか
      関連項目:
        `setUseDottedLine( boolean )`

    - #### setSeriesColors

          public void setSeriesColors(String[] colors)

      複数チャート描画時のチャート色の繰返しパターンを文字列配列で指定します。 通常、複数のチャートを同時に表示させる場合は、縦軸が共通であれば、 １回のSelect分で複数データを取得します。 この、データをシリーズと呼んでおり、これを区別する為に、色を分けます。 初期値は、JFreeChart が自動で割り振ります。 これを、外部からCVS形式で、CSV形式で色コードを指定します。 指定データが多い場合は、多い分の色は使用されません。少ない場合は、 順番に繰り返して使用されます。 例えば、１色だけ指定した場合は、すべてのシリーズが同じ色で表されます。 指定文字列は、java.awt.Color クラスのstatic フィールド名で指定します。 BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY , MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できます。 また、#XXXXXX形式の16bitRGB表記 でも指定可能です。
      パラメータ:
        `colors` - チャート色の繰返しパターン配列(可変長引数)
      関連項目:
        `Color.BLACK`
      変更履歴:

        6.0.2.1 (2014/09/26) StringUtil → ColorMap

    - #### getSeriesColors

          protected Color[] getSeriesColors()

      複数チャート描画時のチャート色の繰返しパターンをColor配列で指定します。
      戻り値:
        チャート色の繰返しパターン(Color配列)
      関連項目:
        `setSeriesColors( String[] )`

    - #### setSeriesLabels

          public void setSeriesLabels(String[] labels)

      複数チャート(series)描画時のラベル名配列を指定します。 通常、複数のチャートを同時に表示させる場合は、縦軸が共通であれば、 １回のSelect分で複数データを取得します。 この、データをシリーズと呼んでおり、これの名称は、Select文のカラム名になります。 英文であれば問題ないのですが、日本語表示したい場合に、別名(as)に{@XXXX}を 付けるなどの方法がありますが、firebird では、JDBCのResultSetMetaData#getColumnLabel(int) の取得で、文字コードがうまく処理されないようなので、外部から与える機能を用意します。 ここでは、select category,series1,series2,････,seriesN from table の series1,series2,････,seriesN の部分 を順番に与えます。 ※ 注意：このメソッドでは、配列はコピーではなく、そのままセットされています。 副作用があるかもしれませんので、必要であれば、コピーして渡してください。 (現状、参照しかしていませんけど)
      パラメータ:
        `labels` - チャートのシリーズのラベル名配列(可変長引数)
      変更履歴:

        6.0.2.0 (2014/09/19) 新規追加

    - #### setValueLabelsVisible

          public void setValueLabelsVisible(boolean labelsVisible)

      Value(縦軸)のラベルを表示するかどうかを指定します(初期値:true[表示する])。 ValueAxis にて設定される、縦軸情報の、ラベルを表示するかどうか指定します。 初期値は、true(表示する)です。
      パラメータ:
        `labelsVisible` - Value(縦軸)のラベルを表示するかどうか
      変更履歴:

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

    - #### setValueMarksVisible

          public void setValueMarksVisible(boolean marksVisible)

      Value(縦軸)のマーカーを表示するかどうかを指定します(初期値:true[表示する])。 ValueAxis にて設定される、縦軸情報の、マーカーを表示するかどうか指定します。 初期値は、true(表示する)です。
      パラメータ:
        `marksVisible` - Value(縦軸)のマーカーを表示するかどうか
      変更履歴:

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

    - #### setItemLabelVisible

          public void setItemLabelVisible(String visible)

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

        4.1.1.0 (2008/02/04) 新規追加
        4.1.2.0 (2008/03/12) 文字列のまま、受け取りるように変更

    - #### setUseItemLabelSep

          public void setUseItemLabelSep(boolean used)

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

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

    - #### setValueInset

          public void setValueInset(String inset)

      縦軸の表示領域INSET値(double)を指定します。 縦軸文字表示領域(NumberAxis)の幅の追加値を設定します。 これは、通常の表示領域の左側にスペースを挿入します。 あくまで、追加する値なので、文字の長さは含まれません。 何も指定しない場合は、設定しません。
      パラメータ:
        `inset` - Value(縦軸)の表示領域INSET値
      変更履歴:

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

    - #### setBarWidth

          public void setBarWidth(String width)

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

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

    - #### getBarWidth

          protected String getBarWidth()

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

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

    - #### setBarMaxWidth

          public void setBarMaxWidth(String barWidth)

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

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

    - #### setBarItemMargin

          public void setBarItemMargin(String margin)

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

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

    - #### setVisibleLimit

          public void setVisibleLimit(String limit)

      表示下限値(これ以下のデータは未表示)の値(double)を指定します。 HybsLine でのみ使用可能です。 この設定値以下のデータは、存在しない扱いとします。 Lineを引くとき、このデータと、存在しているデータ間にラインは引かれません。 何も指定しない場合は、設定しません。
      パラメータ:
        `limit` - 表示下限値(これ以下のデータは未表示)
      変更履歴:

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

    - #### setDomainMargin

          public void setDomainMargin(double margin)

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

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

    - #### setTimeFormatType

          public void setTimeFormatType(String type)

      時刻を表す場合の表現の仕方を指定します(初期値:null)。 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)です。
      パラメータ:
        `type` - 時刻の表示方法 [E1/E2/E3/H1/H2/H3]
      変更履歴:

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

    - #### setUseVerticalLabels

          public void setUseVerticalLabels(boolean useVLavels)

      ラベルの表示向きを縦にするかどうか[true/false]を指定します(初期値:false)。 ChartCreate の rotationLabel は、角度を指定できましたが、NumberAxis では、 縦にするかどうかの指定しかできません。 ここでは、true を指定するとラベルは、縦書きになります。 初期値は、false(横書き)です。
      パラメータ:
        `useVLavels` - ラベルの表示向き [false:横書き/:true:縦書き]
      変更履歴:

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

    - #### setUseCategoryColor

          public void setUseCategoryColor(boolean useCateColor)

      カテゴリのカラー名指定があるかどうか[true/false]を指定します(初期値:false)。 select category,series1,series2,series3,･･･,color from ･･･ の様に 検索するSelect文の一番最後に、Color文字列を付けて、カテゴリのカラー名の指定を行う事が可能です。 つまり、useCategoryColor="true" を指定すると、最後のカラムは、Color文字列と認識して、 データ(シリーズとして)使われなくなります。 CategoryColor は、HybsColorBar と、HybsColorBar3D のみサポートされている機能ですが、 グラフ合成(例えば、HybsParetoLineなど)と同時に使用する場合、同じ select文や、DBTableModelを 使った処理を行う場合、Color指定のカラムを無視する必要があります。 そういう場合(つまり、カテゴリカラーを使わない場合)に、共通のSelect文を指定する場合にも、true に 設定して、Color文字列を無視するように指定します。 初期値は、false(指定しない)です。
      パラメータ:
        `useCateColor` - カテゴリのカラー名指定 [false:指定しない/true:指定する]
      変更履歴:

        6.0.2.2 (2014/10/03) 新規追加

    - #### makeMeterPlot

          protected org.jfree.chart.plot.Plot makeMeterPlot()

      MeterPlot に必要な情報を設定します。 これは、ChartDataset(このクラス)に必要な getterメソッドを用意して、 利用側のクラス(ChartPlot_Pie) でセットすべきですが、メソッドが増えるので、 こちらに MeterPlotオブジェクトを渡して、メソッド数を減らそうとしているだけです。 lowerBound は、最小値(low) upperBound は、最大値(upp) markValues 値,A,B,C markOverColors GREEN,BLUE,YELLOW,RED low-A⇒GREEN , A-B⇒BLUE , B-C⇒YELLOW , C-upp⇒RED で、MeterIntervalを指定します。 shapeColors に、NeedlePaint,ValuePaint,TickPaint,TickLabelPaint,DialBackgroundPaint,DialOutlinePaint を指定できます。 初期値は、BLACK,BLACK,BLACK,BLACK,透明,BLACK です。 needleType に、DialShape の指定ｷｰﾜｰﾄﾞとして、CHORD,CIRCLE,PIE が指定可能です。 指定方法としては、taglib上で、chartType 指定時に、Meter_PIE などと指定します。 shapeScale は、MeterAngle(メーターの表示角度) を指定できます。 valueLabel は、MeterInterval の規定値(値,A,B,C) に対応した凡例ラベルです。
      戻り値:
        値をセットし終わった、MeterPlotオブジェクト
      変更履歴:

        5.7.8.0 (2014/07/04) 新規追加
        6.3.6.0 (2015/08/16) System.arraycopy が使える箇所は、置き換えます。

    - #### makeThermometerPlot

          protected org.jfree.chart.plot.Plot makeThermometerPlot()

      ThermometerPlot に必要な情報を設定します。 markValues 値,A,B markOverColors GREEN,YELLOW,RED xxx-low⇒GRAY , low-A⇒GREEN , A-B⇒YELLOW , B-upp⇒RED , upp-xxx⇒GRAY で、SubrangePaintを指定します。 markOverColors を指定しない場合は、ThermometerPlot.NORMAL , WARNING , CRITICAL が順に指定されます。 これは、GREEN,YELLOW,RED になります。 shapeColors に、ValuePaint,ThermometerPaint(温度計の枠線),MercuryPaint を指定できます。
      戻り値:
        値をセットし終わった、元のThermometerPlotオブジェクト
      変更履歴:

        5.7.8.0 (2014/07/04) 新規追加
        6.3.6.0 (2015/08/16) System.arraycopy が使える箇所は、置き換えます。

    - #### makeCompassPlot

          protected org.jfree.chart.plot.Plot makeCompassPlot()

      CompassPlot に必要な情報を設定します。 shapeColors に、Compassの色を指定できます。(内部的には、SeriesPaint にセットしています) SeriesPaint,SeriesOutlinePaint,RoseCenterPaint,RoseHighlightPaint,RosePaint を指定します。 needleType には、MeterNeedle の指定ｷｰﾜｰﾄﾞとして、下記の９種類が指定可能です。 指定は、Arrow,Line,Long,Pin,Plum,Pointer,Ship,Wind,Arrow,MiddlePin という文字列です。 初期値は、Pointer です。
      戻り値:
        値をセットし終わった、元のCompassPlotオブジェクト
      変更履歴:

        5.7.8.0 (2014/07/04) 新規追加
        6.3.6.0 (2015/08/16) System.arraycopy が使える箇所は、置き換えます。

    - #### toString

          public String toString()

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

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