বিল্ডার একটি Embedded Chart সম্পাদনা করতে ব্যবহৃত হয়। পুনঃনির্মিত চার্টে 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 | চার্টের ধরন হিস্টোগ্রামচার্টে সেট করে এবং একটি Embedded Histogram Chart Builder প্রদান করে। |
as Line Chart() | Embedded Line Chart Builder | চার্টের ধরন লাইনচার্টে সেট করে এবং একটি Embedded Line Chart Builder প্রদান করে। |
as Pie Chart() | Embedded Pie Chart Builder | চার্টের ধরনটি PieChart-এ সেট করে এবং একটি Embedded Pie Chart Builder প্রদান করে। |
as Scatter Chart() | Embedded Scatter Chart Builder | চার্টের ধরনটিকে ScatterChart-এ সেট করে এবং একটি Embedded Scatter Chart Builder প্রদান করে। |
as Table Chart() | Embedded Table Chart Builder | চার্টের ধরনটি টেবিলচার্টে সেট করে এবং একটি 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 | চার্টের সারি এবং কলামগুলি স্থানান্তরিত হয়েছে কিনা তা সেট করে। |
বিস্তারিত ডকুমেন্টেশন
add Range(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 | যোগ করার ব্যাপ্তি। |
প্রত্যাবর্তন
Embedded Chart Builder — এই নির্মাতা, চেইনিংয়ের জন্য
as Area Chart()
চার্টের ধরন AreaChart এ সেট করে এবং একটি Embedded Area Chart Builder প্রদান করে।
প্রত্যাবর্তন
Embedded Area Chart Builder — একটি এলাকা চার্টের জন্য একজন নির্মাতা
as Bar Chart()
বারচার্টে চার্টের ধরন সেট করে এবং একটি Embedded Bar Chart Builder প্রদান করে।
প্রত্যাবর্তন
Embedded Bar Chart Builder — একটি বার চার্টের জন্য একজন নির্মাতা
as Column Chart()
চার্টের ধরনটি ColumnChart এ সেট করে এবং একটি Embedded Column Chart Builder প্রদান করে।
প্রত্যাবর্তন
Embedded Column Chart Builder — একটি কলাম চার্টের জন্য একজন নির্মাতা
as Combo Chart()
চার্টের ধরন কম্বোচার্টে সেট করে এবং একটি Embedded Combo Chart Builder প্রদান করে।
প্রত্যাবর্তন
Embedded Combo Chart Builder — একটি কম্বো চার্টের জন্য একজন নির্মাতা
as Histogram Chart()
চার্টের ধরন হিস্টোগ্রামচার্টে সেট করে এবং একটি Embedded Histogram Chart Builder প্রদান করে।
প্রত্যাবর্তন
Embedded Histogram Chart Builder — একটি হিস্টোগ্রাম চার্টের জন্য একজন নির্মাতা
as Line Chart()
চার্টের ধরন লাইনচার্টে সেট করে এবং একটি Embedded Line Chart Builder প্রদান করে।
প্রত্যাবর্তন
Embedded Line Chart Builder — একটি লাইন চার্টের জন্য একজন নির্মাতা
as Pie Chart()
চার্টের ধরনটি PieChart-এ সেট করে এবং একটি Embedded Pie Chart Builder প্রদান করে।
প্রত্যাবর্তন
Embedded Pie Chart Builder — পাই চার্টের জন্য একজন নির্মাতা
as Scatter Chart()
চার্টের ধরনটিকে ScatterChart-এ সেট করে এবং একটি Embedded Scatter Chart Builder প্রদান করে।
প্রত্যাবর্তন
Embedded Scatter Chart Builder — একটি স্ক্যাটার চার্টের জন্য একজন নির্মাতা
as Table Chart()
চার্টের ধরনটি টেবিলচার্টে সেট করে এবং একটি Embedded Table Chart Builder প্রদান করে।
প্রত্যাবর্তন
Embedded Table Chart Builder — একটি টেবিল চার্টের জন্য একজন নির্মাতা
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);প্রত্যাবর্তন
Embedded Chart — তৈরি করা চার্ট, যা এখনও স্প্রেডশীটে যোগ করতে হবে
clear Ranges()
এই নির্মাতার পরিবর্তন করা চার্ট থেকে সমস্ত রেঞ্জ সরিয়ে দেয়।
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);প্রত্যাবর্তন
Embedded Chart Builder — এই নির্মাতা, চেইনিংয়ের জন্য
get Chart Type()
get Container()
চার্টটি Container Info ফেরত দিন, যা শীটে চার্টটি কোথায় প্রদর্শিত হবে তা অন্তর্ভুক্ত করে।
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(),
);প্রত্যাবর্তন
Container Info — চার্ট ধারক অবস্থান ধারণকারী একটি বস্তু
get Ranges()
বর্তমানে এই চার্টের জন্য ডেটা প্রদান করা ব্যাপ্তির তালিকার একটি অনুলিপি প্রদান করে। এই তালিকাটি সংশোধন করতে add Range(range) এবং remove Range(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[] — রেঞ্জের একটি অ্যারে যা তৈরি করা ডেটা উৎস হিসেবে চার্ট হিসেবে কাজ করে
remove Range(range)
এই নির্মাতার পরিবর্তন করা চার্ট থেকে নির্দিষ্ট পরিসরটি সরিয়ে দেয়। রেঞ্জটি এই চার্টে না থাকলে ত্রুটি নিক্ষেপ করে না।
সরানো ব্যাপ্তিটি অবশ্যই add Range(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 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'));
const chart = chartBuilder.build();
sheet.insertChart(chart);পরামিতি
| নাম | টাইপ | বর্ণনা |
|---|---|---|
range | Range | যে পরিসরটি সরাতে হবে। |
প্রত্যাবর্তন
Embedded Chart Builder — এই নির্মাতা, চেইনিংয়ের জন্য
set Chart Type(type)
চার্টের ধরন পরিবর্তন করে। সব এমবেডেড চার্টের ধরন বর্তমানে সমর্থিত নয়। Chart Type দেখুন।
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 | এই চার্টটি যে প্রকারে পরিবর্তন করতে হবে। |
প্রত্যাবর্তন
Embedded Chart Builder — এই নির্মাতা, চেইনিংয়ের জন্য
set Hidden Dimension Strategy(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 | লুকানো সারি এবং কলামের জন্য ব্যবহার করার কৌশল। |
প্রত্যাবর্তন
Embedded Chart Builder — এই নির্মাতা, চেইনিংয়ের জন্য
set Merge Strategy(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 | একত্রীকরণ কৌশল ব্যবহার করার জন্য. |
প্রত্যাবর্তন
Embedded Chart Builder — এই নির্মাতা, চেইনিংয়ের জন্য
set Num Headers(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 | হেডার হিসাবে গণ্য করার জন্য সারি বা কলামের সংখ্যা। নেতিবাচক মান শিরোনাম স্বয়ংক্রিয়ভাবে সনাক্ত করা হয়. |
প্রত্যাবর্তন
Embedded Chart Builder — এই নির্মাতা, চেইনিংয়ের জন্য
set Option(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 | বিকল্পের মান। |
প্রত্যাবর্তন
Embedded Chart Builder — এই নির্মাতা, চেইনিংয়ের জন্য।
set Position(anchorRowPos, anchorColPos, offsetX, offsetY)
শীটে চার্ট কোথায় প্রদর্শিত হবে তা পরিবর্তন করে অবস্থান সেট করে। anchor Row Pos এবং anchor Col Pos 1-সূচীযুক্ত।
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 | চার্টের নীচের বাম-হাতের কোণে এই অনেক পিক্সেল দ্বারা অফসেট করা হয়েছে। |
প্রত্যাবর্তন
Embedded Chart Builder — এই নির্মাতা, চেইনিংয়ের জন্য
set Transpose Rows And Columns(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 , চার্ট তৈরি করতে ব্যবহৃত সারি এবং কলামগুলি স্থানান্তরিত হয়। |
প্রত্যাবর্তন
Embedded Chart Builder — এই নির্মাতা, চেইনিংয়ের জন্য