Class EmbeddedLineChartBuilder

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

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

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

الإرجاع

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

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

// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner.
var builder = Charts.newPieChart();
builder.reverseCategories();

الإرجاع

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

لضبط لون خلفية الرسم البياني.

// Creates a line chart builder and sets the background color to gray
var builder = Charts.newLineChart();
builder.setBackgroundColor("gray");

المعلمات

الإرجاع

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

تغيير نوع الرسم البياني بعض أنواع الرسوم البيانية المضمّنة غير متوافقة حاليًا. يمكنك الاطّلاع على 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 — أداة الإنشاء هذه، للسلاسل

لتعيين ألوان الخطوط في الرسم البياني.

// Creates a line chart builder and sets the first two lines to be drawn in green and red,
// respectively.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

المعلمات

الإرجاع

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

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

// Creates a line chart builder and curves the lines in the chart.
var builder = Charts.newLineChart();
builder.setCurveStyle(Charts.CurveStyle.SMOOTH)

المعلمات

الإرجاع

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

انظر أيضًا

• CurveStyle

تحدِّد الاستراتيجية المراد استخدامها للصفوف والأعمدة المخفية. وتكون القيمة التلقائية هي 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 line chart builder and sets the legend position to right.
var builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

المعلمات

الإرجاع

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

لتعيين نمط نص وسيلة إيضاح الرسم البياني.

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

المعلمات

الإرجاع

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

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

لتعيين نمط النقاط في الخط. ولا تكون للنقاط بشكل افتراضي أنماط معينة، الخط مرئي.

// Creates a line chart builder and sets large point style.
var builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

المعلمات

الإرجاع

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

انظر أيضًا

• PointStyle

لضبط الموضع، وتغيير مكان ظهور الرسم البياني في الورقة 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 — أداة الإنشاء هذه، للسلاسل

تعين نطاق الرسم البياني.

إذا كانت أي نقاط بيانات تقع خارج النطاق، يتم توسيع النطاق ليشمل تلك البيانات. نقاط.

المعلمات

الإرجاع

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

لتعيين عنوان الرسم البياني. يتم عرض العنوان في وسط أعلى الرسم البياني.

// Creates a line chart builder and title to 'My Line Chart'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')

المعلمات

الإرجاع

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

لضبط نمط نص عنوان الرسم البياني.

// Creates a line chart builder and sets it up for a  blue, 26-point title.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

المعلمات

الإرجاع

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

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

لضبط نمط نص المحور الأفقي.

// Creates a line chart builder and sets the X-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

المعلمات

الإرجاع

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

لإضافة عنوان إلى المحور الأفقي. يتم توسيط العنوان ويظهر أسفل قيمة المحور الفعلية.

// Creates a line chart builder and sets the X-axis title.
var builder = Charts.newLineChart();
builder.setTitle('X-axis Title')

المعلمات

الإرجاع

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

لضبط نمط نص عنوان المحور الأفقي.

// Creates a line chart builder and sets the X-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

المعلمات

الإرجاع

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

لضبط نمط نص المحور الرأسي.

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

المعلمات

الإرجاع

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

لإضافة عنوان إلى المحور الرأسي. يظهر العنوان في الوسط ويظهر على يسار القيمة. الفعلية.

// Creates a line chart builder and sets the Y-axis title.
var builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title')

المعلمات

الإرجاع

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

لضبط نمط نص عنوان المحور الرأسي.

// Creates a line chart builder and sets the Y-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

المعلمات

الإرجاع

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

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

الإرجاع

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