Bir e-tabloya yerleştirilmiş bir grafiği temsil eder.
Bu örnekte, mevcut bir grafiğin nasıl değiştirileceği gösterilmektedir:
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);
Bu örnekte, yeni bir grafiğin nasıl oluşturulacağı gösterilmektedir:
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()); }
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
asDataSourceChart() | DataSourceChart | Grafik bir veri kaynağı grafikse veri kaynağı grafik örneğine, aksi takdirde null öğesine yayınlar. |
getAs(contentType) | Blob | Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün. |
getBlob() | Blob | Bu nesnenin içindeki verileri blob olarak döndürün. |
getChartId() | Integer | Grafik için grafiği içeren e-tablo genelinde benzersiz olan sabit bir tanımlayıcı veya grafik bir e-tabloda değilse null döndürür. |
getContainerInfo() | ContainerInfo | Grafiğin sayfadaki konumuyla ilgili bilgileri döndürür. |
getHiddenDimensionStrategy() | ChartHiddenDimensionStrategy | Gizli satırları ve sütunları işlemek için kullanılacak stratejiyi döndürür. |
getMergeStrategy() | ChartMergeStrategy | Birden fazla aralık olduğunda kullanılan birleştirme stratejisini döndürür. |
getNumHeaders() | Integer | Başlık olarak değerlendirilen satır veya sütun sayısını döndürür. |
getOptions() | ChartOptions | Bu grafik için yükseklik, renkler ve eksenler gibi seçenekleri döndürür. |
getRanges() | Range[] | Bu grafiğin veri kaynağı olarak kullandığı aralıkları döndürür. |
getTransposeRowsAndColumns() | Boolean | true ise grafiği doldurmak için kullanılan satırlar ve sütunlar değiştirilir. |
modify() | EmbeddedChartBuilder | Bu grafiği değiştirmek için kullanılabilecek bir EmbeddedChartBuilder döndürür. |
Ayrıntılı belgeler
asDataSourceChart()
Grafik bir veri kaynağı grafikse veri kaynağı grafik örneğine, aksi takdirde null
öğesine yayınlar.
Return
DataSourceChart
: Veri kaynağı grafiği.
getAs(contentType)
Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün. Bu yöntem, dosya adına uygun uzantıyı ekler (örneğin, "dosyam.pdf"). Bununla birlikte, dosya adında son noktanın ardından gelen bölümün (varsa) değiştirilmesi gereken mevcut bir uzantı olduğu varsayılır. Sonuç olarak, "ShoppingList.12.25.2014", "ShoppingList.12.25.pdf" haline gelir.
Günlük dönüşüm kotalarını görüntülemek için Google Hizmetleri Kotalar bölümüne bakın. Yeni oluşturulan Google Workspace alanları geçici olarak daha sıkı kotalara tabi olabilir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
contentType | String | Dönüştürülecek MIME türü. Çoğu blob için geçerli tek seçenek 'application/pdf' 'tir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp' , 'image/gif' , 'image/jpeg' veya 'image/png' değerleri de geçerlidir. |
Return
Blob
: Blob halinde veriler.
getBlob()
getChartId()
Grafik için grafiği içeren e-tablo genelinde benzersiz olan sabit bir tanımlayıcı veya grafik bir e-tabloda değilse null
döndürür.
Return
Integer
: Sabit bir grafik tanımlayıcısı.
getContainerInfo()
Grafiğin sayfadaki konumuyla ilgili bilgileri döndürür.
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());
Return
ContainerInfo
: Grafik kapsayıcısının konumunu içeren bir nesne
getHiddenDimensionStrategy()
Gizli satırları ve sütunları işlemek için kullanılacak stratejiyi döndürür. Varsayılan olarak IGNORE_ROWS
değerine ayarlanır.
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());
Return
ChartHiddenDimensionStrategy
: Gizli satırlar ve sütunlar için kullanılacak strateji.
getMergeStrategy()
Birden fazla aralık olduğunda kullanılan birleştirme stratejisini döndürür. MERGE_ROWS
değerine ayarlanırsa satır birleştirilir, MERGE_COLUMNS
değerine ayarlanırsa sütunlar birleştirilir. Varsayılan olarak MERGE_COLUMNS
değerine ayarlanır.
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());
Return
ChartMergeStrategy
- Satırlar birden fazla aralıkta birleştirilirse MERGE_ROWS
; sütunlar birden fazla aralıkta birleştirilirse MERGE_COLUMNS
getNumHeaders()
Başlık olarak değerlendirilen satır veya sütun sayısını döndürür.
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());
Return
Integer
: Başlık olarak değerlendirilen satır veya sütunların sayısı. Negatif değerler, başlıkların otomatik olarak algılandığını gösterir.
getOptions()
Bu grafik için yükseklik, renkler ve eksenler gibi seçenekleri döndürür.
Döndürülen seçenekler sabittir.
Return
ChartOptions
: Bu grafik için yükseklik, renkler ve eksenler gibi seçeneklerdir.
getRanges()
Bu grafiğin veri kaynağı olarak kullandığı aralıkları döndürür.
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()); }
Return
Range[]
: Bu grafiğin veri kaynağı olarak işlev gören aralıklar dizisi
getTransposeRowsAndColumns()
true
ise grafiği doldurmak için kullanılan satırlar ve sütunlar değiştirilir. Varsayılan olarak
false
değerine ayarlanır.
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());
Return
Boolean
— Grafiği oluşturmak için kullanılan satırlar ve sütunlar ters çevrilmişse true
.
modify()
Bu grafiği değiştirmek için kullanılabilecek bir EmbeddedChartBuilder
döndürür. Değişiklikleri kaydetmek için sheet.updateChart(chart)
komutunu çalıştırın.
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);
Return
EmbeddedChartBuilder
: Yerleştirilmiş grafikler oluşturmanıza olanak tanıyan bir oluşturucu