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

पैरामीटर

नामटाइपब्यौरा
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 — यह बिल्डर, चेनिंग के लिए है.