Class EmbeddedTableChartBuilder

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

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

المعلمات

الإرجاع

EmbeddedChartBuilder — أداة الإنشاء هذه، للسلاسل

لضبط نوع الرسم البياني على "مخطط مساحي" وعرض EmbeddedAreaChartBuilder

الإرجاع

EmbeddedAreaChartBuilder — أداة إنشاء لمخطط مساحي

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

الإرجاع

EmbeddedBarChartBuilder — أداة إنشاء للمخطط الشريطي

لضبط نوع الرسم البياني على "مخطط عمودي" وعرض EmbeddedColumnChartBuilder

الإرجاع

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

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

الإرجاع

EmbeddedComboChartBuilder — أداة إنشاء لمخطط مختلط

لضبط نوع الرسم البياني على "مخطّط تكرار بياني" وعرض EmbeddedHistogramChartBuilder.

الإرجاع

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

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

الإرجاع

EmbeddedLineChartBuilder — أداة إنشاء لمخطط خطي

لضبط نوع الرسم البياني على PieChart وعرض EmbeddedPieChartBuilder

الإرجاع

EmbeddedPieChartBuilder — أداة إنشاء للمخطط الدائري

لضبط نوع الرسم البياني على ScatterChart وعرض EmbeddedScatterChartBuilder.

الإرجاع

EmbeddedScatterChartBuilder — أداة إنشاء لمخطط مبعثر

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

الإرجاع

EmbeddedTableChartBuilder — أداة إنشاء لمخطط جدولي

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

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

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

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 — أداة الإنشاء هذه، للسلاسل

لتعيين ما إذا كان سيتم تفعيل التنقل بين البيانات.

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

المعلمات

الإرجاع

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

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

يبلغ حجم الصفحة التلقائي 10.

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

المعلمات

الإرجاع

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

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

حجم الصفحة التلقائي هو 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);

المعلمات

الإرجاع

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

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

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

المعلمات

الإرجاع

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

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

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

المعلمات

الإرجاع

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

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

الإرجاع

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

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

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

يزيل النطاق المحدد من الرسم البياني الذي تعدِّله هذه الأداة. لا تعرض رسالة خطأ إذا النطاق غير موجود في هذا المخطط.

يجب أن يتطابق النطاق الذي تمت إزالته مع نطاق تمت إضافته عبر 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);

المعلمات

الإرجاع

EmbeddedChartBuilder — أداة الإنشاء هذه، للسلاسل

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

المعلمات

الإرجاع

EmbeddedChartBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

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

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

المعلمات

الإرجاع

EmbeddedChartBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

المعلمات

الإرجاع

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

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

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

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

المعلمات

الإرجاع

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

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

المعلمات

الإرجاع

EmbeddedChartBuilder — أداة الإنشاء هذه، للسلاسل

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

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

المعلمات

الإرجاع

EmbeddedChartBuilder — أداة الإنشاء هذه، للسلاسل

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

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

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

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

المعلمات

الإرجاع

EmbeddedChartBuilder — أداة الإنشاء هذه، للسلاسل

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

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

المعلمات

الإرجاع

EmbeddedChartBuilder — أداة الإنشاء هذه، للسلاسل

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

المعلمات

الإرجاع

EmbeddedChartBuilder — أداة الإنشاء هذه، للسلاسل

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

الإعداد التلقائي هو عدم إظهار أرقام الصفوف.

المعلمات

الإرجاع

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

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

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

المعلمات

الإرجاع

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