このページは Cloud Translation API によって翻訳されました。

Class EmbeddedChart

スプレッドシートに埋め込まれているグラフを表します。

次の例は、既存のグラフを変更する方法を示しています。

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A2:B8")
var chart = sheet.getCharts()[0];
chart = chart.modify()
    .addRange(range)
    .setOption('title', 'Updated!')
    .setOption('animation.duration', 500)
    .setPosition(2,2,0,0)
    .build();
sheet.updateChart(chart);

次の例は、新しいグラフを作成する方法を示しています。

function newChart(range, sheet) {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chartBuilder = sheet.newChart();
  chartBuilder.addRange(range)
      .setChartType(Charts.ChartType.LINE)
      .setOption('title', 'My Line Chart!');
  sheet.insertChart(chartBuilder.build());
}

メソッド

メソッド	戻り値の型	概要
`asDataSourceChart()`	`DataSourceChart`	データソースのグラフがデータソースのグラフである場合は、データソースのグラフインスタンスにキャストされます。`null` できません。
`getAs(contentType)`	`Blob`	このオブジェクト内のデータを、指定されたコンテンツタイプに変換された blob として返します。
`getBlob()`	`Blob`	このオブジェクト内のデータを blob として返します。
`getChartId()`	`Integer`	グラフの不変の識別子を返します。識別子は、グラフ。スプレッドシートにグラフがない場合は `null`。
`getContainerInfo()`	`ContainerInfo`	シート内のグラフの位置に関する情報を返します。
`getHiddenDimensionStrategy()`	`ChartHiddenDimensionStrategy`	非表示の行と列の処理に使用する戦略を返します。
`getMergeStrategy()`	`ChartMergeStrategy`	複数の範囲が存在する場合に使用される統合戦略を返します。
`getNumHeaders()`	`Integer`	ヘッダーとして扱われる範囲の行数または列数を返します。
`getOptions()`	`ChartOptions`	このグラフのオプション（高さ、色、軸など）を返します。
`getRanges()`	`Range[]`	このグラフがデータソースとして使用する範囲を返します。
`getTransposeRowsAndColumns()`	`Boolean`	`true` の場合、グラフへのデータ入力に使用される行と列が切り替わります。
`modify()`	`EmbeddedChartBuilder`	このグラフの変更に使用できる `EmbeddedChartBuilder` を返します。

詳細なドキュメント

`asDataSourceChart()`

データソースのグラフがデータソースのグラフである場合は、データソースのグラフインスタンスにキャストされます。null できません。

戻る

DataSourceChart - データソースのグラフ。

`getAs(contentType)`

このオブジェクト内のデータを、指定されたコンテンツタイプに変換された blob として返します。このメソッドにより、ファイル名に適切な拡張子（例: myfile.pdf）が追加されます。ただし、ファイル名の最後のピリオド（ある場合）に続く部分は、指定します。したがって、「ShoppingList.12.25.2014」となります。が以下に変換される: 「ShoppingList.12.25.pdf」

コンバージョンの 1 日あたりの割り当てを確認するには、Google Cloud の割り当てサービス。新しく作成された Google Workspace ドメインには一時的に厳格なできます。

パラメータ

名前	型	説明
`contentType`	`String`	変換先の MIME タイプ。ほとんどの blob の場合、`'application/pdf'` は次のようになります。唯一の有効な選択肢となりますBMP、GIF、JPEG、PNG 形式の画像の場合は、`'image/bmp'`、`'image/gif'`、`'image/jpeg'`、`'image/png'` のいずれかも可有効です。Google ドキュメントのドキュメントの場合は、`'text/markdown'` も有効です。

戻る

Blob - blob としてのデータ。

`getBlob()`

このオブジェクト内のデータを blob として返します。

戻る

Blob - blob としてのデータ。

`getChartId()`

グラフの不変の識別子を返します。識別子は、グラフ。スプレッドシートにグラフがない場合は null。

戻る

Integer - 不変のグラフ ID。

`getContainerInfo()`

シート内のグラフの位置に関する情報を返します。

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0)
    .build();

var containerInfo = chart.getContainerInfo();

// Logs the values we used in setPosition()
Logger.log("Anchor Column: %s\r\nAnchor Row %s\r\nOffset X %s\r\nOffset Y %s",
          containerInfo.getAnchorColumn(),
          containerInfo.getAnchorRow(),
          containerInfo.getOffsetX(),
          containerInfo.getOffsetY());

戻る

ContainerInfo - グラフコンテナの位置を含むオブジェクト

`getHiddenDimensionStrategy()`

非表示の行と列の処理に使用する戦略を返します。デフォルトは IGNORE_ROWS です。

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setHiddenDimensionStrategy(Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs the strategy to use for hidden rows and columns which is
// Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS in this case.
Logger.log(chart.getHiddenDimensionStrategy());

戻る

ChartHiddenDimensionStrategy - 非表示の行と列に使用する方法。

`getMergeStrategy()`

複数の範囲が存在する場合に使用される統合戦略を返します。MERGE_ROWS の場合、行がマージされます。MERGE_COLUMNS の場合、列はマージされます。デフォルトは MERGE_COLUMNS です。

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B10");
var range2 = sheet.getRange("C1:C10");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .addRange(range2)
    .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs whether rows of multiple ranges are merged, which is MERGE_ROWS in this case.
Logger.log(chart.getMergeStrategy());

戻る

ChartMergeStrategy - 行が複数にマージされている場合は MERGE_ROWS 範囲列がマージされている場合は MERGE_COLUMNS 複数の範囲にわたる

`getNumHeaders()`

ヘッダーとして扱われる範囲の行数または列数を返します。

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setNumHeaders(1)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs the number of rows or columns to use as headers, which is 1 in this case.
Logger.log(chart.getHeaders());

戻る

Integer - ヘッダーとして扱われる行または列の数。負の値はヘッダーを示します自動的に検出されます。

`getOptions()`

このグラフのオプション（高さ、色、軸など）を返します。

返されるオプションは変更できません。

戻る

ChartOptions - グラフのオプション（高さ、色、軸など）。

`getRanges()`

このグラフがデータソースとして使用する範囲を返します。

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0)
    .build();

var ranges = chart.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (var i in ranges) {
  var range = ranges[i];
  Logger.log(range.getA1Notation());
}

戻る

Range[] - このグラフのデータソースとして機能する範囲の配列

`getTransposeRowsAndColumns()`

true の場合、グラフへのデータ入力に使用される行と列が切り替わります。デフォルトは false。

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .addRange(range)
    .setChartType(Charts.ChartType.BAR)
    .setTransposeRowsAndColumns(true)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs whether rows and columns should be transposed, which is true in this case.
Logger.log(chart.getTransposeRowsAndColumns());

戻る

Boolean - グラフの作成に使用する行と列が転置されている場合は true です。

`modify()`

このグラフの変更に使用できる EmbeddedChartBuilder を返します。sheet.updateChart(chart) を呼び出して変更を保存します。

var sheet = SpreadsheetApp.getActiveSheet();
var chart = sheet.getCharts()[0];
chart = chart.modify()
    .setOption('width', 800)
    .setOption('height', 640)
    .setPosition(5, 5, 0, 0)
    .build();
sheet.updateChart(chart);

戻る

EmbeddedChartBuilder - 埋め込みグラフを作成するためのビルダー