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

पैरामीटर

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

वापसी का टिकट

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

पैरामीटर

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

वापसी का टिकट

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

पैरामीटर

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

वापसी का टिकट

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

पैरामीटर

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

वापसी का टिकट

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

पैरामीटर

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

वापसी का टिकट

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

पैरामीटर

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

वापसी का टिकट

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

---

setOption(option, value)

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

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

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

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

पैरामीटर

नाम	टाइप	ब्यौरा
option	String	विकल्प का नाम.
value	Object	विकल्प का मान.

वापसी का टिकट

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

पैरामीटर

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

वापसी का टिकट

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

पैरामीटर

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

वापसी का टिकट

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