EmbeddedChart
düzenlemek için kullanılan oluşturucu. Grafikte yapılan değişiklikler, yeniden oluşturulan grafikte Sheet.updateChart(chart)
çağrılana kadar kaydedilmez.
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B8"); var chart = sheet.getCharts()[0]; chart = chart.modify() .addRange(range) .setOption('title', 'Updated!') .setOption('animation.duration', 500) .setPosition(2,2,0,0) .build(); sheet.updateChart(chart);
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
addRange(range) | EmbeddedChartBuilder | Bu oluşturucunun değiştirdiği grafiğe bir aralık ekler. |
asAreaChart() | EmbeddedAreaChartBuilder | Grafik türünü AreaChart olarak ayarlar ve EmbeddedAreaChartBuilder döndürür. |
asBarChart() | EmbeddedBarChartBuilder | Grafik türünü BarChart olarak ayarlar ve EmbeddedBarChartBuilder değerini döndürür. |
asColumnChart() | EmbeddedColumnChartBuilder | Grafik türünü ColumnChart olarak ayarlar ve EmbeddedColumnChartBuilder döndürür. |
asComboChart() | EmbeddedComboChartBuilder | Grafik türünü ComboChart olarak ayarlar ve EmbeddedComboChartBuilder döndürür. |
asHistogramChart() | EmbeddedHistogramChartBuilder | Grafik türünü HistogramChart olarak ayarlar ve EmbeddedHistogramChartBuilder sonucunu döndürür. |
asLineChart() | EmbeddedLineChartBuilder | Grafik türünü Çizgi Grafik olarak ayarlar ve EmbeddedLineChartBuilder değerini döndürür. |
asPieChart() | EmbeddedPieChartBuilder | Grafik türünü Pasta Grafik olarak ayarlar ve EmbeddedPieChartBuilder değerini döndürür. |
asScatterChart() | EmbeddedScatterChartBuilder | Grafik türünü ScatterChart olarak ayarlar ve bir EmbeddedScatterChartBuilder döndürür. |
asTableChart() | EmbeddedTableChartBuilder | Grafik türünü TableChart olarak ayarlar ve bir EmbeddedTableChartBuilder döndürür. |
build() | EmbeddedChart | Grafiği, üzerinde yapılan tüm değişiklikleri yansıtacak şekilde oluşturur. |
clearRanges() | EmbeddedChartBuilder | Bu oluşturucunun değiştirdiği grafikten tüm aralıkları kaldırır. |
getChartType() | ChartType | Geçerli grafik türünü döndürür. |
getContainer() | ContainerInfo | Grafiğ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) | EmbeddedChartBuilder | Belirtilen aralığı, bu oluşturucunun değiştirdiği grafikten kaldırır. |
setChartType(type) | EmbeddedChartBuilder | Grafik türünü değiştirir. |
setHiddenDimensionStrategy(strategy) | EmbeddedChartBuilder | Gizli satırlar ve sütunlar için kullanılacak stratejiyi ayarlar. |
setMergeStrategy(mergeStrategy) | EmbeddedChartBuilder | Birden fazla aralık olduğunda kullanılacak birleştirme stratejisini ayarlar. |
setNumHeaders(headers) | EmbeddedChartBuilder | Aralıkta başlık olarak ele alınması gereken satır veya sütun sayısını belirler. |
setOption(option, value) | EmbeddedChartBuilder | Bu grafik için gelişmiş seçenekleri belirler. |
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY) | EmbeddedChartBuilder | Konumu ayarlar ve grafiğin sayfada göründüğü yeri değiştirir. |
setTransposeRowsAndColumns(transpose) | EmbeddedChartBuilder | Grafikteki 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
Ad | Tür | Açıklama |
---|---|---|
range | Range | Eklenecek 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()
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
Ad | Tür | Açıklama |
---|---|---|
range | Range | Kaldırılacak aralık. |
Return
EmbeddedChartBuilder
— zincirleme bağlantı için bu derleyici
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
Ad | Tür | Açıklama |
---|---|---|
type | ChartType | Bu grafiğin değiştirileceği tür. |
Return
EmbeddedChartBuilder
— zincirleme bağlantı için bu derleyici
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
Ad | Tür | Açıklama |
---|---|---|
strategy | ChartHiddenDimensionStrategy | Gizli satırlar ve sütunlar için kullanılacak strateji. |
Return
EmbeddedChartBuilder
— zincirleme bağlantı için bu derleyici
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
Ad | Tür | Açıklama |
---|---|---|
mergeStrategy | ChartMergeStrategy | Kullanı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
Ad | Tür | Açıklama |
---|---|---|
headers | Integer | Baş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
Ad | Tür | Açıklama |
---|---|---|
option | String | Seçeneğin adı. |
value | Object | Seç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
Ad | Tür | Açıklama |
---|---|---|
anchorRowPos | Integer | Grafiğin üst tarafı bu satıra sabitlenmiştir. |
anchorColPos | Integer | Grafiğin sol tarafı bu sütuna sabitlenmiştir. |
offsetX | Integer | Grafiğin sağ üst köşesinin uzaklığı bu kadar pikseldir. |
offsetY | Integer | Grafiğin sol alt köşesinin uzaklığı bu kadar pikseldir. |
Return
EmbeddedChartBuilder
— zincirleme bağlantı için bu derleyici
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
Ad | Tür | Açıklama |
---|---|---|
transpose | Boolean | true 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