Class EmbeddedChartBuilder

EmbeddedChartBuilder

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

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ü AreaChart olarak ayarlar ve EmbeddedAreaChartBuilder 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 döndürür.
asHistogramChart()EmbeddedHistogramChartBuilderGrafik türünü HistogramChart olarak ayarlar ve EmbeddedHistogramChartBuilder sonucunu döndürür.
asLineChart()EmbeddedLineChartBuilderGrafik türünü Çizgi Grafik olarak ayarlar ve EmbeddedLineChartBuilder değerini döndürür.
asPieChart()EmbeddedPieChartBuilderGrafik türünü Pasta Grafik 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 grafikten tüm aralıkları kaldırır.
getChartType()ChartTypeGeçerli grafik türünü döndürür.
getContainer()ContainerInfoGrafiğin sayfada nerede göründüğünü gösteren ContainerInfo grafiğini döndürün.
getRanges()Range[]Bu grafik için halihazırda 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ıkta başlık olarak ele alınması gereken satır veya sütun sayısını belirler.
setOption(option, value)EmbeddedChartBuilderBu grafik için gelişmiş seçenekleri belirler.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)EmbeddedChartBuilderKonumu ayarlar ve grafiğin sayfada göründüğü yeri değiştirir.
setTransposeRowsAndColumns(transpose)EmbeddedChartBuilderGrafikteki satır ve sütunların yer değiştirilip yer değiştirilmeyeceğini belirler.

Ayrıntılı belgeler

addRange(range)

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

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 bağlantı için bu derleyici


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 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 döndürür.

Return

EmbeddedComboChartBuilder: Karma grafik oluşturucu


asHistogramChart()

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

Return

EmbeddedHistogramChartBuilder - histogram grafik oluşturucu


asLineChart()

Grafik türünü Çizgi Grafik olarak ayarlar ve EmbeddedLineChartBuilder değerini döndürür.

Return

EmbeddedLineChartBuilder - çizgi grafik oluşturucu


asPieChart()

Grafik türünü Pasta Grafik 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 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()

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

Bu yöntemde, grafik otomatik olarak e-tablonun üzerine çizmez. sheet.insertChart(chart) aracılığıyla yeni bir grafik eklenmeli ve mevcut bir grafik sheet.updateChart(chart) aracılığıyla güncellenmelidir.

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 grafik (yine de e-tabloya eklenmesi gerekir)


clearRanges()

Bu oluşturucunun değiştirdiği grafikten 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 bağlantı için bu derleyici


getChartType()

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

Return

ChartType: grafik türü


getContainer()

Grafiğin sayfada nerede göründüğünü gösteren ContainerInfo grafiğini döndürü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);

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

Bu grafik için halihazırda veri sağlayan aralık listesinin bir kopyasını döndürür. Bu listede değişiklik yapmak 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 aralık dizisi


removeRange(range)

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

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

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 bağlantı için bu derleyici


setChartType(type)

Grafik türünü değiştirir. Tüm yerleştirilmiş grafik türleri ş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 bağlantı için bu derleyici


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 bağlantı için bu derleyici


setMergeStrategy(mergeStrategy)

Birden fazla aralık olduğunda kullanılacak birleştirme stratejisini ayarlar. MERGE_ROWS değeri kullanıldığında satırlar birleştirilir, MERGE_COLUMNS değerinde 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 bağlantı için bu derleyici


setNumHeaders(headers)

Aralıkta başlık olarak ele alınması gereken satır veya sütun sayısını belirler.

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 ele alınacak satır veya sütun sayısı. Negatif değerler, başlıkların otomatik olarak algılanmasına neden olur.

Return

EmbeddedChartBuilder — zincirleme bağlantı için bu derleyici


setOption(option, value)

Bu grafik için gelişmiş seçenekleri belirler. Kullanılabilir seçeneklerin listesini görüntülemek için Grafik yapılandırma seçenekleri konusuna bakın.

Bu yöntem, belirttiğiniz seçeneğin bu grafik türü için geçerli olduğunu 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 göstergenin nasıl 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 ayarlar ve grafiğin sayfada göründüğü yeri değiştirir. anchorRowPos ve anchorColPos 1 dizine eklendi.

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 sabitlenmiştir.
anchorColPosIntegerGrafiğin sol tarafı bu sütuna sabitlenmiştir.
offsetXIntegerGrafiğin sağ üst köşesinin uzaklığı bu kadar pikseldir.
offsetYIntegerGrafiğin sol alt köşesinin uzaklığı bu kadar pikseldir.

Return

EmbeddedChartBuilder — zincirleme bağlantı için bu derleyici


setTransposeRowsAndColumns(transpose)

Grafikteki satır ve sütunların yer değiştirilip yer değiştirilmeyeceğini 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 çevrilmiştir.

Return

EmbeddedChartBuilder — zincirleme bağlantı için bu derleyici