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 | चार्ट टाइप को AreaChart पर सेट करता है और EmbeddedAreaChartBuilder दिखाता है. |
asBarChart() | EmbeddedBarChartBuilder | चार्ट टाइप को BarChart पर सेट करता है और EmbeddedBarChartBuilder देता है. |
asColumnChart() | EmbeddedColumnChartBuilder | चार्ट टाइप को ColumnChart पर सेट करता है और EmbeddedColumnChartBuilder दिखाता है. |
asComboChart() | EmbeddedComboChartBuilder | चार्ट टाइप को कॉम्बो चार्ट पर सेट करता है और EmbeddedComboChartBuilder दिखाता है. |
asHistogramChart() | EmbeddedHistogramChartBuilder | चार्ट टाइप को HistogramChart पर सेट करता है और EmbeddedHistogramChartBuilder दिखाता है. |
asLineChart() | EmbeddedLineChartBuilder | चार्ट टाइप को LineChart पर सेट करता है और EmbeddedLineChartBuilder दिखाता है. |
asPieChart() | EmbeddedPieChartBuilder | चार्ट टाइप को PieChart पर सेट करता है और EmbeddedPieChartBuilder दिखाता है. |
asScatterChart() | EmbeddedScatterChartBuilder | चार्ट टाइप को स्कैटर चार्ट पर सेट करता है और EmbeddedScatterChartBuilder दिखाता है. |
asTableChart() | EmbeddedTableChartBuilder | चार्ट टाइप को TablesChart पर सेट करता है और 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);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
range | Range | जोड़ी जाने वाली रेंज. |
रिटर्न
EmbeddedChartBuilder
— यह बिल्डर, चेन बनाने के लिए
asAreaChart()
चार्ट टाइप को AreaChart पर सेट करता है और EmbeddedAreaChartBuilder
दिखाता है.
रिटर्न
EmbeddedAreaChartBuilder
— एरिया चार्ट के लिए बिल्डर
asBarChart()
चार्ट टाइप को BarChart पर सेट करता है और EmbeddedBarChartBuilder
देता है.
रिटर्न
EmbeddedBarChartBuilder
— बार चार्ट के लिए बिल्डर
asColumnChart()
चार्ट टाइप को ColumnChart पर सेट करता है और EmbeddedColumnChartBuilder
दिखाता है.
रिटर्न
EmbeddedColumnChartBuilder
— कॉलम चार्ट के लिए बिल्डर
asComboChart()
चार्ट टाइप को कॉम्बो चार्ट पर सेट करता है और EmbeddedComboChartBuilder
दिखाता है.
रिटर्न
EmbeddedComboChartBuilder
— कॉम्बो चार्ट के लिए बिल्डर
asHistogramChart()
चार्ट टाइप को HistogramChart पर सेट करता है और EmbeddedHistogramChartBuilder
दिखाता है.
रिटर्न
EmbeddedHistogramChartBuilder
— हिस्टोग्राम चार्ट के लिए बिल्डर
asLineChart()
चार्ट टाइप को LineChart पर सेट करता है और EmbeddedLineChartBuilder
दिखाता है.
रिटर्न
EmbeddedLineChartBuilder
— लाइन चार्ट के लिए बिल्डर
asPieChart()
चार्ट टाइप को PieChart पर सेट करता है और EmbeddedPieChartBuilder
दिखाता है.
रिटर्न
EmbeddedPieChartBuilder
— पाई चार्ट के लिए बिल्डर
asScatterChart()
चार्ट टाइप को स्कैटर चार्ट पर सेट करता है और EmbeddedScatterChartBuilder
दिखाता है.
रिटर्न
EmbeddedScatterChartBuilder
— स्कैटर चार्ट के लिए बिल्डर
asTableChart()
चार्ट टाइप को TablesChart पर सेट करता है और 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);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
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 | ब्यौरा |
---|---|---|
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);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
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);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
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);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
headers | Integer | उन पंक्तियों या कॉलम की संख्या जिन्हें हेडर माना जाना है. नेगेटिव वैल्यू की वजह से हेडर का पता अपने-आप लग जाता है. |
रिटर्न
EmbeddedChartBuilder
— यह बिल्डर, चेन बनाने के लिए
setOption(option, value)
इस चार्ट के लिए बेहतर विकल्प सेट करता है. उपलब्ध विकल्पों की सूची देखने के लिए, चार्ट कॉन्फ़िगरेशन विकल्प देखें.
यह तरीका इस बात की पुष्टि नहीं करता कि आपने जो विकल्प चुना है वह इस चार्ट टाइप के लिए मान्य है या नहीं. इसके अलावा, इससे यह भी पता नहीं चलता कि वैल्यू सही फ़ॉर्मैट/स्ट्रक्चर में है या नहीं.
इस उदाहरण में टाइटल बदलने और लेजेंड सेट करने का तरीका बताया गया है.
builder.setOption('title', 'Earnings projections'); builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
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);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
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);
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
transpose | Boolean | अगर true हो, तो चार्ट बनाने के लिए इस्तेमाल की गई पंक्तियों और कॉलम को
ट्रांसपोज़ किया जाता है. |
रिटर्न
EmbeddedChartBuilder
— यह बिल्डर, चेन बनाने के लिए