Class EmbeddedTableChartBuilder

EmbeddedTableChartBuilder

سازنده برای نمودارهای جدول. برای جزئیات بیشتر، به مستندات Gviz مراجعه کنید.

مواد و روش ها

روش نوع برگشت توضیح مختصر
addRange(range) EmbeddedChartBuilder محدوده ای را به نموداری که سازنده اصلاح می کند اضافه می کند.
asAreaChart() EmbeddedAreaChartBuilder نوع نمودار را روی AreaChart تنظیم می کند و EmbeddedAreaChartBuilder را برمی گرداند.
asBarChart() EmbeddedBarChartBuilder نوع نمودار را بر روی BarChart تنظیم می کند و EmbeddedBarChartBuilder را برمی گرداند.
asColumnChart() EmbeddedColumnChartBuilder نوع نمودار را روی ColumnChart تنظیم می کند و EmbeddedColumnChartBuilder را برمی گرداند.
asComboChart() EmbeddedComboChartBuilder نوع نمودار را روی ComboChart تنظیم می کند و EmbeddedComboChartBuilder را برمی گرداند.
asHistogramChart() EmbeddedHistogramChartBuilder نوع نمودار را روی HistogramChart تنظیم می کند و EmbeddedHistogramChartBuilder را برمی گرداند.
asLineChart() EmbeddedLineChartBuilder نوع نمودار را روی LineChart تنظیم می کند و EmbeddedLineChartBuilder را برمی گرداند.
asPieChart() EmbeddedPieChartBuilder نوع نمودار را روی PieChart تنظیم می کند و EmbeddedPieChartBuilder را برمی گرداند.
asScatterChart() EmbeddedScatterChartBuilder نوع نمودار را روی ScatterChart تنظیم می کند و EmbeddedScatterChartBuilder را برمی گرداند.
asTableChart() EmbeddedTableChartBuilder نوع نمودار را روی TableChart تنظیم می کند و EmbeddedTableChartBuilder را برمی گرداند.
build() EmbeddedChart نمودار را می سازد تا تمام تغییرات ایجاد شده در آن را منعکس کند.
clearRanges() EmbeddedChartBuilder همه محدوده‌ها را از نموداری که این سازنده اصلاح می‌کند حذف می‌کند.
enablePaging(enablePaging) EmbeddedTableChartBuilder تنظیم می کند که آیا صفحه بندی از طریق داده ها فعال شود یا خیر.
enablePaging(pageSize) EmbeddedTableChartBuilder صفحه بندی را فعال می کند و تعداد ردیف ها را در هر صفحه تنظیم می کند.
enablePaging(pageSize, startPage) EmbeddedTableChartBuilder صفحه‌بندی را فعال می‌کند، تعداد ردیف‌های هر صفحه و اولین صفحه جدول را برای نمایش تنظیم می‌کند (تعداد صفحات بر اساس صفر هستند).
enableRtlTable(rtlEnabled) EmbeddedTableChartBuilder با معکوس کردن ترتیب ستون های جدول، پشتیبانی اولیه را برای زبان های راست به چپ (مانند عربی یا عبری) اضافه می کند، به طوری که ستون صفر سمت راست ترین ستون و آخرین ستون سمت چپ ترین ستون باشد.
enableSorting(enableSorting) EmbeddedTableChartBuilder تنظیم می کند که آیا وقتی کاربر روی عنوان ستون کلیک می کند، ستون ها مرتب شوند یا خیر.
getChartType() ChartType نوع نمودار فعلی را برمی‌گرداند.
getContainer() ContainerInfo نمودار ContainerInfo برگردانید، که در آن جاهایی که نمودار روی برگه ظاهر می شود، محصور می شود.
getRanges() Range[] یک کپی از فهرست محدوده‌هایی که در حال حاضر داده‌های این نمودار را ارائه می‌دهند، برمی‌گرداند.
removeRange(range) EmbeddedChartBuilder محدوده مشخص شده را از نموداری که سازنده اصلاح می کند حذف می کند.
setChartType(type) EmbeddedChartBuilder نوع نمودار را تغییر می دهد.
setFirstRowNumber(number) EmbeddedTableChartBuilder شماره ردیف را برای ردیف اول در جدول داده ها تنظیم می کند.
setHiddenDimensionStrategy(strategy) EmbeddedChartBuilder استراتژی را برای استفاده برای سطرها و ستون های مخفی تنظیم می کند.
setInitialSortingAscending(column) EmbeddedTableChartBuilder شاخص ستونی را که جدول بر اساس آن ابتدا باید مرتب شود (صعودی) را تنظیم می کند.
setInitialSortingDescending(column) EmbeddedTableChartBuilder شاخص ستونی را که جدول بر اساس آن ابتدا باید مرتب شود (نزولی) را تنظیم می کند.
setMergeStrategy(mergeStrategy) EmbeddedChartBuilder استراتژی ادغام را برای استفاده زمانی که بیش از یک محدوده وجود دارد تنظیم می کند.
setNumHeaders(headers) EmbeddedChartBuilder تعداد ردیف‌ها یا ستون‌های محدوده را که باید به عنوان سرصفحه در نظر گرفته شوند را تنظیم می‌کند.
setOption(option, value) EmbeddedChartBuilder گزینه های پیشرفته را برای این نمودار تنظیم می کند.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY) EmbeddedChartBuilder موقعیت را تنظیم می کند، جایی که نمودار روی صفحه ظاهر می شود.
setTransposeRowsAndColumns(transpose) EmbeddedChartBuilder تعیین می‌کند ردیف‌ها و ستون‌های نمودار جابه‌جا شوند یا خیر.
showRowNumberColumn(showRowNumber) EmbeddedTableChartBuilder تعیین می کند که آیا شماره ردیف به عنوان اولین ستون جدول نشان داده شود.
useAlternatingRowStyle(alternate) EmbeddedTableChartBuilder تعیین می کند که آیا سبک رنگ متناوب به ردیف های زوج و فرد از نمودار جدول اختصاص داده شود.

مستندات دقیق

addRange(range)

محدوده ای را به نموداری که سازنده اصلاح می کند اضافه می کند. اگر محدوده را قبلاً به نمودار اضافه کرده باشد، اضافه نمی کند.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var 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) به‌روزرسانی شود.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

برگشت

EmbeddedChart - نمودار ایجاد شده، که همچنان باید به صفحه گسترده اضافه شود

clearRanges()

همه محدوده‌ها را از نموداری که این سازنده اصلاح می‌کند حذف می‌کند.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This code updates the chart to use only the new ranges while preserving the existing
// formatting of the chart.
var chart = sheet.getCharts()[0];
var newChart = chart
    .modify()
    .clearRanges()
    .addRange(sheet.getRange("A1:A5"))
    .addRange(sheet.getRange("B1:B5"))
    .build();
sheet.updateChart(newChart);

برگشت

EmbeddedChartBuilder - این سازنده، برای زنجیره زدن

enablePaging(enablePaging)

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

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

مولفه های

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

برگشت

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

enablePaging(pageSize)

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

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

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

مولفه های

نام تایپ کنید شرح
pageSize Integer تعداد سطرها در هر صفحه از جدول.

برگشت

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

enablePaging(pageSize, startPage)

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

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

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

مولفه های

نام تایپ کنید شرح
pageSize Integer تعداد سطرها در هر صفحه از جدول.
startPage Integer اولین صفحه جدولی که نمایش داده می شود (اعداد صفحات بر اساس صفر هستند).

برگشت

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

enableRtlTable(rtlEnabled)

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

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

مولفه های

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

برگشت

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

enableSorting(enableSorting)

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

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

مولفه های

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

برگشت

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

getChartType()

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

برگشت

ChartType - نوع نمودار

getContainer()

نمودار ContainerInfo برگردانید، که در آن جاهایی که نمودار روی برگه ظاهر می شود، محصور می شود.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var 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()
var containerInfo = chartBuilder.getContainer();

// Logs the values we 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) برای اصلاح این لیست استفاده کنید.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0);

var ranges = chartBuilder.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (var i in ranges) {
  var range = ranges[i];
  Logger.log(range.getA1Notation());
}

برگشت

Range[] - آرایه ای از محدوده ها که به عنوان نموداری که قرار است منبع داده ساخته شود، عمل می کند

removeRange(range)

محدوده مشخص شده را از نموداری که سازنده اصلاح می کند حذف می کند. اگر محدوده در این نمودار نباشد خطایی ایجاد نمی کند.

محدوده حذف شده باید با محدوده اضافه شده از طریق addRange(range) مطابقت داشته باشد. در غیر این صورت تغییری در نمودار ایجاد نمی شود. این روش را نمی توان برای حذف بخشی از مقادیر از یک محدوده استفاده کرد.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var firstRange = sheet.getRange("A1:B5");
var secondRange = sheet.getRange("A6:B8");

var 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"));

var chart = chartBuilder.build();

sheet.insertChart(chart);

مولفه های

نام تایپ کنید شرح
range Range محدوده ای که باید حذف شود.

برگشت

EmbeddedChartBuilder - این سازنده، برای زنجیره زدن

setChartType(type)

نوع نمودار را تغییر می دهد. همه انواع نمودارهای جاسازی شده در حال حاضر پشتیبانی نمی شوند. ChartType ببینید.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

مولفه های

نام تایپ کنید شرح
type ChartType نوع تغییر این نمودار

برگشت

EmbeddedChartBuilder - این سازنده، برای زنجیره زدن

setFirstRowNumber(number)

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

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

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

مولفه های

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

برگشت

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

setHiddenDimensionStrategy(strategy)

استراتژی را برای استفاده برای سطرها و ستون های مخفی تنظیم می کند. پیش‌فرض IGNORE_ROWS است.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setHiddenDimensionStrategy(Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

مولفه های

نام تایپ کنید شرح
strategy ChartHiddenDimensionStrategy استراتژی مورد استفاده برای سطرها و ستون های مخفی.

برگشت

EmbeddedChartBuilder - این سازنده، برای زنجیره زدن

setInitialSortingAscending(column)

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

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

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

مولفه های

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

برگشت

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

setInitialSortingDescending(column)

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

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

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

مولفه های

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

برگشت

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

setMergeStrategy(mergeStrategy)

استراتژی ادغام را برای استفاده زمانی که بیش از یک محدوده وجود دارد تنظیم می کند. اگر MERGE_ROWS ، ردیف ها ادغام می شوند. اگر MERGE_COLUMNS ، ستون ها ادغام شوند. پیش‌فرض MERGE_COLUMNS است.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B10");
var range2 = sheet.getRange("C:C10");
var 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);

مولفه های

نام تایپ کنید شرح
mergeStrategy ChartMergeStrategy استراتژی ادغام برای استفاده

برگشت

EmbeddedChartBuilder - این سازنده، برای زنجیره زدن

setNumHeaders(headers)

تعداد ردیف‌ها یا ستون‌های محدوده را که باید به عنوان سرصفحه در نظر گرفته شوند را تنظیم می‌کند.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var 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)

گزینه های پیشرفته را برای این نمودار تنظیم می کند. برای مشاهده لیستی از گزینه های موجود، گزینه های پیکربندی نمودار را ببینید.

این روش گزینه ای را که مشخص کرده اید برای این نوع نمودار معتبر است و همچنین اگر مقدار از قالب/ساختار صحیح باشد، اعتبار سنجی نمی کند.

این مثال نحوه تغییر عنوان و تنظیم یک افسانه را نشان می دهد.

builder.setOption('title', 'Earnings projections');
builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});

مولفه های

نام تایپ کنید شرح
option String نام گزینه.
value Object ارزش گزینه.

برگشت

EmbeddedChartBuilder - این سازنده، برای زنجیر کردن.

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

موقعیت را تنظیم می کند، جایی که نمودار روی صفحه ظاهر می شود. anchorRowPos و anchorColPos دارای 1 ایندکس هستند.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

مولفه های

نام تایپ کنید شرح
anchorRowPos Integer سمت بالای نمودار در این ردیف لنگر انداخته است.
anchorColPos Integer سمت چپ نمودار در این ستون لنگر انداخته است.
offsetX Integer گوشه سمت راست بالای نمودار با این تعداد پیکسل جبران شده است.
offsetY Integer گوشه سمت چپ پایین نمودار با این تعداد پیکسل جبران شده است.

برگشت

EmbeddedChartBuilder - این سازنده، برای زنجیره زدن

setTransposeRowsAndColumns(transpose)

تعیین می‌کند ردیف‌ها و ستون‌های نمودار جابه‌جا شوند یا خیر. اگر روی true تنظیم شود، سطرها و ستون ها تغییر می کنند. پیش فرض ها به false .

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setTransposeRowsAndColumns(true)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

مولفه های

نام تایپ کنید شرح
transpose Boolean اگر true ، سطرها و ستون‌های مورد استفاده برای ساخت نمودار جابه‌جا می‌شوند.

برگشت

EmbeddedChartBuilder - این سازنده، برای زنجیره زدن

showRowNumberColumn(showRowNumber)

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

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

مولفه های

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

برگشت

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

useAlternatingRowStyle(alternate)

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

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

مولفه های

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

برگشت

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

،
EmbeddedTableChartBuilder

سازنده برای نمودارهای جدول. برای جزئیات بیشتر، به مستندات Gviz مراجعه کنید.

مواد و روش ها

روش نوع برگشت توضیح مختصر
addRange(range) EmbeddedChartBuilder محدوده ای را به نموداری که سازنده اصلاح می کند اضافه می کند.
asAreaChart() EmbeddedAreaChartBuilder نوع نمودار را روی AreaChart تنظیم می کند و EmbeddedAreaChartBuilder را برمی گرداند.
asBarChart() EmbeddedBarChartBuilder نوع نمودار را بر روی BarChart تنظیم می کند و EmbeddedBarChartBuilder را برمی گرداند.
asColumnChart() EmbeddedColumnChartBuilder نوع نمودار را روی ColumnChart تنظیم می کند و EmbeddedColumnChartBuilder را برمی گرداند.
asComboChart() EmbeddedComboChartBuilder نوع نمودار را روی ComboChart تنظیم می کند و EmbeddedComboChartBuilder را برمی گرداند.
asHistogramChart() EmbeddedHistogramChartBuilder نوع نمودار را روی HistogramChart تنظیم می کند و EmbeddedHistogramChartBuilder را برمی گرداند.
asLineChart() EmbeddedLineChartBuilder نوع نمودار را روی LineChart تنظیم می کند و EmbeddedLineChartBuilder را برمی گرداند.
asPieChart() EmbeddedPieChartBuilder نوع نمودار را روی PieChart تنظیم می کند و EmbeddedPieChartBuilder را برمی گرداند.
asScatterChart() EmbeddedScatterChartBuilder نوع نمودار را روی ScatterChart تنظیم می کند و EmbeddedScatterChartBuilder را برمی گرداند.
asTableChart() EmbeddedTableChartBuilder نوع نمودار را روی TableChart تنظیم می کند و EmbeddedTableChartBuilder را برمی گرداند.
build() EmbeddedChart نمودار را می سازد تا تمام تغییرات ایجاد شده در آن را منعکس کند.
clearRanges() EmbeddedChartBuilder همه محدوده‌ها را از نموداری که این سازنده اصلاح می‌کند حذف می‌کند.
enablePaging(enablePaging) EmbeddedTableChartBuilder تنظیم می کند که آیا صفحه بندی از طریق داده ها فعال شود یا خیر.
enablePaging(pageSize) EmbeddedTableChartBuilder صفحه بندی را فعال می کند و تعداد ردیف ها را در هر صفحه تنظیم می کند.
enablePaging(pageSize, startPage) EmbeddedTableChartBuilder صفحه‌بندی را فعال می‌کند، تعداد ردیف‌های هر صفحه و اولین صفحه جدول را برای نمایش تنظیم می‌کند (تعداد صفحات بر اساس صفر هستند).
enableRtlTable(rtlEnabled) EmbeddedTableChartBuilder با معکوس کردن ترتیب ستون های جدول، پشتیبانی اولیه را برای زبان های راست به چپ (مانند عربی یا عبری) اضافه می کند، به طوری که ستون صفر سمت راست ترین ستون و آخرین ستون سمت چپ ترین ستون باشد.
enableSorting(enableSorting) EmbeddedTableChartBuilder تنظیم می کند که آیا وقتی کاربر روی عنوان ستون کلیک می کند، ستون ها مرتب شوند یا خیر.
getChartType() ChartType نوع نمودار فعلی را برمی‌گرداند.
getContainer() ContainerInfo نمودار ContainerInfo برگردانید، که در آن جاهایی که نمودار روی برگه ظاهر می شود، محصور می شود.
getRanges() Range[] یک کپی از فهرست محدوده‌هایی که در حال حاضر داده‌های این نمودار را ارائه می‌دهند، برمی‌گرداند.
removeRange(range) EmbeddedChartBuilder محدوده مشخص شده را از نموداری که سازنده اصلاح می کند حذف می کند.
setChartType(type) EmbeddedChartBuilder نوع نمودار را تغییر می دهد.
setFirstRowNumber(number) EmbeddedTableChartBuilder شماره ردیف را برای ردیف اول در جدول داده ها تنظیم می کند.
setHiddenDimensionStrategy(strategy) EmbeddedChartBuilder استراتژی را برای استفاده برای سطرها و ستون های مخفی تنظیم می کند.
setInitialSortingAscending(column) EmbeddedTableChartBuilder شاخص ستونی را که جدول بر اساس آن ابتدا باید مرتب شود (صعودی) را تنظیم می کند.
setInitialSortingDescending(column) EmbeddedTableChartBuilder شاخص ستونی را که جدول بر اساس آن ابتدا باید مرتب شود (نزولی) را تنظیم می کند.
setMergeStrategy(mergeStrategy) EmbeddedChartBuilder استراتژی ادغام را برای استفاده زمانی که بیش از یک محدوده وجود دارد تنظیم می کند.
setNumHeaders(headers) EmbeddedChartBuilder تعداد ردیف‌ها یا ستون‌های محدوده را که باید به عنوان سرصفحه در نظر گرفته شوند را تنظیم می‌کند.
setOption(option, value) EmbeddedChartBuilder گزینه های پیشرفته را برای این نمودار تنظیم می کند.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY) EmbeddedChartBuilder موقعیت را تنظیم می کند، جایی که نمودار روی صفحه ظاهر می شود.
setTransposeRowsAndColumns(transpose) EmbeddedChartBuilder تعیین می‌کند ردیف‌ها و ستون‌های نمودار جابه‌جا شوند یا خیر.
showRowNumberColumn(showRowNumber) EmbeddedTableChartBuilder تعیین می کند که آیا شماره ردیف به عنوان اولین ستون جدول نشان داده شود.
useAlternatingRowStyle(alternate) EmbeddedTableChartBuilder تعیین می کند که آیا سبک رنگ متناوب به ردیف های زوج و فرد از نمودار جدول اختصاص داده شود.

مستندات دقیق

addRange(range)

محدوده ای را به نموداری که سازنده اصلاح می کند اضافه می کند. اگر محدوده را قبلاً به نمودار اضافه کرده باشد، اضافه نمی کند.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var 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) به‌روزرسانی شود.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

برگشت

EmbeddedChart - نمودار ایجاد شده، که همچنان باید به صفحه گسترده اضافه شود

clearRanges()

همه محدوده‌ها را از نموداری که این سازنده اصلاح می‌کند حذف می‌کند.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This code updates the chart to use only the new ranges while preserving the existing
// formatting of the chart.
var chart = sheet.getCharts()[0];
var newChart = chart
    .modify()
    .clearRanges()
    .addRange(sheet.getRange("A1:A5"))
    .addRange(sheet.getRange("B1:B5"))
    .build();
sheet.updateChart(newChart);

برگشت

EmbeddedChartBuilder - این سازنده، برای زنجیره زدن

enablePaging(enablePaging)

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

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

مولفه های

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

برگشت

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

enablePaging(pageSize)

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

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

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

مولفه های

نام تایپ کنید شرح
pageSize Integer تعداد سطرها در هر صفحه از جدول.

برگشت

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

enablePaging(pageSize, startPage)

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

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

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

مولفه های

نام تایپ کنید شرح
pageSize Integer تعداد سطرها در هر صفحه از جدول.
startPage Integer اولین صفحه جدولی که نمایش داده می شود (اعداد صفحات بر اساس صفر هستند).

برگشت

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

enableRtlTable(rtlEnabled)

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

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

مولفه های

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

برگشت

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

enableSorting(enableSorting)

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

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

مولفه های

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

برگشت

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

getChartType()

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

برگشت

ChartType - نوع نمودار

getContainer()

نمودار ContainerInfo برگردانید، که در آن جاهایی که نمودار روی برگه ظاهر می شود، محصور می شود.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var 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()
var containerInfo = chartBuilder.getContainer();

// Logs the values we 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) برای اصلاح این لیست استفاده کنید.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0);

var ranges = chartBuilder.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (var i in ranges) {
  var range = ranges[i];
  Logger.log(range.getA1Notation());
}

برگشت

Range[] - آرایه ای از محدوده ها که به عنوان نموداری که قرار است منبع داده ساخته شود، عمل می کند

removeRange(range)

محدوده مشخص شده را از نموداری که سازنده اصلاح می کند حذف می کند. اگر محدوده در این نمودار نباشد خطایی ایجاد نمی کند.

محدوده حذف شده باید با محدوده اضافه شده از طریق addRange(range) مطابقت داشته باشد. در غیر این صورت تغییری در نمودار ایجاد نمی شود. این روش را نمی توان برای حذف بخشی از مقادیر از یک محدوده استفاده کرد.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var firstRange = sheet.getRange("A1:B5");
var secondRange = sheet.getRange("A6:B8");

var 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"));

var chart = chartBuilder.build();

sheet.insertChart(chart);

مولفه های

نام تایپ کنید شرح
range Range محدوده ای که باید حذف شود.

برگشت

EmbeddedChartBuilder - این سازنده، برای زنجیره زدن

setChartType(type)

نوع نمودار را تغییر می دهد. همه انواع نمودارهای جاسازی شده در حال حاضر پشتیبانی نمی شوند. ChartType ببینید.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

مولفه های

نام تایپ کنید شرح
type ChartType نوع تغییر این نمودار

برگشت

EmbeddedChartBuilder - این سازنده، برای زنجیره زدن

setFirstRowNumber(number)

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

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

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

مولفه های

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

برگشت

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

setHiddenDimensionStrategy(strategy)

استراتژی را برای استفاده برای سطرها و ستون های مخفی تنظیم می کند. پیش‌فرض IGNORE_ROWS است.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setHiddenDimensionStrategy(Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

مولفه های

نام تایپ کنید شرح
strategy ChartHiddenDimensionStrategy استراتژی مورد استفاده برای سطرها و ستون های مخفی.

برگشت

EmbeddedChartBuilder - این سازنده، برای زنجیره زدن

setInitialSortingAscending(column)

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

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

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

مولفه های

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

برگشت

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

setInitialSortingDescending(column)

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

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

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

مولفه های

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

برگشت

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

setMergeStrategy(mergeStrategy)

استراتژی ادغام را برای استفاده زمانی که بیش از یک محدوده وجود دارد تنظیم می کند. اگر MERGE_ROWS ، ردیف ها ادغام می شوند. اگر MERGE_COLUMNS ، ستون ها ادغام شوند. پیش‌فرض MERGE_COLUMNS است.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B10");
var range2 = sheet.getRange("C:C10");
var 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);

مولفه های

نام تایپ کنید شرح
mergeStrategy ChartMergeStrategy استراتژی ادغام برای استفاده

برگشت

EmbeddedChartBuilder - این سازنده، برای زنجیره زدن

setNumHeaders(headers)

تعداد ردیف‌ها یا ستون‌های محدوده را که باید به عنوان سرصفحه در نظر گرفته شوند را تنظیم می‌کند.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var 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)

گزینه های پیشرفته را برای این نمودار تنظیم می کند. برای مشاهده لیستی از گزینه های موجود، گزینه های پیکربندی نمودار را ببینید.

این روش گزینه ای را که مشخص کرده اید برای این نوع نمودار معتبر است و همچنین اگر مقدار از قالب/ساختار صحیح باشد، اعتبار سنجی نمی کند.

این مثال نحوه تغییر عنوان و تنظیم یک افسانه را نشان می دهد.

builder.setOption('title', 'Earnings projections');
builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});

مولفه های

نام تایپ کنید شرح
option String نام گزینه.
value Object ارزش گزینه.

برگشت

EmbeddedChartBuilder - این سازنده، برای زنجیر کردن.

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

موقعیت را تنظیم می کند، جایی که نمودار روی صفحه ظاهر می شود. anchorRowPos و anchorColPos دارای 1 ایندکس هستند.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

مولفه های

نام تایپ کنید شرح
anchorRowPos Integer سمت بالای نمودار در این ردیف لنگر انداخته است.
anchorColPos Integer سمت چپ نمودار در این ستون لنگر انداخته است.
offsetX Integer گوشه سمت راست بالای نمودار با این تعداد پیکسل جبران شده است.
offsetY Integer گوشه سمت چپ پایین نمودار با این تعداد پیکسل جبران شده است.

برگشت

EmbeddedChartBuilder - این سازنده، برای زنجیره زدن

setTransposeRowsAndColumns(transpose)

تعیین می‌کند ردیف‌ها و ستون‌های نمودار جابه‌جا شوند یا خیر. اگر روی true تنظیم شود، سطرها و ستون ها تغییر می کنند. پیش فرض ها به false .

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setTransposeRowsAndColumns(true)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

مولفه های

نام تایپ کنید شرح
transpose Boolean اگر true ، سطرها و ستون‌های مورد استفاده برای ساخت نمودار جابه‌جا می‌شوند.

برگشت

EmbeddedChartBuilder - این سازنده، برای زنجیره زدن

showRowNumberColumn(showRowNumber)

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

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

مولفه های

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

برگشت

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

useAlternatingRowStyle(alternate)

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

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

مولفه های

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

برگشت

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