Class EmbeddedChart

EmbeddedChart

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öntemDönüş türüKısa açıklama
asDataSourceChart()DataSourceChartGrafik bir veri kaynağı grafiğiyse bir veri kaynağı grafik örneğine yayınlanır veya null aksi takdirde.
getAs(contentType)BlobBu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün.
getBlob()BlobBu nesnenin içindeki verileri blob olarak döndürün.
getChartId()IntegerGrafik için, grafik e-tabloda değilse null.
getContainerInfo()ContainerInfoGrafiğin bulunduğu sayfayla ilgili bilgileri döndürür.
getHiddenDimensionStrategy()ChartHiddenDimensionStrategyGizli satır ve sütunların işlenmesi için kullanılacak stratejiyi döndürür.
getMergeStrategy()ChartMergeStrategyBirden fazla aralık olduğunda kullanılan birleştirme stratejisini döndürür.
getNumHeaders()IntegerAralıktaki başlık olarak kabul edilen satır veya sütun sayısını döndürür.
getOptions()ChartOptionsBu grafikle ilgili 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()Booleantrue değeri gösterilirse grafiği doldurmak için kullanılan satır ve sütunlar değiştirilir.
modify()EmbeddedChartBuilderBu grafiği değiştirmek için kullanılabilecek bir EmbeddedChartBuilder döndürür.

Ayrıntılı belgeler

asDataSourceChart()

Grafik bir veri kaynağı grafiğiyse bir veri kaynağı grafik örneğine yayınlanır veya null aksi takdirde.

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öntemi, dosya adına uygun uzantıyı ekler. Örneğin, "dosyam.pdf". Ancak, dosya adında son noktadan sonra gelen bölümün (varsa) mevcut bir alan olduğunu varsayar değiştirilmesi gereken uzantıdır. Sonuç olarak, "AlışverişListesi.12.25.2014" şu olur: "ShoppingList.12.25.pdf".

Günlük dönüşüm kotalarını görüntülemek için bkz. Google için Kotalar Hizmetler. Yeni oluşturulan Google Workspace alanları geçici olarak daha sıkılığa tabi olabilir kotalar.

Parametreler

AdTürAçıklama
contentTypeStringDönüşümün gerçekleştirileceği MIME türü. Çoğu blob için 'application/pdf', tek geçerli seçenektir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp', 'image/gif', 'image/jpeg' veya 'image/png''ten herhangi biri de geçerlidir. Bir Google Dokümanlar dokümanı için 'text/markdown' ayrıca geçerlidir.

Return

Blob — Veriler bir blob olarak.


getBlob()

Bu nesnenin içindeki verileri blob olarak döndürün.

Return

Blob — Veriler bir blob olarak.


getChartId()

Grafik için, grafik e-tabloda değilse null.

Return

Integer: Sabit bir grafik tanımlayıcısı.


getContainerInfo()

Grafiğin bulunduğu sayfayla 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ır ve sütunların işlenmesi 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 ise satır birleştirilir; MERGE_COLUMNS ise 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

Satırlar birden çokta birleştirilirse ChartMergeStrategyMERGE_ROWS aralıklar; Sütunlar birleştirilirse MERGE_COLUMNS birden fazla aralıkta


getNumHeaders()

Aralıktaki başlık olarak kabul edilen 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 kabul edilen satır veya sütunların sayısı. Negatif değerler, başlıkları otomatik olarak algılanır.


getOptions()

Bu grafikle ilgili yükseklik, renkler ve eksenler gibi seçenekleri döndürür.

Döndürülen seçenekler sabittir.

Return

ChartOptions — Bu grafikle ilgili yükseklik, renkler ve eksenler gibi seçenekler.


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 kullanılan bir aralık dizisi


getTransposeRowsAndColumns()

true değeri gösterilirse grafiği doldurmak için kullanılan satır ve sütunlar değiştirilir. Varsayılan değer: 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());

Return

Grafiği oluşturmak için kullanılan satırlar ve sütunlar ters çevrilmişse Booleantrue değerini alır.


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 çağı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şturmak için kullanılan bir oluşturucu