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

Class EmbeddedChart

نموداری را نشان می دهد که در یک صفحه گسترده جاسازی شده است.

این مثال نحوه تغییر نمودار موجود را نشان می دهد:

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A2:B8")
var chart = sheet.getCharts()[0];
chart = chart.modify()
    .addRange(range)
    .setOption('title', 'Updated!')
    .setOption('animation.duration', 500)
    .setPosition(2,2,0,0)
    .build();
sheet.updateChart(chart);

این مثال نحوه ایجاد یک نمودار جدید را نشان می دهد:

function newChart(range, sheet) {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chartBuilder = sheet.newChart();
  chartBuilder.addRange(range)
      .setChartType(Charts.ChartType.LINE)
      .setOption('title', 'My Line Chart!');
  sheet.insertChart(chartBuilder.build());
}

مواد و روش ها

روش	نوع برگشت	توضیح مختصر
`asDataSourceChart()`	`DataSourceChart`	اگر نمودار یک نمودار منبع داده باشد، به نمونه نمودار منبع داده ارسال می شود، یا در غیر این صورت `null` .
`getAs(contentType)`	`Blob`	داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید.
`getBlob()`	`Blob`	داده های داخل این شی را به صورت حباب برگردانید.
`getChartId()`	`Integer`	یک شناسه پایدار برای نمودار برمی‌گرداند که در سراسر صفحه‌گسترده حاوی نمودار منحصربه‌فرد است یا اگر نمودار در صفحه‌گسترده نباشد، `null` است.
`getContainerInfo()`	`ContainerInfo`	اطلاعات مربوط به مکان قرارگیری نمودار در یک صفحه را برمی‌گرداند.
`getHiddenDimensionStrategy()`	`ChartHiddenDimensionStrategy`	استراتژی مورد استفاده برای مدیریت سطرها و ستون‌های پنهان را برمی‌گرداند.
`getMergeStrategy()`	`ChartMergeStrategy`	استراتژی ادغام مورد استفاده در زمانی که بیش از یک محدوده وجود دارد را برمی گرداند.
`getNumHeaders()`	`Integer`	تعداد ردیف‌ها یا ستون‌های محدوده را که به عنوان سرصفحه در نظر گرفته می‌شوند، برمی‌گرداند.
`getOptions()`	`ChartOptions`	گزینه‌های این نمودار مانند ارتفاع، رنگ‌ها و محورها را برمی‌گرداند.
`getRanges()`	`Range[]`	محدوده هایی را که این نمودار به عنوان منبع داده استفاده می کند، برمی گرداند.
`getTransposeRowsAndColumns()`	`Boolean`	اگر `true` ، سطرها و ستون‌هایی که برای پر کردن نمودار استفاده می‌شوند جابه‌جا می‌شوند.
`modify()`	`EmbeddedChartBuilder`	`EmbeddedChartBuilder` را برمی‌گرداند که می‌توان از آن برای اصلاح این نمودار استفاده کرد.

مستندات دقیق

`asDataSourceChart()`

اگر نمودار یک نمودار منبع داده باشد، به نمونه نمودار منبع داده ارسال می شود، یا در غیر این صورت null .

برگشت

DataSourceChart - نمودار منبع داده.

`getAs(contentType)`

داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. این روش پسوند مناسب را به نام فایل اضافه می کند - به عنوان مثال، "myfile.pdf". با این حال، فرض می‌کند که بخشی از نام فایل که پس از آخرین نقطه (در صورت وجود) یک پسوند موجود است که باید جایگزین شود. در نتیجه، "ShoppingList.12.25.2014" به "ShoppingList.12.25.pdf" تبدیل می شود.

برای مشاهده سهمیه های روزانه برای تبدیل، به سهمیه خدمات Google مراجعه کنید. دامنه‌های جدید Google Workspace ممکن است به طور موقت مشمول سهمیه‌های سخت‌گیرانه‌تر شوند.

مولفه های

نام	تایپ کنید	شرح
`contentType`	`String`	نوع MIME برای تبدیل. برای اکثر حباب‌ها، `'application/pdf'` تنها گزینه معتبر است. برای تصاویر با فرمت BMP، GIF، JPEG یا PNG، هر یک از `'image/bmp'` ، `'image/gif'` ، `'image/jpeg'` یا `'image/png'` نیز معتبر هستند.

برگشت

Blob - داده ها به عنوان یک لکه.

`getBlob()`

داده های داخل این شی را به صورت حباب برگردانید.

برگشت

Blob - داده ها به عنوان یک لکه.

`getChartId()`

یک شناسه پایدار برای نمودار برمی‌گرداند که در سراسر صفحه‌گسترده حاوی نمودار منحصربه‌فرد است یا اگر نمودار در صفحه‌گسترده نباشد، null است.

برگشت

Integer - یک شناسه نمودار پایدار.

`getContainerInfo()`

اطلاعات مربوط به مکان قرارگیری نمودار در یک صفحه را برمی‌گرداند.

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

var containerInfo = chart.getContainerInfo();

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

`getHiddenDimensionStrategy()`

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

// Logs the strategy to use for hidden rows and columns which is
// Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS in this case.
Logger.log(chart.getHiddenDimensionStrategy());

برگشت

ChartHiddenDimensionStrategy - استراتژی مورد استفاده برای سطرها و ستون های مخفی.

`getMergeStrategy()`

استراتژی ادغام مورد استفاده در زمانی که بیش از یک محدوده وجود دارد را برمی گرداند. اگر 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("C1:C10");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .addRange(range2)
    .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs whether rows of multiple ranges are merged, which is MERGE_ROWS in this case.
Logger.log(chart.getMergeStrategy());

برگشت

ChartMergeStrategy - MERGE_ROWS اگر ردیف ها در چندین محدوده ادغام شوند. اگر ستون‌ها در چندین محدوده ادغام شوند MERGE_COLUMNS

`getNumHeaders()`

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

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

// Logs the number of rows or columns to use as headers, which is 1 in this case.
Logger.log(chart.getHeaders());

برگشت

Integer - تعداد سطرها یا ستون هایی که به عنوان هدر در نظر گرفته می شوند. مقادیر منفی نشان می دهد که هدرها به صورت خودکار شناسایی می شوند.

`getOptions()`

گزینه‌های این نمودار مانند ارتفاع، رنگ‌ها و محورها را برمی‌گرداند.

گزینه های برگشتی تغییر ناپذیر هستند.

برگشت

ChartOptions - گزینه های این نمودار مانند ارتفاع، رنگ ها و محورها.

`getRanges()`

محدوده هایی را که این نمودار به عنوان منبع داده استفاده می کند، برمی گرداند.

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

var ranges = chart.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[] - آرایه ای از محدوده ها که به عنوان منبع داده این نمودار عمل می کنند

`getTransposeRowsAndColumns()`

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

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

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

// Logs whether rows and columns should be transposed, which is true in this case.
Logger.log(chart.getTransposeRowsAndColumns());

برگشت

Boolean - true اگر سطرها و ستون‌های مورد استفاده برای ساخت نمودار جابه‌جا شوند.

`modify()`

EmbeddedChartBuilder را برمی‌گرداند که می‌توان از آن برای اصلاح این نمودار استفاده کرد. برای ذخیره هر گونه تغییر sheet.updateChart(chart) را فراخوانی کنید.

var sheet = SpreadsheetApp.getActiveSheet();
var chart = sheet.getCharts()[0];
chart = chart.modify()
    .setOption('width', 800)
    .setOption('height', 640)
    .setPosition(5, 5, 0, 0)
    .build();
sheet.updateChart(chart);

برگشت

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