Class EmbeddedChartBuilder

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

تم استخدام أداة الإنشاء لتعديل EmbeddedChart. ولن يتم حفظ التغييرات التي تم إجراؤها على الرسم البياني حتى يتم استدعاء Sheet.updateChart(chart) على الرسم البياني المُعاد إنشاؤه.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B8");
var 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);

الطُرق

الطريقةنوع الإرجاعوصف قصير
addRange(range)EmbeddedChartBuilderتضيف نطاقًا إلى الرسم البياني الذي تعدِّله أداة الإنشاء هذه.
asAreaChart()EmbeddedAreaChartBuilderلضبط نوع الرسم البياني على AreaChart وعرض EmbeddedAreaChartBuilder.
asBarChart()EmbeddedBarChartBuilderلضبط نوع الرسم البياني على BarChart وعرض EmbeddedBarChartBuilder.
asColumnChart()EmbeddedColumnChartBuilderلضبط نوع الرسم البياني على ColumnChart وعرض EmbeddedColumnChartBuilder.
asComboChart()EmbeddedComboChartBuilderلضبط نوع الرسم البياني على "سرد مجمّع" وعرض EmbeddedComboChartBuilder.
asHistogramChart()EmbeddedHistogramChartBuilderلضبط نوع الرسم البياني على المدرّج التكراري، وعرض EmbeddedHistogramChartBuilder.
asLineChart()EmbeddedLineChartBuilderلضبط نوع الرسم البياني على LineChart وعرض EmbeddedLineChartBuilder.
asPieChart()EmbeddedPieChartBuilderلضبط نوع الرسم البياني على PieChart وإرجاع EmbeddedPieChartBuilder.
asScatterChart()EmbeddedScatterChartBuilderلضبط نوع الرسم البياني على ScaterChart وعرض EmbeddedScatterChartBuilder.
asTableChart()EmbeddedTableChartBuilderتتيح هذه السياسة ضبط نوع الرسم البياني على TableChart وعرض EmbeddedTableChartBuilder.
build()EmbeddedChartإنشاء الرسم البياني ليعكس جميع التغييرات التي تم إجراؤها عليه.
clearRanges()EmbeddedChartBuilderإزالة جميع النطاقات من الرسم البياني الذي تعدِّله أداة الإنشاء هذه.
getChartType()ChartTypeلعرض نوع الرسم البياني الحالي.
getContainer()ContainerInfoاعرض الرسم البياني ContainerInfo، والذي يشير إلى مكان ظهور الرسم البياني في الورقة.
getRanges()Range[]لعرض نسخة من قائمة النطاقات التي تقدِّم بيانات لهذا الرسم البياني حاليًا.
removeRange(range)EmbeddedChartBuilderإزالة النطاق المحدد من الرسم البياني الذي تعدِّله أداة الإنشاء هذه.
setChartType(type)EmbeddedChartBuilderيؤدي إلى تغيير نوع الرسم البياني.
setHiddenDimensionStrategy(strategy)EmbeddedChartBuilderتُحدّد استراتيجية الاستخدام للصفوف والأعمدة المخفية.
setMergeStrategy(mergeStrategy)EmbeddedChartBuilderتعمل هذه السياسة على ضبط استراتيجية الدمج لاستخدامها في حال توفُّر أكثر من نطاق واحد.
setNumHeaders(headers)EmbeddedChartBuilderتحدد عدد الصفوف أو الأعمدة في النطاق الذي يجب التعامل معه كرؤوس.
setOption(option, value)EmbeddedChartBuilderلتحديد الخيارات المتقدمة لهذا الرسم البياني.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)EmbeddedChartBuilderلضبط الموضع، مع تغيير مكان ظهور الرسم البياني في ورقة البيانات.
setTransposeRowsAndColumns(transpose)EmbeddedChartBuilderإعداد ما إذا كان يتم تحويل صفوف وأعمدة الرسم البياني.

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

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

المعلّمات

الاسمالنوعالوصف
rangeRangeالنطاق المراد إضافته.

تذكرة ذهاب وعودة

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


asAreaChart()

لضبط نوع الرسم البياني على AreaChart وعرض EmbeddedAreaChartBuilder.

تذكرة ذهاب وعودة

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


asBarChart()

لضبط نوع الرسم البياني على BarChart وعرض EmbeddedBarChartBuilder.

تذكرة ذهاب وعودة

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


asColumnChart()

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

تذكرة ذهاب وعودة

EmbeddedColumnChartBuilder - أداة إنشاء رسم بياني عمودي


asComboChart()

لضبط نوع الرسم البياني على"سرد مجمّع"وعرض EmbeddedComboChartBuilder.

تذكرة ذهاب وعودة

EmbeddedComboChartBuilder: أداة إنشاء رسم بياني مجمّع


asHistogramChart()

لضبط نوع الرسم البياني على المدرّج التكراري، وعرض EmbeddedHistogramChartBuilder.

تذكرة ذهاب وعودة

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


asLineChart()

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

تذكرة ذهاب وعودة

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


asPieChart()

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

تذكرة ذهاب وعودة

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


asScatterChart()

لضبط نوع الرسم البياني على ScaterChart وعرض 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 — أداة الإنشاء هذه للسلاسل


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

المعلّمات

الاسمالنوعالوصف
rangeRangeالنطاق المراد إزالته.

تذكرة ذهاب وعودة

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

المعلّمات

الاسمالنوعالوصف
typeChartTypeالنوع المطلوب تغيير هذا الرسم البياني إليه.

تذكرة ذهاب وعودة

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


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

المعلّمات

الاسمالنوعالوصف
strategyChartHiddenDimensionStrategyاستراتيجية الاستخدام للصفوف والأعمدة المخفية.

تذكرة ذهاب وعودة

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


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

المعلّمات

الاسمالنوعالوصف
mergeStrategyChartMergeStrategyاستراتيجية الدمج المطلوب استخدامها.

تذكرة ذهاب وعودة

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

المعلّمات

الاسمالنوعالوصف
headersIntegerعدد الصفوف أو الأعمدة المطلوب التعامل معها كعناوين. تؤدي القيم السلبية إلى الاكتشاف التلقائي للعناوين.

تذكرة ذهاب وعودة

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


setOption(option, value)

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

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

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

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

المعلّمات

الاسمالنوعالوصف
optionStringاسم الخيار.
valueObjectقيمة الخيار.

تذكرة ذهاب وعودة

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

المعلّمات

الاسمالنوعالوصف
anchorRowPosIntegerتم إرساء الجانب العلوي من الرسم البياني في هذا الصف.
anchorColPosIntegerتم إرساء الجانب الأيسر من الرسم البياني في هذا العمود.
offsetXIntegerيزيّن هذا العدد الكبير من وحدات البكسل الرسم البياني للزاوية العلوية اليمنى من الرسم البياني.
offsetYIntegerيزيّن هذا البكسل العديد من وحدات البكسل في الزاوية السفلية اليسرى من الرسم البياني.

تذكرة ذهاب وعودة

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

المعلّمات

الاسمالنوعالوصف
transposeBooleanإذا كانت السمة true، سيتم تحويل الصفوف والأعمدة المستخدمة لإنشاء الرسم البياني.

تذكرة ذهاب وعودة

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