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ğı grafiğiyse bir veri kaynağı grafik örneğine yayınlanır veya `null` aksi takdirde.
`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, grafik e-tabloda değilse `null`.
`getContainerInfo()`	`ContainerInfo`	Grafiğin bulunduğu sayfayla ilgili bilgileri döndürür.
`getHiddenDimensionStrategy()`	`ChartHiddenDimensionStrategy`	Gizli satır ve sütunların işlenmesi 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`	Aralıktaki başlık olarak kabul edilen 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` değeri gösterilirse grafiği doldurmak için kullanılan satır 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ğı 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

Ad	Tür	Açıklama
`contentType`	`String`	Dö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 ChartMergeStrategy — MERGE_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 Boolean — true 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