تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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 التي تم إنشاؤها حديثًا إلى عروض أسعار أكثر صرامة.

المعلّمات

الاسم	النوع	الوصف
`contentType`	`String`	نوع 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());

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

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