इस पेज का अनुवाद Cloud Translation API से किया गया है.

Class EmbeddedChartBuilder

EmbeddedChart में बदलाव करने के लिए इस्तेमाल किया जाने वाला बिल्डर. चार्ट में किए गए बदलाव तब तक सेव नहीं होते, जब तक कि फिर से बनाए गए चार्ट पर 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);

तरीके

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
`addRange(range)`	`EmbeddedChartBuilder`	इस बिल्डर से बदलाव किए जाने वाले चार्ट में रेंज जोड़ता है.
`asAreaChart()`	`EmbeddedAreaChartBuilder`	चार्ट टाइप को AreaChart पर सेट करता है और `EmbeddedAreaChartBuilder` दिखाता है.
`asBarChart()`	`EmbeddedBarChartBuilder`	चार्ट टाइप को BarChart पर सेट करता है और `EmbeddedBarChartBuilder` दिखाता है.
`asColumnChart()`	`EmbeddedColumnChartBuilder`	चार्ट टाइप को ColumnChart पर सेट करता है और `EmbeddedColumnChartBuilder` दिखाता है.
`asComboChart()`	`EmbeddedComboChartBuilder`	चार्ट टाइप को ComboChart पर सेट करता है और `EmbeddedComboChartBuilder` दिखाता है.
`asHistogramChart()`	`EmbeddedHistogramChartBuilder`	चार्ट टाइप को HistogramChart पर सेट करता है और `EmbeddedHistogramChartBuilder` दिखाता है.
`asLineChart()`	`EmbeddedLineChartBuilder`	चार्ट टाइप को LineChart पर सेट करता है और `EmbeddedLineChartBuilder` दिखाता है.
`asPieChart()`	`EmbeddedPieChartBuilder`	चार्ट टाइप को PieChart पर सेट करता है और `EmbeddedPieChartBuilder` दिखाता है.
`asScatterChart()`	`EmbeddedScatterChartBuilder`	चार्ट टाइप को ScatterChart पर सेट करता है और `EmbeddedScatterChartBuilder` दिखाता है.
`asTableChart()`	`EmbeddedTableChartBuilder`	चार्ट टाइप को TableChart पर सेट करता है और `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)`

इस बिल्डर से बदलाव किए जाने वाले चार्ट में रेंज जोड़ता है. अगर रेंज को पहले ही चार्ट में जोड़ दिया गया है, तो उसे नहीं जोड़ा जाता.

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`	जोड़ने के लिए रेंज.

वापसी का टिकट

EmbeddedChartBuilder — चेन बनाने के लिए यह बिल्डर

`asAreaChart()`

चार्ट टाइप को AreaChart पर सेट करता है और EmbeddedAreaChartBuilder दिखाता है.

वापसी का टिकट

EmbeddedAreaChartBuilder — एरिया चार्ट बनाने वाला बिल्डर

`asBarChart()`

चार्ट टाइप को BarChart पर सेट करता है और EmbeddedBarChartBuilder दिखाता है.

वापसी का टिकट

EmbeddedBarChartBuilder — बार चार्ट बनाने वाला टूल

`asColumnChart()`

चार्ट टाइप को ColumnChart पर सेट करता है और EmbeddedColumnChartBuilder दिखाता है.

वापसी का टिकट

EmbeddedColumnChartBuilder — कॉलम चार्ट बनाने वाला टूल

`asComboChart()`

चार्ट टाइप को ComboChart पर सेट करता है और EmbeddedComboChartBuilder दिखाता है.

वापसी का टिकट

EmbeddedComboChartBuilder — कॉम्बो चार्ट बनाने वाला बिल्डर

`asHistogramChart()`

चार्ट टाइप को HistogramChart पर सेट करता है और EmbeddedHistogramChartBuilder दिखाता है.

वापसी का टिकट

EmbeddedHistogramChartBuilder — हिस्टोग्राम चार्ट बनाने वाला बिल्डर

`asLineChart()`

चार्ट टाइप को LineChart पर सेट करता है और EmbeddedLineChartBuilder दिखाता है.

वापसी का टिकट

EmbeddedLineChartBuilder — लाइन चार्ट बनाने वाला टूल

`asPieChart()`

चार्ट टाइप को PieChart पर सेट करता है और EmbeddedPieChartBuilder दिखाता है.

वापसी का टिकट

EmbeddedPieChartBuilder — पाई चार्ट बनाने वाला टूल

`asScatterChart()`

चार्ट टाइप को ScatterChart पर सेट करता है और EmbeddedScatterChartBuilder दिखाता है.

वापसी का टिकट

EmbeddedScatterChartBuilder — स्कैटर चार्ट बनाने वाला बिल्डर

`asTableChart()`

चार्ट टाइप को TableChart पर सेट करता है और EmbeddedTableChartBuilder दिखाता है.

वापसी का टिकट

EmbeddedTableChartBuilder — टेबल चार्ट के लिए बिल्डर

`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);

वापसी का टिकट

EmbeddedChart — बनाया गया चार्ट, जिसे अब भी स्प्रेडशीट में जोड़ना होगा

`clearRanges()`

इस बिल्डर से बदलाव किए गए चार्ट से सभी रेंज हटा देता है.

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);

वापसी का टिकट

EmbeddedChartBuilder — चेन बनाने के लिए यह बिल्डर

`getChartType()`

चार्ट का मौजूदा टाइप दिखाता है.

वापसी का टिकट

ChartType — चार्ट का टाइप

`getContainer()`

चार्ट ContainerInfo दिखाता है, जो शीट पर चार्ट के दिखने की जगह को दिखाता है.

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(),
);

वापसी का टिकट

ContainerInfo — चार्ट कंटेनर की पोज़िशन वाला ऑब्जेक्ट

`getRanges()`

इस चार्ट के लिए फ़िलहाल डेटा उपलब्ध कराने वाली रेंज की सूची की कॉपी दिखाता है. इस सूची में बदलाव करने के लिए, addRange(range) और removeRange(range) का इस्तेमाल करें.

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[] — रेंज का एक कलेक्शन, जो बनाए जाने वाले चार्ट के डेटा सोर्स के तौर पर काम करता है

`removeRange(range)`

इस बिल्डर से बदलाव किए गए चार्ट से, चुनी गई रेंज को हटाता है. अगर रेंज इस चार्ट में मौजूद नहीं है, तो गड़बड़ी का मैसेज नहीं दिखता.

हटाई गई रेंज, addRange(range) की मदद से जोड़ी गई रेंज से मेल खानी चाहिए. ऐसा न होने पर, चार्ट में कोई बदलाव नहीं किया जाएगा. इस तरीके का इस्तेमाल, किसी रेंज से वैल्यू को कुछ हद तक हटाने के लिए नहीं किया जा सकता.

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`	हटाने के लिए रेंज.

वापसी का टिकट

EmbeddedChartBuilder — चेन बनाने के लिए यह बिल्डर

`setChartType(type)`

चार्ट का टाइप बदलता है. फ़िलहाल, एम्बेड किए गए सभी तरह के चार्ट काम नहीं करते. ChartType देखें.

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`	`ChartType`	इस चार्ट को किस तरह के चार्ट में बदलना है.

वापसी का टिकट

EmbeddedChartBuilder — चेन बनाने के लिए यह बिल्डर

`setHiddenDimensionStrategy(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`	`ChartHiddenDimensionStrategy`	छिपी हुई पंक्तियों और कॉलम के लिए इस्तेमाल की जाने वाली रणनीति.

वापसी का टिकट

EmbeddedChartBuilder — चेन बनाने के लिए यह बिल्डर

`setMergeStrategy(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);

पैरामीटर

नाम	टाइप	ब्यौरा
`mergeStrategy`	`ChartMergeStrategy`	मर्ज करने के लिए इस्तेमाल की जाने वाली रणनीति.

वापसी का टिकट

EmbeddedChartBuilder — चेन बनाने के लिए यह बिल्डर

`setNumHeaders(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`	हेडर के तौर पर इस्तेमाल की जाने वाली पंक्तियों या कॉलम की संख्या. नेगेटिव वैल्यू की वजह से, हेडर अपने-आप पहचाने जाते हैं.

वापसी का टिकट

EmbeddedChartBuilder — चेन बनाने के लिए यह बिल्डर

`setOption(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`	विकल्प की वैल्यू.

वापसी का टिकट

EmbeddedChartBuilder — यह बिल्डर, चेन करने के लिए है.

`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`

शीट पर चार्ट की जगह बदलकर, उसकी पोज़िशन सेट करता है. anchorRowPos और anchorColPos को 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);

पैरामीटर

नाम	टाइप	ब्यौरा
`anchorRowPos`	`Integer`	चार्ट का ऊपरी हिस्सा इस पंक्ति में ऐंकर किया जाता है.
`anchorColPos`	`Integer`	चार्ट की बाईं ओर मौजूद डेटा, इस कॉलम में ऐंकर किया गया है.
`offsetX`	`Integer`	चार्ट के सबसे ऊपर दाएं कोने को इतने पिक्सल से ऑफ़सेट किया गया है.
`offsetY`	`Integer`	चार्ट के सबसे नीचे बाएं कोने को इतने पिक्सल से ऑफ़सेट किया जाता है.

वापसी का टिकट

EmbeddedChartBuilder — चेन बनाने के लिए यह बिल्डर

`setTransposeRowsAndColumns(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` है, तो चार्ट बनाने के लिए इस्तेमाल की गई पंक्तियों और कॉलम को ट्रांसपोज़ किया जाता है.

वापसी का टिकट

EmbeddedChartBuilder — चेन बनाने के लिए यह बिल्डर