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	चार्ट टाइप को AreaChart पर सेट करता है और EmbeddedAreaChartBuilder दिखाता है.
asBarChart()	EmbeddedBarChartBuilder	चार्ट टाइप को BarChart पर सेट करता है और EmbeddedBarChartBuilder देता है.
asColumnChart()	EmbeddedColumnChartBuilder	चार्ट टाइप को ColumnChart पर सेट करता है और EmbeddedColumnChartBuilder दिखाता है.
asComboChart()	EmbeddedComboChartBuilder	चार्ट टाइप को कॉम्बो चार्ट पर सेट करता है और EmbeddedComboChartBuilder दिखाता है.
asHistogramChart()	EmbeddedHistogramChartBuilder	चार्ट टाइप को HistogramChart पर सेट करता है और EmbeddedHistogramChartBuilder दिखाता है.
asLineChart()	EmbeddedLineChartBuilder	चार्ट टाइप को LineChart पर सेट करता है और EmbeddedLineChartBuilder दिखाता है.
asPieChart()	EmbeddedPieChartBuilder	चार्ट टाइप को PieChart पर सेट करता है और EmbeddedPieChartBuilder दिखाता है.
asScatterChart()	EmbeddedScatterChartBuilder	चार्ट टाइप को स्कैटर चार्ट पर सेट करता है और EmbeddedScatterChartBuilder दिखाता है.
asTableChart()	EmbeddedTableChartBuilder	चार्ट टाइप को TablesChart पर सेट करता है और 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);

पैरामीटर

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

रिटर्न

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

---

asAreaChart()

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

रिटर्न

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

---

asBarChart()

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

रिटर्न

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

---

asColumnChart()

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

रिटर्न

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

---

asComboChart()

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

रिटर्न

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

---

asHistogramChart()

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

रिटर्न

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

---

asLineChart()

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

रिटर्न

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

---

asPieChart()

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

रिटर्न

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

---

asScatterChart()

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

रिटर्न

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

---

asTableChart()

चार्ट टाइप को TablesChart पर सेट करता है और 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);

पैरामीटर

नाम	Type	ब्यौरा
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	ब्यौरा
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);

पैरामीटर

नाम	Type	ब्यौरा
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);

पैरामीटर

नाम	Type	ब्यौरा
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);

पैरामीटर

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

रिटर्न

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

---

setOption(option, value)

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

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

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

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

पैरामीटर

नाम	Type	ब्यौरा
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);

पैरामीटर

नाम	Type	ब्यौरा
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);

पैरामीटर

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

रिटर्न

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