این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class EmbeddedLineChartBuilder

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

نوع نمودار فعلی را برمی‌گرداند.

بازگشت

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 Line 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 Line 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 Line Chart Builder - این سازنده، برای زنجیره‌بندی مفید است.

`set Curve Style(style)`

سبک را برای استفاده برای منحنی‌های نمودار تنظیم می‌کند. برای سبک‌های منحنی مجاز، به Curve Style مراجعه کنید.

// Creates a line chart builder and curves the lines in the chart.
const builder = Charts.newLineChart();
builder.setCurveStyle(Charts.CurveStyle.SMOOTH);

پارامترها

نام	تایپ کنید	توضیحات
`style`	`Curve Style`	سبک برای منحنی ها در نمودار.

بازگشت

Embedded Line Chart Builder - این سازنده، برای زنجیره‌بندی مفید است.

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

Curve Style

`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 Line 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 Line 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 Point Style(style)`

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

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

پارامترها

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

بازگشت

Embedded Line Chart Builder - این سازنده، برای زنجیره‌بندی مفید است.

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

Point Style

`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 Range(start, end)`

محدوده را برای نمودار تنظیم می کند.

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

پارامترها

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

بازگشت

Embedded Line 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 Line Chart Builder - این سازنده، برای زنجیره‌بندی مفید است.

`set Title Text Style(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` ایجاد کنید.

بازگشت

Embedded Line 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 - این سازنده، برای زنجیر کردن

`set XAxis Text Style(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` ایجاد کنید.

بازگشت

Embedded Line Chart Builder - این سازنده، برای زنجیره‌بندی مفید است.

`set XAxis Title(title)`

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

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

پارامترها

نام	تایپ کنید	توضیحات
`title`	`String`	عنوان برای محور X.

بازگشت

Embedded Line Chart Builder - این سازنده، برای زنجیره‌بندی مفید است.

`set XAxis Title Text Style(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` ایجاد کنید.

بازگشت

Embedded Line Chart Builder - این سازنده، برای زنجیره‌بندی مفید است.

`set YAxis Text Style(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` ایجاد کنید.

بازگشت

Embedded Line Chart Builder - این سازنده، برای زنجیره‌بندی مفید است.

`set YAxis Title(title)`

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

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

پارامترها

نام	تایپ کنید	توضیحات
`title`	`String`	عنوان برای محور Y.

بازگشت

Embedded Line Chart Builder - این سازنده، برای زنجیره‌بندی مفید است.

`set YAxis Title Text Style(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` ایجاد کنید.

بازگشت

Embedded Line Chart Builder - این سازنده، برای زنجیره‌بندی مفید است.

`use Log Scale()`

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

بازگشت

Embedded Line Chart Builder - این سازنده، برای زنجیره‌بندی مفید است.