Class EmbeddedColumnChartBuilder

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

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

پارامترها

بازگشت

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

نوع نمودار را روی AreaChart تنظیم می کند و EmbeddedAreaChartBuilder را برمی گرداند.

بازگشت

EmbeddedAreaChartBuilder - سازنده برای نمودار منطقه

نوع نمودار را بر روی BarChart تنظیم می کند و EmbeddedBarChartBuilder را برمی گرداند.

بازگشت

EmbeddedBarChartBuilder - سازنده برای نمودار میله ای

نوع نمودار را روی ColumnChart تنظیم می کند و EmbeddedColumnChartBuilder را برمی گرداند.

بازگشت

EmbeddedColumnChartBuilder - سازنده برای نمودار ستونی

نوع نمودار را روی ComboChart تنظیم می کند و EmbeddedComboChartBuilder را برمی گرداند.

بازگشت

EmbeddedComboChartBuilder - سازنده یک نمودار ترکیبی

نوع نمودار را روی HistogramChart تنظیم می کند و EmbeddedHistogramChartBuilder را برمی گرداند.

بازگشت

EmbeddedHistogramChartBuilder - سازنده نمودار هیستوگرام

نوع نمودار را روی LineChart تنظیم می کند و EmbeddedLineChartBuilder را برمی گرداند.

بازگشت

EmbeddedLineChartBuilder - سازنده برای نمودار خطی

نوع نمودار را روی PieChart تنظیم می کند و EmbeddedPieChartBuilder را برمی گرداند.

بازگشت

EmbeddedPieChartBuilder - سازنده نمودار دایره ای

نوع نمودار را روی ScatterChart تنظیم می کند و EmbeddedScatterChartBuilder را برمی گرداند.

بازگشت

EmbeddedScatterChartBuilder - سازنده برای نمودار پراکندگی

نوع نمودار را روی TableChart تنظیم می کند و EmbeddedTableChartBuilder را برمی گرداند.

بازگشت

EmbeddedTableChartBuilder - سازنده برای نمودار جدول

نمودار را می سازد تا تمام تغییرات ایجاد شده در آن را منعکس کند.

این روش به طور خودکار نمودار را در بالای صفحه گسترده ترسیم نمی کند. یک نمودار جدید باید از طریق 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 - نمودار ایجاد شده، که همچنان باید به صفحه گسترده اضافه شود

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

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

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

بازگشت

ChartType - نوع نمودار

نمودار 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 - یک شی حاوی موقعیت ظرف نمودار

یک کپی از فهرست محدوده‌هایی که در حال حاضر داده‌های این نمودار را ارائه می‌دهند، برمی‌گرداند. از 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[] - آرایه ای از محدوده ها که به عنوان نموداری که قرار است منبع داده ساخته شود، عمل می کند

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

محدوده حذف شده باید با محدوده اضافه شده از طریق 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);

پارامترها

بازگشت

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

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

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

بازگشت

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

رنگ پس زمینه نمودار را تنظیم می کند.

// Creates a line chart builder and sets the background color to gray
var builder = Charts.newLineChart();
builder.setBackgroundColor("gray");

پارامترها

بازگشت

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

نوع نمودار را تغییر می دهد. همه انواع نمودارهای جاسازی شده در حال حاضر پشتیبانی نمی شوند. 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);

پارامترها

بازگشت

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

رنگ ها را برای خطوط در نمودار تنظیم می کند.

// Creates a line chart builder and sets the first two lines to be drawn in green and red,
// respectively.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

پارامترها

بازگشت

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

استراتژی را برای استفاده برای سطرها و ستون های مخفی تنظیم می کند. پیش‌فرض 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);

پارامترها

بازگشت

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

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

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

پارامترها

بازگشت

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

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

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

پارامترها

بازگشت

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

استراتژی ادغام را برای استفاده زمانی که بیش از یک محدوده وجود دارد تنظیم می کند. اگر 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);

پارامترها

بازگشت

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

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

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

پارامترها

بازگشت

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

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

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

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

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

پارامترها

بازگشت

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

موقعیت را تنظیم می کند، جایی که نمودار روی صفحه ظاهر می شود. 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);

پارامترها

بازگشت

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

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

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

پارامترها

بازگشت

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

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

بازگشت

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

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

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

پارامترها

بازگشت

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

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

// Creates a line chart builder and sets it up for a  blue, 26-point title.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

پارامترها

بازگشت

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

تعیین می‌کند ردیف‌ها و ستون‌های نمودار جابه‌جا شوند یا خیر. اگر روی 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);

پارامترها

بازگشت

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

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

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

پارامترها

بازگشت

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

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

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

پارامترها

بازگشت

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

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

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

پارامترها

بازگشت

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

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

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

پارامترها

بازگشت

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

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

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

پارامترها

بازگشت

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

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

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

پارامترها

بازگشت

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

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

بازگشت

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