表グラフのビルダー。詳しくは、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()
グラフの種類を ComboChart に設定し、EmbeddedComboChartBuilder
を返します。
リターン
EmbeddedComboChartBuilder
- 複合グラフのビルダー
asHistogramChart()
グラフの種類を HistogramChart に設定し、EmbeddedHistogramChartBuilder
を返します。
リターン
EmbeddedHistogramChartBuilder
- ヒストグラム グラフのビルダー
asLineChart()
asPieChart()
asScatterChart()
グラフの種類を ScatterChart に設定し、EmbeddedScatterChartBuilder
を返します。
リターン
EmbeddedScatterChartBuilder
- 散布図のビルダー
asTableChart()
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
- このビルダー(チェーン用)
enablePaging(enablePaging)
データに対するページングを有効にするかどうかを設定します。
デフォルトの動作では、ページングは無効になっています。ページングが有効になっている場合、デフォルトのページサイズは 10 です。
パラメータ
名前 | 型 | 説明 |
---|---|---|
enablePaging | Boolean | ページングを有効にする場合は true 、そうでない場合は false 。 |
リターン
EmbeddedTableChartBuilder
- このビルダー。チェーンに役立ちます。
enablePaging(pageSize)
ページングを有効にし、各ページの行数を設定します。
デフォルトのページサイズは 10 です。
// Creates a table chart builder and enables paging with page size of 5. var builder = Charts.newTableChart(); builder.enablePaging(5);
パラメータ
名前 | 型 | 説明 |
---|---|---|
pageSize | Integer | テーブルの各ページの行数。 |
リターン
EmbeddedTableChartBuilder
- このビルダー。チェーンに役立ちます。
enablePaging(pageSize, startPage)
ページングを有効にし、各ページの行数と表示する最初の表ページの行数を設定します(ページ番号はゼロから始まる)。
デフォルトのページサイズは 10、スタートページは 0 です。
// Creates a table chart builder and enables paging with page size of 5 and displays page 2 // first. var builder = Charts.newTableChart(); builder.enablePaging(5, 2);
パラメータ
名前 | 型 | 説明 |
---|---|---|
pageSize | Integer | テーブルの各ページの行数。 |
startPage | Integer | 最初に表示する表ページ(ページ番号はゼロから始まる)。 |
リターン
EmbeddedTableChartBuilder
- このビルダー。チェーンに役立ちます。
enableRtlTable(rtlEnabled)
テーブルの列の順序を逆にして、右から左に記述する言語(アラビア語やヘブライ語など)の基本的なサポートを追加します。これにより、列 0 が右端の列、最後の列が左端の列になります。
これは、基になるデータの列インデックスには影響せず、表示の順序にのみ影響します。このオプションを使用した場合でも、テーブル可視化では完全な双方向(BiDi)言語表示はサポートされていません。ページ オプションを使用してページングを有効にしている場合や、指定した高さと幅のオプションがテーブルに必要なサイズよりも小さいためにテーブルにスクロールバーがある場合、このオプションは無視されます。デフォルトの動作では、RTL サポートは無効になっています。
パラメータ
名前 | 型 | 説明 |
---|---|---|
rtlEnabled | Boolean | 右から左へのサポートを有効にする場合は true 、そうでない場合は false 。 |
リターン
EmbeddedTableChartBuilder
- このビルダー。チェーンに役立ちます。
enableSorting(enableSorting)
ユーザーが列見出しをクリックしたときに列を並べ替えるかどうかを設定します。
並べ替えを有効にすると、ユーザーが列ヘッダーをクリックすると、行が自動的に並べ替えられます。デフォルトでは、並べ替えは有効になっています。
パラメータ
名前 | 型 | 説明 |
---|---|---|
enableSorting | Boolean | true : 列ヘッダーをクリックして並べ替えを有効にします。それ以外の場合は false 。 |
リターン
EmbeddedTableChartBuilder
- このビルダー。チェーンに役立ちます。
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
- このビルダー(チェーン用)
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
- このビルダー(チェーン用)
setFirstRowNumber(number)
データテーブルの最初の行の行番号を設定します。
最初の行のデフォルトの行番号は 1 です。
// Creates a table chart builder and sets the first row to be 2. var builder = Charts.newTableChart(); builder.setFirstRowNumber(2);
パラメータ
名前 | 型 | 説明 |
---|---|---|
number | Integer | データテーブルの最初の行の行番号。 |
リターン
EmbeddedTableChartBuilder
- このビルダー。チェーンに役立ちます。
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
- このビルダー(チェーン用)
setInitialSortingAscending(column)
テーブルの最初の並べ替え(昇順)を基準にする列のインデックスを設定します。
[OS] 列が昇順で並べ替えられており、それを示す小さな矢印が付いています。
// Creates a table chart builder and sorts it by the second column (ascending). var builder = Charts.newTableChart(); builder.setInitialSortingAscending(2);
パラメータ
名前 | 型 | 説明 |
---|---|---|
column | Integer | テーブルを最初に並べ替える基準となる列の数です。 |
リターン
EmbeddedTableChartBuilder
- このビルダー。チェーンに役立ちます。
setInitialSortingDescending(column)
列のインデックスを設定します。このインデックスに基づいてテーブルが最初に並べ替えられます(降順)。
[OS] 列が降順で並べ替えられ、それを示す小さな矢印が付いています。
// Creates a table chart builder and sorts it by the second column (descending). var builder = Charts.newTableChart(); builder.setInitialSortingDescending(2);
パラメータ
名前 | 型 | 説明 |
---|---|---|
column | Integer | テーブルを最初に並べ替える基準となる列の数です。 |
リターン
EmbeddedTableChartBuilder
- このビルダー。チェーンに役立ちます。
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
- このビルダー(チェーン用)
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
- このビルダー(チェーン用)
showRowNumberColumn(showRowNumber)
行番号を表の最初の列として表示するかどうかを設定します。
デフォルトの動作では、行番号は表示されません。
パラメータ
名前 | 型 | 説明 |
---|---|---|
showRowNumber | Boolean | テーブルの最初の列に行番号を表示する場合は true 、そうでない場合は false 。 |
リターン
EmbeddedTableChartBuilder
- このビルダー。チェーンに役立ちます。
useAlternatingRowStyle(alternate)
表グラフの奇数行と偶数行に交互の配色スタイルを割り当てるかどうかを設定します。
デフォルトの動作では、行が交互の背景色で表示されます。
パラメータ
名前 | 型 | 説明 |
---|---|---|
alternate | Boolean | 色スタイルを交互にする必要がある場合は true 、そうでない場合は false 。 |
リターン
EmbeddedTableChartBuilder
- このビルダー。チェーンに役立ちます。