Class 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 চার্টের ধরনটি ComboChart-এ সেট করে এবং একটি EmbeddedComboChartBuilder প্রদান করে।
asHistogramChart() EmbeddedHistogramChartBuilder চার্টের ধরনটি হিস্টোগ্রামচার্টে সেট করে এবং একটি EmbeddedHistogramChartBuilder প্রদান করে।
asLineChart() EmbeddedLineChartBuilder চার্টের ধরনটি লাইনচার্টে সেট করে এবং একটি 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()

চার্টের ধরন AreaChart-এ সেট করে এবং একটি EmbeddedAreaChartBuilder প্রদান করে।

প্রত্যাবর্তন

EmbeddedAreaChartBuilder — একটি এলাকা চার্টের জন্য একজন নির্মাতা


asBarChart()

চার্টের ধরনটি BarChart-এ সেট করে এবং একটি EmbeddedBarChartBuilder প্রদান করে।

প্রত্যাবর্তন

EmbeddedBarChartBuilder — একটি বার চার্টের জন্য একজন নির্মাতা


asColumnChart()

চার্টের ধরনটি ColumnChart-এ সেট করে এবং একটি EmbeddedColumnChartBuilder প্রদান করে।

প্রত্যাবর্তন

EmbeddedColumnChartBuilder — একটি কলাম চার্টের জন্য একজন নির্মাতা


asComboChart()

চার্টের ধরনটি ComboChart-এ সেট করে এবং একটি EmbeddedComboChartBuilder প্রদান করে।

প্রত্যাবর্তন

EmbeddedComboChartBuilder — একটি কম্বো চার্টের জন্য একজন নির্মাতা


asHistogramChart()

চার্টের ধরনটি হিস্টোগ্রামচার্টে সেট করে এবং একটি EmbeddedHistogramChartBuilder প্রদান করে।

প্রত্যাবর্তন

EmbeddedHistogramChartBuilder — একটি হিস্টোগ্রাম চার্টের জন্য একজন নির্মাতা


asLineChart()

চার্টের ধরনটি লাইনচার্টে সেট করে এবং একটি 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 — এই নির্মাতা, চেইন করার জন্য