Bu sayfa, Cloud Translation API ile çevrilmiştir.

Class 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ö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()`

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

Return

Blob: Blob halinde veriler.

`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