Class EmbeddedPieChartBuilder

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

سازنده نمودارهای دایره ای. برای جزئیات بیشتر، به مستندات 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()

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

بازگشت

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