Class 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عرض البيانات داخل هذا العنصر ككائن ثنائي كبير (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)

عرض البيانات داخل هذا العنصر ككائن ثنائي كبير (blob) تم تحويله إلى نوع المحتوى المحدد. تضيف هذه الطريقة الامتداد المناسب إلى اسم الملف، على سبيل المثال، "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' صالح أيضًا.

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

Blob — البيانات كائن ثنائي كبير.


getBlob()

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

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

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

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

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


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: أداة إنشاء الرسوم البيانية المضمّنة