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

Class EmbeddedTableChartBuilder

سازنده برای نمودارهای جدول. برای جزئیات بیشتر، به مستندات 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`	همه محدوده‌ها را از نموداری که این سازنده اصلاح می‌کند حذف می‌کند.
`enable Paging(enablePaging)`	`Embedded Table Chart Builder`	تنظیم می کند که آیا صفحه بندی از طریق داده ها فعال شود یا خیر.
`enable Paging(pageSize)`	`Embedded Table Chart Builder`	صفحه بندی را فعال می کند و تعداد ردیف ها را در هر صفحه تنظیم می کند.
`enable Paging(pageSize, startPage)`	`Embedded Table Chart Builder`	صفحه‌بندی را فعال می‌کند، تعداد ردیف‌های هر صفحه و اولین صفحه جدول را برای نمایش تنظیم می‌کند (تعداد صفحات بر اساس صفر هستند).
`enable Rtl Table(rtlEnabled)`	`Embedded Table Chart Builder`	با معکوس کردن ترتیب ستون های جدول، پشتیبانی اولیه را برای زبان های راست به چپ (مانند عربی یا عبری) اضافه می کند، به طوری که ستون صفر سمت راست ترین ستون و آخرین ستون سمت چپ ترین ستون باشد.
`enable Sorting(enableSorting)`	`Embedded Table 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 First Row Number(number)`	`Embedded Table Chart Builder`	شماره ردیف را برای ردیف اول در جدول داده ها تنظیم می کند.
`set Hidden Dimension Strategy(strategy)`	`Embedded Chart Builder`	استراتژی را برای استفاده برای سطرها و ستون های مخفی تنظیم می کند.
`set Initial Sorting Ascending(column)`	`Embedded Table Chart Builder`	شاخص ستونی را که جدول بر اساس آن ابتدا باید مرتب شود (صعودی) را تنظیم می کند.
`set Initial Sorting Descending(column)`	`Embedded Table 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`	تعیین می‌کند ردیف‌ها و ستون‌های نمودار جابه‌جا شوند یا خیر.
`show Row Number Column(showRowNumber)`	`Embedded Table Chart Builder`	تعیین می کند که آیا شماره ردیف به عنوان اولین ستون جدول نشان داده شود.
`use Alternating Row Style(alternate)`	`Embedded Table 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 - این سازنده، برای زنجیر کردن

`enable Paging(enablePaging)`

تنظیم می کند که آیا صفحه بندی از طریق داده ها فعال شود یا خیر.

رفتار پیش‌فرض صفحه‌بندی غیرفعال است. اگر صفحه‌بندی فعال باشد، اندازه صفحه پیش‌فرض 10 است.

پارامترها

نام	تایپ کنید	توضیحات
`enable Paging`	`Boolean`	`true` اگر صفحه بندی باید فعال باشد، در غیر این صورت `false` .

بازگشت

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

`enable Paging(pageSize)`

صفحه بندی را فعال می کند و تعداد ردیف ها را در هر صفحه تنظیم می کند.

اندازه پیش فرض صفحه 10 است.

// Creates a table chart builder and enables paging with page size of 5.
const builder = Charts.newTableChart();
builder.enablePaging(5);

پارامترها

نام	تایپ کنید	توضیحات
`page Size`	`Integer`	تعداد سطرها در هر صفحه از جدول.

بازگشت

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

`enable Paging(pageSize, startPage)`

صفحه‌بندی را فعال می‌کند، تعداد ردیف‌های هر صفحه و اولین صفحه جدول را برای نمایش تنظیم می‌کند (تعداد صفحات بر اساس صفر هستند).

اندازه صفحه پیش فرض 10 و صفحه شروع پیش فرض 0 است.

// Creates a table chart builder and enables paging with page size of 5 and
// displays page 2 first.
const builder = Charts.newTableChart();
builder.enablePaging(5, 2);

پارامترها

نام	تایپ کنید	توضیحات
`page Size`	`Integer`	تعداد سطرها در هر صفحه از جدول.
`start Page`	`Integer`	اولین صفحه جدولی که نمایش داده می شود (اعداد صفحات بر اساس صفر هستند).

بازگشت

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

`enable Rtl Table(rtlEnabled)`

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

این بر شاخص ستون در داده‌های زیربنایی تأثیر نمی‌گذارد، فقط ترتیب نمایش را تحت تأثیر قرار می‌دهد. نمایش زبان کامل دو جهته (BiDi) توسط تجسم جدول حتی با این گزینه پشتیبانی نمی شود. اگر صفحه‌بندی را فعال کنید (با استفاده از گزینه صفحه)، یا اگر جدول دارای نوارهای پیمایش باشد، این گزینه نادیده گرفته می‌شود زیرا گزینه‌های ارتفاع و عرض کوچک‌تر از اندازه جدول مورد نیاز را مشخص کرده‌اید. رفتار پیش‌فرض پشتیبانی RTL غیرفعال است.

پارامترها

نام	تایپ کنید	توضیحات
`rtl Enabled`	`Boolean`	`true` اگر پشتیبانی از راست به چپ باید فعال شود، در غیر این صورت `false` .

بازگشت

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

`enable Sorting(enableSorting)`

تنظیم می کند که آیا وقتی کاربر روی عنوان ستون کلیک می کند، ستون ها مرتب شوند یا خیر.

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

پارامترها

نام	تایپ کنید	توضیحات
`enable Sorting`	`Boolean`	`true` تا مرتب‌سازی را با کلیک کردن روی سرصفحه‌های ستون فعال کنید، در غیر این صورت `false` .

بازگشت

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

`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 First Row Number(number)`

شماره ردیف را برای ردیف اول در جدول داده ها تنظیم می کند.

شماره ردیف پیش فرض ردیف اول 1 است.

// Creates a table chart builder and sets the first row to be 2.
const builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

پارامترها

نام	تایپ کنید	توضیحات
`number`	`Integer`	شماره ردیف برای ردیف اول در جدول داده ها.

بازگشت

Embedded Table 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 Initial Sorting Ascending(column)`

شاخص ستونی را که جدول بر اساس آن ابتدا باید مرتب شود (صعودی) را تنظیم می کند.

ستون OS به ترتیب صعودی مرتب شده و با یک فلش کوچک نشان داده شده است.

// Creates a table chart builder and sorts it by the second column (ascending).
const builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

پارامترها

نام	تایپ کنید	توضیحات
`column`	`Integer`	شماره ستونی که جدول ابتدا باید بر اساس آن مرتب شود.

بازگشت

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

`set Initial Sorting Descending(column)`

شاخص ستونی را که جدول بر اساس آن ابتدا باید مرتب شود (نزولی) را تنظیم می کند.

ستون OS به ترتیب نزولی مرتب شده است و با یک فلش کوچک نشان داده شده است.

// Creates a table chart builder and sorts it by the second column (descending).
const builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

پارامترها

نام	تایپ کنید	توضیحات
`column`	`Integer`	شماره ستونی که جدول ابتدا باید بر اساس آن مرتب شود.

بازگشت

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

`show Row Number Column(showRowNumber)`

تعیین می کند که آیا شماره ردیف به عنوان اولین ستون جدول نشان داده شود.

رفتار پیش‌فرض اعداد ردیف را نشان نمی‌دهد.

پارامترها

نام	تایپ کنید	توضیحات
`show Row Number`	`Boolean`	`true` اگر ستون اول جدول باید شماره ردیف را نشان دهد، در غیر این صورت `false` .

بازگشت

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

`use Alternating Row Style(alternate)`

تعیین می کند که آیا سبک رنگ متناوب به ردیف های زوج و فرد از نمودار جدول اختصاص داده شود.

رفتار پیش‌فرض ردیف‌هایی است که سبک رنگ متناوب دارند.

پارامترها

نام	تایپ کنید	توضیحات
`alternate`	`Boolean`	`true` اگر سبک رنگ باید متناوب باشد، در غیر این صورت `false` .

بازگشت

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