Class EmbeddedChartBuilder

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

पैरामीटर

नामटाइपब्यौरा
rangeRangeजोड़ी जाने वाली रेंज.

वापसी का टिकट

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

पैरामीटर

नामटाइपब्यौरा
rangeRangeहटाने के लिए रेंज.

वापसी का टिकट

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

पैरामीटर

नामटाइपब्यौरा
typeChartTypeइस चार्ट को जिस टाइप में बदलना है.

वापसी का टिकट

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

पैरामीटर

नामटाइपब्यौरा
strategyChartHiddenDimensionStrategyछुपाई गई लाइनों और कॉलम के लिए इस्तेमाल की जाने वाली रणनीति.

वापसी का टिकट

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

पैरामीटर

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

वापसी का टिकट

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

पैरामीटर

नामटाइपब्यौरा
headersIntegerहेडर के तौर पर इस्तेमाल की जाने वाली पंक्तियों या कॉलम की संख्या. नेगेटिव वैल्यू की वजह से, हेडर अपने-आप पहचान लिए जाते हैं.

वापसी का टिकट

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

पैरामीटर

नामटाइपब्यौरा
optionStringविकल्प का नाम.
valueObjectविकल्प की वैल्यू.

वापसी का टिकट

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

पैरामीटर

नामटाइपब्यौरा
anchorRowPosIntegerचार्ट का ऊपरी हिस्सा इस लाइन में ऐंकर किया गया है.
anchorColPosIntegerचार्ट की बाईं ओर इस कॉलम में ऐंकर की गई है.
offsetXIntegerचार्ट का सबसे ऊपर वाला दायां कोना, इतने पिक्सल से ऑफ़सेट होता है.
offsetYIntegerचार्ट का सबसे नीचे बायां कोना, इतने पिक्सल से ऑफ़सेट होता है.

वापसी का टिकट

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

पैरामीटर

नामटाइपब्यौरा
transposeBooleanअगर true है, तो चार्ट बनाने के लिए इस्तेमाल की गई पंक्तियों और कॉलम को ट्रांसपोज़ किया जाता है.

वापसी का टिकट

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