इस पेज का अनुवाद Cloud Translation API से किया गया है.

Class EmbeddedChart

उस चार्ट को दिखाता है जिसे स्प्रेडशीट में एम्बेड किया गया है.

इस उदाहरण में मौजूदा चार्ट में बदलाव करने का तरीका बताया गया है:

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A2: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);

इस उदाहरण में नया चार्ट बनाने का तरीका बताया गया है:

function newChart(range, sheet) {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chartBuilder = sheet.newChart();
  chartBuilder.addRange(range)
      .setChartType(Charts.ChartType.LINE)
      .setOption('title', 'My Line Chart!');
  sheet.insertChart(chartBuilder.build());
}

माटिंग में इस्तेमाल हुए तरीके

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
`asDataSourceChart()`	`DataSourceChart`	अगर चार्ट, डेटा सोर्स चार्ट है, तो डेटा सोर्स चार्ट के इंस्टेंस पर कास्ट करता है या `null` नहीं.
`getAs(contentType)`	`Blob`	इस ऑब्जेक्ट में मौजूद डेटा को बताए गए कॉन्टेंट के प्रकार में ब्लॉब के तौर पर दिखाएं.
`getBlob()`	`Blob`	इस ऑब्जेक्ट के डेटा को BLOB के तौर पर दिखाएं.
`getChartId()`	`Integer`	चार्ट के लिए स्थायी पहचानकर्ता देता है जो चार्ट और `null` में शामिल पूरी स्प्रेडशीट में यूनीक होता है और अगर चार्ट स्प्रेडशीट में नहीं है.
`getContainerInfo()`	`ContainerInfo`	इस बात की जानकारी देता है कि चार्ट किसी शीट में कहां रखा गया है.
`getHiddenDimensionStrategy()`	`ChartHiddenDimensionStrategy`	छिपी हुई पंक्तियों और कॉलम को हैंडल करने के लिए इस्तेमाल की जाने वाली रणनीति दिखाता है.
`getMergeStrategy()`	`ChartMergeStrategy`	एक से ज़्यादा रेंज मौजूद होने पर इस्तेमाल की जाने वाली मर्ज रणनीति दिखाता है.
`getNumHeaders()`	`Integer`	रेंज की संख्या को दिखाता है जिसे हेडर के तौर पर माना जाता है.
`getOptions()`	`ChartOptions`	इस चार्ट के लिए विकल्प दिखाता है. जैसे, ऊंचाई, रंग, और ऐक्सिस.
`getRanges()`	`Range[]`	वे रेंज दिखाता है जिनका इस्तेमाल यह चार्ट, डेटा सोर्स के तौर पर करता है.
`getTransposeRowsAndColumns()`	`Boolean`	अगर `true` है, तो चार्ट को भरने के लिए इस्तेमाल की गई पंक्तियां और कॉलम स्विच किए जाते हैं.
`modify()`	`EmbeddedChartBuilder`	`EmbeddedChartBuilder` दिखाता है, जिसका इस्तेमाल इस चार्ट में बदलाव करने के लिए किया जा सकता है.

ज़्यादा जानकारी वाले दस्तावेज़

`asDataSourceChart()`

अगर चार्ट, डेटा सोर्स चार्ट है, तो डेटा सोर्स चार्ट के इंस्टेंस पर कास्ट करता है या null नहीं.

रिटर्न टिकट

DataSourceChart — डेटा सोर्स का चार्ट.

`getAs(contentType)`

इस ऑब्जेक्ट में मौजूद डेटा को बताए गए कॉन्टेंट के प्रकार में ब्लॉब के तौर पर दिखाएं. यह तरीका फ़ाइल नाम में सही एक्सटेंशन जोड़ता है—उदाहरण के लिए, "myfile.pdf". हालांकि, यह माना जाता है कि पिछली अवधि (अगर कोई है) के बाद आने वाले फ़ाइल नाम का कोई मौजूदा एक्सटेंशन है, जिसे बदला जाना चाहिए. इस वजह से, &ShoppingList.12.25.2014" "ShoppingList.12.25.pdf" में बदल जाता है.

कन्वर्ज़न के लिए रोज़ के कोटा देखने के लिए, Google की सेवाओं के लिए कोटा देखें. नए बनाए गए Google Workspace डोमेन पर, कुछ समय के लिए लागू किए जा सकने वाले सख्त नियम लागू हो सकते हैं.

पैरामीटर

नाम	टाइप	ब्यौरा
`contentType`	`String`	वह MIME टाइप जिसे बदलना है. ब्लॉब के मामले में, सिर्फ़ `'application/pdf'` मान्य विकल्प है. BMP, GIF, JPEG या PNG फ़ॉर्मैट वाली इमेज के लिए, `'image/bmp'`, `'image/gif'`, `'image/jpeg'` या `'image/png'` में से कोई भी मान्य होना चाहिए.

रिटर्न टिकट

Blob — डेटा ब्लॉब के रूप में है.

`getBlob()`

इस ऑब्जेक्ट के डेटा को BLOB के तौर पर दिखाएं.

रिटर्न टिकट

Blob — डेटा ब्लॉब के रूप में है.

`getChartId()`

चार्ट के लिए स्थायी पहचानकर्ता देता है जो चार्ट और null में शामिल पूरी स्प्रेडशीट में यूनीक होता है और अगर चार्ट स्प्रेडशीट में नहीं है.

रिटर्न टिकट

Integer — चार्ट का स्थिर आइडेंटिफ़ायर.

`getContainerInfo()`

इस बात की जानकारी देता है कि चार्ट किसी शीट में कहां रखा गया है.

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

var containerInfo = chart.getContainerInfo();

// 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 — चार्ट कंटेनर की स्थिति वाला एक ऑब्जेक्ट

`getHiddenDimensionStrategy()`

छिपी हुई पंक्तियों और कॉलम को हैंडल करने के लिए इस्तेमाल की जाने वाली रणनीति दिखाता है. डिफ़ॉल्ट 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()

// Logs the strategy to use for hidden rows and columns which is
// Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS in this case.
Logger.log(chart.getHiddenDimensionStrategy());

रिटर्न टिकट

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

`getMergeStrategy()`

एक से ज़्यादा रेंज मौजूद होने पर इस्तेमाल की जाने वाली मर्ज रणनीति दिखाता है. अगर 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("C1:C10");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .addRange(range2)
    .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs whether rows of multiple ranges are merged, which is MERGE_ROWS in this case.
Logger.log(chart.getMergeStrategy());

रिटर्न टिकट

ChartMergeStrategy — MERGE_ROWS अगर पंक्तियां एक से ज़्यादा श्रेणियों में मर्ज की गई हैं; MERGE_COLUMNS अगर कॉलम एक से ज़्यादा श्रेणियों में मर्ज किए गए हैं

`getNumHeaders()`

रेंज की संख्या को दिखाता है जिसे हेडर के तौर पर माना जाता है.

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

// Logs the number of rows or columns to use as headers, which is 1 in this case.
Logger.log(chart.getHeaders());

रिटर्न टिकट

Integer — पंक्तियों या हेडर की संख्या. नेगेटिव वैल्यू से पता चलता है कि हेडर की अपने-आप पहचान की जाती है.

`getOptions()`

इस चार्ट के लिए विकल्प दिखाता है. जैसे, ऊंचाई, रंग, और ऐक्सिस.

लौटाए गए विकल्प नहीं बदले जा सकते.

रिटर्न टिकट

ChartOptions — इस चार्ट के विकल्प, जैसे कि ऊंचाई, रंग, और ऐक्सिस.

`getRanges()`

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

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

var ranges = chart.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[] — रेंज की एक कैटगरी है, जो इस चार्ट के डेटा सोर्स के तौर पर काम करती है

`getTransposeRowsAndColumns()`

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

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

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

// Logs whether rows and columns should be transposed, which is true in this case.
Logger.log(chart.getTransposeRowsAndColumns());

रिटर्न टिकट

Boolean — true अगर चार्ट बनाने के लिए इस्तेमाल की गई पंक्तियां और कॉलम बदल दिए जाते हैं.

`modify()`

EmbeddedChartBuilder दिखाता है, जिसका इस्तेमाल इस चार्ट में बदलाव करने के लिए किया जा सकता है. सभी बदलावों को सेव करने के लिए, sheet.updateChart(chart) शुरू करें.

var sheet = SpreadsheetApp.getActiveSheet();
var chart = sheet.getCharts()[0];
chart = chart.modify()
    .setOption('width', 800)
    .setOption('height', 640)
    .setPosition(5, 5, 0, 0)
    .build();
sheet.updateChart(chart);

रिटर्न टिकट

EmbeddedChartBuilder — एम्बेड किए गए चार्ट बनाने के लिए बिल्डर