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

Class EmbeddedTableChartBuilder

أداة إنشاء الرسوم البيانية للجداول. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات Gviz.

الطُرق

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
`addRange(range)`	`EmbeddedChartBuilder`	تضيف نطاقًا إلى الرسم البياني الذي تعدِّله أداة الإنشاء هذه.
`asAreaChart()`	`EmbeddedAreaChartBuilder`	لضبط نوع الرسم البياني على مخطط المنطقة وعرض `EmbeddedAreaChartBuilder`
`asBarChart()`	`EmbeddedBarChartBuilder`	لضبط نوع الرسم البياني على المخطط الشريطي وعرض `EmbeddedBarChartBuilder`
`asColumnChart()`	`EmbeddedColumnChartBuilder`	تضبط نوع الرسم البياني على رسم بياني عمودي وتعرض `EmbeddedColumnChartBuilder`.
`asComboChart()`	`EmbeddedComboChartBuilder`	لضبط نوع الرسم البياني على "رسم بياني مختلط" وعرض `EmbeddedComboChartBuilder`
`asHistogramChart()`	`EmbeddedHistogramChartBuilder`	لضبط نوع الرسم البياني على مخطط تكراري وعرض القيمة `EmbeddedHistogramChartBuilder`
`asLineChart()`	`EmbeddedLineChartBuilder`	لضبط نوع الرسم البياني على رسم بياني خطي وعرض `EmbeddedLineChartBuilder`
`asPieChart()`	`EmbeddedPieChartBuilder`	لضبط نوع الرسم البياني على مخطط دائري لعرض القيمة `EmbeddedPieChartBuilder`
`asScatterChart()`	`EmbeddedScatterChartBuilder`	لضبط نوع الرسم البياني على "رسم بياني بالنقاط المبعثرة" وعرض القيمة `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)`

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

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

المَعلمات

الاسم	Type	الوصف
`range`	`Range`	النطاق المطلوب إضافته.

استرجاع الكرة

EmbeddedChartBuilder: أداة إنشاء السلاسل

`asAreaChart()`

لضبط نوع الرسم البياني على مخطط المنطقة وعرض EmbeddedAreaChartBuilder

استرجاع الكرة

EmbeddedAreaChartBuilder: أداة إنشاء للرسم البياني المساحي

`asBarChart()`

لضبط نوع الرسم البياني على المخطط الشريطي وعرض EmbeddedBarChartBuilder

استرجاع الكرة

EmbeddedBarChartBuilder - أداة إنشاء للرسم البياني الشريطي

`asColumnChart()`

تضبط نوع الرسم البياني على رسم بياني عمودي وتعرض EmbeddedColumnChartBuilder.

استرجاع الكرة

EmbeddedColumnChartBuilder - أداة إنشاء للمخطط العمودي

`asComboChart()`

لضبط نوع الرسم البياني على "رسم بياني مختلط" وعرض EmbeddedComboChartBuilder

استرجاع الكرة

EmbeddedComboChartBuilder - أداة إنشاء للرسم البياني المختلط

`asHistogramChart()`

لضبط نوع الرسم البياني على مخطط تكراري وعرض القيمة EmbeddedHistogramChartBuilder

استرجاع الكرة

EmbeddedHistogramChartBuilder - أداة إنشاء للمخطط التكراري

`asLineChart()`

لضبط نوع الرسم البياني على رسم بياني خطي وعرض EmbeddedLineChartBuilder

استرجاع الكرة

EmbeddedLineChartBuilder - أداة إنشاء للرسم البياني الخطي

`asPieChart()`

لضبط نوع الرسم البياني على مخطط دائري لعرض القيمة EmbeddedPieChartBuilder

استرجاع الكرة

EmbeddedPieChartBuilder: أداة إنشاء للرسم البياني الدائري

`asScatterChart()`

لضبط نوع الرسم البياني على "رسم بياني بالنقاط المبعثرة" وعرض القيمة EmbeddedScatterChartBuilder.

استرجاع الكرة

EmbeddedScatterChartBuilder: أداة إنشاء للرسم البياني للنقاط المبعثرة

`asTableChart()`

لضبط نوع الرسم البياني على TableChart وعرض القيمة EmbeddedTableChartBuilder

استرجاع الكرة

EmbeddedTableChartBuilder: أداة إنشاء للرسم البياني الجدولي

`build()`

ينشئ المخطط ليعكس جميع التغييرات التي تم إجراؤها عليه.

لا ترسم هذه الطريقة المخطط تلقائيًا أعلى جدول البيانات. يجب إدراج رسم بياني جديد من خلال 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 - الرسم البياني الذي تم إنشاؤه، ويجب إضافته إلى جدول البيانات

`clearRanges()`

تزيل جميع النطاقات من الرسم البياني الذي تعدِّله أداة الإنشاء هذه.

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: أداة إنشاء السلاسل

`enablePaging(enablePaging)`

تحدِّد ما إذا كان سيتم تفعيل الانتقال من صفحة البيانات إلى صفحات أم لا.

ويكون السلوك التلقائي هو إيقاف نقل البيانات. في حال تفعيل التقسيم على صفحات، سيكون حجم الصفحة التلقائي هو 10 صفحات.

المَعلمات

الاسم	Type	الوصف
`enablePaging`	`Boolean`	`true` إذا كان يجب تفعيل التقسيم، أو `false` إذا لم يكن الأمر كذلك.

استرجاع الكرة

EmbeddedTableChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل

`enablePaging(pageSize)`

لتفعيل التقسيم على صفحات وتعيين عدد الصفوف في كل صفحة.

حجم الصفحة التلقائي هو 10.

// Creates a table chart builder and enables paging with page size of 5.
var builder = Charts.newTableChart();
builder.enablePaging(5);

المَعلمات

الاسم	Type	الوصف
`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.
var builder = Charts.newTableChart();
builder.enablePaging(5, 2);

المَعلمات

الاسم	Type	الوصف
`pageSize`	`Integer`	عدد الصفوف في كل صفحة من الجدول.
`startPage`	`Integer`	صفحة الجدول الأولى المطلوب عرضها (أرقام الصفحات تستند إلى صفر).

استرجاع الكرة

EmbeddedTableChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل

`enableRtlTable(rtlEnabled)`

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

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

المَعلمات

الاسم	Type	الوصف
`rtlEnabled`	`Boolean`	`true` إذا كان يجب تفعيل الدعم من اليمين إلى اليسار، `false` وإلا.

استرجاع الكرة

EmbeddedTableChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل

`enableSorting(enableSorting)`

تحدّد هذه السياسة ما إذا كان سيتم ترتيب الأعمدة عندما ينقر المستخدم على عنوان عمود.

إذا تم تفعيل الترتيب، عندما ينقر المستخدمون على عنوان العمود، يتم فرز الصفوف تلقائيًا. السلوك التلقائي هو تفعيل ميزة التصنيف.

المَعلمات

الاسم	Type	الوصف
`enableSorting`	`Boolean`	`true` لتفعيل الترتيب عن طريق النقر على عناوين الأعمدة، أو `false` بدلاً من ذلك.

استرجاع الكرة

EmbeddedTableChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل

`getChartType()`

تعرض نوع الرسم البياني الحالي.

استرجاع الكرة

ChartType — نوع الرسم البياني

`getContainer()`

عرض الرسم البياني 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 - كائن يحتوي على موضع حاوية الرسم البياني

`getRanges()`

تعرض نسخة من قائمة النطاقات التي توفر حاليًا بيانات لهذا الرسم البياني. يمكنك استخدام 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[] - مصفوفة من النطاقات التي تعمل كمصدر بيانات الرسم البياني الذي سيتم إنشاؤه

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

المَعلمات

الاسم	Type	الوصف
`range`	`Range`	النطاق المطلوب إزالته.

استرجاع الكرة

EmbeddedChartBuilder: أداة إنشاء السلاسل

`setChartType(type)`

تغيير نوع الرسم البياني بعض أنواع الرسوم البيانية المضمّنة غير متوافقة حاليًا. يمكنك الاطّلاع على 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);

المَعلمات

الاسم	Type	الوصف
`type`	`ChartType`	النوع الذي تريد تغيير هذا الرسم البياني إليه.

استرجاع الكرة

EmbeddedChartBuilder: أداة إنشاء السلاسل

`setFirstRowNumber(number)`

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

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

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

المَعلمات

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

استرجاع الكرة

EmbeddedTableChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل

`setHiddenDimensionStrategy(strategy)`

تحدِّد الاستراتيجية لاستخدامها في الصفوف والأعمدة المخفية. يكون الإعداد التلقائي هو 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);

المَعلمات

الاسم	Type	الوصف
`strategy`	`ChartHiddenDimensionStrategy`	الإستراتيجية المستخدمة للصفوف والأعمدة المخفية.

استرجاع الكرة

EmbeddedChartBuilder: أداة إنشاء السلاسل

`setInitialSortingAscending(column)`

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

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

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

المَعلمات

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

استرجاع الكرة

EmbeddedTableChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل

`setInitialSortingDescending(column)`

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

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

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

المَعلمات

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

استرجاع الكرة

EmbeddedTableChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل

`setMergeStrategy(mergeStrategy)`

لضبط استراتيجية الدمج لاستخدامها عند وجود أكثر من نطاق واحد. إذا تم 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);

المَعلمات

الاسم	Type	الوصف
`mergeStrategy`	`ChartMergeStrategy`	استراتيجية الدمج المطلوب استخدامها.

استرجاع الكرة

EmbeddedChartBuilder: أداة إنشاء السلاسل

`setNumHeaders(headers)`

لضبط عدد الصفوف أو الأعمدة في النطاق التي يجب التعامل معها كعناوين.

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

المَعلمات

الاسم	Type	الوصف
`headers`	`Integer`	عدد الصفوف أو الأعمدة المطلوب التعامل معها كرؤوس. تتسبب القيم السالبة في اكتشاف العناوين تلقائيًا.

استرجاع الكرة

EmbeddedChartBuilder: أداة إنشاء السلاسل

`setOption(option, value)`

ضبط الخيارات المتقدمة لهذا الرسم البياني لعرض قائمة بالخيارات المتاحة، يُرجى الاطّلاع على خيارات ضبط الرسم البياني.

لا تتحقّق هذه الطريقة من صلاحية الخيار الذي تحدّده لنوع الرسم البياني هذا ولا إذا كانت القيمة بالتنسيق أو البنية الصحيحة.

يوضح هذا المثال كيفية تغيير العنوان وتعيين وسيلة إيضاح.

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

المَعلمات

الاسم	Type	الوصف
`option`	`String`	اسم الخيار
`value`	`Object`	قيمة الخيار.

استرجاع الكرة

EmbeddedChartBuilder: أداة الإنشاء هذه مخصّصة للسلاسل

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

تعيين الموضع، وتغيير مكان ظهور الرسم البياني في الورقة. تمت فهرسة anchorRowPos وanchorColPos مرة واحدة.

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

المَعلمات

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

استرجاع الكرة

EmbeddedChartBuilder: أداة إنشاء السلاسل

`setTransposeRowsAndColumns(transpose)`

تحدِّد هذه السياسة ما إذا كان سيتم تبديل موضع صفوف الرسم البياني وأعمدته. وفي حال ضبطها على 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);

المَعلمات

الاسم	Type	الوصف
`transpose`	`Boolean`	إذا تم استخدام `true`، سيتم تبديل موضع الصفوف والأعمدة المستخدَمة لإنشاء الرسم البياني.

استرجاع الكرة

EmbeddedChartBuilder: أداة إنشاء السلاسل

`showRowNumberColumn(showRowNumber)`

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

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

المَعلمات

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

استرجاع الكرة

EmbeddedTableChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل

`useAlternatingRowStyle(alternate)`

تحدِّد هذه السياسة ما إذا كان سيتم تخصيص نمط الألوان البديل إلى صفوف فردية وزوجية من الرسم البياني الجدولي.

السلوك الافتراضي هو الصفوف التي تحتوي على نمط ألوان بديل.

المَعلمات

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

استرجاع الكرة

EmbeddedTableChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل