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()EmbeddedChartBuilderEmbeddedChartBuilder दिखाता है, जिसका इस्तेमाल इस चार्ट में बदलाव करने के लिए किया जा सकता है.

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

asDataSourceChart()

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

रिटर्न टिकट

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


getAs(contentType)

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

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

पैरामीटर

नामटाइपब्यौरा
contentTypeStringवह 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());

रिटर्न टिकट

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

रिटर्न टिकट

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


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 — एम्बेड किए गए चार्ट बनाने के लिए बिल्डर