EmbeddedChart में बदलाव करने के लिए बिल्डर का इस्तेमाल किया गया. चार्ट में किए गए बदलाव इस समय तक सेव नहीं होते
फिर से बनाए गए चार्ट पर Sheet.updateChart(chart) को कॉल किया गया.
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);
तरीके
| तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
|---|---|---|
addRange(range) | EmbeddedChartBuilder | उस चार्ट में रेंज जोड़ता है जिसमें यह बिल्डर बदलाव करता है. |
asAreaChart() | EmbeddedAreaChartBuilder | चार्ट टाइप को एरिया चार्ट पर सेट करता है और EmbeddedAreaChartBuilder दिखाता है. |
asBarChart() | EmbeddedBarChartBuilder | चार्ट टाइप को BarChart पर सेट करता है और EmbeddedBarChartBuilder दिखाता है. |
asColumnChart() | EmbeddedColumnChartBuilder | चार्ट टाइप को ColumnChart पर सेट करता है और EmbeddedColumnChartBuilder दिखाता है. |
asComboChart() | EmbeddedComboChartBuilder | चार्ट टाइप को कॉम्बो चार्ट पर सेट करता है और EmbeddedComboChartBuilder दिखाता है. |
asHistogramChart() | EmbeddedHistogramChartBuilder | चार्ट टाइप को हिस्टोग्राम चार्ट पर सेट करता है और EmbeddedHistogramChartBuilder दिखाता है. |
asLineChart() | EmbeddedLineChartBuilder | यह चार्ट टाइप को LineChart पर सेट करता है और EmbeddedLineChartBuilder दिखाता है. |
asPieChart() | EmbeddedPieChartBuilder | चार्ट टाइप को PieChart पर सेट करता है और EmbeddedPieChartBuilder दिखाता है. |
asScatterChart() | EmbeddedScatterChartBuilder | चार्ट टाइप को ScatterChart पर सेट करता है और EmbeddedScatterChartBuilder दिखाता है. |
asTableChart() | EmbeddedTableChartBuilder | चार्ट टाइप को टेबलचार्ट पर सेट करता है और EmbeddedTableChartBuilder दिखाता है. |
build() | EmbeddedChart | इसमें किए गए सभी बदलावों को दिखाने के लिए, चार्ट बनाता है. |
clearRanges() | EmbeddedChartBuilder | इस बिल्डर से बदलाव करने वाले चार्ट से सभी रेंज हटा देता है. |
getChartType() | ChartType | यह फ़ंक्शन मौजूदा चार्ट टाइप दिखाता है. |
getContainer() | ContainerInfo | चार्ट ContainerInfo दिखाएं, जो यह बताता है कि चार्ट पर
शीट. |
getRanges() | Range[] | उन रेंज की सूची की कॉपी दिखाता है जो फ़िलहाल इस चार्ट के लिए डेटा उपलब्ध करा रही हैं. |
removeRange(range) | EmbeddedChartBuilder | इस बिल्डर से बदलाव करने वाले चार्ट से, चुनी गई रेंज हटा देता है. |
setChartType(type) | EmbeddedChartBuilder | चार्ट का टाइप बदलता है. |
setHiddenDimensionStrategy(strategy) | EmbeddedChartBuilder | छिपी हुई पंक्तियों और कॉलम के लिए इस्तेमाल की रणनीति सेट करता है. |
setMergeStrategy(mergeStrategy) | EmbeddedChartBuilder | एक से ज़्यादा रेंज मौजूद होने पर, मर्ज करने की रणनीति सेट करता है. |
setNumHeaders(headers) | EmbeddedChartBuilder | रेंज की उन पंक्तियों या कॉलम की संख्या तय करता है जिन्हें हेडर माना जाना चाहिए. |
setOption(option, value) | EmbeddedChartBuilder | इस चार्ट के लिए बेहतर विकल्प सेट करता है. |
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY) | EmbeddedChartBuilder | जगह सेट करता है और शीट में चार्ट के दिखने की जगह बदलता है. |
setTransposeRowsAndColumns(transpose) | EmbeddedChartBuilder | सेट करता है कि चार्ट की पंक्तियां और कॉलम ट्रांसपोज़ किए गए हैं या नहीं. |
विस्तृत दस्तावेज़
addRange(range)
उस चार्ट में रेंज जोड़ता है जिसमें यह बिल्डर बदलाव करता है. अगर रेंज पहले से मौजूद है, तो उसे नहीं जोड़ा जाता चार्ट में जोड़ा गया.
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);
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
range | Range | जोड़ी जाने वाली रेंज. |
वापसी का टिकट
EmbeddedChartBuilder — यह बिल्डर, चेन बनाने के लिए है
asAreaChart()
चार्ट टाइप को एरिया चार्ट पर सेट करता है और EmbeddedAreaChartBuilder दिखाता है.
वापसी का टिकट
EmbeddedAreaChartBuilder — एरिया चार्ट के लिए बिल्डर
asBarChart()
चार्ट टाइप को BarChart पर सेट करता है और EmbeddedBarChartBuilder दिखाता है.
वापसी का टिकट
EmbeddedBarChartBuilder — बार चार्ट के लिए बिल्डर
asColumnChart()
चार्ट टाइप को ColumnChart पर सेट करता है और EmbeddedColumnChartBuilder दिखाता है.
वापसी का टिकट
EmbeddedColumnChartBuilder — कॉलम चार्ट के लिए बिल्डर
asComboChart()
चार्ट टाइप को कॉम्बो चार्ट पर सेट करता है और EmbeddedComboChartBuilder दिखाता है.
वापसी का टिकट
EmbeddedComboChartBuilder — कॉम्बो चार्ट बनाने वाला टूल
asHistogramChart()
चार्ट टाइप को हिस्टोग्राम चार्ट पर सेट करता है और EmbeddedHistogramChartBuilder दिखाता है.
वापसी का टिकट
EmbeddedHistogramChartBuilder — हिस्टोग्राम चार्ट के लिए बिल्डर
asLineChart()
यह चार्ट टाइप को LineChart पर सेट करता है और EmbeddedLineChartBuilder दिखाता है.
वापसी का टिकट
EmbeddedLineChartBuilder — लाइन चार्ट के लिए बिल्डर
asPieChart()
चार्ट टाइप को PieChart पर सेट करता है और EmbeddedPieChartBuilder दिखाता है.
वापसी का टिकट
EmbeddedPieChartBuilder — पाई चार्ट के लिए बिल्डर
asScatterChart()
चार्ट टाइप को ScatterChart पर सेट करता है और EmbeddedScatterChartBuilder दिखाता है.
वापसी का टिकट
EmbeddedScatterChartBuilder — स्कैटर चार्ट के लिए बिल्डर
asTableChart()
चार्ट टाइप को टेबलचार्ट पर सेट करता है और EmbeddedTableChartBuilder दिखाता है.
वापसी का टिकट
EmbeddedTableChartBuilder — टेबल चार्ट के लिए बिल्डर
build()
इसमें किए गए सभी बदलावों को दिखाने के लिए, चार्ट बनाता है.
इस तरीके से, चार्ट अपने-आप स्प्रेडशीट में सबसे ऊपर नहीं ड्रॉ होता. एक नया चार्ट
sheet.insertChart(chart) के ज़रिए शामिल किया जाना चाहिए और मौजूदा चार्ट को अपडेट किया जाना चाहिए
sheet.updateChart(chart) से.
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);
वापसी का टिकट
EmbeddedChart — बनाया गया चार्ट, जिसे अब भी स्प्रेडशीट में जोड़ा जाना चाहिए
clearRanges()
इस बिल्डर से बदलाव करने वाले चार्ट से सभी रेंज हटा देता है.
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);
वापसी का टिकट
EmbeddedChartBuilder — यह बिल्डर, चेन बनाने के लिए है
getChartType()
getContainer()
चार्ट ContainerInfo दिखाएं, जो यह बताता है कि चार्ट पर
शीट.
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());
वापसी का टिकट
ContainerInfo — ऐसा ऑब्जेक्ट जिसमें चार्ट कंटेनर की पोज़िशन होती है
getRanges()
उन रेंज की सूची की कॉपी दिखाता है जो फ़िलहाल इस चार्ट के लिए डेटा उपलब्ध करा रही हैं. इस सूची में बदलाव करने के लिए addRange(range) और removeRange(range) का इस्तेमाल करें.
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());
}
वापसी का टिकट
Range[] — रेंज की ऐसी कैटगरी जो बनाए जाने वाले डेटा सोर्स के लिए चार्ट के तौर पर काम करती है
removeRange(range)
इस बिल्डर से बदलाव करने वाले चार्ट से, चुनी गई रेंज हटा देता है. इससे गड़बड़ी नहीं मिलती, अगर इस चार्ट में श्रेणी नहीं है.
हटाई गई रेंज, addRange(range) के ज़रिए जोड़ी गई रेंज से मेल खानी चाहिए;
ऐसा नहीं होने पर चार्ट में कोई बदलाव नहीं किया जाता. कुछ हद तक वैल्यू हटाने के लिए, इस तरीके का इस्तेमाल नहीं किया जा सकता
इस सीमा से बाहर निकलें.
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);
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
range | Range | वह रेंज जिसे हटाना है. |
वापसी का टिकट
EmbeddedChartBuilder — यह बिल्डर, चेन बनाने के लिए है
setChartType(type)
चार्ट का टाइप बदलता है. फ़िलहाल, एम्बेड किए गए सभी चार्ट टाइप काम नहीं करते. 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);
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
type | ChartType | वह प्रकार जिसमें इस चार्ट को बदलना है. |
वापसी का टिकट
EmbeddedChartBuilder — यह बिल्डर, चेन बनाने के लिए है
setHiddenDimensionStrategy(strategy)
छिपी हुई पंक्तियों और कॉलम के लिए इस्तेमाल की रणनीति सेट करता है. डिफ़ॉल्ट तौर पर, यह IGNORE_ROWS पर सेट होता है.
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);
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
strategy | ChartHiddenDimensionStrategy | छिपी हुई पंक्तियों और कॉलम के लिए इस्तेमाल की जाने वाली रणनीति. |
वापसी का टिकट
EmbeddedChartBuilder — यह बिल्डर, चेन बनाने के लिए है
setMergeStrategy(mergeStrategy)
एक से ज़्यादा रेंज मौजूद होने पर, मर्ज करने की रणनीति सेट करता है. अगर MERGE_ROWS है, तो पंक्तियां मर्ज कर दी जाती हैं; अगर MERGE_COLUMNS है, तो कॉलम मर्ज किए जाते हैं. डिफ़ॉल्ट तौर पर, यह MERGE_COLUMNS पर सेट होता है.
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);
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
mergeStrategy | ChartMergeStrategy | इस्तेमाल करने के लिए, मर्ज करने की रणनीति. |
वापसी का टिकट
EmbeddedChartBuilder — यह बिल्डर, चेन बनाने के लिए है
setNumHeaders(headers)
रेंज की उन पंक्तियों या कॉलम की संख्या तय करता है जिन्हें हेडर माना जाना चाहिए.
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);
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
headers | Integer | हेडर के तौर पर इस्तेमाल की जाने वाली पंक्तियों या कॉलम की संख्या. नेगेटिव वैल्यू की वजह से हेडर अपने-आप पहचानने के लिए इसे सेट किया जा सकता है. |
वापसी का टिकट
EmbeddedChartBuilder — यह बिल्डर, चेन बनाने के लिए है
setOption(option, value)
इस चार्ट के लिए बेहतर विकल्प सेट करता है. उपलब्ध विकल्पों की सूची देखने के लिए, चार्ट कॉन्फ़िगरेशन के विकल्प.
यह तरीका इस चार्ट प्रकार के लिए आपके बताए गए विकल्प की पुष्टि नहीं करता और न ही वैल्यू सही फ़ॉर्मैट/स्ट्रक्चर में है.
इस उदाहरण में टाइटल बदलने और लेजेंड सेट करने का तरीका बताया गया है.
builder.setOption('title', 'Earnings projections');
builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
option | String | विकल्प का नाम. |
value | Object | विकल्प का मान. |
वापसी का टिकट
EmbeddedChartBuilder — चेन बनाने के लिए यह बिल्डर.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
जगह सेट करता है और शीट में चार्ट के दिखने की जगह बदलता है. anchorRowPos और
anchorColPos को 1 इंडेक्स किया गया.
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);
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
anchorRowPos | Integer | चार्ट का ऊपरी हिस्सा इस पंक्ति में दिखाया गया है. |
anchorColPos | Integer | चार्ट का बायां हिस्सा, इस कॉलम में ऐंकर किया गया है. |
offsetX | Integer | चार्ट के ऊपरी दाएं कोने को इतने पिक्सल से ऑफ़सेट किया गया है. |
offsetY | Integer | चार्ट के निचले बायां कोना इतने पिक्सल से ऑफ़सेट किया गया है. |
वापसी का टिकट
EmbeddedChartBuilder — यह बिल्डर, चेन बनाने के लिए है
setTransposeRowsAndColumns(transpose)
सेट करता है कि चार्ट की पंक्तियां और कॉलम ट्रांसपोज़ किए गए हैं या नहीं. अगर true पर सेट की जाती है, तो पंक्तियां और
कॉलम स्विच किए गए हैं. डिफ़ॉल्ट तौर पर, यह false पर सेट होता है.
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);
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
transpose | Boolean | अगर true है, तो चार्ट बनाने के लिए इस्तेमाल की जाने वाली पंक्तियां और कॉलम
ट्रांसपोज़ किया गया. |
वापसी का टिकट
EmbeddedChartBuilder — यह बिल्डर, चेन बनाने के लिए है