データ系列

チャートタイプに所属する各データ系列はさらにデータシークエンスとしてラベルされたデータを保持しています。

このデータ系列オブジェクトではそのひとつの系列の外見などのプロパティを保持しています。系列に所属するすべてのデータ点のプロパティを変更するにはこのデータ系列を介して設定します。たとえば、データ点全てにラベルを表示したければ Label プロパティを操作します。個別のデータ点で同じプロパティを変更するとその該当するデータ点のみ変更できます。

回帰曲線などについてもこのオブジェクトで操作します。

Sub GetDataSeries
  oSheet = ThisComponent.getSheets().getByIndex(0)
  oChart = oSheet.getChart().getByIndex(0).getEmbeddedObject()
  oFirstDiagram = oChart.getFirstDiagram()
  
  oCoordinateSystems = oFirstDiagram.getCoordinateSystems()
  oCoord = oCoordinateSystems(0)
  
  oChartTypes = oCoord.getChartTypes()
  oChartType = oChartTypes(0)
  
  oSeriesSeq = oChartType.getDataSeries()
  oSeries = oSeriesSeq(0)
End Sub

.chart2.data.XDataSource インターフェース

データ系列に所属するデータを読み込みます。このインターフェースではデータは書き込めません。データを書き込むには .chart2.data.XDataSink インターフェースを利用してください。

このデータ系列に所属する既存のラベル付きデータを取得します。

  • []XLabeledDataSequence getDataSequences()

ラベル付きデータシークエンスを取得します。

.chart2.data.XDataSink インターフェース

データ系列に所属するデータを書き込みます。このインターフェースではデータは読み出せません。データを読み出すには .chart2.data.XDataSource インターフェースを利用してください。

新しく作成したデータ系列にデータを設定したり、既存のデータ系列のデータを変更するときに利用します。

  • void setData( [in] []XLabeledDataSequence aData )

データを設定します。

.chart2.XDataSeries インターフェース

このデータ系列に所属するデータの各データポイントオブジェクトにアクセスするインターフェースです。データ系列全体でなく個別のデータ点の外見などを変更したいときにはこのインターフェースを介して各データ点オブジェクトを取得します。

  • .beans.XPropertySet getDataPointByIndex( [in] long nIndex )

指定したインデックスにデータ点オブジェクトを取得します。

  • void resetDataPoint( [in] long nIndex )

指定したインデックスのデータ点のフォーマットを初期化します。

  • void resetAllDataPoints()

全てのデータ点のフォーマットを初期化します。

.chart2.XRegressionCurveContainer インターフェース

回帰曲線を表示させるときに利用するインターフェースです。

  • void addRegressionCurve( [in] XRegressionCurve aRegressionCurve )

新しい回帰曲線を追加します。

  • void removeRegressionCurve( [in] XRegressionCurve aRegressionCurve )

指定した回帰曲線を削除します。

  • []XRegressionCurve getRegressionCurves()

全ての回帰曲線を取得します。

  • void setRegressionCurves( [in] []XRegressionCurve aCurves )

回帰曲線をまとめて設定します。

データ系列のプロパティ

データ系列のプロパティ

名前 説明
AttachedAxisIndex long
AttributedDataPoints []long
StackingDirection com.sun.star.chart2.StackingDirection
VaryColorsByPoint boolean
Color long
ErrorBarX com.sun.star.beans.XPropertySet
ErrorBarY com.sun.star.beans.XPropertySet
Geometry3D long
Label com.sun.star.chart2.DataPointLabel
LabelPlacement long
LabelSeparator string
NumberFormat long
Offset double
PercentDiagonal short
PercentageNumberFormat long
Symbol com.sun.star.chart2.Symbol
TextRotation double
ShowErrorBox boolean