モジュール javafx.controls
パッケージ javafx.scene.chart

クラスCategoryAxis

  • すべての実装されたインタフェース:
    Styleable, EventTarget


    public final class CategoryAxis
    extends Axis<String>
    各値が一意のカテゴリ(目盛)として軸に沿って示される、文字列カテゴリに対して機能する軸の実装。
    導入されたバージョン:
    JavaFX 2.0
    • コンストラクタの詳細

      • CategoryAxis

        public CategoryAxis​()
        カテゴリの空のリストを使用して自動範囲指定カテゴリ軸を作成します。
      • CategoryAxis

        public CategoryAxis​(ObservableList<String> categories)
        指定されたカテゴリを使用してカテゴリ軸を作成します。 自動範囲指定は実行しませんが、指定されたカテゴリで固定されています。
        パラメータ:
        categories - この軸のカテゴリのリスト
    • メソッドの詳細

      • getStartMargin

        public final double getStartMargin​()
        プロパティstartMarginの値を取得します。
        プロパティの説明:
        軸の開始点と最初の目盛の間の余白
      • setStartMargin

        public final void setStartMargin​(double value)
        プロパティstartMarginの値を設定します。
        プロパティの説明:
        軸の開始点と最初の目盛の間の余白
      • getEndMargin

        public final double getEndMargin​()
        プロパティendMarginの値を取得します。
        プロパティの説明:
        最後の目盛と軸の終了点の間の余白
      • setEndMargin

        public final void setEndMargin​(double value)
        プロパティendMarginの値を設定します。
        プロパティの説明:
        最後の目盛と軸の終了点の間の余白
      • isGapStartAndEnd

        public final boolean isGapStartAndEnd​()
        プロパティgapStartAndEndの値を取得します。
        プロパティの説明:
        これがtrueの場合は、目盛の間の半分のスペースが開始点と終了点に残されます
      • setGapStartAndEnd

        public final void setGapStartAndEnd​(boolean value)
        プロパティgapStartAndEndの値を設定します。
        プロパティの説明:
        これがtrueの場合は、目盛の間の半分のスペースが開始点と終了点に残されます
      • setCategories

        public final void setCategories​(ObservableList<String> value)
        この軸上にプロットされたカテゴリの順序付けられたリスト。 autoRangingがtrueの場合、チャート・データに基づいて自動的に設定されます。 アプリケーションがカテゴリを設定している場合、自動範囲指定はオフになります。 このリストに重複したエントリを追加しようとすると、IllegalArgumentExceptionがスローされます。
        パラメータ:
        value - この軸にプロットされたカテゴリの順序付きリスト
      • getCategories

        public final ObservableList<String> getCategories​()
        この軸上にプロットされたカテゴリのObservableListを返します。
        戻り値:
        この軸のカテゴリのObservableList。
        関連項目:
        categories
      • getCategorySpacing

        public final double getCategorySpacing​()
        プロパティcategorySpacingの値を取得します。
        プロパティの説明:
        これは、この軸の1つのカテゴリと次のカテゴリの間の間隔です
      • categorySpacingProperty

        public final ReadOnlyDoubleProperty categorySpacingProperty​()
        これは、この軸の1つのカテゴリと次のカテゴリの間の間隔です
        関連項目:
        getCategorySpacing()
      • getRange

        protected Object getRange​()
        現在の軸の範囲を取得するために呼び出されます。
        定義:
        getRange 、クラス: Axis<String>
        戻り値:
        setRange()およびcalculateTickValues()に渡すことができる範囲オブジェクト
      • setRange

        protected void setRange​(Object range,
                                boolean animate)
        現在の軸の範囲を指定された範囲に設定するために呼び出されます。 isAnimating()がtrueの場合は、このメソッドによって、範囲が新しい範囲に移動する状態がアニメーション化されます。
        定義:
        setRange 、クラス: Axis<String>
        パラメータ:
        range - autoRange()から返された範囲オブジェクト
        animate - trueの場合、範囲内の変更をアニメーション化
      • autoRange

        protected Object autoRange​(double length)
        invalidateRange()メソッドに入力されたデータに基づいてカテゴリを計算します。 このことによって軸のプロパティが変更され、軸の状態に影響を及ぼすことがないようにする必要があります。 自動範囲指定のすべての結果は、範囲オブジェクトで返される必要があります。 この軸のこの範囲を採用することが決定されている場合は、setRange()に渡されます。
        定義:
        autoRange 、クラス: Axis<String>
        パラメータ:
        length - 画面座標での軸の長さ
        戻り値:
        範囲の情報(実装に依存)
      • calculateTickValues

        protected List<String> calculateTickValues​(double length,
                                                   Object range)
        範囲内の各目盛に対するすべてのデータ値のリストを計算します。
        定義:
        calculateTickValues 、クラス: Axis<String>
        パラメータ:
        length - 表示単位の軸の長さ
        range - autoRange()から返された範囲オブジェクト
        戻り値:
        指定された長さの場合、軸沿いの適合する目盛のリスト
      • getTickMarkLabel

        protected String getTickMarkLabel​(String value)
        指定された値の目盛の文字列ラベル名を取得します。
        定義:
        getTickMarkLabel 、クラス: Axis<String>
        パラメータ:
        value - 目盛ラベル文字列にフォーマットする値
        戻り値:
        指定された値のフォーマット済文字列
      • measureTickMarkSize

        protected Dimension2D measureTickMarkSize​(String value,
                                                  Object range)
        特定の目盛値のラベルのサイズを測定します。 目盛に設定されたフォントを使用します。
        オーバーライド:
        measureTickMarkSize 、クラス: Axis<String>
        パラメータ:
        value - 目盛の値
        range - 計算中に使用する範囲
        戻り値:
        指定された値の目盛ラベルのサイズ
      • invalidateRange

        public void invalidateRange​(List<String> data)
        データが変更され、その範囲が有効でなくなった可能性がある場合に呼び出されます。 これは、isAutoRanging()がtrueを返した場合にのみチャートによって呼び出されます。 自動範囲指定を行っている場合は、次回のレイアウト受渡しでレイアウトがリクエストされ、自動範囲指定が発生します。
        オーバーライド:
        invalidateRange 、クラス: Axis<String>
        パラメータ:
        data - この軸にプロットされる必要があるすべてのデータの現在のセット
      • getDisplayPosition

        public double getDisplayPosition​(String value)
        指定された値に対する、この軸沿いの表示位置を取得します。 値がいずれのカテゴリとも等しくない場合は、Double.NaNが返されます。
        定義:
        getDisplayPosition 、クラス: Axis<String>
        パラメータ:
        value - 表示位置を算出するためのデータ値
        戻り値:
        表示位置、または値がいずれのカテゴリでもない場合はDouble.NaN
      • getValueForDisplay

        public String getValueForDisplay​(double displayPosition)
        この軸上の指定された表示位置のデータ値を取得します。 軸がCategoryAxisである場合、これは最も近い値になります。
        定義:
        getValueForDisplay 、クラス: Axis<String>
        パラメータ:
        displayPosition - この軸上のピクセル位置
        戻り値:
        指定されたピクセル位置に最も近いデータ値、または軸上に存在しない場合はnull
      • isValueOnAxis

        public boolean isValueOnAxis​(String value)
        指定された値がこの軸上でプロット可能であるかどうかをチェックします。
        定義:
        isValueOnAxis 、クラス: Axis<String>
        パラメータ:
        value - 軸上にあるかどうかをチェックする値
        戻り値:
        指定された値がこの軸上でプロット可能な場合はtrue
      • toNumericValue

        public double toNumericValue​(String value)
        軸のすべての値は、なんらかの数値で表現できる必要があります。 指定されたデータ値の数値を取得します。
        定義:
        toNumericValue 、クラス: Axis<String>
        パラメータ:
        value - 変換するデータ値
        戻り値:
        指定されたデータ値の数値
      • toRealValue

        public String toRealValue​(double value)
        軸のすべての値は、なんらかの数値で表現できる必要があります。 指定された数値のデータ値を取得します。
        定義:
        toRealValue 、クラス: Axis<String>
        パラメータ:
        value - 変換する数値
        戻り値:
        指定された数値のデータ値
      • getZeroPosition

        public double getZeroPosition​()
        この軸沿いのゼロ行の表示位置を取得します。 CategoryAxisではゼロの概念がないため、常にDouble.NaNとなります。
        定義:
        getZeroPosition 、クラス: Axis<String>
        戻り値:
        CategoryAxisの場合は常にDouble.NaN
      • getClassCssMetaData

        public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData​()
        戻り値:
        このクラスに関連付けられたCssMetaData。スーパークラスのCssMetaDataを含むことがあります。
        導入されたバージョン:
        JavaFX 8.0
      • getCssMetaData

        public List<CssMetaData<? extends Styleable,?>> getCssMetaData​()
        NodeのCssMetaDataがリフレクションなしでアクセス可能になるように、このメソッドはNode.getClassCssMetaData()に委任する必要があります。
        定義:
        getCssMetaData 、インタフェース: Styleable
        オーバーライド:
        getCssMetaData 、クラス: Axis<String>
        戻り値:
        このノードに関連付けられたCssMetaData。スーパークラスのCssMetaDataを含むことがあります。
        導入されたバージョン:
        JavaFX 8.0