Embedded
में बदलाव करने के लिए इस्तेमाल किया जाने वाला बिल्डर. चार्ट में किए गए बदलाव तब तक सेव नहीं होते, जब तक कि फिर से बनाए गए चार्ट पर Sheet.updateChart(chart)
को कॉल नहीं किया जाता.
const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B8'); let 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);
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
add | Embedded | इस बिल्डर से बदले गए चार्ट में एक रेंज जोड़ता है. |
as | Embedded | यह फ़ंक्शन, चार्ट टाइप को AreaChart पर सेट करता है और Embedded दिखाता है. |
as | Embedded | यह चार्ट टाइप को BarChart पर सेट करता है और Embedded दिखाता है. |
as | Embedded | यह चार्ट टाइप को ColumnChart पर सेट करता है और Embedded दिखाता है. |
as | Embedded | यह चार्ट टाइप को ComboChart पर सेट करता है और Embedded दिखाता है. |
as | Embedded | यह फ़ंक्शन, चार्ट टाइप को HistogramChart पर सेट करता है और Embedded दिखाता है. |
as | Embedded | यह चार्ट टाइप को LineChart पर सेट करता है और Embedded दिखाता है. |
as | Embedded | यह चार्ट टाइप को PieChart पर सेट करता है और Embedded दिखाता है. |
as | Embedded | यह चार्ट टाइप को ScatterChart पर सेट करता है और Embedded दिखाता है. |
as | Embedded | यह चार्ट टाइप को TableChart पर सेट करता है और Embedded दिखाता है. |
build() | Embedded | चार्ट में किए गए सभी बदलावों को दिखाने के लिए, चार्ट बनाता है. |
clear | Embedded | इस बिल्डर से बदले गए चार्ट से सभी रेंज हटाता है. |
get | Chart | मौजूदा चार्ट टाइप दिखाता है. |
get | Container | चार्ट Container दिखाता है. इससे पता चलता है कि चार्ट, शीट में कहां दिखता है. |
get | Range[] | यह फ़ंक्शन, उन रेंज की सूची की कॉपी दिखाता है जो फ़िलहाल इस चार्ट के लिए डेटा उपलब्ध करा रही हैं. |
remove | Embedded | यह फ़ंक्शन, उस चार्ट से तय की गई रेंज को हटाता है जिसे यह बिल्डर बदलता है. |
set | Embedded | इस विकल्प से चार्ट का टाइप बदला जाता है. |
set | Embedded | छुपाई गई लाइनों और कॉलम के लिए इस्तेमाल की जाने वाली रणनीति सेट करता है. |
set | Embedded | एक से ज़्यादा रेंज मौजूद होने पर, मर्ज करने की रणनीति सेट करता है. |
set | Embedded | यह विकल्प, रेंज की उन पंक्तियों या कॉलम की संख्या सेट करता है जिन्हें हेडर के तौर पर इस्तेमाल किया जाना चाहिए. |
set | Embedded | इस चार्ट के लिए बेहतर विकल्प सेट करता है. |
set | Embedded | इस विकल्प से, चार्ट की जगह सेट की जाती है. इससे यह तय होता है कि चार्ट, शीट में कहां दिखेगा. |
set | Embedded | इससे यह तय किया जाता है कि चार्ट की पंक्तियों और कॉलम की अदला-बदली की जाए या नहीं. |
ज़्यादा जानकारी वाला दस्तावेज़
add Range(range)
इस बिल्डर से बदले गए चार्ट में एक रेंज जोड़ता है. अगर रेंज को पहले ही चार्ट में जोड़ दिया गया है, तो उसे दोबारा नहीं जोड़ा जाता.
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);
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
range | Range | जोड़ी जाने वाली रेंज. |
वापसी का टिकट
Embedded
— यह बिल्डर, चेनिंग के लिए है.
as Area Chart()
यह फ़ंक्शन, चार्ट टाइप को AreaChart पर सेट करता है और Embedded
दिखाता है.
वापसी का टिकट
Embedded
— यह एरिया चार्ट बनाने वाला टूल है.
as Bar Chart()
यह चार्ट टाइप को BarChart पर सेट करता है और Embedded
दिखाता है.
वापसी का टिकट
Embedded
— बार चार्ट बनाने वाला बिल्डर.
as Column Chart()
यह चार्ट टाइप को ColumnChart पर सेट करता है और Embedded
दिखाता है.
वापसी का टिकट
Embedded
— यह कॉलम चार्ट बनाने वाला बिल्डर है.
as Combo Chart()
यह चार्ट टाइप को ComboChart पर सेट करता है और Embedded
दिखाता है.
वापसी का टिकट
Embedded
— यह कॉम्बो चार्ट बनाने वाला टूल है.
as Histogram Chart()
यह फ़ंक्शन, चार्ट टाइप को HistogramChart पर सेट करता है और Embedded
दिखाता है.
वापसी का टिकट
Embedded
— यह हिस्टोग्राम चार्ट बनाने वाला बिल्डर है.
as Line Chart()
यह चार्ट टाइप को LineChart पर सेट करता है और Embedded
दिखाता है.
वापसी का टिकट
Embedded
— यह लाइन चार्ट बनाने वाला टूल है.
as Pie Chart()
यह चार्ट टाइप को PieChart पर सेट करता है और Embedded
दिखाता है.
वापसी का टिकट
Embedded
— यह पाई चार्ट बनाने वाला टूल है.
as Scatter Chart()
यह चार्ट टाइप को ScatterChart पर सेट करता है और Embedded
दिखाता है.
वापसी का टिकट
Embedded
— स्कैटर चार्ट बनाने वाला बिल्डर.
as Table Chart()
यह चार्ट टाइप को TableChart पर सेट करता है और Embedded
दिखाता है.
वापसी का टिकट
Embedded
— यह टेबल चार्ट बनाने वाला बिल्डर है.
build()
चार्ट में किए गए सभी बदलावों को दिखाने के लिए, चार्ट बनाता है.
इस तरीके से, स्प्रेडशीट के ऊपर चार्ट अपने-आप नहीं बनता है. sheet.insertChart(chart)
की मदद से नया चार्ट डाला जाना चाहिए. साथ ही, sheet.updateChart(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);
वापसी का टिकट
Embedded
— बनाया गया चार्ट, जिसे अब भी स्प्रेडशीट में जोड़ना होगा.
clear Ranges()
इस बिल्डर से बदले गए चार्ट से सभी रेंज हटाता है.
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);
वापसी का टिकट
Embedded
— यह बिल्डर, चेनिंग के लिए है.
get Chart Type()
get Container()
चार्ट Container
दिखाता है. इससे पता चलता है कि चार्ट, शीट में कहां दिखता है.
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(), );
वापसी का टिकट
Container
— यह एक ऐसा ऑब्जेक्ट होता है जिसमें चार्ट कंटेनर की पोज़िशन शामिल होती है.
get Ranges()
यह फ़ंक्शन, उन रेंज की सूची की कॉपी दिखाता है जो फ़िलहाल इस चार्ट के लिए डेटा उपलब्ध करा रही हैं. इस सूची में बदलाव करने के लिए, add
और remove
का इस्तेमाल करें.
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()); }
वापसी का टिकट
Range[]
— यह रेंज का एक ऐसा कलेक्शन होता है जो चार्ट बनाने के लिए डेटा सोर्स के तौर पर काम करता है.
remove Range(range)
यह फ़ंक्शन, उस चार्ट से तय की गई रेंज को हटाता है जिसे यह बिल्डर बदलता है. अगर रेंज इस चार्ट में नहीं है, तो गड़बड़ी नहीं दिखाता है.
हटाए गए डेटा की रेंज, add
के ज़रिए जोड़े गए डेटा की रेंज से मेल खानी चाहिए. ऐसा न होने पर, चार्ट में कोई बदलाव नहीं किया जाता. इस तरीके का इस्तेमाल, किसी रेंज से वैल्यू को पूरी तरह से हटाने के लिए नहीं किया जा सकता.
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);
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
range | Range | हटाने के लिए रेंज. |
वापसी का टिकट
Embedded
— यह बिल्डर, चेनिंग के लिए है.
set Chart Type(type)
इस विकल्प से चार्ट का टाइप बदला जाता है. फ़िलहाल, सभी तरह के एम्बेड किए गए चार्ट काम नहीं करते. 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);
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
type | Chart | चार्ट को जिस टाइप में बदलना है. |
वापसी का टिकट
Embedded
— यह बिल्डर, चेनिंग के लिए है.
set Hidden Dimension Strategy(strategy)
छुपाई गई लाइनों और कॉलम के लिए इस्तेमाल की जाने वाली रणनीति सेट करता है. डिफ़ॉल्ट रूप से, यह IGNORE_ROWS
पर सेट होती है.
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);
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
strategy | Chart | छुपी हुई लाइनों और कॉलम के लिए इस्तेमाल की जाने वाली रणनीति. |
वापसी का टिकट
Embedded
— यह बिल्डर, चेनिंग के लिए है.
set Merge Strategy(mergeStrategy)
एक से ज़्यादा रेंज मौजूद होने पर, मर्ज करने की रणनीति सेट करता है. अगर MERGE_ROWS
है, तो पंक्तियां मर्ज की जाती हैं. अगर MERGE_COLUMNS
है, तो कॉलम मर्ज किए जाते हैं. डिफ़ॉल्ट रूप से, यह MERGE_COLUMNS
पर सेट होती है.
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);
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
merge | Chart | मर्ज करने के लिए इस्तेमाल की जाने वाली रणनीति. |
वापसी का टिकट
Embedded
— यह बिल्डर, चेनिंग के लिए है.
set Num Headers(headers)
यह विकल्प, रेंज की उन पंक्तियों या कॉलम की संख्या सेट करता है जिन्हें हेडर के तौर पर इस्तेमाल किया जाना चाहिए.
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);
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
headers | Integer | हेडर के तौर पर इस्तेमाल की जाने वाली पंक्तियों या कॉलम की संख्या. नेगेटिव वैल्यू की वजह से, हेडर अपने-आप पहचान लिए जाते हैं. |
वापसी का टिकट
Embedded
— यह बिल्डर, चेनिंग के लिए है.
set Option(option, value)
इस चार्ट के लिए बेहतर विकल्प सेट करता है. उपलब्ध विकल्पों की सूची देखने के लिए, चार्ट कॉन्फ़िगरेशन के विकल्प देखें.
इस तरीके से यह पुष्टि नहीं की जाती कि आपने जो विकल्प दिया है वह इस चार्ट टाइप के लिए मान्य है या नहीं. साथ ही, यह भी पुष्टि नहीं की जाती कि वैल्यू सही फ़ॉर्मैट/स्ट्रक्चर में है या नहीं.
इस उदाहरण में, टाइटल बदलने और लेजेंड सेट करने का तरीका बताया गया है.
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();
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
option | String | विकल्प का नाम. |
value | Object | विकल्प की वैल्यू. |
वापसी का टिकट
Embedded
— यह बिल्डर, चेनिंग के लिए है.
set Position(anchorRowPos, anchorColPos, offsetX, offsetY)
इस विकल्प से, चार्ट की जगह सेट की जाती है. इससे यह तय होता है कि चार्ट, शीट में कहां दिखेगा. anchor
और anchor
, 1 से इंडेक्स किए गए हैं.
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);
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
anchor | Integer | चार्ट का ऊपरी हिस्सा इस लाइन में ऐंकर किया गया है. |
anchor | Integer | चार्ट का बायां हिस्सा इस कॉलम में ऐंकर किया गया है. |
offsetX | Integer | चार्ट का ऊपर दायां कोना, इतने पिक्सल से ऑफ़सेट होता है. |
offsetY | Integer | चार्ट का सबसे नीचे बायां कोना, इतने पिक्सल से ऑफ़सेट होता है. |
वापसी का टिकट
Embedded
— यह बिल्डर, चेनिंग के लिए है.
set Transpose Rows And Columns(transpose)
इससे यह तय किया जाता है कि चार्ट की पंक्तियों और कॉलम की अदला-बदली की जाए या नहीं. अगर इसे true
पर सेट किया जाता है, तो पंक्तियों और कॉलम की अदला-बदली हो जाती है. डिफ़ॉल्ट रूप से, यह false
पर सेट होती है.
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);
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
transpose | Boolean | अगर true है, तो चार्ट बनाने के लिए इस्तेमाल की गई पंक्तियों और कॉलम को ट्रांसपोज़ किया जाता है. |
वापसी का टिकट
Embedded
— यह बिल्डर, चेनिंग के लिए है.