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

Class EmbeddedChartBuilder

EmbeddedChart'yi düzenlemek için kullanılan oluşturucu. Yeniden oluşturulan grafikte Sheet.updateChart(chart) çağrılana kadar grafikte yapılan değişiklikler 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 derleyicinin değiştirdiği grafiğe bir aralık ekler.
`asAreaChart()`	`EmbeddedAreaChartBuilder`	Grafik türünü AreaChart olarak ayarlar ve bir `EmbeddedAreaChartBuilder` döndürür.
`asBarChart()`	`EmbeddedBarChartBuilder`	Grafik türünü BarChart olarak ayarlar ve bir `EmbeddedBarChartBuilder` döndürür.
`asColumnChart()`	`EmbeddedColumnChartBuilder`	Grafik türünü ColumnChart olarak ayarlar ve bir `EmbeddedColumnChartBuilder` döndürür.
`asComboChart()`	`EmbeddedComboChartBuilder`	Grafik türünü ComboChart olarak ayarlar ve bir `EmbeddedComboChartBuilder` döndürür.
`asHistogramChart()`	`EmbeddedHistogramChartBuilder`	Grafik türünü HistogramChart olarak ayarlar ve bir `EmbeddedHistogramChartBuilder` döndürür.
`asLineChart()`	`EmbeddedLineChartBuilder`	Grafik türünü LineChart olarak ayarlar ve bir `EmbeddedLineChartBuilder` döndürür.
`asPieChart()`	`EmbeddedPieChartBuilder`	Grafik türünü PieChart olarak ayarlar ve bir `EmbeddedPieChartBuilder` döndürür.
`asScatterChart()`	`EmbeddedScatterChartBuilder`	Grafik türünü ScatterChart olarak ayarlar ve bir `EmbeddedScatterChartBuilder` döndürür.
`asTableChart()`	`EmbeddedTableChartBuilder`	Grafik türünü TableChart olarak ayarlar ve bir `EmbeddedTableChartBuilder` döndürür.
`build()`	`EmbeddedChart`	Grafik, üzerinde yapılan tüm değişiklikleri yansıtacak şekilde oluşturulur.
`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`	E-tabloda grafiğin nerede göründüğünü kapsayan grafik `ContainerInfo` değerini döndürür.
`getRanges()`	`Range[]`	Şu anda bu grafik için veri sağlayan aralıkların 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 belirler.
`setMergeStrategy(mergeStrategy)`	`EmbeddedChartBuilder`	Birden fazla aralık olduğunda kullanılacak birleştirme stratejisini belirler.
`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 belirler.
`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`	`EmbeddedChartBuilder`	Grafiğin e-tabloda göründüğü yeri değiştirerek konumu belirler.
`setTransposeRowsAndColumns(transpose)`	`EmbeddedChartBuilder`	Grafiğin satır ve sütunlarının transpoze edilip edilmeyeceğini belirler.

Ayrıntılı dokümanlar

`addRange(range)`

Bu derleyicinin değiştirdiği grafiğe bir aralık ekler. Grafike zaten 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 bu oluşturucu

`asAreaChart()`

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

Return

EmbeddedAreaChartBuilder: Alan grafiği oluşturucu

`asBarChart()`

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

Return

EmbeddedBarChartBuilder: Çubuk grafik oluşturucu

`asColumnChart()`

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

Return

EmbeddedColumnChartBuilder: sütun grafiği oluşturucu

`asComboChart()`

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

Return

EmbeddedComboChartBuilder: Karma grafik oluşturucu

`asHistogramChart()`

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

Return

EmbeddedHistogramChartBuilder: histogram grafiği oluşturucu

`asLineChart()`

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

Return

EmbeddedLineChartBuilder: Çizgi grafik oluşturucu

`asPieChart()`

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

Return

EmbeddedPieChartBuilder: Pasta grafiği oluşturucu

`asScatterChart()`

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

Return

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

`asTableChart()`

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

Return

EmbeddedTableChartBuilder: Tablo grafiği oluşturucu

`build()`

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

Bu yöntem, grafiği e-tablonun üzerine otomatik olarak çizmez. Yeni bir grafik sheet.insertChart(chart) aracılığıyla, mevcut bir grafik ise sheet.updateChart(chart) aracılığıyla eklenmelidir.

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 (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 bu oluşturucu

`getChartType()`

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

Return

ChartType: Grafik türü

`getContainer()`

E-tabloda grafiğin nerede göründüğünü 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ısının konumunu içeren bir nesne

`getRanges()`

Şu anda bu grafik için veri sağlayan aralıkların listesinin bir kopyasını döndürür. Bu listeyi değiştirmek için addRange(range) ve removeRange(range) simgesini 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 will render 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
// will not be removed, and will 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ılacağı aralık.

Return

EmbeddedChartBuilder: zincirleme için bu oluşturucu

`setChartType(type)`

Grafik türünü değiştirir. Şu anda tüm yerleşik grafik türleri desteklenmiyor. Ş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 bu oluşturucu

`setHiddenDimensionStrategy(strategy)`

Gizli satırlar ve sütunlar için kullanılacak stratejiyi belirler. 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 bu oluşturucu

`setMergeStrategy(mergeStrategy)`

Birden fazla aralık olduğunda kullanılacak birleştirme stratejisini belirler. 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 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`	Üstbilgi 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 bu oluşturucu

`setOption(option, value)`

Bu grafik için gelişmiş seçenekleri belirler. Mevcut seçeneklerin listesini görüntülemek için Grafiğin 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çim/yapıda olup olmadığını doğrulamaz.

Bu örnekte, başlığın nasıl değiştirileceği ve bir açıklamanın 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 bu oluşturucu.

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

Grafiğin e-tabloda göründüğü yeri değiştirerek konumu belirler. anchorRowPos ve anchorColPos 1'den başlar.

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 tarafı bu satıra sabitlenir.
`anchorColPos`	`Integer`	Grafiğin sol tarafı bu sütuna sabitlenir.
`offsetX`	`Integer`	Grafiğin sağ üst köşesi bu kadar piksel kaydırılır.
`offsetY`	`Integer`	Grafiğin sol alt köşesi bu kadar piksel kaydırılır.

Return

EmbeddedChartBuilder: zincirleme için bu oluşturucu

`setTransposeRowsAndColumns(transpose)`

Grafiğin satır ve sütunlarının transpoze edilip edilmeyeceğini belirler. 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 transpoze edilir.

Return

EmbeddedChartBuilder: zincirleme için bu oluşturucu