Class EmbeddedAreaChartBuilder

سازنده نمودار ناحیه جاسازی‌شده

سازنده نمودارهای مساحت. برای جزئیات بیشتر، به مستندات 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 Area Chart Builder رسم سری‌ها را در محور دامنه معکوس می‌کند.
set Background Color(cssValue) Embedded Area Chart Builder رنگ پس‌زمینه را برای نمودار تنظیم می‌کند.
set Chart Type(type) Embedded Chart Builder نوع نمودار را تغییر می‌دهد.
set Colors(cssValues) Embedded Area Chart Builder رنگ خطوط نمودار را تنظیم می‌کند.
set Hidden Dimension Strategy(strategy) Embedded Chart Builder استراتژی مورد استفاده برای ردیف‌ها و ستون‌های پنهان را تنظیم می‌کند.
set Legend Position(position) Embedded Area Chart Builder موقعیت راهنما را نسبت به نمودار تنظیم می‌کند.
set Legend Text Style(textStyle) Embedded Area Chart Builder سبک متن راهنمای نمودار را تنظیم می‌کند.
set Merge Strategy(mergeStrategy) Embedded Chart Builder استراتژی ادغام را برای استفاده در زمانی که بیش از یک محدوده وجود دارد، تنظیم می‌کند.
set Num Headers(headers) Embedded Chart Builder تعداد ردیف‌ها یا ستون‌های محدوده‌ای که باید به عنوان سرصفحه در نظر گرفته شوند را تنظیم می‌کند.
set Option(option, value) Embedded Chart Builder گزینه‌های پیشرفته‌ای را برای این نمودار تنظیم می‌کند.
set Point Style(style) Embedded Area Chart Builder سبک نقاط درون خط را تنظیم می‌کند.
set Position(anchorRowPos, anchorColPos, offsetX, offsetY) Embedded Chart Builder موقعیت را تنظیم می‌کند و محل نمایش نمودار روی برگه را تغییر می‌دهد.
set Range(start, end) Embedded Area Chart Builder محدوده نمودار را تعیین می‌کند.
set Stacked() Embedded Area Chart Builder از خطوط انباشته استفاده می‌کند، به این معنی که مقادیر خط و میله روی هم انباشته (انباشته) می‌شوند.
set Title(chartTitle) Embedded Area Chart Builder عنوان نمودار را تعیین می‌کند.
set Title Text Style(textStyle) Embedded Area Chart Builder سبک متن عنوان نمودار را تنظیم می‌کند.
set Transpose Rows And Columns(transpose) Embedded Chart Builder تنظیم می‌کند که آیا ردیف‌ها و ستون‌های نمودار جابه‌جا (transposition) شوند یا خیر.
set XAxis Text Style(textStyle) Embedded Area Chart Builder سبک متن محور افقی را تنظیم می‌کند.
set XAxis Title(title) Embedded Area Chart Builder یک عنوان به محور افقی اضافه می‌کند.
set XAxis Title Text Style(textStyle) Embedded Area Chart Builder سبک متن عنوان محور افقی را تنظیم می‌کند.
set YAxis Text Style(textStyle) Embedded Area Chart Builder سبک متن محور عمودی را تنظیم می‌کند.
set YAxis Title(title) Embedded Area Chart Builder یک عنوان به محور عمودی اضافه می‌کند.
set YAxis Title Text Style(textStyle) Embedded Area Chart Builder سبک متن عنوان محور عمودی را تنظیم می‌کند.
use Log Scale() Embedded Area 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 - این سازنده، برای زنجیره‌سازی.

reverseCategories()

رسم سری‌ها را در محور دامنه معکوس می‌کند. برای نمودارهای با دامنه عمودی (مانند نمودارهای خطی، مساحتی یا ستونی)، این به این معنی است که محور افقی از راست به چپ رسم می‌شود. برای نمودارهای با دامنه افقی (مانند نمودارهای میله‌ای)، این به این معنی است که محور عمودی از بالا به پایین رسم می‌شود. برای نمودارهای دایره‌ای، این به این معنی است که برش‌ها در خلاف جهت عقربه‌های ساعت رسم می‌شوند.

// Creates a pie chart builder and sets drawing of the slices in a
// counter-clockwise manner.
const builder = Charts.newPieChart();
builder.reverseCategories();

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

setBackgroundColor(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" ).

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

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 - این سازنده، برای زنجیره‌سازی.

setColors(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ام در نمودار را نشان می‌دهد.

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

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 - این سازنده، برای زنجیره‌سازی.

setLegendPosition(position)

موقعیت راهنما را نسبت به نمودار تنظیم می‌کند. به طور پیش‌فرض، راهنما وجود ندارد. 

// Creates a line chart builder and sets the legend position to right.
const builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

پارامترها

نام نوع توضیحات
position Position جایگاه افسانه.

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

setLegendTextStyle(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 سبک متنی که برای راهنمای نمودار استفاده می‌شود.

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

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 - این سازنده، برای زنجیره‌سازی.

setPointStyle(style)

سبک نقاط در خط را تنظیم می‌کند. به طور پیش‌فرض، نقاط هیچ سبک خاصی ندارند و فقط خط قابل مشاهده است. 

// Creates a line chart builder and sets large point style.
const builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

پارامترها

نام نوع توضیحات
style Point Style سبکی که برای نقاط درون خط استفاده می‌شود.

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

همچنین ببینید

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 - این سازنده، برای زنجیره‌سازی.

setRange(start, end)

محدوده نمودار را تعیین می‌کند.

اگر هر یک از نقاط داده خارج از محدوده قرار گیرند، محدوده گسترش می‌یابد تا آن نقاط داده را شامل شود.

پارامترها

نام نوع توضیحات
start Number مقدار مربوط به پایین‌ترین خط شبکه از محور محدوده.
end Number مقدار مربوط به بالاترین خط شبکه محور برد.

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

setStacked()

از خطوط انباشته استفاده می‌کند، به این معنی که مقادیر خط و میله روی هم انباشته (انباشته) می‌شوند. به طور پیش‌فرض، هیچ انباشتگی وجود ندارد.

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

setTitle(chartTitle)

عنوان نمودار را تنظیم می‌کند. عنوان در مرکز بالای نمودار نمایش داده می‌شود. 

// Creates a line chart builder and title to 'My Line Chart'.
const builder = Charts.newLineChart();
builder.setTitle('My Line Chart');

پارامترها

نام نوع توضیحات
chart Title String عنوان نمودار.

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

setTitleTextStyle(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 Style Builder ایجاد کنید.

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

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 - این سازنده، برای زنجیره‌سازی.

setXAxisTextStyle(textStyle)

سبک متن محور افقی را تنظیم می‌کند. 

// Creates a line chart builder and sets the X-axis text style to blue, 18-point
// font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

پارامترها

نام نوع توضیحات
text Style Text Style سبک متنی که برای عنوان محور افقی استفاده می‌شود. می‌توانید با فراخوانی Charts.newTextStyle() یک شیء Text Style Builder ایجاد کنید.

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

setXAxisTitle(title)

یک عنوان به محور افقی اضافه می‌کند. عنوان در مرکز قرار می‌گیرد و زیر برچسب‌های مقادیر محور ظاهر می‌شود. 

// Creates a line chart builder and sets the X-axis title.
const builder = Charts.newLineChart();
builder.setTitle('X-axis Title');

پارامترها

نام نوع توضیحات
title String عنوان برای محور X.

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

setXAxisTitleTextStyle(textStyle)

سبک متن عنوان محور افقی را تنظیم می‌کند. 

// Creates a line chart builder and sets the X-axis title text style to blue,
// 18-point font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

پارامترها

نام نوع توضیحات
text Style Text Style سبک متنی که برای عنوان محور افقی استفاده می‌شود. می‌توانید با فراخوانی Charts.newTextStyle() یک شیء Text Style Builder ایجاد کنید.

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

setYAxisTextStyle(textStyle)

سبک متن محور عمودی را تنظیم می‌کند. 

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point
// font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

پارامترها

نام نوع توضیحات
text Style Text Style سبک متنی که برای عنوان محور افقی استفاده می‌شود. می‌توانید با فراخوانی Charts.newTextStyle() یک شیء Text Style Builder ایجاد کنید.

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

setYAxisTitle(title)

یک عنوان به محور عمودی اضافه می‌کند. عنوان در مرکز قرار می‌گیرد و در سمت چپ برچسب‌های مقدار ظاهر می‌شود. 

// Creates a line chart builder and sets the Y-axis title.
const builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title');

پارامترها

نام نوع توضیحات
title String عنوان محور Y.

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

setYAxisTitleTextStyle(textStyle)

سبک متن عنوان محور عمودی را تنظیم می‌کند. 

// Creates a line chart builder and sets the Y-axis title text style to blue,
// 18-point font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

پارامترها

نام نوع توضیحات
text Style Text Style سبک متنی که برای عنوان محور افقی استفاده می‌شود. می‌توانید با فراخوانی Charts.newTextStyle() یک شیء Text Style Builder ایجاد کنید.

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

useLogScale()

محور محدوده را به مقیاس لگاریتمی تبدیل می‌کند (نیازمند مثبت بودن همه مقادیر است). محور محدوده، محور عمودی برای نمودارهای عمودی (مانند خط، مساحت یا ستون) و محور افقی برای نمودارهای افقی (مانند میله) است.

بازگشت

EmbeddedAreaChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.