Class EmbeddedChart

EmbeddedChart

Bir e-tabloya yerleştirilmiş grafiği temsil eder.

Bu örnekte, mevcut bir grafiğin nasıl değiştirileceği gösterilmektedir: 

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A2:B8');
let 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 grafik oluşturma işlemi gösterilmektedir: 

function newChart(range) {
  const sheet = SpreadsheetApp.getActiveSheet();
  const 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()DataSourceChart|nullGrafik bir veri kaynağı grafiğiyse veri kaynağı grafiği örneğine, aksi takdirde null öğesine yayın yapar.
getAs(contentType)BlobBu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürür.
getBlob()BlobBu nesnenin içindeki verileri blob olarak döndürür.
getChartId()Integer|nullGrafiği içeren e-tablo genelinde benzersiz olan grafik için sabit bir tanımlayıcı döndürür veya grafik bir e-tabloda değilse null döndürür.
getContainerInfo()ContainerInfoGrafiğin bir sayfada bulunduğu konumla ilgili bilgileri döndürür.
getHiddenDimensionStrategy()ChartHiddenDimensionStrategyGizli satır ve sütunları işlemek 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ığın başlık olarak kabul edilen satır veya sütun sayısını döndürür.
getOptions()ChartOptionsBu grafiğin seçeneklerini (ör. yükseklik, renkler ve eksenler) döndürür.
getRanges()Range[]Bu grafiğin veri kaynağı olarak kullandığı aralıkları döndürür.
getTransposeRowsAndColumns()Booleantrue ise 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 veri kaynağı grafiği örneğine, aksi takdirde null öğesine yayın yapar.

Return

DataSourceChart|null: 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ür. Bu yöntem, dosya adına uygun uzantıyı ekler (ör. "dosyam.pdf"). Ancak, dosya adının son noktadan sonraki kısmının (varsa) değiştirilmesi gereken mevcut bir uzantı olduğunu varsayar. Dolayısıyla, "ShoppingList.12.25.2014" ifadesi "ShoppingList.12.25.pdf" olur.

Dönüşümlerle ilgili günlük kotaları görüntülemek için Google Hizmetleri Kotaları başlıklı makaleyi inceleyin. Yeni oluşturulan Google Workspace alanları geçici olarak daha katı kotalara tabi olabilir.

Parametreler

AdTürAçıklama
contentTypeStringDönüştürülecek MIME türü. Çoğu blob için tek geçerli seçenek 'application/pdf''dır. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp', 'image/gif', 'image/jpeg' veya 'image/png' de geçerlidir. Google Dokümanlar dokümanlarında 'text/markdown' da geçerlidir.

Return

Blob — Veriler blob olarak.

getBlob()

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

Return

Blob — Veriler blob olarak.

getChartId()

Grafiği içeren e-tablo genelinde benzersiz olan grafik için sabit bir tanımlayıcı döndürür veya grafik bir e-tabloda değilse null döndürür.

Return

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

getContainerInfo()

Grafiğin bir sayfada bulunduğu konumla ilgili bilgileri döndürür. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(sheet.getRange('A1:B8'))
                  .setPosition(5, 5, 0, 0)
                  .build();

const containerInfo = chart.getContainerInfo();

// Logs the values 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ının konumunu içeren bir nesne.

getHiddenDimensionStrategy()

Gizli satır ve sütunları işlemek için kullanılacak stratejiyi döndürür. Varsayılan olarak IGNORE_ROWS değerine ayarlanır. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const 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ırlar, MERGE_COLUMNS ise sütunlar birleştirilir. Varsayılan olarak MERGE_COLUMNS değerine ayarlanır. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B10');
const range2 = sheet.getRange('C1:C10');
const 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 — MERGE_ROWS Satırlar birden fazla aralıkta birleştirilmişse; MERGE_COLUMNS sütunlar birden fazla aralıkta birleştirilmişse.

getNumHeaders()

Aralığın başlık olarak kabul edilen satır veya sütun sayısını döndürür. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const 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ütun sayısı. Negatif değerler, başlıkların otomatik olarak algılandığını gösterir.

getOptions()

Bu grafiğin seçeneklerini (ör. yükseklik, renkler ve eksenler) döndürür.

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

Return

ChartOptions: Bu grafikle ilgili seçenekler (ör. yükseklik, renkler ve eksenler).

getRanges()

Bu grafiğin veri kaynağı olarak kullandığı aralıkları döndürür. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(sheet.getRange('A1:B8'))
                  .setPosition(5, 5, 0, 0)
                  .build();

const ranges = chart.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (const i in ranges) {
  const range = ranges[i];
  Logger.log(range.getA1Notation());
}

Return

Range[]: Bu grafiğin veri kaynağı olarak kullanılan bir aralık dizisi.

getTransposeRowsAndColumns()

true ise grafiği doldurmak için kullanılan satır ve sütunlar değiştirilir. Varsayılan olarak false değerine ayarlanır. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const 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 — True: Grafiği oluşturmak için kullanılan satır ve sütunlar transpoze edilmişse.

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) tuşuna basın. 

const sheet = SpreadsheetApp.getActiveSheet();
let 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.