円グラフのビルダー。詳しくは、Gviz のドキュメントをご覧ください。
Methods
詳細なドキュメント
addRange(range)
このビルダーで変更されるグラフに範囲を追加します。すでにグラフに追加されている場合、範囲は追加されません。
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(); sheet.insertChart(chart);
パラメータ
名前 | 型 | 説明 |
---|---|---|
range | Range | 追加する範囲です。 |
戻る
EmbeddedChartBuilder
- このビルダー、チェーン用
asAreaChart()
asBarChart()
asColumnChart()
グラフの種類を ColumnChart に設定し、EmbeddedColumnChartBuilder
を返します。
戻る
EmbeddedColumnChartBuilder
- 縦棒グラフのビルダー
asComboChart()
asHistogramChart()
グラフの種類を HistogramChart に設定し、EmbeddedHistogramChartBuilder
を返します。
戻る
EmbeddedHistogramChartBuilder
- ヒストグラム チャートのビルダー
asLineChart()
asPieChart()
asScatterChart()
グラフの種類を ScatterChart に設定し、EmbeddedScatterChartBuilder
を返します。
戻る
EmbeddedScatterChartBuilder
- 散布図のビルダー
asTableChart()
グラフの種類を TableChart に設定し、EmbeddedTableChartBuilder
を返します。
戻る
EmbeddedTableChartBuilder
- テーブルグラフのビルダー
build()
グラフに加えられたすべての変更を反映するようにグラフを作成します。
この方法では、スプレッドシート上にグラフが自動的に描画されることはありません。新しいグラフは sheet.insertChart(chart)
を介して挿入し、既存のグラフは sheet.updateChart(chart)
を介して更新する必要があります。
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) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
戻る
EmbeddedChart
- 作成したグラフ。スプレッドシートに追加する必要があります
clearRanges()
このビルダーで変更されたグラフからすべての範囲を削除します。
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This code updates the chart to use only the new ranges while preserving the existing // formatting of the chart. var chart = sheet.getCharts()[0]; var newChart = chart .modify() .clearRanges() .addRange(sheet.getRange("A1:A5")) .addRange(sheet.getRange("B1:B5")) .build(); sheet.updateChart(newChart);
戻る
EmbeddedChartBuilder
- このビルダー、チェーン用
getChartType()
getContainer()
グラフ ContainerInfo
を返します。これは、グラフ内のシートが表示される場所をカプセル化したものです。
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange("A1:B8")) .setPosition(5, 5, 0, 0); // This method returns the exact same data as Chart#getContainerInfo() var containerInfo = chartBuilder.getContainer(); // 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
- グラフのコンテナの位置を含むオブジェクト
getRanges()
現在、このグラフのデータを提供している範囲のリストのコピーを返します。このリストを変更するには、addRange(range)
と removeRange(range)
を使用します。
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange("A1:B8")) .setPosition(5, 5, 0, 0); var ranges = chartBuilder.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[]
- 構築するグラフとして機能する範囲の配列。
removeRange(range)
ビルダーによって変更されたグラフから、指定された範囲を削除します。範囲がこのグラフにない場合、エラーはスローされません。
削除される範囲は、addRange(range)
を介して追加された範囲と一致している必要があります。一致しない場合、グラフは変更されません。このメソッドを使用して、範囲から値を部分的に削除することはできません。
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var firstRange = sheet.getRange("A1:B5"); var secondRange = sheet.getRange("A6:B8"); var chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(firstRange) // This range will render in a different color .addRange(secondRange) .setPosition(5, 5, 0, 0); // Note that you can use either of these two formats, but the range // MUST match up with a range that was added via addRange(), or it // will not be removed, and will not throw an exception chartBuilder.removeRange(firstRange); chartBuilder.removeRange(sheet.getRange("A6:B8")); var chart = chartBuilder.build(); sheet.insertChart(chart);
パラメータ
名前 | 型 | 説明 |
---|---|---|
range | Range | 削除する範囲を指定します。 |
戻る
EmbeddedChartBuilder
- このビルダー、チェーン用
reverseCategories()
ドメイン軸で系列の描画を逆にします。縦棒グラフ(折れ線グラフ、面グラフ、縦棒グラフなど)の場合、横軸は右から左に描画されます。横範囲のグラフ(棒グラフなど)の場合、縦軸は上から下に向かって描画されます。円グラフの場合、スライスは反時計回りに描画されます。
// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner. var builder = Charts.newPieChart(); builder.reverseCategories();
戻る
EmbeddedPieChartBuilder
- チェーンに役立つビルダー。
set3D()
setBackgroundColor(cssValue)
グラフの背景色を設定します。
// Creates a line chart builder and sets the background color to gray var builder = Charts.newLineChart(); builder.setBackgroundColor("gray");
パラメータ
名前 | 型 | 説明 |
---|---|---|
cssValue | String | 色の CSS 値("blue" 、"#00f" など)。 |
戻る
EmbeddedPieChartBuilder
- チェーンに役立つビルダー。
setChartType(type)
グラフの種類を変更します。現時点では、すべての埋め込みグラフの種類がサポートされているわけではありません。ChartType
を参照。
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) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
パラメータ
名前 | 型 | 説明 |
---|---|---|
type | ChartType | このグラフのデータ型です。 |
戻る
EmbeddedChartBuilder
- このビルダー、チェーン用
setColors(cssValues)
グラフの折れ線の色を設定します。
// Creates a line chart builder and sets the first two lines to be drawn in green and red, // respectively. var builder = Charts.newLineChart(); builder.setColors(["green", "red"]);
パラメータ
名前 | 型 | 説明 |
---|---|---|
cssValues | String[] | 色の CSS 値の配列(["red", "#acf"] など)。配列内の n 番目の要素は、グラフの n 番目の線の色を表します。 |
戻る
EmbeddedPieChartBuilder
- チェーンに役立つビルダー。
setHiddenDimensionStrategy(strategy)
非表示の行や列に使用する方法を設定します。デフォルトは 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(); sheet.insertChart(chart);
パラメータ
名前 | 型 | 説明 |
---|---|---|
strategy | ChartHiddenDimensionStrategy | 非表示の行や列に使用する方法。 |
戻る
EmbeddedChartBuilder
- このビルダー、チェーン用
setLegendPosition(position)
グラフに対する凡例の位置を設定します。デフォルトでは、凡例はありません。
// Creates a line chart builder and sets the legend position to right. var builder = Charts.newLineChart(); builder.setLegendPosition(Charts.Position.RIGHT);
パラメータ
名前 | 型 | 説明 |
---|---|---|
position | Position | 凡例の位置。 |
戻る
EmbeddedPieChartBuilder
- チェーンに役立つビルダー。
setLegendTextStyle(textStyle)
グラフの凡例のテキスト スタイルを設定します。
// Creates a line chart builder and sets it up for a blue, 26-point legend. var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26); var style = textStyleBuilder.build(); var builder = Charts.newLineChart(); builder.setLegendTextStyle(style);
パラメータ
名前 | 型 | 説明 |
---|---|---|
textStyle | TextStyle | グラフの凡例に使用するテキスト スタイルです。 |
戻る
EmbeddedPieChartBuilder
- チェーンに役立つビルダー。
setMergeStrategy(mergeStrategy)
複数の範囲が存在する場合に使用する統合戦略を設定します。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("C:C10"); var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .addRange(range2) .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
パラメータ
名前 | 型 | 説明 |
---|---|---|
mergeStrategy | ChartMergeStrategy | 使用する統合戦略。 |
戻る
EmbeddedChartBuilder
- このビルダー、チェーン用
setNumHeaders(headers)
ヘッダーとして扱う範囲の行または列の数を設定します。
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(); sheet.insertChart(chart);
パラメータ
名前 | 型 | 説明 |
---|---|---|
headers | Integer | ヘッダーとして扱う行または列の数。負の値を指定すると、ヘッダーが自動検出されます。 |
戻る
EmbeddedChartBuilder
- このビルダー、チェーン用
setOption(option, value)
このグラフの詳細オプションを設定します。使用可能なオプションの一覧を表示するには、グラフの設定オプションをご覧ください。
このメソッドは、指定したオプションがこのグラフの種類に対して有効かどうか、または値が正しい形式/構造かどうかを検証しません。
この例では、タイトルを変更して凡例を設定する方法を示しています。
builder.setOption('title', 'Earnings projections'); builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});
パラメータ
名前 | 型 | 説明 |
---|---|---|
option | String | オプションの名前。 |
value | Object | オプションの値。 |
戻る
EmbeddedChartBuilder
- チェーン用のビルダー。
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
位置を設定し、シート上のグラフの位置を変更します。anchorRowPos
と anchorColPos
は 1 から始まるインデックスです。
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) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
パラメータ
名前 | 型 | 説明 |
---|---|---|
anchorRowPos | Integer | グラフの上面がこの行に固定されています。 |
anchorColPos | Integer | グラフの左側はこの列に固定されています。 |
offsetX | Integer | グラフの右上隅が、このピクセル数によってオフセットされます。 |
offsetY | Integer | グラフの左下隅が、このピクセル数によってオフセットされます。 |
戻る
EmbeddedChartBuilder
- このビルダー、チェーン用
setTitle(chartTitle)
グラフのタイトルを設定します。タイトルはグラフの中央に表示されます。
// Creates a line chart builder and title to 'My Line Chart'. var builder = Charts.newLineChart(); builder.setTitle('My Line Chart')
パラメータ
名前 | 型 | 説明 |
---|---|---|
chartTitle | String | グラフのタイトル。 |
戻る
EmbeddedPieChartBuilder
- チェーンに役立つビルダー。
setTitleTextStyle(textStyle)
グラフのタイトルのテキスト スタイルを設定します。
// Creates a line chart builder and sets it up for a blue, 26-point title. var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26); var style = textStyleBuilder.build(); var builder = Charts.newLineChart(); builder.setTitleTextStyle(style);
パラメータ
名前 | 型 | 説明 |
---|---|---|
textStyle | TextStyle | グラフのタイトルに使用するテキスト スタイルです。TextStyleBuilder オブジェクトを作成するには、Charts.newTextStyle() を呼び出します。 |
戻る
EmbeddedPieChartBuilder
- チェーンに役立つビルダー。
setTransposeRowsAndColumns(transpose)
グラフの行と列を転置するかどうかを設定します。true
に設定すると、行と列が切り替わります。デフォルトは false
です。
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) .setTransposeRowsAndColumns(true) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
パラメータ
名前 | 型 | 説明 |
---|---|---|
transpose | Boolean | true の場合、グラフの作成に使用される行と列が変換されます。 |
戻る
EmbeddedChartBuilder
- このビルダー、チェーン用