スプレッドシートに埋め込まれているグラフを表します。
次の例は、既存のグラフを変更する方法を示しています。
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()
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()
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()
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
- 埋め込みグラフを作成するためのビルダー