تمت ترجمة هذه الصفحة بواسطة 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)`

تضيف هذه السمة إمكانية استخدام اللغات التي تُكتب من اليمين إلى اليسار (مثل العربية أو العبرية) من خلال عكس ترتيب أعمدة الجدول، بحيث يكون العمود صفر هو العمود الموجود في أقصى اليمين، ويكون العمود الأخير هو العمود الموجود في أقصى اليسار.

لا يؤثر ذلك في فهرس العمود في البيانات الأساسية، بل في ترتيب العرض فقط. لا يتيح التمثيل المرئي للجدول عرض اللغات ثنائية الاتجاه بشكل كامل حتى مع تفعيل هذا الخيار. يتم تجاهل هذا الخيار إذا فعّلت تقسيم المحتوى إلى صفحات (باستخدام الخيار page)، أو إذا كان الجدول يحتوي على أشرطة تمرير لأنّك حدّدت خيارات الارتفاع والعرض أصغر من حجم الجدول المطلوب. السلوك التلقائي هو إيقاف إتاحة الكتابة من اليمين إلى اليسار.

المعلمات

الاسم	النوع	الوصف
`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 renders 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
// is not removed, and does 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: أداة إنشاء مفيدة للتسلسل

Class EmbeddedTableChartBuilder تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الطُرق

مستندات مفصّلة

addRange(range)

المعلمات

الإرجاع

asAreaChart()

الإرجاع

asBarChart()

الإرجاع

asColumnChart()

الإرجاع

asComboChart()

الإرجاع

asHistogramChart()

الإرجاع

asLineChart()

الإرجاع

asPieChart()

الإرجاع

asScatterChart()

الإرجاع

asTableChart()

الإرجاع

build()

الإرجاع

clearRanges()

الإرجاع

enablePaging(enablePaging)

المعلمات

الإرجاع

enablePaging(pageSize)

المعلمات

الإرجاع

enablePaging(pageSize, startPage)

المعلمات

الإرجاع

enableRtlTable(rtlEnabled)

المعلمات

الإرجاع

enableSorting(enableSorting)

المعلمات

الإرجاع

getChartType()

الإرجاع

getContainer()

الإرجاع

getRanges()

الإرجاع

removeRange(range)

المعلمات

الإرجاع

setChartType(type)

المعلمات

الإرجاع

setFirstRowNumber(number)

المعلمات

الإرجاع

setHiddenDimensionStrategy(strategy)

المعلمات

الإرجاع

setInitialSortingAscending(column)

المعلمات

الإرجاع

setInitialSortingDescending(column)

المعلمات

الإرجاع

setMergeStrategy(mergeStrategy)

المعلمات

الإرجاع

setNumHeaders(headers)

المعلمات

الإرجاع

setOption(option, value)

المعلمات

الإرجاع

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

المعلمات

الإرجاع

setTransposeRowsAndColumns(transpose)

Class EmbeddedTableChartBuilder

`addRange(range)`

`asAreaChart()`

`asBarChart()`

`asColumnChart()`

`asComboChart()`

`asHistogramChart()`

`asLineChart()`

`asPieChart()`

`asScatterChart()`

`asTableChart()`

`build()`

`clearRanges()`

`enablePaging(enablePaging)`

`enablePaging(pageSize)`

`enablePaging(pageSize, startPage)`

`enableRtlTable(rtlEnabled)`

`enableSorting(enableSorting)`

`getChartType()`

`getContainer()`

`getRanges()`

`removeRange(range)`

`setChartType(type)`

`setFirstRowNumber(number)`

`setHiddenDimensionStrategy(strategy)`

`setInitialSortingAscending(column)`

`setInitialSortingDescending(column)`

`setMergeStrategy(mergeStrategy)`

`setNumHeaders(headers)`

`setOption(option, value)`

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

`setTransposeRowsAndColumns(transpose)`

`showRowNumberColumn(showRowNumber)`

`useAlternatingRowStyle(alternate)`