এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

Class EmbeddedChartBuilder

একটি EmbeddedChart সম্পাদনা করতে বিল্ডার ব্যবহার করা হয়। পুনর্নির্মিত চার্টটিতে Sheet.updateChart(chart) কল না করা পর্যন্ত চার্টে করা পরিবর্তনগুলো সংরক্ষিত হয় না।

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B8');
let 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);

পদ্ধতি

পদ্ধতি	রিটার্ন টাইপ	সংক্ষিপ্ত বিবরণ
`add Range(range)`	`Embedded Chart Builder`	এই বিল্ডার দ্বারা পরিবর্তিত চার্টে একটি রেঞ্জ যোগ করে।
`as Area Chart()`	`Embedded Area Chart Builder`	চার্টের ধরণকে AreaChart-এ সেট করে এবং একটি `Embedded Area Chart Builder` ফেরত দেয়।
`as Bar Chart()`	`Embedded Bar Chart Builder`	চার্টের ধরণ বারচার্ট-এ সেট করে এবং একটি `Embedded Bar Chart Builder` ফেরত দেয়।
`as Column Chart()`	`Embedded Column Chart Builder`	চার্টের ধরণকে কলামচার্ট (ColumnChart) হিসেবে সেট করে এবং একটি `Embedded Column Chart Builder` ফেরত দেয়।
`as Combo Chart()`	`Embedded Combo Chart Builder`	চার্টের ধরণ কম্বোচার্ট-এ সেট করে এবং একটি `Embedded Combo Chart Builder` ফেরত দেয়।
`as Histogram Chart()`	`Embedded Histogram Chart Builder`	চার্টের ধরণকে HistogramChart-এ সেট করে এবং একটি `Embedded Histogram Chart Builder` ফেরত দেয়।
`as Line Chart()`	`Embedded Line Chart Builder`	চার্টের ধরণকে লাইনচার্ট (LineChart) হিসেবে সেট করে এবং একটি `Embedded Line Chart Builder` ফেরত দেয়।
`as Pie Chart()`	`Embedded Pie Chart Builder`	চার্টের ধরণ পাইচার্ট-এ সেট করে এবং একটি `Embedded Pie Chart Builder` ফেরত দেয়।
`as Scatter Chart()`	`Embedded Scatter Chart Builder`	চার্টের ধরণকে স্ক্যাটারচার্ট (ScatterChart) হিসেবে সেট করে এবং একটি `Embedded Scatter Chart Builder` ফেরত দেয়।
`as Table Chart()`	`Embedded Table Chart Builder`	চার্টের ধরণকে টেবিলচার্ট (TableChart) হিসেবে সেট করে এবং একটি `Embedded Table Chart Builder` ফেরত দেয়।
`build()`	`Embedded Chart`	চার্টটিতে করা সমস্ত পরিবর্তন প্রতিফলিত করার জন্য এটি তৈরি করে।
`clear Ranges()`	`Embedded Chart Builder`	এই বিল্ডার দ্বারা পরিবর্তিত চার্ট থেকে সমস্ত রেঞ্জ মুছে ফেলে।
`get Chart Type()`	`Chart Type`	বর্তমান চার্টের ধরণ ফেরত দেয়।
`get Container()`	`Container Info`	চার্ট `Container Info` ফেরত দিন, যা শীটে চার্টটির অবস্থানকে অন্তর্ভুক্ত করে।
`get Ranges()`	`Range[]`	বর্তমানে এই চার্টের জন্য ডেটা সরবরাহকারী রেঞ্জগুলির তালিকার একটি অনুলিপি ফেরত দেয়।
`remove Range(range)`	`Embedded Chart Builder`	এই বিল্ডার দ্বারা পরিবর্তিত চার্ট থেকে নির্দিষ্ট পরিসরটি মুছে ফেলে।
`set Chart Type(type)`	`Embedded Chart Builder`	চার্টের ধরন পরিবর্তন করে।
`set Hidden Dimension Strategy(strategy)`	`Embedded Chart Builder`	লুকানো সারি এবং কলামের জন্য ব্যবহৃত কৌশল নির্ধারণ করে।
`set Merge Strategy(mergeStrategy)`	`Embedded Chart Builder`	একাধিক রেঞ্জ বিদ্যমান থাকলে কোন মার্জ কৌশল ব্যবহার করা হবে তা নির্ধারণ করে।
`set Num Headers(headers)`	`Embedded Chart Builder`	রেঞ্জের কতগুলো সারি বা কলামকে হেডার হিসেবে গণ্য করা হবে, তা নির্ধারণ করে।
`set Option(option, value)`	`Embedded Chart Builder`	এই চার্টের জন্য উন্নত বিকল্পসমূহ সেট করে।
`set Position(anchorRowPos, anchorColPos, offsetX, offsetY)`	`Embedded Chart Builder`	চার্টটি শীটে কোথায় প্রদর্শিত হবে, তা নির্ধারণ করে।
`set Transpose Rows And Columns(transpose)`	`Embedded Chart Builder`	চার্টের সারি এবং কলামগুলি স্থানান্তরিত হবে কিনা তা নির্ধারণ করে।

বিস্তারিত ডকুমেন্টেশন

`addRange(range)`

এই বিল্ডার দ্বারা পরিবর্তিত চার্টে একটি রেঞ্জ যোগ করে। যদি রেঞ্জটি আগে থেকেই চার্টে যোগ করা থাকে, তবে এটি যোগ করে না।

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

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

চার্টের ধরণ HistogramChart-এ সেট করে এবং একটি EmbeddedHistogramChartBuilder রিটার্ন করে।

ফেরত

EmbeddedHistogramChartBuilder — একটি হিস্টোগ্রাম চার্ট তৈরির বিল্ডার।

`asLineChart()`

চার্টের ধরণ LineChart-এ সেট করে এবং একটি EmbeddedLineChartBuilder রিটার্ন করে।

ফেরত

EmbeddedLineChartBuilder — একটি লাইন চার্ট তৈরির বিল্ডার।

`asPieChart()`

চার্টের ধরণ পাইচার্ট (PieChart) হিসেবে সেট করে এবং একটি EmbeddedPieChartBuilder ) রিটার্ন করে।

ফেরত

EmbeddedPieChartBuilder — পাই চার্ট তৈরির একটি বিল্ডার।

`asScatterChart()`

চার্টের ধরণকে স্ক্যাটারচার্ট (ScatterChart) হিসেবে সেট করে এবং একটি EmbeddedScatterChartBuilder রিটার্ন করে।

ফেরত

EmbeddedScatterChartBuilder — একটি স্ক্যাটার চার্ট তৈরির বিল্ডার।

`asTableChart()`

চার্টের ধরণ TableChart-এ সেট করে এবং একটি EmbeddedTableChartBuilder রিটার্ন করে।

ফেরত

EmbeddedTableChartBuilder — একটি টেবিল চার্ট তৈরির বিল্ডার।

`build()`

চার্টটিতে করা সমস্ত পরিবর্তন প্রতিফলিত করার জন্য এটি তৈরি করে।

এই পদ্ধতিটি স্বয়ংক্রিয়ভাবে স্প্রেডশীটের উপরে চার্ট তৈরি করে না। একটি নতুন চার্ট অবশ্যই sheet.insertChart(chart) এর মাধ্যমে যোগ করতে হবে, এবং একটি বিদ্যমান চার্ট sheet.updateChart(chart) এর মাধ্যমে আপডেট করতে হবে।

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

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

ফেরত

EmbeddedChart — তৈরি করা চার্ট, যা এখনও স্প্রেডশিটে যোগ করতে হবে।

`clearRanges()`

এই বিল্ডার দ্বারা পরিবর্তিত চার্ট থেকে সমস্ত রেঞ্জ মুছে ফেলে।

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

// This code updates the chart to use only the new ranges while preserving the
// existing formatting of the chart.
const chart = sheet.getCharts()[0];
const newChart = chart.modify()
                     .clearRanges()
                     .addRange(sheet.getRange('A1:A5'))
                     .addRange(sheet.getRange('B1:B5'))
                     .build();
sheet.updateChart(newChart);

ফেরত

EmbeddedChartBuilder — এটি চেইনিং-এর জন্য ব্যবহৃত বিল্ডার।

`getChartType()`

বর্তমান চার্টের ধরণ ফেরত দেয়।

ফেরত

ChartType — চার্টের ধরন।

`getContainer()`

চার্টের ContainerInfo ফেরত দিন, যা শীটে চার্টটির অবস্থানকে নির্দেশ করে।

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

const 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()
const containerInfo = chartBuilder.getContainer();

// Logs the values 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) ব্যবহার করুন।

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

const chartBuilder = sheet.newChart()
                         .setChartType(Charts.ChartType.BAR)
                         .addRange(sheet.getRange('A1:B8'))
                         .setPosition(5, 5, 0, 0);

const ranges = chartBuilder.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (const i in ranges) {
  const range = ranges[i];
  Logger.log(range.getA1Notation());
}

ফেরত

Range[] — রেঞ্জসমূহের একটি অ্যারে যা নির্মিতব্য চার্টের ডেটা উৎস হিসেবে কাজ করে।

`removeRange(range)`

এই বিল্ডার দ্বারা পরিবর্তিত চার্ট থেকে নির্দিষ্ট পরিসরটি সরিয়ে দেয়। পরিসরটি এই চার্টে না থাকলে কোনো ত্রুটি দেখায় না।

মুছে ফেলা রেঞ্জটি অবশ্যই addRange(range) এর মাধ্যমে যোগ করা রেঞ্জের সাথে মিলতে হবে; অন্যথায় চার্টে কোনো পরিবর্তন করা হয় না। এই পদ্ধতিটি কোনো রেঞ্জ থেকে আংশিকভাবে মান মুছে ফেলার জন্য ব্যবহার করা যাবে না।

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

const firstRange = sheet.getRange('A1:B5');
const secondRange = sheet.getRange('A6:B8');

const chartBuilder = sheet.newChart()
                         .setChartType(Charts.ChartType.BAR)
                         .addRange(firstRange)
                         // This range renders 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
// is not removed, and does not throw an exception
chartBuilder.removeRange(firstRange);
chartBuilder.removeRange(sheet.getRange('A6:B8'));

const chart = chartBuilder.build();

sheet.insertChart(chart);

প্যারামিটার

নাম	প্রকার	বর্ণনা
`range`	`Range`	অপসারণ করার পরিসর।

ফেরত

EmbeddedChartBuilder — এটি চেইনিং-এর জন্য ব্যবহৃত বিল্ডার।

`setChartType(type)`

চার্টের ধরন পরিবর্তন করে। বর্তমানে সব এমবেডেড চার্ট টাইপ সমর্থিত নয়। ChartType ) দেখুন।

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

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

প্যারামিটার

নাম	প্রকার	বর্ণনা
`type`	`Chart Type`	যে ধরনে এই চার্টটি পরিবর্তন করতে হবে।

ফেরত

EmbeddedChartBuilder — এটি চেইনিং-এর জন্য ব্যবহৃত বিল্ডার।

`setHiddenDimensionStrategy(strategy)`

লুকানো সারি এবং কলামের জন্য ব্যবহৃত কৌশল নির্ধারণ করে। ডিফল্ট হলো IGNORE_ROWS ।

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

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setHiddenDimensionStrategy(
                      Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS,
                      )
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

প্যারামিটার

নাম	প্রকার	বর্ণনা
`strategy`	`Chart Hidden Dimension Strategy`	লুকানো সারি এবং কলামের জন্য ব্যবহারযোগ্য কৌশল।

ফেরত

EmbeddedChartBuilder — এটি চেইনিং-এর জন্য ব্যবহৃত বিল্ডার।

`setMergeStrategy(mergeStrategy)`

একাধিক রেঞ্জ থাকলে কোন মার্জ কৌশল ব্যবহার করা হবে তা নির্ধারণ করে। যদি MERGE_ROWS হয়, তাহলে সারিগুলো মার্জ করা হয়; যদি MERGE_COLUMNS , তাহলে কলামগুলো মার্জ করা হয়। ডিফল্ট হিসেবে MERGE_COLUMNS ব্যবহৃত হয়।

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

const range = sheet.getRange('A1:B10');
const range2 = sheet.getRange('C:C10');
const 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);

প্যারামিটার

নাম	প্রকার	বর্ণনা
`merge Strategy`	`Chart Merge Strategy`	ব্যবহার করার জন্য একত্রীকরণ কৌশল।

ফেরত

EmbeddedChartBuilder — এটি চেইনিং-এর জন্য ব্যবহৃত বিল্ডার।

`setNumHeaders(headers)`

রেঞ্জের কতগুলো সারি বা কলামকে হেডার হিসেবে গণ্য করা হবে, তা নির্ধারণ করে।

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

const range = sheet.getRange('A1:B5');
const 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)`

এই চার্টের জন্য উন্নত বিকল্পসমূহ নির্ধারণ করে। উপলব্ধ বিকল্পগুলির তালিকা দেখতে, চার্ট কনফিগারেশন বিকল্পসমূহ দেখুন।

এই পদ্ধতিটি যাচাই করে না যে আপনার নির্দিষ্ট করা বিকল্পটি এই চার্ট প্রকারের জন্য বৈধ কিনা, অথবা মানটি সঠিক বিন্যাস/কাঠামোর কিনা।

এই উদাহরণটিতে দেখানো হয়েছে কীভাবে শিরোনাম পরিবর্তন করতে এবং একটি লিজেন্ড সেট করতে হয়।

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const sheet = spreadsheet.getSheets()[0];
const chart = sheet.newChart()
 .setOption('title', 'Earnings projections')
 .setOption('legend', {
   position: 'top',
   textStyle: { color: 'blue', fontSize: 16 },
 }).build();

প্যারামিটার

নাম	প্রকার	বর্ণনা
`option`	`String`	বিকল্পটির নাম।
`value`	`Object`	বিকল্পটির মান।

ফেরত

EmbeddedChartBuilder — এটি চেইনিং-এর জন্য ব্যবহৃত বিল্ডার।

`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`

চার্টটি শীটে কোথায় প্রদর্শিত হবে তা নির্ধারণ করে। anchorRowPos এবং anchorColPos হলো ১-ইনডেক্সড।

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

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

প্যারামিটার

নাম	প্রকার	বর্ণনা
`anchor Row Pos`	`Integer`	চার্টটির উপরের দিকটি এই সারিতে স্থির করা আছে।
`anchor Col Pos`	`Integer`	চার্টটির বাম দিক এই কলামে স্থির করা আছে।
`offsetX`	`Integer`	চার্টটির উপরের ডানদিকের কোণাটি এই পরিমাণ পিক্সেল দ্বারা স্থানান্তরিত করা হয়েছে।
`offsetY`	`Integer`	চার্টটির নিচের বাম কোণাটি এই পরিমাণ পিক্সেল দ্বারা অফসেট করা হয়েছে।

ফেরত

EmbeddedChartBuilder — এটি চেইনিং-এর জন্য ব্যবহৃত বিল্ডার।

`setTransposeRowsAndColumns(transpose)`

চার্টের সারি এবং কলামগুলি স্থানান্তরিত হবে কিনা তা নির্ধারণ করে। যদি ' true সেট করা হয়, তাহলে সারি এবং কলামগুলি অদলবদল হয়ে যায়। ডিফল্ট মান ' false ।

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

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

sheet.insertChart(chart);

প্যারামিটার

নাম	প্রকার	বর্ণনা
`transpose`	`Boolean`	যদি `true` , তাহলে চার্টটি তৈরি করতে ব্যবহৃত সারি এবং কলামগুলো স্থানান্তরিত হয়।

ফেরত

EmbeddedChartBuilder — এটি চেইনিং-এর জন্য ব্যবহৃত বিল্ডার।