Class EmbeddedPieChartBuilder

EmbeddedPieChartBuilder

Pasta grafik oluşturucu. Daha fazla ayrıntı için Gviz belgelerine bakın.

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.
reverseCategories()EmbeddedPieChartBuilderAlan eksenindeki seri çizimini tersine çevirir.
set3D()EmbeddedPieChartBuilderGrafiği üç boyutlu olacak şekilde ayarlar.
setBackgroundColor(cssValue)EmbeddedPieChartBuilderGrafiğin arka plan rengini ayarlar.
setChartType(type)EmbeddedChartBuilderGrafik türünü değiştirir.
setColors(cssValues)EmbeddedPieChartBuilderGrafikteki çizgilerin renklerini ayarlar.
setHiddenDimensionStrategy(strategy)EmbeddedChartBuilderGizli satırlar ve sütunlar için kullanılacak stratejiyi ayarlar.
setLegendPosition(position)EmbeddedPieChartBuilderGöstergenin grafiğe göre konumunu ayarlar.
setLegendTextStyle(textStyle)EmbeddedPieChartBuilderGrafik açıklamasının metin stilini 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.
setTitle(chartTitle)EmbeddedPieChartBuilderGrafiğin başlığını ayarlar.
setTitleTextStyle(textStyle)EmbeddedPieChartBuilderGrafik başlığının metin stilini ayarlar.
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


reverseCategories()

Alan eksenindeki seri çizimini tersine çevirir. Dikey aralıklı grafiklerde (çizgi, alan veya sütun grafikler gibi) yatay eksen, sağdan sola doğru çizilir. Bu, yatay aralıklı grafiklerde (çubuk grafikler gibi) dikey eksenin yukarıdan aşağıya doğru çizildiği anlamına gelir. Pasta grafiklerde bu, dilimlerin saat yönünün tersine çizileceği anlamına gelir.

// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner.
var builder = Charts.newPieChart();
builder.reverseCategories();

Return

EmbeddedPieChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


set3D()

Grafiği üç boyutlu olacak şekilde ayarlar.

Return

EmbeddedPieChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setBackgroundColor(cssValue)

Grafiğin arka plan rengini ayarlar.

// Creates a line chart builder and sets the background color to gray
var builder = Charts.newLineChart();
builder.setBackgroundColor("gray");

Parametreler

AdTürAçıklama
cssValueStringRengin CSS değeri ("blue" veya "#00f" gibi).

Return

EmbeddedPieChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


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


setColors(cssValues)

Grafikteki çizgilerin renklerini ayarlar.

// Creates a line chart builder and sets the first two lines to be drawn in green and red,
// respectively.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

Parametreler

AdTürAçıklama
cssValuesString[]["red", "#acf"] gibi renk CSS değerleri dizisi. Dizideki n'inci öğe, grafikteki n'inci çizginin rengini temsil eder.

Return

EmbeddedPieChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


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


setLegendPosition(position)

Göstergenin grafiğe göre konumunu ayarlar. Varsayılan olarak gösterge yoktur.

// Creates a line chart builder and sets the legend position to right.
var builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

Parametreler

AdTürAçıklama
positionPositionAçıklamaların konumu.

Return

EmbeddedPieChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setLegendTextStyle(textStyle)

Grafik açıklamasının metin stilini ayarlar.

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

Parametreler

AdTürAçıklama
textStyleTextStyleGrafik açıklaması için kullanılacak metin stili.

Return

EmbeddedPieChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


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


setTitle(chartTitle)

Grafiğin başlığını ayarlar. Başlık, grafiğin üstünde ortalanmış olarak görüntülenir.

// Creates a line chart builder and title to 'My Line Chart'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')

Parametreler

AdTürAçıklama
chartTitleStringgrafik başlığı.

Return

EmbeddedPieChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setTitleTextStyle(textStyle)

Grafik başlığının metin stilini ayarlar.

// Creates a line chart builder and sets it up for a  blue, 26-point title.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

Parametreler

AdTürAçıklama
textStyleTextStyleGrafik başlığı için kullanılacak metin stili. Charts.newTextStyle() yöntemini çağırarak TextStyleBuilder nesnesi oluşturabilirsiniz.

Return

EmbeddedPieChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


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