Class EmbeddedChart

EmbeddedChart

يمثل مخططًا تم تضمينه في جدول بيانات.

يوضح هذا المثال كيفية تعديل رسم بياني حالي: 

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

يوضح هذا المثال كيفية إنشاء رسم بياني جديد: 

function newChart(range, sheet) {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chartBuilder = sheet.newChart();
  chartBuilder.addRange(range)
      .setChartType(Charts.ChartType.LINE)
      .setOption('title', 'My Line Chart!');
  sheet.insertChart(chartBuilder.build());
}

الطُرق

الطريقةنوع الإرجاعوصف قصير
asDataSourceChart()DataSourceChartيتم البث إلى مثيل الرسم البياني لمصدر البيانات إذا كان الرسم البياني هو رسم بياني لمصدر البيانات، أو الخيار null. وإلا.
getAs(contentType)Blobعرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد.
getBlob()Blobعرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير.
getChartId()Integerلعرض معرّف ثابت للمخطط فريد عبر جدول البيانات الذي يحتوي على مخطط أو null إذا لم يكن الرسم البياني في جدول بيانات.
getContainerInfo()ContainerInfoلعرض معلومات حول مكان وضع الرسم البياني داخل ورقة.
getHiddenDimensionStrategy()ChartHiddenDimensionStrategyتعرض الإستراتيجية التي سيتم استخدامها للتعامل مع الصفوف والأعمدة المخفية.
getMergeStrategy()ChartMergeStrategyلعرض استراتيجية الدمج المستخدمة عند وجود أكثر من نطاق واحد.
getNumHeaders()Integerتعرض عدد الصفوف أو الأعمدة في النطاق الذي يتم التعامل معه كرؤوس.
getOptions()ChartOptionsلعرض الخيارات لهذا المخطط، مثل الارتفاع والألوان والمحاور.
getRanges()Range[]تعرض النطاقات التي يستخدمها هذا الرسم البياني كمصدر بيانات.
getTransposeRowsAndColumns()Booleanإذا كان true، يتم تبديل الصفوف والأعمدة المستخدَمة لتعبئة الرسم البياني.
modify()EmbeddedChartBuilderتعرض علامة EmbeddedChartBuilder التي يمكن استخدامها لتعديل هذا الرسم البياني.

الوثائق التفصيلية

asDataSourceChart()

يتم البث إلى مثيل الرسم البياني لمصدر البيانات إذا كان الرسم البياني هو رسم بياني لمصدر البيانات، أو الخيار null. وإلا.

الإرجاع

DataSourceChart — الرسم البياني لمصدر البيانات.

getAs(contentType)

عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد. هذا النمط تضيف الامتداد المناسب لاسم الملف — على سبيل المثال، "myfile.pdf". ومع ذلك، أن جزء اسم الملف الذي يلي النقطة الأخيرة (إن وجدت) موجود الإضافة التي يجب استبدالها. وبالتالي، "ShoppingList.12.25.2014" يصبح "ShoppingList.12.25.pdf".

لعرض الحصص اليومية للإحالات الناجحة، اطّلِع على حصص Google. الخدمات: قد تكون نطاقات Google Workspace التي تم إنشاؤها حديثًا أكثر صرامة مؤقتًا. حصصها.

المعلمات

الاسمالنوعالوصف
contentTypeStringنوع MIME المطلوب التحويل إليه. بالنسبة إلى معظم الكائنات الثنائية الكبيرة، 'application/pdf' هو هو الخيار الوحيد الصالح. بالنسبة إلى الصور بتنسيق BMP أو GIF أو JPEG أو PNG، يتم أيضًا استخدام أي من 'image/bmp' أو 'image/gif' أو 'image/jpeg' أو 'image/png' صالحة. بالنسبة إلى مستند "مستندات Google"، يُعدّ 'text/markdown' أيضًا صالحًا.

الإرجاع

Blob — البيانات ككائنات ثنائية كبيرة (blob).

getBlob()

عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير.

الإرجاع

Blob — البيانات ككائنات ثنائية كبيرة (blob).

getChartId()

لعرض معرّف ثابت للمخطط فريد عبر جدول البيانات الذي يحتوي على مخطط أو null إذا لم يكن الرسم البياني في جدول بيانات.

الإرجاع

Integer — معرّف رسم بياني ثابت.

getContainerInfo()

لعرض معلومات حول مكان وضع الرسم البياني داخل ورقة. 

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

var containerInfo = chart.getContainerInfo();

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

getHiddenDimensionStrategy()

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

// Logs the strategy to use for hidden rows and columns which is
// Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS in this case.
Logger.log(chart.getHiddenDimensionStrategy());

الإرجاع

ChartHiddenDimensionStrategy: الاستراتيجية التي يتم استخدامها مع الصفوف والأعمدة المخفية

getMergeStrategy()

لعرض استراتيجية الدمج المستخدمة عند وجود أكثر من نطاق واحد. إذا كانت القيمة 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("C1:C10");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .addRange(range2)
    .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs whether rows of multiple ranges are merged, which is MERGE_ROWS in this case.
Logger.log(chart.getMergeStrategy());

الإرجاع

ChartMergeStrategy — MERGE_ROWS في حال دمج صفوف متعددة النطاقات MERGE_COLUMNS في حال دمج الأعمدة في نطاقات متعددة

getNumHeaders()

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

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

// Logs the number of rows or columns to use as headers, which is 1 in this case.
Logger.log(chart.getHeaders());

الإرجاع

Integer — عدد الصفوف أو الأعمدة التي تتم معالجتها كرؤوس. تشير القيم السالبة إلى العناوين مكتشفة تلقائيًا.

getOptions()

لعرض الخيارات لهذا المخطط، مثل الارتفاع والألوان والمحاور.

الخيارات التي تم إرجاعها غير قابلة للتغيير.

الإرجاع

ChartOptions - الخيارات المتاحة لهذا الرسم البياني، مثل الارتفاع والألوان والمحاور

getRanges()

تعرض النطاقات التي يستخدمها هذا الرسم البياني كمصدر بيانات. 

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

var ranges = chart.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[]: مصفوفة من النطاقات التي تعمل كمصدر بيانات هذا الرسم البياني

getTransposeRowsAndColumns()

إذا كان true، يتم تبديل الصفوف والأعمدة المستخدَمة لتعبئة الرسم البياني. الإعدادات التلقائية على false 

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .addRange(range)
    .setChartType(Charts.ChartType.BAR)
    .setTransposeRowsAndColumns(true)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs whether rows and columns should be transposed, which is true in this case.
Logger.log(chart.getTransposeRowsAndColumns());

الإرجاع

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

modify()

تعرض علامة EmbeddedChartBuilder التي يمكن استخدامها لتعديل هذا الرسم البياني. يمكنك استدعاء sheet.updateChart(chart) لحفظ أي تغييرات. 

var sheet = SpreadsheetApp.getActiveSheet();
var chart = sheet.getCharts()[0];
chart = chart.modify()
    .setOption('width', 800)
    .setOption('height', 640)
    .setPosition(5, 5, 0, 0)
    .build();
sheet.updateChart(chart);

الإرجاع

EmbeddedChartBuilder — أداة إنشاء لإنشاء الرسوم البيانية المضمّنة