Class EmbeddedChart

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इस ऑब्जेक्ट के अंदर का डेटा, बताए गए कॉन्टेंट टाइप में बदले गए BLOB के तौर पर दिखाएं.
getBlob()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)

इस ऑब्जेक्ट के अंदर का डेटा, बताए गए कॉन्टेंट टाइप में बदले गए BLOB के तौर पर दिखाएं. यह तरीका, फ़ाइल नाम में सही एक्सटेंशन जोड़ देता है—उदाहरण के लिए, "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' में से कोई भी मान्य. Google Docs के किसी दस्तावेज़ के लिए, 'text/markdown' भी मान्य है.

वापसी का टिकट

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