Class EmbeddedChartBuilder

EmbeddedChart düzenlemek için kullanılan derleyici. Grafikte yapılan değişiklikler, yeniden oluşturulan grafikte Sheet.updateChart(chart) çağrılana kadar kaydedilmez.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1: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);

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`addRange(range)`	`EmbeddedChartBuilder`	Bu oluşturucunun değiştirdiği grafiğe bir aralık ekler.
`asAreaChart()`	`EmbeddedAreaChartBuilder`	Grafik türünü AreaChart olarak ayarlar ve `EmbeddedAreaChartBuilder` döndürür.
`asBarChart()`	`EmbeddedBarChartBuilder`	Grafik türünü BarChart olarak ayarlar ve `EmbeddedBarChartBuilder` döndürür.
`asColumnChart()`	`EmbeddedColumnChartBuilder`	Grafik türünü ColumnChart olarak ayarlar ve `EmbeddedColumnChartBuilder` döndürür.
`asComboChart()`	`EmbeddedComboChartBuilder`	Grafik türünü ComboChart olarak ayarlar ve `EmbeddedComboChartBuilder` döndürür.
`asHistogramChart()`	`EmbeddedHistogramChartBuilder`	Grafik türünü HistogramChart olarak ayarlar ve `EmbeddedHistogramChartBuilder` döndürür.
`asLineChart()`	`EmbeddedLineChartBuilder`	Grafik türünü LineChart olarak ayarlar ve `EmbeddedLineChartBuilder` döndürür.
`asPieChart()`	`EmbeddedPieChartBuilder`	Grafik türünü PieChart olarak ayarlar ve `EmbeddedPieChartBuilder` döndürür.
`asScatterChart()`	`EmbeddedScatterChartBuilder`	Grafik türünü ScatterChart olarak ayarlar ve `EmbeddedScatterChartBuilder` döndürür.
`asTableChart()`	`EmbeddedTableChartBuilder`	Grafik türünü TableChart olarak ayarlar ve `EmbeddedTableChartBuilder` döndürür.
`build()`	`EmbeddedChart`	Grafiği, üzerinde yapılan tüm değişiklikleri yansıtacak şekilde oluşturur.
`clearRanges()`	`EmbeddedChartBuilder`	Bu oluşturucunun değiştirdiği grafikteki tüm aralıkları kaldırır.
`getChartType()`	`ChartType`	Geçerli grafik türünü döndürür.
`getContainer()`	`ContainerInfo`	Grafiğin sayfada göründüğü yeri kapsayan grafik `ContainerInfo` değerini döndürür.
`getRanges()`	`Range[]`	Şu anda bu grafik için veri sağlayan aralık listesinin bir kopyasını döndürür.
`removeRange(range)`	`EmbeddedChartBuilder`	Belirtilen aralığı, bu oluşturucunun değiştirdiği grafikten kaldırır.
`setChartType(type)`	`EmbeddedChartBuilder`	Grafik türünü değiştirir.
`setHiddenDimensionStrategy(strategy)`	`EmbeddedChartBuilder`	Gizli satırlar ve sütunlar için kullanılacak stratejiyi ayarlar.
`setMergeStrategy(mergeStrategy)`	`EmbeddedChartBuilder`	Birden fazla aralık olduğunda kullanılacak birleştirme stratejisini ayarlar.
`setNumHeaders(headers)`	`EmbeddedChartBuilder`	Aralığın başlık olarak değerlendirilmesi gereken satır veya sütun sayısını ayarlar.
`setOption(option, value)`	`EmbeddedChartBuilder`	Bu grafik için gelişmiş seçenekleri ayarlar.
`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`	`EmbeddedChartBuilder`	Grafiğin sayfada görüneceği yeri değiştirerek konumunu ayarlar.
`setTransposeRowsAndColumns(transpose)`	`EmbeddedChartBuilder`	Grafiğin satır ve sütunlarının transpoze edilip edilmeyeceğini ayarlar.

Ayrıntılı belgeler

`addRange(range)`

Bu oluşturucunun değiştirdiği grafiğe bir aralık ekler. Grafiğe daha önce eklenmişse aralığı eklemez.

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();

sheet.insertChart(chart);

Parametreler

Ad	Tür	Açıklama
`range`	`Range`	Eklenecek aralık.

Return

EmbeddedChartBuilder: Zincirleme için kullanılan bu oluşturucu.

`asAreaChart()`

Grafik türünü AreaChart olarak ayarlar ve EmbeddedAreaChartBuilder döndürür.

Return

EmbeddedAreaChartBuilder: Alan grafiği oluşturucu.

`asBarChart()`

Grafik türünü BarChart olarak ayarlar ve EmbeddedBarChartBuilder döndürür.

Return

EmbeddedBarChartBuilder: Çubuk grafik oluşturucu.

`asColumnChart()`

Grafik türünü ColumnChart olarak ayarlar ve EmbeddedColumnChartBuilder döndürür.

Return

EmbeddedColumnChartBuilder: Sütun grafiği oluşturucu.

`asComboChart()`

Grafik türünü ComboChart olarak ayarlar ve EmbeddedComboChartBuilder döndürür.

Return

EmbeddedComboChartBuilder: Karma grafik oluşturucu.

`asHistogramChart()`

Grafik türünü HistogramChart olarak ayarlar ve EmbeddedHistogramChartBuilder döndürür.

Return

EmbeddedHistogramChartBuilder: Histogram grafiği oluşturucu.

`asLineChart()`

Grafik türünü LineChart olarak ayarlar ve EmbeddedLineChartBuilder döndürür.

Return

EmbeddedLineChartBuilder: Çizgi grafik oluşturucu.

`asPieChart()`

Grafik türünü PieChart olarak ayarlar ve EmbeddedPieChartBuilder döndürür.

Return

EmbeddedPieChartBuilder: Pasta grafiği oluşturucu.

`asScatterChart()`

Grafik türünü ScatterChart olarak ayarlar ve EmbeddedScatterChartBuilder döndürür.

Return

EmbeddedScatterChartBuilder: Dağılım grafiği oluşturucu.

`asTableChart()`

Grafik türünü TableChart olarak ayarlar ve EmbeddedTableChartBuilder döndürür.

Return

EmbeddedTableChartBuilder: Tablo grafiği oluşturucu.

`build()`

Grafiği, üzerinde yapılan tüm değişiklikleri yansıtacak şekilde oluşturur.

Bu yöntemde grafik, e-tablonun üzerine otomatik olarak çizilmez. Yeni bir grafik sheet.insertChart(chart) kullanılarak eklenmeli, mevcut bir grafik ise sheet.updateChart(chart) kullanılarak güncellenmelidir.

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)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

Return

EmbeddedChart: Oluşturulan grafik. Bu grafik, e-tabloya eklenmelidir.

`clearRanges()`

Bu oluşturucunun değiştirdiği grafikteki tüm aralıkları kaldırır.

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

// This code updates the chart to use only the new ranges while preserving the
// existing formatting of the chart.
const chart = sheet.getCharts()[0];
const newChart = chart.modify()
                     .clearRanges()
                     .addRange(sheet.getRange('A1:A5'))
                     .addRange(sheet.getRange('B1:B5'))
                     .build();
sheet.updateChart(newChart);

Return

EmbeddedChartBuilder: Zincirleme için kullanılan bu oluşturucu.

`getChartType()`

Geçerli grafik türünü döndürür.

Return

ChartType: Grafik türü.

`getContainer()`

Grafiğin sayfada göründüğü yeri kapsayan grafik ContainerInfo değerini döndürür.

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

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

// This method returns the exact same data as Chart#getContainerInfo()
const containerInfo = chartBuilder.getContainer();

// 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.

`getRanges()`

Şu anda bu grafik için veri sağlayan aralık listesinin bir kopyasını döndürür. Bu listeyi değiştirmek için addRange(range) ve removeRange(range) simgelerini kullanın.

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

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

const ranges = chartBuilder.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[]: Oluşturulacak grafiğin veri kaynağı olarak kullanılan bir aralık dizisi.

`removeRange(range)`

Belirtilen aralığı, bu oluşturucunun değiştirdiği grafikten kaldırır. Aralık bu grafikte yoksa hata vermez.

Kaldırılan aralık, addRange(range) aracılığıyla eklenen bir aralıkla eşleşmelidir. Aksi takdirde grafikte herhangi bir değişiklik yapılmaz. Bu yöntem, bir aralıktaki değerleri kısmen kaldırmak için kullanılamaz.

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

const firstRange = sheet.getRange('A1:B5');
const secondRange = sheet.getRange('A6:B8');

const chartBuilder = sheet.newChart()
                         .setChartType(Charts.ChartType.BAR)
                         .addRange(firstRange)
                         // This range renders in a different color
                         .addRange(secondRange)
                         .setPosition(5, 5, 0, 0);

// Note that you can use either of these two formats, but the range
// MUST match up with a range that was added via addRange(), or it
// is not removed, and does not throw an exception
chartBuilder.removeRange(firstRange);
chartBuilder.removeRange(sheet.getRange('A6:B8'));

const chart = chartBuilder.build();

sheet.insertChart(chart);

Parametreler

Ad	Tür	Açıklama
`range`	`Range`	Kaldırılacak aralık.

Return

EmbeddedChartBuilder: Zincirleme için kullanılan bu oluşturucu.

`setChartType(type)`

Grafik türünü değiştirir. Şu anda tüm yerleştirilmiş grafik türleri desteklenmemektedir. Şu sayfaya göz atın: ChartType.

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)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

Parametreler

Ad	Tür	Açıklama
`type`	`ChartType`	Bu grafiğin dönüştürüleceği tür.

Return

EmbeddedChartBuilder: Zincirleme için kullanılan bu oluşturucu.

`setHiddenDimensionStrategy(strategy)`

Gizli satırlar ve sütunlar için kullanılacak stratejiyi ayarlar. 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();

sheet.insertChart(chart);

Parametreler

Ad	Tür	Açıklama
`strategy`	`ChartHiddenDimensionStrategy`	Gizli satırlar ve sütunlar için kullanılacak strateji.

Return

EmbeddedChartBuilder: Zincirleme için kullanılan bu oluşturucu.

`setMergeStrategy(mergeStrategy)`

Birden fazla aralık olduğunda kullanılacak birleştirme stratejisini ayarlar. 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('C:C10');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .addRange(range2)
                  .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

Parametreler

Ad	Tür	Açıklama
`mergeStrategy`	`ChartMergeStrategy`	Kullanılacak birleştirme stratejisi.

Return

EmbeddedChartBuilder: Zincirleme için kullanılan bu oluşturucu.

`setNumHeaders(headers)`

Aralığın başlık olarak değerlendirilmesi gereken satır veya sütun sayısını ayarlar.

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();

sheet.insertChart(chart);

Parametreler

Ad	Tür	Açıklama
`headers`	`Integer`	Başlık olarak değerlendirilecek satır veya sütun sayısı. Negatif değerler, başlıkların otomatik olarak algılanmasına neden olur.

Return

EmbeddedChartBuilder: Zincirleme için kullanılan bu oluşturucu.

`setOption(option, value)`

Bu grafik için gelişmiş seçenekleri ayarlar. Kullanılabilir seçeneklerin listesini görmek için Grafik yapılandırma seçenekleri başlıklı makaleyi inceleyin.

Bu yöntem, belirttiğiniz seçeneğin bu grafik türü için geçerli olup olmadığını veya değerin doğru biçimde/yapıda olup olmadığını doğrulamaz.

Bu örnekte, başlığın nasıl değiştirileceği ve bir açıklama metninin nasıl ayarlanacağı gösterilmektedir.

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const sheet = spreadsheet.getSheets()[0];
const chart = sheet.newChart()
 .setOption('title', 'Earnings projections')
 .setOption('legend', {
   position: 'top',
   textStyle: { color: 'blue', fontSize: 16 },
 }).build();

Parametreler

Ad	Tür	Açıklama
`option`	`String`	Seçeneğin adı.
`value`	`Object`	Seçeneğin değeri.

Return

EmbeddedChartBuilder: Zincirleme için kullanılan bu oluşturucu.

`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`

Grafiğin sayfada görüneceği yeri değiştirerek konumunu ayarlar. anchorRowPos ve anchorColPos 1 tabanlıdı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)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

Parametreler

Ad	Tür	Açıklama
`anchorRowPos`	`Integer`	Grafiğin üst kısmı bu satıra sabitlenir.
`anchorColPos`	`Integer`	Grafiğin sol tarafı bu sütuna sabitlenir.
`offsetX`	`Integer`	Grafiğin sağ üst köşesi bu kadar pikselle kaydırılır.
`offsetY`	`Integer`	Grafiğin sol alt köşesi bu kadar pikselle kaydırılır.

Return

EmbeddedChartBuilder: Zincirleme için kullanılan bu oluşturucu.

`setTransposeRowsAndColumns(transpose)`

Grafiğin satır ve sütunlarının transpoze edilip edilmeyeceğini ayarlar. true olarak ayarlanırsa satırlar 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()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setTransposeRowsAndColumns(true)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

Parametreler

Ad	Tür	Açıklama
`transpose`	`Boolean`	`true` ise grafiği oluşturmak için kullanılan satırlar ve sütunlar devrik olur.

Return

EmbeddedChartBuilder: Zincirleme için kullanılan bu oluşturucu.

Class EmbeddedChartBuilder Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Yöntemler

Ayrıntılı belgeler

addRange(range)

Parametreler

Return

asAreaChart()

Return

asBarChart()

Return

asColumnChart()

Return

asComboChart()

Return

asHistogramChart()

Return

asLineChart()

Return

asPieChart()

Return

asScatterChart()

Return

asTableChart()

Return

build()

Return

clearRanges()

Return

getChartType()

Return

getContainer()

Return

getRanges()

Return

removeRange(range)

Parametreler

Return

setChartType(type)

Parametreler

Return

setHiddenDimensionStrategy(strategy)

Parametreler

Return

setMergeStrategy(mergeStrategy)

Parametreler

Return

setNumHeaders(headers)

Parametreler

Return

setOption(option, value)

Parametreler

Return

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Parametreler

Return

setTransposeRowsAndColumns(transpose)

Parametreler

Return

Class EmbeddedChartBuilder

`addRange(range)`

`asAreaChart()`

`asBarChart()`

`asColumnChart()`

`asComboChart()`

`asHistogramChart()`

`asLineChart()`

`asPieChart()`

`asScatterChart()`

`asTableChart()`

`build()`

`clearRanges()`

`getChartType()`

`getContainer()`

`getRanges()`

`removeRange(range)`

`setChartType(type)`

`setHiddenDimensionStrategy(strategy)`

`setMergeStrategy(mergeStrategy)`

`setNumHeaders(headers)`

`setOption(option, value)`

`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`

`setTransposeRowsAndColumns(transpose)`