データシークエンス

ChartAPI

グラフに描かれる一連のデータを保持するオブジェクトです。ラベル付きデータシークエンスオブジェクトからラベル用データおよびデータの別々のオブジェクトとしてアクセスできます。

Role プロパティがこのシークエンスオブジェクトの保持するデータの役割を示します。たとえば、values-y といった値です。有効な役割はチャートの種類によって異なり、チャートタイプのテンプレートで調べることができます。

データシークエンスは直接作成せずにラベル付きデータシークエンスとして作成したり、データ系列を生成させるときに自動的に作成されます。

Sub GetDataSequence
  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)
  
  oLabeledDataSequences = oSeries.getDataSequences()
  oLabeledDataSequence = oLabeledDataSequences(0)
  
  oDataSeq = oLabeledDataSequence.getValues()
End Sub

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

  • []any getData()

元のデータを返します。

  • string getSourceRangeRepresentation()

セル範囲から生成された場合、セル範囲のアドレスを返します。

  • []string generateLabel( [in] LabelOrigin eLabelOrigin )

指定位置からのデータからラベル用のデータを生成します。

  • long getNumberFormatKeyByIndex( [in] long nIndex )

指定したインデックスのデータで利用されている数書式番号を返します。

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

  • []double getNumericalData()

データを数値として返します。

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

  • []string getTextualData()

データを文字列として返します。

データシークエンスのプロパティ

名前 型 説明
Role string このデータシークエンスの役割
IncludeHiddenCells boolean 隠しセルの値は含まれない
HiddenValues []long 隠しセルのデータのインデックス