Class EmbeddedChartBuilder

EmbeddedChartBuilder

EmbeddedChart में बदलाव करने के लिए बिल्डर का इस्तेमाल किया गया. चार्ट में किए गए बदलाव इस समय तक सेव नहीं होते फिर से बनाए गए चार्ट पर Sheet.updateChart(chart) को कॉल किया गया.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B8");
var 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चार्ट टाइप को एरिया चार्ट पर सेट करता है और EmbeddedAreaChartBuilder दिखाता है.
asBarChart()EmbeddedBarChartBuilderचार्ट टाइप को BarChart पर सेट करता है और EmbeddedBarChartBuilder दिखाता है.
asColumnChart()EmbeddedColumnChartBuilderचार्ट टाइप को ColumnChart पर सेट करता है और EmbeddedColumnChartBuilder दिखाता है.
asComboChart()EmbeddedComboChartBuilderचार्ट टाइप को कॉम्बो चार्ट पर सेट करता है और EmbeddedComboChartBuilder दिखाता है.
asHistogramChart()EmbeddedHistogramChartBuilderचार्ट टाइप को हिस्टोग्राम चार्ट पर सेट करता है और EmbeddedHistogramChartBuilder दिखाता है.
asLineChart()EmbeddedLineChartBuilderयह चार्ट टाइप को LineChart पर सेट करता है और EmbeddedLineChartBuilder दिखाता है.
asPieChart()EmbeddedPieChartBuilderचार्ट टाइप को PieChart पर सेट करता है और EmbeddedPieChartBuilder दिखाता है.
asScatterChart()EmbeddedScatterChartBuilderचार्ट टाइप को ScatterChart पर सेट करता है और EmbeddedScatterChartBuilder दिखाता है.
asTableChart()EmbeddedTableChartBuilderचार्ट टाइप को टेबलचार्ट पर सेट करता है और 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)

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

पैरामीटर

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

वापसी का टिकट

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


asAreaChart()

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

वापसी का टिकट

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


asBarChart()

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

वापसी का टिकट

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


asColumnChart()

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

वापसी का टिकट

EmbeddedColumnChartBuilder — कॉलम चार्ट के लिए बिल्डर


asComboChart()

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

वापसी का टिकट

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


asHistogramChart()

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

वापसी का टिकट

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


asLineChart()

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

वापसी का टिकट

EmbeddedLineChartBuilder — लाइन चार्ट के लिए बिल्डर


asPieChart()

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

वापसी का टिकट

EmbeddedPieChartBuilder — पाई चार्ट के लिए बिल्डर


asScatterChart()

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

वापसी का टिकट

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


asTableChart()

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

वापसी का टिकट

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


build()

इसमें किए गए सभी बदलावों को दिखाने के लिए, चार्ट बनाता है.

इस तरीके से, चार्ट अपने-आप स्प्रेडशीट में सबसे ऊपर नहीं ड्रॉ होता. एक नया चार्ट sheet.insertChart(chart) के ज़रिए शामिल किया जाना चाहिए और मौजूदा चार्ट को अपडेट किया जाना चाहिए sheet.updateChart(chart) से.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

वापसी का टिकट

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


clearRanges()

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This code updates the chart to use only the new ranges while preserving the existing
// formatting of the chart.
var chart = sheet.getCharts()[0];
var newChart = chart
    .modify()
    .clearRanges()
    .addRange(sheet.getRange("A1:A5"))
    .addRange(sheet.getRange("B1:B5"))
    .build();
sheet.updateChart(newChart);

वापसी का टिकट

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


getChartType()

यह फ़ंक्शन मौजूदा चार्ट टाइप दिखाता है.

वापसी का टिकट

ChartType — चार्ट टाइप


getContainer()

चार्ट ContainerInfo दिखाएं, जो यह बताता है कि चार्ट पर शीट.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var 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()
var containerInfo = chartBuilder.getContainer();

// Logs the values we 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) का इस्तेमाल करें.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0);

var ranges = chartBuilder.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (var i in ranges) {
  var range = ranges[i];
  Logger.log(range.getA1Notation());
}

वापसी का टिकट

Range[] — रेंज की ऐसी कैटगरी जो बनाए जाने वाले डेटा सोर्स के लिए चार्ट के तौर पर काम करती है


removeRange(range)

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

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var firstRange = sheet.getRange("A1:B5");
var secondRange = sheet.getRange("A6:B8");

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

var chart = chartBuilder.build();

sheet.insertChart(chart);

पैरामीटर

नामटाइपब्यौरा
rangeRangeवह रेंज जिसे हटाना है.

वापसी का टिकट

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


setChartType(type)

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

पैरामीटर

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

वापसी का टिकट

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


setHiddenDimensionStrategy(strategy)

छिपी हुई पंक्तियों और कॉलम के लिए इस्तेमाल की रणनीति सेट करता है. डिफ़ॉल्ट तौर पर, यह IGNORE_ROWS पर सेट होता है.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var 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 पर सेट होता है.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B10");
var range2 = sheet.getRange("C:C10");
var 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)

रेंज की उन पंक्तियों या कॉलम की संख्या तय करता है जिन्हें हेडर माना जाना चाहिए.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var 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)

इस चार्ट के लिए बेहतर विकल्प सेट करता है. उपलब्ध विकल्पों की सूची देखने के लिए, चार्ट कॉन्फ़िगरेशन के विकल्प.

यह तरीका इस चार्ट प्रकार के लिए आपके बताए गए विकल्प की पुष्टि नहीं करता और न ही वैल्यू सही फ़ॉर्मैट/स्ट्रक्चर में है.

इस उदाहरण में टाइटल बदलने और लेजेंड सेट करने का तरीका बताया गया है.

builder.setOption('title', 'Earnings projections');
builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});

पैरामीटर

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

वापसी का टिकट

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


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

जगह सेट करता है और शीट में चार्ट के दिखने की जगह बदलता है. anchorRowPos और anchorColPos को 1 इंडेक्स किया गया.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var 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 पर सेट होता है.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setTransposeRowsAndColumns(true)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

पैरामीटर

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

वापसी का टिकट

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