Class EmbeddedChart

مخططمضمّن

يمثّل هذا النوع رسمًا بيانيًا تم تضمينه في جدول بيانات.

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A2:B8');
let 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) {
  const sheet = SpreadsheetApp.getActiveSheet();
  const 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: البيانات ككائن ثنائي كبير.

getBlob()

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

الإرجاع

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

getChartId()

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

الإرجاع

‫Integer: معرّف ثابت للرسم البياني

getContainerInfo()

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

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

const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(sheet.getRange('A1:B8'))
                  .setPosition(5, 5, 0, 0)
                  .build();

const containerInfo = chart.getContainerInfo();

// Logs the values 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. 

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

const range = sheet.getRange('A1:B5');
const 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. 

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

const range = sheet.getRange('A1:B10');
const range2 = sheet.getRange('C1:C10');
const 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()

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

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

const range = sheet.getRange('A1:B5');
const 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()

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

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

const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(sheet.getRange('A1:B8'))
                  .setPosition(5, 5, 0, 0)
                  .build();

const ranges = chart.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (const i in ranges) {
  const range = ranges[i];
  Logger.log(range.getA1Notation());
}

الإرجاع

Range[]: مصفوفة من النطاقات التي تعمل كمصدر بيانات لهذا الرسم البياني.

getTransposeRowsAndColumns()

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

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

const range = sheet.getRange('A1:B5');
const 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) لحفظ أي تغييرات. 

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

الإرجاع

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