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

Class EmbeddedChart

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

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A2:B8');
let 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) {
  const sheet = SpreadsheetApp.getActiveSheet();
  const chartBuilder = sheet.newChart();
  chartBuilder.addRange(range)
      .setChartType(Charts.ChartType.LINE)
      .setOption('title', 'My Line Chart!');
  sheet.insertChart(chartBuilder.build());
}

روش ها

روش	نوع برگشت	شرح مختصر
`as Data Source Chart()`	`Data Source Chart`	اگر نمودار یک نمودار منبع داده باشد، به نمونه نمودار منبع داده ارسال می شود، یا در غیر این صورت `null` .
`get As(contentType)`	`Blob`	داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید.
`get Blob()`	`Blob`	داده های داخل این شی را به صورت حباب برگردانید.
`get Chart Id()`	`Integer`	یک شناسه پایدار برای نمودار برمی‌گرداند که در سراسر صفحه‌گسترده حاوی نمودار منحصربه‌فرد است یا اگر نمودار در صفحه‌گسترده نباشد، `null` .
`get Container Info()`	`Container Info`	اطلاعات مربوط به مکان قرارگیری نمودار در یک صفحه را برمی‌گرداند.
`get Hidden Dimension Strategy()`	`Chart Hidden Dimension Strategy`	استراتژی مورد استفاده برای مدیریت سطرها و ستون‌های پنهان را برمی‌گرداند.
`get Merge Strategy()`	`Chart Merge Strategy`	استراتژی ادغام مورد استفاده در زمانی که بیش از یک محدوده وجود دارد را برمی گرداند.
`get Num Headers()`	`Integer`	تعداد ردیف‌ها یا ستون‌های محدوده را که به عنوان سرصفحه در نظر گرفته می‌شوند، برمی‌گرداند.
`get Options()`	`Chart Options`	گزینه‌های این نمودار مانند ارتفاع، رنگ‌ها و محورها را برمی‌گرداند.
`get Ranges()`	`Range[]`	محدوده هایی را که این نمودار به عنوان منبع داده استفاده می کند، برمی گرداند.
`get Transpose Rows And Columns()`	`Boolean`	اگر `true` ، سطرها و ستون‌هایی که برای پر کردن نمودار استفاده می‌شوند جابه‌جا می‌شوند.
`modify()`	`Embedded Chart Builder`	یک `Embedded Chart Builder` را برمی‌گرداند که می‌توان از آن برای اصلاح این نمودار استفاده کرد.

مستندات دقیق

`as Data Source Chart()`

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

بازگشت

Data Source Chart - نمودار منبع داده.

`get As(contentType)`

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

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

پارامترها

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

بازگشت

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

`get Blob()`

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

بازگشت

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

`get Chart Id()`

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

بازگشت

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

`get Container Info()`

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

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

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

بازگشت

Container Info - یک شی حاوی موقعیت ظرف نمودار

`get Hidden Dimension 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();

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

بازگشت

Chart Hidden Dimension Strategy - استراتژی برای استفاده برای سطرها و ستون های پنهان.

`get Merge Strategy()`

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

بازگشت

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

`get Num 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();

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

بازگشت

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

`get Options()`

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

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

بازگشت

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

`get Ranges()`

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

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

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

`get Transpose Rows And Columns()`

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

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

const range = sheet.getRange('A1:B5');
const 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()`

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

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

بازگشت

Embedded Chart Builder - سازنده ای برای ایجاد نمودارهای جاسازی شده