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
इस बिल्डर से बदलाव किए जाने वाले चार्ट में रेंज जोड़ता है. अगर रेंज को पहले ही चार्ट में जोड़ दिया गया है, तो उसे नहीं जोड़ा जाता.
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
चार्ट टाइप को AreaChart पर सेट करता है और Embedded दिखाता है.
वापसी का टिकट
Embedded — एरिया चार्ट बनाने वाला बिल्डर
as
चार्ट टाइप को BarChart पर सेट करता है और Embedded दिखाता है.
वापसी का टिकट
Embedded — बार चार्ट बनाने वाला टूल
as
चार्ट टाइप को ColumnChart पर सेट करता है और Embedded दिखाता है.
वापसी का टिकट
Embedded — कॉलम चार्ट बनाने वाला टूल
as
चार्ट टाइप को ComboChart पर सेट करता है और Embedded दिखाता है.
वापसी का टिकट
Embedded — कॉम्बो चार्ट बनाने वाला बिल्डर
as
चार्ट टाइप को HistogramChart पर सेट करता है और Embedded दिखाता है.
वापसी का टिकट
Embedded — हिस्टोग्राम चार्ट बनाने वाला बिल्डर
as
चार्ट टाइप को LineChart पर सेट करता है और Embedded दिखाता है.
वापसी का टिकट
Embedded — लाइन चार्ट बनाने वाला टूल
as
चार्ट टाइप को PieChart पर सेट करता है और Embedded दिखाता है.
वापसी का टिकट
Embedded — पाई चार्ट बनाने वाला टूल
as
चार्ट टाइप को ScatterChart पर सेट करता है और Embedded दिखाता है.
वापसी का टिकट
Embedded — स्कैटर चार्ट बनाने वाला बिल्डर
as
चार्ट टाइप को 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
इस बिल्डर से बदलाव किए गए चार्ट से सभी रेंज हटा देता है.
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
get
चार्ट 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
इस चार्ट के लिए फ़िलहाल डेटा उपलब्ध कराने वाली रेंज की सूची की कॉपी दिखाता है. इस सूची में बदलाव करने के लिए, 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
इस बिल्डर से बदलाव किए गए चार्ट से, चुनी गई रेंज को हटाता है. अगर रेंज इस चार्ट में मौजूद नहीं है, तो गड़बड़ी का मैसेज नहीं दिखता.
हटाई गई रेंज, 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 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);
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
range | Range | हटाने के लिए रेंज. |
वापसी का टिकट
Embedded — चेन बनाने के लिए यह बिल्डर
set
चार्ट का टाइप बदलता है. फ़िलहाल, एम्बेड किए गए सभी तरह के चार्ट काम नहीं करते. 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
छिपी हुई पंक्तियों और कॉलम के लिए इस्तेमाल की जाने वाली रणनीति सेट करता है. डिफ़ॉल्ट रूप से, यह 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_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
रेंज की उन पंक्तियों या कॉलम की संख्या सेट करता है जिन्हें हेडर के तौर पर इस्तेमाल किया जाना चाहिए.
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
इस चार्ट के लिए बेहतर विकल्प सेट करता है. उपलब्ध विकल्पों की सूची देखने के लिए, चार्ट के कॉन्फ़िगरेशन के विकल्प देखें.
इस तरीके से यह पुष्टि नहीं की जाती कि आपने जो विकल्प चुना है वह इस चार्ट टाइप के लिए मान्य है या नहीं. साथ ही, यह भी पुष्टि नहीं की जाती कि वैल्यू सही फ़ॉर्मैट/स्ट्रक्चर में है या नहीं.
इस उदाहरण में, टाइटल बदलने और लेजेंड सेट करने का तरीका बताया गया है.
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
शीट पर चार्ट की जगह बदलकर, उसकी पोज़िशन सेट करता है. 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
यह सेट करता है कि चार्ट की पंक्तियों और कॉलम को ट्रांसपोज़ किया गया है या नहीं. 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 — चेन बनाने के लिए यह बिल्डर