سازنده نمودارهای دایره ای. برای جزئیات بیشتر، به مستندات Gviz مراجعه کنید.
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
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 | نوع نمودار را بر روی BarChart تنظیم می کند و یک Embedded Bar Chart Builder برمی گرداند. |
as Column Chart() | Embedded Column Chart Builder | نوع نمودار را روی ColumnChart تنظیم می کند و یک Embedded Column Chart Builder برمی گرداند. |
as Combo Chart() | Embedded Combo Chart Builder | نوع نمودار را روی ComboChart تنظیم می کند و یک 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 | نوع نمودار را روی PieChart تنظیم می کند و یک 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 | محدوده مشخص شده را از نموداری که سازنده اصلاح می کند حذف می کند. |
reverse Categories() | Embedded Pie Chart Builder | رسم سری ها را در محور دامنه معکوس می کند. |
set3D() | Embedded Pie Chart Builder | نمودار را سه بعدی تنظیم می کند. |
set Background Color(cssValue) | Embedded Pie Chart Builder | رنگ پس زمینه نمودار را تنظیم می کند. |
set Chart Type(type) | Embedded Chart Builder | نوع نمودار را تغییر می دهد. |
set Colors(cssValues) | Embedded Pie Chart Builder | رنگ ها را برای خطوط در نمودار تنظیم می کند. |
set Hidden Dimension Strategy(strategy) | Embedded Chart Builder | استراتژی را برای استفاده برای سطرها و ستون های مخفی تنظیم می کند. |
set Legend Position(position) | Embedded Pie Chart Builder | موقعیت افسانه را با توجه به نمودار تنظیم می کند. |
set Legend Text Style(textStyle) | Embedded Pie 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 Title(chartTitle) | Embedded Pie Chart Builder | عنوان نمودار را تعیین می کند. |
set TitleTextStyle(textStyle) | Embedded Pie 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()
نوع نمودار را بر روی BarChart تنظیم می کند و یک Embedded Bar Chart Builder
برمی گرداند.
بازگشت
Embedded Bar Chart Builder
- سازنده نمودار میله ای
as Column Chart()
نوع نمودار را روی ColumnChart تنظیم می کند و یک Embedded Column Chart Builder
برمی گرداند.
بازگشت
Embedded Column Chart Builder
- سازنده نمودار ستونی
as Combo Chart()
نوع نمودار را روی ComboChart تنظیم می کند و یک Embedded Combo Chart Builder
برمی گرداند.
بازگشت
Embedded Combo Chart Builder
- سازنده نمودار ترکیبی
as Histogram Chart()
نوع نمودار را روی HistogramChart تنظیم می کند و یک Embedded Histogram Chart Builder
را برمی گرداند.
بازگشت
Embedded Histogram Chart Builder
- سازنده نمودار هیستوگرام
as Line Chart()
نوع نمودار را روی LineChart تنظیم می کند و یک 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()
نوع نمودار را روی TableChart تنظیم میکند و یک 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
- این سازنده، برای زنجیر کردن
reverse Categories()
رسم سری ها را در محور دامنه معکوس می کند. برای نمودارهای با برد عمودی (مانند نمودارهای خط، ناحیه یا ستون)، این بدان معناست که محور افقی از راست به چپ ترسیم شده است. برای نمودارهای با دامنه افقی (مانند نمودارهای میله ای)، این بدان معنی است که محور عمودی از بالا به پایین ترسیم می شود. برای نمودار دایره ای، این بدان معناست که برش ها در خلاف جهت عقربه های ساعت کشیده می شوند.
// Creates a pie chart builder and sets drawing of the slices in a // counter-clockwise manner. const builder = Charts.newPieChart(); builder.reverseCategories();
بازگشت
Embedded Pie Chart Builder
- این سازنده، برای زنجیره زدن مفید است.
set3D()
نمودار را سه بعدی تنظیم می کند.
بازگشت
Embedded Pie Chart Builder
- این سازنده، برای زنجیره زدن مفید است.
set Background Color(cssValue)
رنگ پس زمینه نمودار را تنظیم می کند.
// Creates a line chart builder and sets the background color to gray const builder = Charts.newLineChart(); builder.setBackgroundColor('gray');
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
css Value | String | مقدار CSS برای رنگ (مانند "blue" یا "#00f" ). |
بازگشت
Embedded Pie 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 Colors(cssValues)
رنگ ها را برای خطوط در نمودار تنظیم می کند.
// Creates a line chart builder and sets the first two lines to be drawn in // green and red, respectively. const builder = Charts.newLineChart(); builder.setColors(['green', 'red']);
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
css Values | String[] | آرایه ای از مقادیر رنگی CSS، مانند ["red", "#acf"] . عنصر n در آرایه نشان دهنده رنگ خط n ام در نمودار است. |
بازگشت
Embedded Pie 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 Legend Position(position)
موقعیت افسانه را با توجه به نمودار تنظیم می کند. به طور پیش فرض، هیچ افسانه ای وجود ندارد.
// Creates a line chart builder and sets the legend position to right. const builder = Charts.newLineChart(); builder.setLegendPosition(Charts.Position.RIGHT);
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
position | Position | موقعیت افسانه. |
بازگشت
Embedded Pie Chart Builder
- این سازنده، برای زنجیره زدن مفید است.
set Legend Text Style(textStyle)
سبک متن افسانه نمودار را تنظیم می کند.
// Creates a line chart builder and sets it up for a blue, 26-point legend. const textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26); const style = textStyleBuilder.build(); const builder = Charts.newLineChart(); builder.setLegendTextStyle(style);
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
text Style | Text Style | سبک متن برای استفاده برای افسانه نمودار. |
بازگشت
Embedded Pie 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 Title(chartTitle)
عنوان نمودار را تعیین می کند. عنوان در مرکز بالای نمودار نمایش داده می شود.
// Creates a line chart builder and title to 'My Line Chart'. const builder = Charts.newLineChart(); builder.setTitle('My Line Chart');
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
chart Title | String | عنوان نمودار |
بازگشت
Embedded Pie Chart Builder
- این سازنده، برای زنجیره زدن مفید است.
set TitleTextStyle(textStyle)
سبک متن عنوان نمودار را تنظیم می کند.
// Creates a line chart builder and sets it up for a blue, 26-point title. const textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26); const style = textStyleBuilder.build(); const builder = Charts.newLineChart(); builder.setTitleTextStyle(style);
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
text Style | Text Style | سبک متنی که برای عنوان نمودار استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی Text StyleBuilder ایجاد کنید. |
بازگشت
Embedded Pie 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
- این سازنده، برای زنجیر کردن