تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class 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)`

تُضيف هذه السمة نطاقًا إلى الرسم البياني الذي يعدّله هذا المُنشئ. لا تُضيف النطاق إذا سبق أن تمت إضافته إلى الرسم البياني.

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`	النطاق المطلوب إضافته.

الإرجاع

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

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

الإرجاع

EmbeddedChart: الرسم البياني الذي تم إنشاؤه، والذي يجب إضافته إلى جدول البيانات

`clearRanges()`

تزيل جميع النطاقات من الرسم البياني الذي يعدّله هذا المنشئ.

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

الإرجاع

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.
const 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.
const 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 الذي يحدِّد موضع ظهور الرسم البياني على الجدول

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

الإرجاع

ContainerInfo: عنصر يحتوي على موضع حاوية الرسم البياني

`getRanges()`

تعرِض هذه الدالة نسخة من قائمة النطاقات التي تقدّم حاليًا بيانات لهذا الرسم البياني. استخدِم addRange(range) وremoveRange(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[]: صفيف من النطاقات التي تُستخدَم كمصدر بيانات الرسم البياني الذي سيتم إنشاؤه

`removeRange(range)`

تزيل هذه الدالة النطاق المحدّد من الرسم البياني الذي يعدّله هذا المنشئ. لا يؤدي إلى ظهور خطأ إذا لم يكن النطاق مضمّنًا في هذا الرسم البياني.

يجب أن يتطابق النطاق الذي تمت إزالته مع نطاق تمت إضافته من خلال addRange(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`	النطاق المطلوب إزالته.

الإرجاع

EmbeddedChartBuilder — هذا المُنشئ، لتسلسل العناصر

`setChartType(type)`

لتغيير نوع الرسم البياني لا تتوفّر حاليًا بعض أنواع الرسوم البيانية المضمّنة. يمكنك الاطّلاع على ChartType.

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`	`ChartType`	النوع الذي تريد تغيير هذا الرسم البياني إليه.

الإرجاع

EmbeddedChartBuilder — هذا المُنشئ، لتسلسل العناصر

`setFirstRowNumber(number)`

لتحديد رقم الصف الأول في جدول البيانات

رقم الصف التلقائي للصف الأول هو 1.

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

المعلمات

الاسم	النوع	الوصف
`number`	`Integer`	رقم الصف الأول في جدول البيانات

الإرجاع

‫EmbeddedTableChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

`setHiddenDimensionStrategy(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`	`ChartHiddenDimensionStrategy`	الاستراتيجية التي سيتم استخدامها للصفوف والأعمدة المخفية.

الإرجاع

EmbeddedChartBuilder — هذا المُنشئ، لتسلسل العناصر

`setInitialSortingAscending(column)`

لضبط فهرس العمود الذي يجب ترتيب الجدول وفقًا له في البداية (تصاعديًا).

تم ترتيب العمود تصاعديًا وتم وضع سهم صغير عليه يشير إلى ذلك.

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

المعلمات

الاسم	النوع	الوصف
`column`	`Integer`	رقم العمود الذي يجب ترتيب الجدول وفقًا له في البداية.

الإرجاع

‫EmbeddedTableChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

`setInitialSortingDescending(column)`

لضبط فهرس العمود الذي يجب ترتيب الجدول وفقًا له في البداية (تنازليًا).

تم ترتيب العمود تنازليًا وتم وضع سهم صغير عليه يشير إلى ذلك.

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

المعلمات

الاسم	النوع	الوصف
`column`	`Integer`	رقم العمود الذي يجب ترتيب الجدول وفقًا له في البداية.

الإرجاع

‫EmbeddedTableChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

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

المعلمات

الاسم	النوع	الوصف
`mergeStrategy`	`ChartMergeStrategy`	استراتيجية الدمج التي سيتم استخدامها.

الإرجاع

EmbeddedChartBuilder — هذا المُنشئ، لتسلسل العناصر

`setNumHeaders(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`	عدد الصفوف أو الأعمدة التي سيتم التعامل معها كعناوين تؤدي القيم السلبية إلى رصد العناوين تلقائيًا.

الإرجاع

EmbeddedChartBuilder — هذا المُنشئ، لتسلسل العناصر

`setOption(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`	قيمة الخيار

الإرجاع

EmbeddedChartBuilder: هذا المُنشئ، لتسلسل العناصر.

`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`

لضبط الموضع، وتغيير مكان ظهور الرسم البياني على ورقة البيانات يتمّ ترقيم anchorRowPos و anchorColPos بدءًا من 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);

المعلمات

الاسم	النوع	الوصف
`anchorRowPos`	`Integer`	يتم تثبيت الجانب العلوي من الرسم البياني في هذا الصف.
`anchorColPos`	`Integer`	يتم تثبيت الجانب الأيسر من الرسم البياني في هذا العمود.
`offsetX`	`Integer`	يتم تعويض الزاوية العلوية اليسرى من الرسم البياني بعدد هذا القدر من البكسل.
`offsetY`	`Integer`	يتم تعويض الزاوية اليسرى السفلية للرسم البياني بعدد هذا القدر من البكسل.

الإرجاع

EmbeddedChartBuilder — هذا المُنشئ، لتسلسل العناصر

`setTransposeRowsAndColumns(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`، يتم قلب الصفوف والأعمدة المستخدَمة لإنشاء الرسم البياني.

الإرجاع

EmbeddedChartBuilder — هذا المُنشئ، لتسلسل العناصر

`showRowNumberColumn(showRowNumber)`

لتحديد ما إذا كان سيتم عرض رقم الصف كأول عمود في الجدول.

لا يعرض السلوك التلقائي أرقام الصفوف.

المعلمات

الاسم	النوع	الوصف
`showRowNumber`	`Boolean`	`true` إذا كان يجب أن يعرض العمود الأول من الجدول رقم الصف، `false` بخلاف ذلك.

الإرجاع

‫EmbeddedTableChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

`useAlternatingRowStyle(alternate)`

لتحديد ما إذا كان سيتم تعيين نمط الألوان المتناوبة للصفوف الفردية والزوجية في الرسم البياني للجدول.

السلوك التلقائي هو أنّ الصفوف لها نمط ألوان متغيّر.

المعلمات

الاسم	النوع	الوصف
`alternate`	`Boolean`	`true` إذا كان يجب أن تكون أنماط الألوان بديلة، `false` بخلاف ذلك.

الإرجاع

‫EmbeddedTableChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.