Class EmbeddedChartBuilder

EmbeddedChartBuilder

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

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

Yöntemler

YöntemDönüş türüKısa açıklama
addRange(range)EmbeddedChartBuilderBu oluşturucunun değiştirdiği grafiğe bir aralık ekler.
asAreaChart()EmbeddedAreaChartBuilderGrafik türünü FieldChart olarak ayarlar ve EmbeddedAreaChartBuilder değerini döndürür.
asBarChart()EmbeddedBarChartBuilderGrafik türünü BarChart olarak ayarlar ve EmbeddedBarChartBuilder değerini döndürür.
asColumnChart()EmbeddedColumnChartBuilderGrafik türünü ColumnChart olarak ayarlar ve EmbeddedColumnChartBuilder döndürür.
asComboChart()EmbeddedComboChartBuilderGrafik türünü ComboChart olarak ayarlar ve EmbeddedComboChartBuilder değerini döndürür.
asHistogramChart()EmbeddedHistogramChartBuilderGrafik türünü HistogramChart olarak ayarlar ve EmbeddedHistogramChartBuilder değerini döndürür.
asLineChart()EmbeddedLineChartBuilderGrafik türünü Çizgi Grafik olarak ayarlar ve bir EmbeddedLineChartBuilder döndürür.
asPieChart()EmbeddedPieChartBuilderGrafik türünü PieChart olarak ayarlar ve EmbeddedPieChartBuilder değerini döndürür.
asScatterChart()EmbeddedScatterChartBuilderGrafik türünü ScatterChart olarak ayarlar ve bir EmbeddedScatterChartBuilder döndürür.
asTableChart()EmbeddedTableChartBuilderGrafik türünü TableChart olarak ayarlar ve bir EmbeddedTableChartBuilder döndürür.
build()EmbeddedChartGrafiği, üzerinde yapılan tüm değişiklikleri yansıtacak şekilde oluşturur.
clearRanges()EmbeddedChartBuilderBu oluşturucunun değiştirdiği grafikteki tüm aralıkları kaldırır.
getChartType()ChartTypeGeçerli grafik türünü döndürür.
getContainer()ContainerInfoGrafiğin bulunduğu yeri içeren ContainerInfo grafiğini döndürün: sayfasına gitmelidir.
getRanges()Range[]Şu anda bu grafik için veri sağlayan aralık listesinin bir kopyasını döndürür.
removeRange(range)EmbeddedChartBuilderBelirtilen aralığı bu oluşturucunun değiştirdiği grafikten kaldırır.
setChartType(type)EmbeddedChartBuilderGrafik türünü değiştirir.
setHiddenDimensionStrategy(strategy)EmbeddedChartBuilderGizli satırlar ve sütunlar için kullanılacak stratejiyi ayarlar.
setMergeStrategy(mergeStrategy)EmbeddedChartBuilderBirden fazla aralık olduğunda kullanılacak birleştirme stratejisini ayarlar.
setNumHeaders(headers)EmbeddedChartBuilderAralıktaki başlık olarak işlenmesi gereken satır veya sütun sayısını ayarlar.
setOption(option, value)EmbeddedChartBuilderBu grafik için gelişmiş seçenekleri ayarlar.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)EmbeddedChartBuilderKonumu ayarlayarak grafiğin sayfada göründüğü yeri değiştirir.
setTransposeRowsAndColumns(transpose)EmbeddedChartBuilderGrafikteki satır ve sütunların ters çevrilmiş olup olmadığını belirler.

Ayrıntılı belgeler

addRange(range)

Bu oluşturucunun değiştirdiği grafiğe bir aralık ekler. Zaten eklenmişse aralığı eklemez grafiğe eklenir.

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

sheet.insertChart(chart);

Parametreler

AdTürAçıklama
rangeRangeEklenecek aralık.

Return

EmbeddedChartBuilder — zincirleme için bu oluşturucu


asAreaChart()

Grafik türünü FieldChart olarak ayarlar ve EmbeddedAreaChartBuilder değerini döndürür.

Return

EmbeddedAreaChartBuilder - alan grafiği oluşturma aracı


asBarChart()

Grafik türünü BarChart olarak ayarlar ve EmbeddedBarChartBuilder değerini 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 grafik oluşturucu


asComboChart()

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

Return

EmbeddedComboChartBuilder: Karma grafik oluşturucu


asHistogramChart()

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

Return

EmbeddedHistogramChartBuilder - histogram grafik oluşturucu


asLineChart()

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

Return

EmbeddedLineChartBuilder - çizgi grafik oluşturucu


asPieChart()

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

Return

EmbeddedPieChartBuilder - pasta grafik oluşturucu


asScatterChart()

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

Return

EmbeddedScatterChartBuilder - dağılım grafiği için oluşturucu


asTableChart()

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

Return

EmbeddedTableChartBuilder: tablo grafik oluşturucu


build()

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

Bu yöntem, grafiği otomatik olarak e-tablonun üstüne çizmez. Yeni grafik sheet.insertChart(chart) aracılığıyla eklenmeli ve mevcut bir grafik güncellenmelidir sheet.updateChart(chart) üzerinden.

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

sheet.insertChart(chart);

Return

EmbeddedChart: Oluşturulan ve yine de e-tabloya eklenmesi gereken grafik


clearRanges()

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

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

// This code updates the chart to use only the new ranges while preserving the existing
// formatting of the chart.
var chart = sheet.getCharts()[0];
var 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()

Grafiğin bulunduğu yeri içeren ContainerInfo grafiğini döndürün: sayfasına gitmelidir.

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

var 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()
var containerInfo = chartBuilder.getContainer();

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


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) öğelerini kullanın.

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

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

var ranges = chartBuilder.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[] : Oluşturulacak grafik olarak kullanılacak bir aralık dizisi


removeRange(range)

Belirtilen aralığı bu oluşturucunun değiştirdiği grafikten kaldırır. Şu durumda hata bildirmez: aralık bu grafikte değil.

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, değerleri kısmen kaldırmak için kullanılamaz seçim yapabilirsiniz.

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

var firstRange = sheet.getRange("A1:B5");
var secondRange = sheet.getRange("A6:B8");

var 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"));

var chart = chartBuilder.build();

sheet.insertChart(chart);

Parametreler

AdTürAçıklama
rangeRangeKaldırılacak aralık.

Return

EmbeddedChartBuilder — zincirleme için bu oluşturucu


setChartType(type)

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

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

sheet.insertChart(chart);

Parametreler

AdTürAçıklama
typeChartTypeBu grafiğin değiştirileceği tür.

Return

EmbeddedChartBuilder — zincirleme için 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.

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

sheet.insertChart(chart);

Parametreler

AdTürAçıklama
strategyChartHiddenDimensionStrategyGizli 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 ayarlar. MERGE_ROWS ise satırlar 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("C:C10");
var 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

AdTürAçıklama
mergeStrategyChartMergeStrategyKullanılacak birleştirme stratejisi.

Return

EmbeddedChartBuilder — zincirleme için bu oluşturucu


setNumHeaders(headers)

Aralıktaki başlık olarak işlenmesi gereken satır veya sütun sayısını ayarlar.

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

sheet.insertChart(chart);

Parametreler

AdTürAçıklama
headersIntegerBaşlık olarak işlenecek satır veya sütun sayısı. Negatif değerler başlıklara neden olur otomatik olarak algılanır.

Return

EmbeddedChartBuilder — zincirleme için 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çeneklerini inceleyin.

Bu yöntem, belirttiğiniz seçeneğin bu grafik türü için geçerli olduğunu ya da değerinin doğru biçimde/yapıda olmasını sağlayın.

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

builder.setOption('title', 'Earnings projections');
builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});

Parametreler

AdTürAçıklama
optionStringSeçeneğin adı.
valueObjectSeçeneğin değeri.

Return

EmbeddedChartBuilder — Zincirleme için bu oluşturucu.


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Konumu ayarlayarak grafiğin sayfada göründüğü yeri değiştirir. anchorRowPos ve anchorColPos 1 dizinli.

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

sheet.insertChart(chart);

Parametreler

AdTürAçıklama
anchorRowPosIntegerGrafiğin üst tarafı bu satıra sabitlenir.
anchorColPosIntegerGrafiğin sol tarafı bu sütuna sabitlenmiştir.
offsetXIntegerGrafiğin sağ üst köşesinin uzaklığı bu piksel kadardır.
offsetYIntegerGrafiğin sol alt köşesinin uzaklığı bu piksel kadardır.

Return

EmbeddedChartBuilder — zincirleme için bu oluşturucu


setTransposeRowsAndColumns(transpose)

Grafikteki satır ve sütunların ters çevrilmiş olup olmadığını belirler. true değerine ayarlanırsa satırlar ve sütunları değiştirilir. Varsayılan olarak false 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)
    .setTransposeRowsAndColumns(true)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parametreler

AdTürAçıklama
transposeBooleantrue ise grafiği oluşturmak için kullanılan satırlar ve sütunlar ters çevrildi.

Return

EmbeddedChartBuilder — zincirleme için bu oluşturucu