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

クラスXYChart<X,Y>

  • すべての実装されたインタフェース:
    Styleable, EventTarget
    直系の既知のサブクラス:
    AreaChart, BarChart, BubbleChart, LineChart, ScatterChart, StackedAreaChart, StackedBarChart


    public abstract class XYChart<X,Y>
    extends Chart
    すべての2軸チャートのチャート・ベース・クラス。 2つの軸とプロット・コンテンツの描画を行います。 プロット内のすべてのコンテンツが含まれ、XYChartの実装によって、レンダリングが必要なノードをこのリストに追加できます。

    データ・アイテムまたはシンボルにツールチップをインストールできます。 たとえば、次のコード・スニペットは最初のデータ・アイテムにツールチップをインストールします。

    
      XYChart.Data item = ( XYChart.Data)series.getData().get(0);
      Tooltip.install(item.getNode(), new Tooltip("Symbol-0"));
     
    導入されたバージョン:
    JavaFX 2.0
    • コンストラクタの詳細

      • XYChart

        public XYChart​(Axis<X> xAxis,
                       Axis<Y> yAxis)
        2つの軸を指定してXYChartを構築します。 チャート・プロットの背景、およびプロット領域(垂直グリッド線と水平グリッド線および塗りつぶしが含まれる)の最初のコンテンツが追加されます。
        パラメータ:
        xAxis - このXYチャートのX軸
        yAxis - このXYチャートのY軸
    • メソッドの詳細

      • getXAxis

        public Axis<X> getXAxis​()
        X軸(デフォルトでは、プロットの下部に沿った軸)を取得します。
        戻り値:
        チャートのX軸
      • getYAxis

        public Axis<Y> getYAxis​()
        Y軸(デフォルトでは、プロットの左側に沿った軸)を取得します。
        戻り値:
        このチャートのY軸
      • getData

        public final ObservableList<XYChart.Series<X,Y>> getData​()
        プロパティ・データの値を取得します。
        プロパティの説明:
        XYChartsデータ
      • setData

        public final void setData​(ObservableList<XYChart.Series<X,Y>> value)
        プロパティ・データの値を設定します。
        プロパティの説明:
        XYChartsデータ
      • getVerticalGridLinesVisible

        public final boolean getVerticalGridLinesVisible​()
        垂直グリッド線が表示されるかどうかを示します。
        戻り値:
        verticalGridLinesが可視の場合はtrue、そうでない場合はfalse。
        関連項目:
        verticalGridLinesVisible
      • setVerticalGridLinesVisible

        public final void setVerticalGridLinesVisible​(boolean value)
        プロパティverticalGridLinesVisibleの値を設定します。
        プロパティの説明:
        垂直グリッド線を描画する場合はtrue
      • isHorizontalGridLinesVisible

        public final boolean isHorizontalGridLinesVisible​()
        プロパティhorizontalGridLinesVisibleの値を取得します。
        プロパティの説明:
        水平グリッド線を描画する場合はtrue
      • setHorizontalGridLinesVisible

        public final void setHorizontalGridLinesVisible​(boolean value)
        プロパティhorizontalGridLinesVisibleの値を設定します。
        プロパティの説明:
        水平グリッド線を描画する場合はtrue
      • isAlternativeColumnFillVisible

        public final boolean isAlternativeColumnFillVisible​()
        プロパティalternativeColumnFillVisibleの値を取得します。
        プロパティの説明:
        trueの場合、代替の垂直列が塗りつぶされます
      • setAlternativeColumnFillVisible

        public final void setAlternativeColumnFillVisible​(boolean value)
        プロパティalternativeColumnFillVisibleの値を設定します。
        プロパティの説明:
        trueの場合、代替の垂直列が塗りつぶされます
      • isAlternativeRowFillVisible

        public final boolean isAlternativeRowFillVisible​()
        プロパティalternativeRowFillVisibleの値を取得します。
        プロパティの説明:
        trueの場合、代替の水平行が塗りつぶされます
      • setAlternativeRowFillVisible

        public final void setAlternativeRowFillVisible​(boolean value)
        プロパティalternativeRowFillVisibleの値を設定します。
        プロパティの説明:
        trueの場合、代替の水平行が塗りつぶされます
      • isVerticalZeroLineVisible

        public final boolean isVerticalZeroLineVisible​()
        プロパティverticalZeroLineVisibleの値を取得します。
        プロパティの説明:
        これがtrueで、かつ垂直軸に正の値と負の値の両方がある場合、追加の軸線がゼロ位置に描画されます
        デフォルト値:
        true
      • setVerticalZeroLineVisible

        public final void setVerticalZeroLineVisible​(boolean value)
        プロパティverticalZeroLineVisibleの値を設定します。
        プロパティの説明:
        これがtrueで、かつ垂直軸に正の値と負の値の両方がある場合、追加の軸線がゼロ位置に描画されます
        デフォルト値:
        true
      • isHorizontalZeroLineVisible

        public final boolean isHorizontalZeroLineVisible​()
        プロパティhorizontalZeroLineVisibleの値を取得します。
        プロパティの説明:
        これがtrueで、かつ水平軸に正の値と負の値の両方がある場合、追加の軸線がゼロ位置に描画されます
        デフォルト値:
        true
      • setHorizontalZeroLineVisible

        public final void setHorizontalZeroLineVisible​(boolean value)
        プロパティhorizontalZeroLineVisibleの値を設定します。
        プロパティの説明:
        これがtrueで、かつ水平軸に正の値と負の値の両方がある場合、追加の軸線がゼロ位置に描画されます
        デフォルト値:
        true
      • getPlotChildren

        protected ObservableList<Node> getPlotChildren​()
        プロットのすべてのコンテンツの変更可能かつ監視可能なリスト。 XYChartの実装では、ここで、プロットを描画するために使用するノードを追加する必要があります。
        戻り値:
        プロットの子の監視可能リスト
      • updateLegend

        protected void updateLegend​()
        これは、系列が追加または削除され、凡例を更新する必要がある場合に常に呼び出されます。
      • dataItemAdded

        protected abstract void dataItemAdded​(XYChart.Series<X,Y> series,
                                              int itemIndex,
                                              XYChart.Data<X,Y> item)
        データ・アイテムが系列に追加されたときに呼び出されます。 XYChartの実装では、ここで、このデータ・アイテムを表すgetPlotChildrenに対して新しいノードを作成または追加できます。 animated = trueの場合、フェードインや同様の効果を追加してそのデータをアニメーション化することもできます。
        パラメータ:
        series - データ・アイテムが追加された系列
        itemIndex - 系列内の新しいアイテムのインデックス
        item - 追加された新しいデータ・アイテム
      • dataItemRemoved

        protected abstract void dataItemRemoved​(XYChart.Data<X,Y> item,
                                                XYChart.Series<X,Y> series)
        データ・アイテムがデータ・モデルから削除されたが、チャートで引き続き表示可能な場合に呼び出されます。 引き続き表示可能であるため、このメソッドでアニメーションの削除を処理できます。 データ・アイテムのアニメーション化を完了してから、removeDataItemFromDisplay()を呼び出して、チャートで表示されないようにアイテム・ノードを削除する必要があります。
        パラメータ:
        item - 系列から削除されたアイテム
        series - アイテムが削除された系列
      • dataItemChanged

        protected abstract void dataItemChanged​(XYChart.Data<X,Y> item)
        データ・アイテムが変更されたとき、つまり、そのxValue、yValueまたはextraValueが変更されたときに呼び出されます。
        パラメータ:
        item - 変更されたデータ・アイテム
      • seriesAdded

        protected abstract void seriesAdded​(XYChart.Series<X,Y> series,
                                            int seriesIndex)
        系列がチャート・データ・モデルに追加されました。 XYChartの実装では、ここで、この系列を表すgetPlotChildrenに対して新しいノードを作成または追加できます。 また、系列にすでに存在するデータ・アイテムの追加を処理することも必要となります。 それぞれに対してdataItemAdded()を単に呼び出すか、または追加される系列全体に様々なアニメーションを提供できます。
        パラメータ:
        series - 追加された系列
        seriesIndex - 新しい系列のインデックス
      • seriesRemoved

        protected abstract void seriesRemoved​(XYChart.Series<X,Y> series)
        系列はデータ・モデルから削除されましたが、引き続きチャートで表示可能です。 引き続き表示可能であるため、このメソッドでアニメーションの削除を処理できます。 データ・アイテムのアニメーション化を完了してから、removeSeriesFromDisplay()を呼び出して、系列を表示リストから削除する必要があります。
        パラメータ:
        series - 削除された系列
      • seriesChanged

        protected void seriesChanged​(ListChangeListener.Change<? extends XYChart.Series> c)
        このチャートのシリーズのリストにアトミックな変更が行われるたびに呼び出されます。
        パラメータ:
        c - シリーズへの変更を表すChangeインスタンス
      • updateAxisRange

        protected void updateAxisRange​()
        範囲が無効化され、その範囲を更新する必要がある場合に呼び出されます。 軸が自動範囲指定である場合は、指定された軸によってプロットされる必要があるすべてのデータのリストをコンパイルし、invalidateRange()を軸で呼び出してデータを渡します。
      • layoutPlotChildren

        protected abstract void layoutPlotChildren​()
        プロットの子を更新およびレイアウトするために呼び出されます。 軸やグリッド線などの最上部のプロットを表すノードを更新するためにすべての作業が含まれる必要があります。原点はプロット面の左上で、プロット面を取得するには、X軸の幅と、Y軸の高さからのX軸の高さを取得します。
      • layoutChartChildren

        protected final void layoutChartChildren​(double top,
                                                 double left,
                                                 double width,
                                                 double height)
        getChartChildren()で使用可能なチャートの子を更新およびレイアウトするために呼び出されます。
        定義:
        layoutChartChildren 、クラス: Chart
        パラメータ:
        top - チャート・コンテンツ上の余白に対応するための、原点からの上部のオフセット
        left - チャート・コンテンツ上の余白に対応するための、原点からの左側のオフセット
        width - チャートを内部にレイアウトする領域の幅
        height - チャートを内部にレイアウトする領域の高さ
      • removeSeriesFromDisplay

        protected final void removeSeriesFromDisplay​(XYChart.Series<X,Y> series)
        これは、アニメーションを完了して系列をチャートから削除した場合に、seriesRemoved()から呼び出される必要があります。 系列を削除して、getDisplayedSeriesIterator()によって返されるイテレータに含められないようにします。
        パラメータ:
        series - 削除する系列
      • getDisplayedSeriesIterator

        protected final Iterator<XYChart.Series<X,Y>> getDisplayedSeriesIterator​()
        XYChartは、現在表示されているすべての系列のリストを保持し、これには、現在のすべての系列に加えて、最近削除され、フェードアウトのプロセス(アニメーション化)中の系列が含まれます。 そのリストのイテレータを作成して返します。 これは、XYChartの実装がデータのプロット時に使用するものです。
        戻り値:
        現在表示されている系列のイテレータ
      • getCurrentDisplayedXValue

        protected final X getCurrentDisplayedXValue​(XYChart.Data<X,Y> item)
        X軸上にプロットされる現在表示されているデータ値。 xValueと同じである場合と異なる場合があります。 xValueが古い値から新しい値に変化する状態をアニメーション化するためにXYChartで使用されます。 これは、カスタムのXYChart実装でプロットする必要があるものです。 LineChartなど、一部のXYChartチャート実装でも、これを使用して、データの追加または削除時にアニメーション化します。
        パラメータ:
        item - 現在のX軸データ値の取得元であるXYChart.Dataアイテム
        戻り値:
        現在表示されているXデータ値
      • setCurrentDisplayedXValue

        protected final void setCurrentDisplayedXValue​(XYChart.Data<X,Y> item,
                                                       X value)
        X軸上にプロットされる現在表示されているデータ値を設定します。
        パラメータ:
        item - 現在のX軸データ値の取得元であるXYChart.Dataアイテム。
        value - X軸のデータ値
        関連項目:
        getCurrentDisplayedXValue(javafx.scene.chart.XYChart.Data<X, Y>)
      • currentDisplayedXValueProperty

        protected final ObjectProperty<X> currentDisplayedXValueProperty​(XYChart.Data<X,Y> item)
        X軸上にプロットされる現在表示されているデータ値プロパティ。
        パラメータ:
        item - 現在のX軸データ値のプロパティ・オブジェクトの取得元であるXYChart.Dataアイテム。
        戻り値:
        現在表示されているXデータ値ObjectProperty。
        関連項目:
        getCurrentDisplayedXValue(javafx.scene.chart.XYChart.Data<X, Y>)
      • getCurrentDisplayedYValue

        protected final Y getCurrentDisplayedYValue​(XYChart.Data<X,Y> item)
        Y軸上にプロットされる現在表示されているデータ値。 yValueと同じである場合と異なる場合があります。 yValueが古い値から新しい値に変化する状態をアニメーション化するためにXYChartで使用されます。 これは、カスタムのXYChart実装でプロットする必要があるものです。 LineChartなど、一部のXYChartチャート実装でも、これを使用して、データの追加または削除時にアニメーション化します。
        パラメータ:
        item - 現在のY軸データ値の取得元であるXYChart.Dataアイテム
        戻り値:
        現在表示されているYデータ値
      • setCurrentDisplayedYValue

        protected final void setCurrentDisplayedYValue​(XYChart.Data<X,Y> item,
                                                       Y value)
        Y軸上にプロットされる現在表示されているデータ値を設定します。
        パラメータ:
        item - 現在のY軸データ値の取得元であるXYChart.Dataアイテム。
        value - Y軸データ値
        関連項目:
        getCurrentDisplayedYValue(javafx.scene.chart.XYChart.Data<X, Y>)
      • currentDisplayedYValueProperty

        protected final ObjectProperty<Y> currentDisplayedYValueProperty​(XYChart.Data<X,Y> item)
        Y軸上にプロットされる現在表示されているデータ値プロパティ。
        パラメータ:
        item - 現在のY軸データ値のプロパティ・オブジェクトの取得元であるXYChart.Dataアイテム。
        戻り値:
        現在表示されているYデータ値ObjectProperty。
        関連項目:
        getCurrentDisplayedYValue(javafx.scene.chart.XYChart.Data<X, Y>)
      • getCurrentDisplayedExtraValue

        protected final Object getCurrentDisplayedExtraValue​(XYChart.Data<X,Y> item)
        現在表示されているデータの追加の値。 extraValueと同じである場合と異なる場合があります。 extraValueが古い値から新しい値に変化する状態をアニメーション化するためにXYChartで使用されます。 これは、カスタムのXYChart実装でプロットする必要があるものです。
        パラメータ:
        item - 現在の追加の値の取得元であるXYChart.Dataアイテム
        戻り値:
        現在の余分な値
      • getDisplayedDataIterator

        protected final Iterator<XYChart.Data<X,Y>> getDisplayedDataIterator​(XYChart.Series<X,Y> series)
        XYChartは、現在表示されているすべてのアイテムのリストを保持し、これには、現在のすべてのデータに加えて、最近削除され、フェードアウトのプロセス中のデータ・アイテムが含まれます。 そのリストのイテレータを作成して返します。 これは、XYChartの実装がデータのプロット時に使用するものです。
        パラメータ:
        series - 表示されるデータを取得する系列
        戻り値:
        この系列の現在表示されているアイテムのイテレータ
      • removeDataItemFromDisplay

        protected final void removeDataItemFromDisplay​(XYChart.Series<X,Y> series,
                                                       XYChart.Data<X,Y> item)
        これは、アニメーション化の完了時にチャートからアイテムを削除するためにdataItemRemoved()から呼び出される必要があります。 データ・アイテムを削除して、getDisplayedDataIterator()によって返されるイテレータに含められないようにします。
        パラメータ:
        series - 削除する系列
        item - 系列の表示リストから削除するアイテム
      • 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 、クラス: Chart
        戻り値:
        このノードに関連付けられたCssMetaData。スーパークラスのCssMetaDataを含むことがあります。
        導入されたバージョン:
        JavaFX 8.0