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:

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 grafiğin nasıl oluşturulacağı 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öntem	Dönüş türü	Kısa açıklama
`asDataSourceChart()`	`DataSourceChart`	Grafik bir veri kaynağı grafiğiyse bir veri kaynağı grafiği örneğine, aksi takdirde `null` bir veri kaynağı örneğine 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ürme.
`getBlob()`	`Blob`	Bu nesnenin içindeki verileri bir blob olarak döndürme.
`getChartId()`	`Integer`	Grafiğin, grafik içeren e-tabloda benzersiz olan kararlı bir tanımlayıcısını döndürür veya grafik bir e-tabloda değilse `null` döndürür.
`getContainerInfo()`	`ContainerInfo`	Grafiğin bir sayfadaki konumu hakkında bilgi döndürür.
`getHiddenDimensionStrategy()`	`ChartHiddenDimensionStrategy`	Gizli satır 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`	Aralığın başlık olarak değerlendirilen satır veya sütun sayısını döndürür.
`getOptions()`	`ChartOptions`	Bu grafiğin yükseklik, renkler ve eksenler gibi seçeneklerini 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ı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ı dokümanlar

`asDataSourceChart()`

Grafik bir veri kaynağı grafiğiyse bir veri kaynağı grafiği örneğine, aksi takdirde null bir veri kaynağı örneğine 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ürme. Bu yöntem, dosya adına uygun uzantıyı ekler (ör. "dosyam.pdf"). Ancak, dosya adının son noktayı (varsa) izleyen kısmının, değiştirilmesi gereken mevcut bir uzantı olduğu varsayılır. Sonuç olarak, "AlışverişListesi.25.12.2014", "AlışverişListesi.25.12.pdf" olur.

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

Parametreler

Ad	Tür	Açıklama
`contentType`	`String`	Dönüştürülecek 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'` değerlerinden herhangi biri de geçerlidir. Google Dokümanlar dokümanları için `'text/markdown'` de geçerlidir.

Return

Blob: Veriler bir blob olarak.

`getBlob()`

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

Return

Blob: Veriler bir blob olarak.

`getChartId()`

Grafiğin, grafik içeren e-tabloda benzersiz olan kararlı bir tanımlayıcısını döndürür veya grafik bir e-tabloda değilse null döndürür.

Return

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

`getContainerInfo()`

Grafiğin bir sayfadaki konumu hakkında bilgi 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 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ı 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: Satırlar birden fazla aralık boyunca birleştirildiyse MERGE_ROWS; sütunlar birden fazla aralık boyunca birleştirildiyse MERGE_COLUMNS

`getNumHeaders()`

Aralığın başlık olarak değerlendirilen 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: Üstbilgi olarak değerlendirilen 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 yükseklik, renkler ve eksenler gibi seçeneklerini döndürür.

Döndürülen seçenekler değiştirilemez.

Return

ChartOptions: Bu grafiğin yükseklik, renkler ve eksenler gibi seçenekleri.

`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: Grafik oluşturmak için kullanılan satırlar ve sütunlar değiştirilmiş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)'ü çağırı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 bir oluşturucu