Tablo grafikleri için oluşturucu. Daha fazla bilgi için Gviz dokümanlarını 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 bir Embedded döndürür. |
as | Embedded | Grafik türünü BarChart olarak ayarlar ve bir Embedded döndürür. |
as | Embedded | Grafik türünü ColumnChart olarak ayarlar ve bir Embedded döndürür. |
as | Embedded | Grafik türünü ComboChart olarak ayarlar ve bir Embedded döndürür. |
as | Embedded | Grafik türünü HistogramChart olarak ayarlar ve bir Embedded döndürür. |
as | Embedded | Grafik türünü LineChart olarak ayarlar ve bir Embedded döndürür. |
as | Embedded | Grafik türünü PieChart olarak ayarlar ve bir Embedded döndürür. |
as | Embedded | Grafik türünü ScatterChart olarak ayarlar ve bir Embedded döndürür. |
as | Embedded | Grafik türünü TableChart olarak ayarlar ve bir Embedded döndürür. |
build() | Embedded | Grafik, üzerinde yapılan tüm değişiklikleri yansıtacak şekilde oluşturulur. |
clear | Embedded | Bu oluşturucunun değiştirdiği grafikteki tüm aralıkları kaldırır. |
enable | Embedded | Veriler arasında sayfalama özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirler. |
enable | Embedded | Sayfalamayı etkinleştirir ve her sayfadaki satır sayısını ayarlar. |
enable | Embedded | Sayfalamayı 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ı olur). |
enable | Embedded | Tablonun sütun düzenini tersine çevirerek sağdan sola yazılan diller (Arapça veya İbranice gibi) için temel destek ekler. Böylece sıfır sütunu 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ı belirler. |
get | Chart | Geçerli grafik türünü döndürür. |
get | Container | E-tabloda grafiğin nerede göründüğünü kapsayan grafik Container değerini döndürür. |
get | Range[] | Şu anda bu grafik için veri sağlayan aralıkların 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 belirler. |
set | Embedded | Tablonun başlangıçta hangi sütuna göre sıralanması gerektiğini (artan) belirten dizin. |
set | Embedded | Tablonun başlangıçta hangi sütuna göre sıralanması gerektiğini (azalan) belirten dizin. |
set | Embedded | Birden fazla aralık olduğunda kullanılacak birleştirme stratejisini belirler. |
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 belirler. |
set | Embedded | Grafiğin e-tabloda göründüğü yeri değiştirerek konumu belirler. |
set | Embedded | Grafiğin satır ve sütunlarının transpoze edilip edilmeyeceğini belirler. |
show | Embedded | Satır numarasının tablonun ilk sütunu olarak gösterilip gösterilmeyeceğini ayarlar. |
use | Embedded | Tablo grafiğinin tek ve çift satırlarına alternatif renk stilinin atanıp atanmayacağını belirler. |
Ayrıntılı dokümanlar
add Range(range)
Bu derleyicinin değiştirdiği grafiğe bir aralık ekler. Grafike zaten 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 bu oluşturucu
as Area Chart()
Grafik türünü AreaChart olarak ayarlar ve bir Embedded
döndürür.
Return
Embedded
: Alan grafiği oluşturucu
as Bar Chart()
Grafik türünü BarChart olarak ayarlar ve bir Embedded
döndürür.
Return
Embedded
: Çubuk grafik oluşturucu
as Column Chart()
Grafik türünü ColumnChart olarak ayarlar ve bir Embedded
döndürür.
Return
Embedded
: sütun grafiği oluşturucu
as Combo Chart()
Grafik türünü ComboChart olarak ayarlar ve bir Embedded
döndürür.
Return
Embedded
: Karma grafik oluşturucu
as Histogram Chart()
Grafik türünü HistogramChart olarak ayarlar ve bir Embedded
döndürür.
Return
Embedded
: histogram grafiği oluşturucu
as Line Chart()
Grafik türünü LineChart olarak ayarlar ve bir Embedded
döndürür.
Return
Embedded
: Çizgi grafik oluşturucu
as Pie Chart()
Grafik türünü PieChart olarak ayarlar ve bir Embedded
döndürür.
Return
Embedded
: Pasta grafiği oluşturucu
as Scatter Chart()
Grafik türünü ScatterChart olarak ayarlar ve bir 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 bir Embedded
döndürür.
Return
Embedded
: Tablo grafiği oluşturucu
build()
Grafik, üzerinde yapılan tüm değişiklikleri yansıtacak şekilde oluşturulur.
Bu yöntem, grafiği e-tablonun üzerine otomatik olarak çizmez. Yeni bir grafik sheet.insertChart(chart)
aracılığıyla, mevcut bir grafik ise sheet.updateChart(chart)
aracılığıyla eklenmelidir.
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 (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 bu oluşturucu
enable Paging(enablePaging)
Veriler arasında sayfalama özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirler.
Varsayılan davranış, sayfalandırmanın devre dışı bırakılmasıdır. Sayfalama 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 yararlı olan bu oluşturucu.
enable Paging(pageSize)
Sayfalamayı 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ında bulunan satır sayısı. |
Return
Embedded
: Zincirleme için yararlı olan bu oluşturucu.
enable Paging(pageSize, startPage)
Sayfalamayı 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ı olur).
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ında bulunan satır sayısı. |
start | Integer | Gösterilecek ilk tablo sayfası (sayfa numaraları sıfır tabanlı). |
Return
Embedded
: Zincirleme için yararlı olan bu oluşturucu.
enable Rtl Table(rtlEnabled)
Tablonun sütun düzenini tersine çevirerek sağdan sola yazılan diller (Arapça veya İbranice gibi) için temel destek ekler. Böylece sıfır sütunu 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. Tam iki yönlü (BiDi) dil görüntüleme, bu seçenek etkinleştirilmiş olsa bile tablo görselleştirmesinde desteklenmez. Sayfalama özelliğini etkinleştirirseniz (sayfa seçeneğini kullanarak) veya tabloda kaydırma çubukları varsa (gerekli tablo boyutundan daha küçük yükseklik ve genişlik seçenekleri belirttiğiniz için) bu seçenek yoksayılır. Varsayılan davranış, RTL desteğinin devre dışı bırakılmasıdır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rtl | Boolean | true sağdan sola desteği etkinleştirilecekse, false
aksi takdirde. |
Return
Embedded
: Zincirleme için yararlı 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ı belirler.
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 yararlı olan bu oluşturucu.
get Chart Type()
get Container()
E-tabloda grafiğin nerede göründüğünü 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ısının konumunu içeren bir nesne
get Ranges()
Şu anda bu grafik için veri sağlayan aralıkların listesinin bir kopyasını döndürür. Bu listeyi değiştirmek için add
ve remove
simgesini 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 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')); const chart = chartBuilder.build(); sheet.insertChart(chart);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
range | Range | Kaldırılacağı aralık. |
Return
Embedded
: zincirleme için bu oluşturucu
set Chart Type(type)
Grafik türünü değiştirir. Şu anda tüm yerleşik grafik türleri desteklenmiyor. Ş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 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 yararlı olan bu oluşturucu.
set Hidden Dimension Strategy(strategy)
Gizli satırlar ve sütunlar için kullanılacak stratejiyi belirler. 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 bu oluşturucu
set Initial Sorting Ascending(column)
Tablonun başlangıçta hangi sütuna göre sıralanması gerektiğini (artan) belirten dizin.
Sütun artan düzende sıralanır ve bunu belirten 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 hangi sütuna göre sıralanacağını belirten sayı. |
Return
Embedded
: Zincirleme için yararlı olan bu oluşturucu.
set Initial Sorting Descending(column)
Tablonun başlangıçta hangi sütuna göre sıralanması gerektiğini (azalan) belirten dizin.
Sütun azalan düzende sıralanır ve bunu belirten 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 hangi sütuna göre sıralanacağını belirten sayı. |
Return
Embedded
: Zincirleme için yararlı olan bu oluşturucu.
set Merge Strategy(mergeStrategy)
Birden fazla aralık olduğunda kullanılacak birleştirme stratejisini belirler. 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 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 | Üstbilgi 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 bu oluşturucu
set Option(option, value)
Bu grafik için gelişmiş seçenekleri belirler. Mevcut seçeneklerin listesini görüntülemek için Grafiğin 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çim/yapıda olup olmadığını doğrulamaz.
Bu örnekte, başlığın nasıl değiştirileceği ve bir açıklamanın 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 bu oluşturucu.
set Position(anchorRowPos, anchorColPos, offsetX, offsetY)
Grafiğin e-tabloda göründüğü yeri değiştirerek konumu belirler. anchor
ve anchor
1'den başlar.
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 tarafı bu satıra sabitlenir. |
anchor | Integer | Grafiğin sol tarafı bu sütuna sabitlenir. |
offsetX | Integer | Grafiğin sağ üst köşesi bu kadar piksel kaydırılır. |
offsetY | Integer | Grafiğin sol alt köşesi bu kadar piksel kaydırılır. |
Return
Embedded
: zincirleme için bu oluşturucu
set Transpose Rows And Columns(transpose)
Grafiğin satır ve sütunlarının transpoze edilip edilmeyeceğini belirler. 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 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 yararlı olan bu oluşturucu.
use Alternating Row Style(alternate)
Tablo grafiğinin tek ve çift satırlarına alternatif renk stilinin atanıp atanmayacağını belirler.
Varsayılan davranış, satırların renk stilinin değişken olmasıdır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
alternate | Boolean | Renk stilleri değişiyorsa true , aksi takdirde false . |
Return
Embedded
: Zincirleme için yararlı olan bu oluşturucu.