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 derleyicinin 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ı belirler. |
Ayrıntılı belgeler
add Range(range)
Bu derleyicinin 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
Embedded
: Zincirleme için kullanılan bu oluşturucu.
as Area Chart()
Grafik türünü AreaChart olarak ayarlar ve Embedded
döndürür.
Return
Embedded
: Alan grafiği oluşturucu.
as Bar Chart()
Grafik türünü BarChart olarak ayarlar ve Embedded
döndürür.
Return
Embedded
: Çubuk grafik oluşturucu.
as Column Chart()
Grafik türünü ColumnChart olarak ayarlar ve Embedded
döndürür.
Return
Embedded
: Sütun grafiği oluşturucu.
as Combo Chart()
Grafik türünü ComboChart olarak ayarlar ve Embedded
döndürür.
Return
Embedded
— Karma grafik oluşturucu.
as Histogram Chart()
Grafik türünü HistogramChart olarak ayarlar ve Embedded
döndürür.
Return
Embedded
: Histogram grafiği oluşturucu.
as Line Chart()
Grafik türünü LineChart olarak ayarlar ve Embedded
döndürür.
Return
Embedded
: Çizgi grafiği oluşturucu.
as Pie Chart()
Grafik türünü PieChart olarak ayarlar ve Embedded
döndürür.
Return
Embedded
: Pasta grafik oluşturucu.
as Scatter Chart()
Grafik türünü ScatterChart olarak ayarlar ve Embedded
döndürür.
Return
Embedded
: Dağılım grafiği oluşturucu.
as Table Chart()
Grafik türünü TableChart olarak ayarlar ve Embedded
döndürür.
Return
Embedded
: Tablo grafiği oluşturucu.
build()
Grafiği, üzerinde yapılan tüm değişiklikleri yansıtacak şekilde oluşturur.
Bu yöntem, grafiği e-tablonun üzerine otomatik olarak çizmez. 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
Embedded
: Oluşturulan grafik. Bu grafik, e-tabloya eklenmelidir.
clear Ranges()
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
Embedded
: Zincirleme için kullanılan bu oluşturucu.
enable Paging(enablePaging)
Verilerde sayfalara ayırma özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirler.
Varsayılan davranış, sayfalara ayırmanın devre dışı bırakılmasıdır. 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
Embedded
: Zincirleme için kullanışlı olan bu oluşturucu.
enable Paging(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
Embedded
: Zincirleme için kullanışlı olan bu oluşturucu.
enable Paging(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
Embedded
: Zincirleme için kullanışlı olan bu oluşturucu.
enable Rtl Table(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
Embedded
: Zincirleme için kullanışlı olan bu oluşturucu.
enable Sorting(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
Embedded
: Zincirleme için kullanışlı olan bu oluşturucu.
get Chart Type()
get Container()
Grafiğin sayfada göründüğü yeri kapsayan grafik Container
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
Container
: Grafik kapsayıcının konumunu içeren bir nesne.
get Ranges()
Ş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 add
ve remove
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.
remove Range(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, add
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
Embedded
: Zincirleme için kullanılan bu oluşturucu.
set Chart Type(type)
Grafik türünü değiştirir. Şu anda tüm yerleştirilmiş grafik türleri desteklenmemektedir. Şu sayfaya göz atın: Chart
.
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
Embedded
: Zincirleme için kullanılan bu oluşturucu.
set First Row Number(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
Embedded
: Zincirleme için kullanışlı olan bu oluşturucu.
set Hidden Dimension Strategy(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
Embedded
: Zincirleme için kullanılan bu oluşturucu.
set Initial Sorting Ascending(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
Embedded
: Zincirleme için kullanışlı olan bu oluşturucu.
set Initial Sorting Descending(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
Embedded
: Zincirleme için kullanışlı olan bu oluşturucu.
set Merge Strategy(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
Embedded
: Zincirleme için kullanılan bu oluşturucu.
set Num Headers(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
Embedded
: Zincirleme için kullanılan bu oluşturucu.
set Option(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 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
Embedded
: Zincirleme için kullanılan bu oluşturucu.
set Position(anchorRowPos, anchorColPos, offsetX, offsetY)
Grafiğin sayfada görüneceği yeri değiştirerek konumunu ayarlar. anchor
ve anchor
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 dengelenir. |
Return
Embedded
: Zincirleme için kullanılan bu oluşturucu.
set Transpose Rows And Columns(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
transpoze edilir. |
Return
Embedded
: Zincirleme için kullanılan bu oluşturucu.
show Row Number Column(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
Embedded
: Zincirleme için kullanışlı olan bu oluşturucu.
use Alternating Row Style(alternate)
Tablo grafiğin 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
Ad | Tür | Açıklama |
---|---|---|
alternate | Boolean | Renk stilleri dönüşümlü olmalıdırsa true , aksi takdirde false . |
Return
Embedded
: Zincirleme için kullanışlı olan bu oluşturucu.