Class EmbeddedTableChartBuilder

EmbeddedTableChartBuilder

Tablo grafikleri oluşturucu. Daha ayrıntılı bilgi için Gviz dokümanlarını inceleyin.

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.
enablePaging(enablePaging)EmbeddedTableChartBuilderVerilerde sayfalandırmanın etkinleştirilip etkinleştirilmeyeceğini ayarlar.
enablePaging(pageSize)EmbeddedTableChartBuilderSayfalara ayırma özelliğini etkinleştirir ve her sayfadaki satır sayısını ayarlar.
enablePaging(pageSize, startPage)EmbeddedTableChartBuilderSayfalara ayırmayı etkinleştirir, her bir sayfadaki satır sayısını ve görüntülenecek ilk tablo sayfasını ayarlar sayılar sıfır tabanlıdır).
enableRtlTable(rtlEnabled)EmbeddedTableChartBuilderSağdan sola yazılan diller (ör. Arapça veya İbranice) için sütun sırasına göre, bu sütun sıfır en sağdaki sütun olacak ve son sütun sütuna girin.
enableSorting(enableSorting)EmbeddedTableChartBuilderKullanıcı bir sütun başlığını tıkladığında sütunların sıralanıp sıralanmayacağını ayarlar.
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.
setFirstRowNumber(number)EmbeddedTableChartBuilderVeri tablosundaki ilk satırın satır numarasını ayarlar.
setHiddenDimensionStrategy(strategy)EmbeddedChartBuilderGizli satırlar ve sütunlar için kullanılacak stratejiyi ayarlar.
setInitialSortingAscending(column)EmbeddedTableChartBuilderTablonun başlangıçta sıralanması gereken sütunun dizinini ayarlar (artan).
setInitialSortingDescending(column)EmbeddedTableChartBuilderTablonun başlangıçta sıralanması gereken sütunun dizinini ayarlar (azalan).
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.
showRowNumberColumn(showRowNumber)EmbeddedTableChartBuilderTablonun ilk sütunu olarak satır numarasının gösterilip gösterilmeyeceğini ayarlar.
useAlternatingRowStyle(alternate)EmbeddedTableChartBuilderTablo grafiğindeki tek ve çift satırlarına alternatif renk stilinin atanıp atanmayacağı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


enablePaging(enablePaging)

Verilerde sayfalandırmanın etkinleştirilip etkinleştirilmeyeceğini ayarlar.

Varsayılan davranış, sayfalama devre dışıdır. Sayfalara ayırma etkinse varsayılan sayfa boyutu 10 olur.

Parametreler

AdTürAçıklama
enablePagingBooleanSayfalara ayırmanın etkinleştirilmesi gerekiyorsa true, aksi takdirde false.

Return

EmbeddedTableChartBuilder — Zincirleme işlemleri için kullanışlı bu oluşturucu.


enablePaging(pageSize)

Sayfalara ayırma özelliğini etkinleştirir ve her sayfadaki satır sayısını ayarlar.

Varsayılan sayfa boyutu 10'dur.

// Creates a table chart builder and enables paging with page size of 5.
var builder = Charts.newTableChart();
builder.enablePaging(5);

Parametreler

AdTürAçıklama
pageSizeIntegerTablonun her sayfasındaki satır sayısı.

Return

EmbeddedTableChartBuilder — Zincirleme işlemleri için kullanışlı bu oluşturucu.


enablePaging(pageSize, startPage)

Sayfalara ayırmayı etkinleştirir, her bir sayfadaki satır sayısını ve görüntülenecek ilk tablo sayfasını ayarlar sayılar sıfır tabanlıdır).

Varsayılan sayfa boyutu 10, varsayılan başlangıç sayfası boyutu 0'dır.

// Creates a table chart builder and enables paging with page size of 5 and displays page 2
// first.
var builder = Charts.newTableChart();
builder.enablePaging(5, 2);

Parametreler

AdTürAçıklama
pageSizeIntegerTablonun her sayfasındaki satır sayısı.
startPageIntegerGörüntülenecek ilk tablo sayfası (sayfa numaraları sıfır tabanlıdır).

Return

EmbeddedTableChartBuilder — Zincirleme işlemleri için kullanışlı bu oluşturucu.


enableRtlTable(rtlEnabled)

Sağdan sola yazılan diller (ör. Arapça veya İbranice) için sütun sırasına göre, bu sütun sıfır en sağdaki sütun olacak ve son sütun sütuna girin.

Bu durum, temel verilerdeki sütun dizinini etkilemez, yalnızca görüntülenme sırasını etkiler. Tam çift yönlü (BiDi) dil görüntüleme, tablo görselleştirme tarafından seçim yapabilirsiniz. Bu seçenek, sayfalandırmayı etkinleştirirseniz (sayfa seçeneğini kullanarak) veya Yükseklik ve genişlik seçeneklerini boyutu belirleyin. Varsayılan davranış, RTL desteğinin devre dışı olmasıdır.

Parametreler

AdTürAçıklama
rtlEnabledBooleanSağdan sola desteğin etkinleştirilmesi gerekiyorsa true, false aksi takdirde.

Return

EmbeddedTableChartBuilder — Zincirleme işlemleri için kullanışlı bu oluşturucu.


enableSorting(enableSorting)

Kullanıcı bir sütun başlığını tıkladığında sütunların sıralanıp sıralanmayacağını ayarlar.

Sıralama etkinse kullanıcılar sütun başlığını tıkladığında satırlar otomatik olarak açılır sıralandı. Varsayılan davranış, sıralama etkindir.

Parametreler

AdTürAçıklama
enableSortingBooleanSütun başlıklarını tıklayarak sıralamayı etkinleştirmek için true, aksi takdirde false tuşlarına basın.

Return

EmbeddedTableChartBuilder — Zincirleme işlemleri için kullanışlı 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


setFirstRowNumber(number)

Veri tablosundaki ilk satırın satır numarasını ayarlar.

İlk satırın varsayılan satır numarası 1'dir.

// Creates a table chart builder and sets the first row to be 2.
var builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

Parametreler

AdTürAçıklama
numberIntegerVeri tablosundaki ilk satırın numarası.

Return

EmbeddedTableChartBuilder — Zincirleme işlemleri için kullanışlı 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


setInitialSortingAscending(column)

Tablonun başlangıçta sıralanması gereken sütunun dizinini ayarlar (artan).

Sütun işletim sistemi artan düzende sıralanmıştır ve bunu belirten küçük bir okla işaretlenmiştir.

// Creates a table chart builder and sorts it by the second column (ascending).
var builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

Parametreler

AdTürAçıklama
columnIntegerTablonun ilk başta sıralanması gereken sütun numarası.

Return

EmbeddedTableChartBuilder — Zincirleme işlemleri için kullanışlı bu oluşturucu.


setInitialSortingDescending(column)

Tablonun başlangıçta sıralanması gereken sütunun dizinini ayarlar (azalan).

Sütun işletim sistemi azalan düzende sıralanmıştır ve bunu belirten küçük bir okla işaretlenmiştir.

// Creates a table chart builder and sorts it by the second column (descending).
var builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

Parametreler

AdTürAçıklama
columnIntegerTablonun ilk başta sıralanması gereken sütun numarası.

Return

EmbeddedTableChartBuilder — Zincirleme işlemleri için kullanışlı 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


showRowNumberColumn(showRowNumber)

Tablonun ilk sütunu olarak satır numarasının gösterilip gösterilmeyeceğini ayarlar.

Varsayılan davranış, satır numaralarını göstermemektir.

Parametreler

AdTürAçıklama
showRowNumberBooleanTablonun ilk sütununda satır numarası gerekiyorsa true, Aksi takdirde false.

Return

EmbeddedTableChartBuilder — Zincirleme işlemleri için kullanışlı bu oluşturucu.


useAlternatingRowStyle(alternate)

Tablo grafiğindeki tek ve çift satırlarına alternatif renk stilinin atanıp atanmayacağını belirler.

Varsayılan davranış, satırların alternatif renk stiline sahip olmasıdır.

Parametreler

AdTürAçıklama
alternateBooleanRenk stillerinin dönüşümlü olarak kullanılması gerekiyorsa true, aksi takdirde false.

Return

EmbeddedTableChartBuilder — Zincirleme işlemleri için kullanışlı bu oluşturucu.