Tablo grafikleri için oluşturucu. Daha fazla bilgi için Gviz belgelerini inceleyin.
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
add | Embedded | Bu oluşturucunun değiştirdiği grafiğe bir aralık ekler. |
as | Embedded | Grafik türünü AreaChart olarak ayarlar ve Embedded döndürür. |
as | Embedded | Grafik türünü BarChart olarak ayarlar ve Embedded döndürür. |
as | Embedded | Grafik türünü ColumnChart olarak ayarlar ve Embedded döndürür. |
as | Embedded | Grafik türünü ComboChart olarak ayarlar ve Embedded döndürür. |
as | Embedded | Grafik türünü HistogramChart olarak ayarlar ve Embedded döndürür. |
as | Embedded | Grafik türünü LineChart olarak ayarlar ve Embedded döndürür. |
as | Embedded | Grafik türünü PieChart olarak ayarlar ve Embedded döndürür. |
as | Embedded | Grafik türünü ScatterChart olarak ayarlar ve Embedded döndürür. |
as | Embedded | Grafik türünü TableChart olarak ayarlar ve Embedded döndürür. |
build() | Embedded | Grafiği, üzerinde yapılan tüm değişiklikleri yansıtacak şekilde oluşturur. |
clear | Embedded | Bu oluşturucunun değiştirdiği grafikteki tüm aralıkları kaldırır. |
enable | Embedded | Verilerde sayfalara ayırma özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirler. |
enable | Embedded | Sayfalara ayırmayı etkinleştirir ve her sayfadaki satır sayısını ayarlar. |
enable | Embedded | Sayfalandırmayı etkinleştirir, her sayfadaki satır sayısını ve görüntülenecek ilk tablo sayfasını ayarlar (sayfa numaraları sıfır tabanlıdır). |
enable | Embedded | Tablonun sütun sırasını tersine çevirerek sağdan sola okunan diller (ör. Arapça veya İbranice) için temel destek ekler. Böylece sıfırıncı sütun en sağdaki sütun, son sütun ise en soldaki sütun olur. |
enable | Embedded | Kullanıcı bir sütun başlığını tıkladığında sütunların sıralanıp sıralanmayacağını ayarlar. |
get | Chart | Geçerli grafik türünü döndürür. |
get | Container | Grafiğin sayfada göründüğü yeri kapsayan grafik Container değerini döndürür. |
get | Range[] | Şu anda bu grafik için veri sağlayan aralık listesinin bir kopyasını döndürür. |
remove | Embedded | Belirtilen aralığı, bu oluşturucunun değiştirdiği grafikten kaldırır. |
set | Embedded | Grafik türünü değiştirir. |
set | Embedded | Veri tablosundaki ilk satırın satır numarasını ayarlar. |
set | Embedded | Gizli satırlar ve sütunlar için kullanılacak stratejiyi ayarlar. |
set | Embedded | Tablonun başlangıçta sıralanacağı sütunun dizinini (artan) ayarlar. |
set | Embedded | Tablonun başlangıçta sıralanacağı sütunun dizinini (azalan) ayarlar. |
set | Embedded | Birden fazla aralık olduğunda kullanılacak birleştirme stratejisini ayarlar. |
set | Embedded | Aralığın başlık olarak değerlendirilmesi gereken satır veya sütun sayısını ayarlar. |
set | Embedded | Bu grafik için gelişmiş seçenekleri ayarlar. |
set | Embedded | Grafiğin sayfada görüneceği yeri değiştirerek konumunu ayarlar. |
set | Embedded | Grafiğin satır ve sütunlarının transpoze edilip edilmeyeceğini ayarlar. |
show | Embedded | Satır numarasının tablonun ilk sütunu olarak gösterilip gösterilmeyeceğini ayarlar. |
use | Embedded | Tablo grafiğin tek ve çift satırlarına alternatif renk stilinin atanıp atanmayacağını ayarlar. |
Ayrıntılı belgeler
addRange(range)
Bu oluşturucunun değiştirdiği grafiğe bir aralık ekler. Grafiğe daha önce 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 kullanılan bu oluşturucu.
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 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 grafiği 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 döndürür.
Return
EmbeddedHistogramChartBuilder: Histogram grafiği oluşturucu.
asLineChart()
Grafik türünü LineChart olarak ayarlar ve EmbeddedLineChartBuilder döndürür.
Return
EmbeddedLineChartBuilder: Çizgi grafik oluşturucu.
asPieChart()
Grafik türünü PieChart olarak ayarlar ve EmbeddedPieChartBuilder döndürür.
Return
EmbeddedPieChartBuilder: Pasta grafiği oluşturucu.
asScatterChart()
Grafik türünü ScatterChart olarak ayarlar ve EmbeddedScatterChartBuilder döndürür.
Return
EmbeddedScatterChartBuilder: Dağılım grafiği oluşturucu.
asTableChart()
Grafik türünü TableChart olarak ayarlar ve 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, e-tablonun üzerine otomatik olarak çizilmez. Yeni bir grafik sheet.insertChart(chart) kullanılarak eklenmeli, mevcut bir grafik ise sheet.updateChart(chart) kullanılarak güncellenmelidir.
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. Bu 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 kullanılan bu oluşturucu.
enablePaging(enablePaging)
Verilerde sayfalara ayırma özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirler.
Varsayılan davranış, sayfalama devre dışı şeklindedir. Sayfalara ayırma etkinse varsayılan sayfa boyutu 10'dur.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
enable | Boolean | Sayfalama etkinleştirilecekse true, aksi takdirde false. |
Return
EmbeddedTableChartBuilder: Zincirleme için kullanışlı olan bu oluşturucu.
enablePaging(pageSize)
Sayfalara ayırmayı 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. const builder = Charts.newTableChart(); builder.enablePaging(5);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
page | Integer | Tablonun her sayfasındaki satır sayısı. |
Return
EmbeddedTableChartBuilder: Zincirleme için kullanışlı olan bu oluşturucu.
enablePaging(pageSize, startPage)
Sayfalandırmayı etkinleştirir, her sayfadaki satır sayısını ve görüntülenecek ilk tablo sayfasını ayarlar (sayfa numaraları sıfır tabanlıdır).
Varsayılan sayfa boyutu 10, varsayılan başlangıç sayfası ise 0'dır.
// Creates a table chart builder and enables paging with page size of 5 and // displays page 2 first. const builder = Charts.newTableChart(); builder.enablePaging(5, 2);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
page | Integer | Tablonun her sayfasındaki satır sayısı. |
start | Integer | Gösterilecek ilk tablo sayfası (sayfa numaraları sıfır tabanlıdır). |
Return
EmbeddedTableChartBuilder: Zincirleme için kullanışlı olan bu oluşturucu.
enableRtlTable(rtlEnabled)
Tablonun sütun sırasını tersine çevirerek sağdan sola okunan diller (ör. Arapça veya İbranice) için temel destek ekler. Böylece sıfırıncı sütun en sağdaki sütun, son sütun ise en soldaki sütun olur.
Bu durum, temel verilerdeki sütun dizinini değil, yalnızca görüntüleme sırasını etkiler. Bu seçenekle bile tablo görselleştirmesi tam çift yönlü (BiDi) dil görüntülemeyi desteklemez. Sayfalandırmayı etkinleştirirseniz (sayfa seçeneğini kullanarak) veya gerekli tablo boyutundan daha küçük yükseklik ve genişlik seçenekleri belirlediğiniz için tabloda kaydırma çubukları varsa bu seçenek yoksayılır. Varsayılan davranış, sağdan sola dil desteğinin devre dışı bırakılmasıdır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
rtl | Boolean | Sağdan sola dil desteği etkinleştirilmelidirse true, false
aksi takdirde. |
Return
EmbeddedTableChartBuilder: Zincirleme için kullanışlı olan 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 sıralanır. Varsayılan davranış, sıralamanın etkinleştirilmesidir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
enable | Boolean | Sütun başlıklarını tıklayarak sıralamayı etkinleştirmek için true, aksi takdirde false. |
Return
EmbeddedTableChartBuilder: Zincirleme için kullanışlı olan bu oluşturucu.
getChartType()
getContainer()
Grafiğin sayfada göründüğü yeri 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ı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) simgelerini 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 renders 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 // is not removed, and does 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ılacak aralık. |
Return
EmbeddedChartBuilder: Zincirleme için kullanılan bu oluşturucu.
setChartType(type)
Grafik türünü değiştirir. Şu anda tüm yerleştirilmiş grafik türleri desteklenmemektedir. Ş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 | Chart | Bu grafiğin dönüştürüleceği tür. |
Return
EmbeddedChartBuilder: Zincirleme için kullanılan 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. const builder = Charts.newTableChart(); builder.setFirstRowNumber(2);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
number | Integer | Veri tablosundaki ilk satırın satır numarası. |
Return
EmbeddedTableChartBuilder: Zincirleme için kullanışlı olan 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.
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 | Chart | Gizli satırlar ve sütunlar için kullanılacak strateji. |
Return
EmbeddedChartBuilder: Zincirleme için kullanılan bu oluşturucu.
setInitialSortingAscending(column)
Tablonun başlangıçta sıralanacağı sütunun dizinini (artan) ayarlar.
Sütun artan düzende sıralanır ve bunu gösteren küçük bir okla işaretlenir.
// Creates a table chart builder and sorts it by the second column (ascending). const builder = Charts.newTableChart(); builder.setInitialSortingAscending(2);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
column | Integer | Tablonun başlangıçta sıralanması gereken sütunun numarası. |
Return
EmbeddedTableChartBuilder: Zincirleme için kullanışlı olan bu oluşturucu.
setInitialSortingDescending(column)
Tablonun başlangıçta sıralanacağı sütunun dizinini (azalan) ayarlar.
Sütun azalan düzende sıralanır ve bunu gösteren küçük bir okla işaretlenir.
// Creates a table chart builder and sorts it by the second column (descending). const builder = Charts.newTableChart(); builder.setInitialSortingDescending(2);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
column | Integer | Tablonun başlangıçta sıralanması gereken sütunun numarası. |
Return
EmbeddedTableChartBuilder: Zincirleme için kullanışlı olan bu oluşturucu.
setMergeStrategy(mergeStrategy)
Birden fazla aralık olduğunda kullanılacak birleştirme stratejisini ayarlar. 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 |
|---|---|---|
merge | Chart | Kullanılacak birleştirme stratejisi. |
Return
EmbeddedChartBuilder: Zincirleme için kullanılan 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 | Başlık 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 kullanılan 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ç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çimde/yapıda olup olmadığını doğrulamaz.
Bu örnekte, başlığın nasıl değiştirileceği ve bir açıklama metninin 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 kullanılan bu oluşturucu.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
Grafiğin sayfada görüneceği yeri değiştirerek konumunu ayarlar. anchorRowPos ve anchorColPos 1 tabanlıdı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) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
anchor | Integer | Grafiğin üst kısmı bu satıra sabitlenir. |
anchor | Integer | Grafiğin sol tarafı bu sütuna sabitlenir. |
offsetX | Integer | Grafiğin sağ üst köşesi bu kadar pikselle kaydırılır. |
offsetY | Integer | Grafiğin sol alt köşesi bu kadar pikselle kaydırılır. |
Return
EmbeddedChartBuilder: Zincirleme için kullanılan bu oluşturucu.
setTransposeRowsAndColumns(transpose)
Grafiğin satır ve sütunlarının transpoze edilip edilmeyeceğini ayarlar. 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
devrik olur. |
Return
EmbeddedChartBuilder: Zincirleme için kullanılan bu oluşturucu.
showRowNumberColumn(showRowNumber)
Satır numarasının tablonun ilk sütunu olarak gösterilip gösterilmeyeceğini ayarlar.
Varsayılan davranış, satır numaralarını göstermemektir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
show | Boolean | Tablonun ilk sütununda satır numarası gösterilecekse true,
aksi takdirde false. |
Return
EmbeddedTableChartBuilder: Zincirleme için kullanışlı olan bu oluşturucu.
useAlternatingRowStyle(alternate)
Tablo grafiğin tek ve çift satırlarına alternatif renk stilinin atanıp atanmayacağını ayarlar.
Varsayılan davranış, satırların alternatif renk stiline sahip olmasıdır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
alternate | Boolean | Renk stilleri alternatifli olmalıysa true, aksi takdirde false. |
Return
EmbeddedTableChartBuilder: Zincirleme için kullanışlı olan bu oluşturucu.