Class EmbeddedAreaChartBuilder

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

أداة إنشاء الرسوم البيانية المساحية لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات Gviz.

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
addRange(range)	EmbeddedChartBuilder	تُضيف هذه السمة نطاقًا إلى الرسم البياني الذي يعدّله هذا المُنشئ.
asAreaChart()	EmbeddedAreaChartBuilder	تُستخدَم لضبط نوع الرسم البياني على AreaChart وعرض EmbeddedAreaChartBuilder.
asBarChart()	EmbeddedBarChartBuilder	تُستخدَم لضبط نوع الرسم البياني على BarChart وعرض EmbeddedBarChartBuilder.
asColumnChart()	EmbeddedColumnChartBuilder	تضبط نوع الرسم البياني على ColumnChart وتُعرِض EmbeddedColumnChartBuilder.
asComboChart()	EmbeddedComboChartBuilder	تُستخدَم لضبط نوع الرسم البياني على ComboChart وعرض EmbeddedComboChartBuilder.
asHistogramChart()	EmbeddedHistogramChartBuilder	تُستخدَم لضبط نوع الرسم البياني على HistogramChart وعرض EmbeddedHistogramChartBuilder.
asLineChart()	EmbeddedLineChartBuilder	تُستخدَم لضبط نوع الرسم البياني على LineChart وعرض EmbeddedLineChartBuilder.
asPieChart()	EmbeddedPieChartBuilder	تضبط نوع الرسم البياني على PieChart وتُعرِض EmbeddedPieChartBuilder.
asScatterChart()	EmbeddedScatterChartBuilder	تضبط نوع الرسم البياني على ScatterChart وتُعرِض EmbeddedScatterChartBuilder.
asTableChart()	EmbeddedTableChartBuilder	تُستخدَم لضبط نوع الرسم البياني على TableChart وعرض EmbeddedTableChartBuilder.
build()	EmbeddedChart	ينشئ هذا الخيار الرسم البياني ليعكس جميع التغييرات التي تم إجراؤها عليه.
clearRanges()	EmbeddedChartBuilder	تزيل جميع النطاقات من الرسم البياني الذي يعدّله هذا المنشئ.
getChartType()	ChartType	لعرض نوع الرسم البياني الحالي.
getContainer()	ContainerInfo	عرض الرسم البياني ContainerInfo الذي يحدِّد موضع ظهور الرسم البياني على الجدول
getRanges()	Range[]	تعرِض هذه الدالة نسخة من قائمة النطاقات التي تقدّم حاليًا بيانات لهذا الرسم البياني.
removeRange(range)	EmbeddedChartBuilder	تزيل هذه الدالة النطاق المحدّد من الرسم البياني الذي يعدّله هذا المنشئ.
reverseCategories()	EmbeddedAreaChartBuilder	يعكس رسم السلاسل في محور النطاق.
setBackgroundColor(cssValue)	EmbeddedAreaChartBuilder	لضبط لون خلفية الرسم البياني.
setChartType(type)	EmbeddedChartBuilder	لتغيير نوع الرسم البياني
setColors(cssValues)	EmbeddedAreaChartBuilder	تُستخدَم لضبط ألوان الخطوط في الرسم البياني.
setHiddenDimensionStrategy(strategy)	EmbeddedChartBuilder	لضبط الاستراتيجية التي سيتم استخدامها للصفوف والأعمدة المخفية.
setLegendPosition(position)	EmbeddedAreaChartBuilder	لضبط موضع العنوان التفسيري بالنسبة إلى الرسم البياني
setLegendTextStyle(textStyle)	EmbeddedAreaChartBuilder	لضبط نمط النص لشرح الرسم البياني
setMergeStrategy(mergeStrategy)	EmbeddedChartBuilder	لضبط استراتيجية الدمج التي سيتم استخدامها عند توفّر أكثر من نطاق واحد.
setNumHeaders(headers)	EmbeddedChartBuilder	تُستخدَم لضبط عدد الصفوف أو الأعمدة في النطاق التي يجب التعامل معها كعناوين.
setOption(option, value)	EmbeddedChartBuilder	لضبط الخيارات المتقدّمة لهذا الرسم البياني
setPointStyle(style)	EmbeddedAreaChartBuilder	تُستخدَم لضبط نمط النقاط في الخط.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)	EmbeddedChartBuilder	لضبط الموضع، وتغيير مكان ظهور الرسم البياني على ورقة البيانات
setRange(start, end)	EmbeddedAreaChartBuilder	لضبط النطاق للرسم البياني.
setStacked()	EmbeddedAreaChartBuilder	يستخدم هذا المخطّط خطوطًا مكدّسة، ما يعني أنّه يتم تجميع قيم الخطوط والأشرطة (تجميعها).
setTitle(chartTitle)	EmbeddedAreaChartBuilder	لضبط عنوان الرسم البياني.
setTitleTextStyle(textStyle)	EmbeddedAreaChartBuilder	لضبط نمط النص لعنوان الرسم البياني
setTransposeRowsAndColumns(transpose)	EmbeddedChartBuilder	لتحديد ما إذا كان سيتم تبديل صفوف المخطط وأعمدةه.
setXAxisTextStyle(textStyle)	EmbeddedAreaChartBuilder	لضبط نمط نص المحور الأفقي
setXAxisTitle(title)	EmbeddedAreaChartBuilder	تضيف عنوانًا إلى المحور الأفقي.
setXAxisTitleTextStyle(textStyle)	EmbeddedAreaChartBuilder	لضبط نمط نص عنوان المحور الأفقي.
setYAxisTextStyle(textStyle)	EmbeddedAreaChartBuilder	لضبط نمط نص المحور العمودي
setYAxisTitle(title)	EmbeddedAreaChartBuilder	تُضيف عنوانًا إلى المحور العمودي.
setYAxisTitleTextStyle(textStyle)	EmbeddedAreaChartBuilder	تُستخدَم لضبط نمط نص عنوان المحور العمودي.
useLogScale()	EmbeddedAreaChartBuilder	تحوِّل محور النطاق إلى مقياس لوغاريتمي (يتطلب أن تكون جميع القيم موجبة).

مستندات تفصيلية

addRange(range)

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

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

sheet.insertChart(chart);

المعلَمات

الاسم	النوع	الوصف
range	Range	النطاق المطلوب إضافته.

الإرجاع

EmbeddedChartBuilder — هذا المُنشئ، لتسلسل العناصر

---

asAreaChart()

تُستخدَم لضبط نوع الرسم البياني على AreaChart وعرض EmbeddedAreaChartBuilder.

الإرجاع

EmbeddedAreaChartBuilder - أداة إنشاء رسم بياني مساحي

---

asBarChart()

تُستخدَم لضبط نوع الرسم البياني على BarChart وعرض EmbeddedBarChartBuilder.

الإرجاع

EmbeddedBarChartBuilder - أداة إنشاء رسم بياني شريطي

---

asColumnChart()

تضبط نوع الرسم البياني على ColumnChart وتُعرِض EmbeddedColumnChartBuilder.

الإرجاع

EmbeddedColumnChartBuilder - أداة إنشاء رسم بياني عمودي

---

asComboChart()

تُستخدَم لضبط نوع الرسم البياني على ComboChart وعرض EmbeddedComboChartBuilder.

الإرجاع

EmbeddedComboChartBuilder - أداة إنشاء للرسم البياني المجمّع

---

asHistogramChart()

تُستخدَم لضبط نوع الرسم البياني على HistogramChart وعرض EmbeddedHistogramChartBuilder.

الإرجاع

EmbeddedHistogramChartBuilder - أداة إنشاء رسم بياني لمدرّج تكراري

---

asLineChart()

تُستخدَم لضبط نوع الرسم البياني على LineChart وعرض EmbeddedLineChartBuilder.

الإرجاع

EmbeddedLineChartBuilder - أداة إنشاء رسم بياني خطي

---

asPieChart()

تضبط نوع الرسم البياني على PieChart وتُعرِض EmbeddedPieChartBuilder.

الإرجاع

EmbeddedPieChartBuilder - أداة إنشاء رسم بياني دائري

---

asScatterChart()

تضبط نوع الرسم البياني على ScatterChart وتُعرِض EmbeddedScatterChartBuilder.

الإرجاع

EmbeddedScatterChartBuilder - أداة إنشاء رسم بياني للنقاط المبعثرة

---

asTableChart()

تُستخدَم لضبط نوع الرسم البياني على TableChart وعرض EmbeddedTableChartBuilder.

الإرجاع

EmbeddedTableChartBuilder - أداة إنشاء للرسم البياني على شكل جدول

---

build()

ينشئ هذا الخيار الرسم البياني ليعكس جميع التغييرات التي تم إجراؤها عليه.

لا ترسم هذه الطريقة الرسم البياني تلقائيًا فوق جدول البيانات. يجب إدراج رسم بياني جديد من خلال sheet.insertChart(chart)، ويجب تعديل رسم بياني حالي من خلال sheet.updateChart(chart).

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)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

الإرجاع

EmbeddedChart: الرسم البياني الذي تم إنشاؤه، والذي يجب إضافته إلى جدول البيانات

---

clearRanges()

تزيل جميع النطاقات من الرسم البياني الذي يعدّله هذا المنشئ.

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

// This code updates the chart to use only the new ranges while preserving the
// existing formatting of the chart.
const chart = sheet.getCharts()[0];
const newChart = chart.modify()
                     .clearRanges()
                     .addRange(sheet.getRange('A1:A5'))
                     .addRange(sheet.getRange('B1:B5'))
                     .build();
sheet.updateChart(newChart);

الإرجاع

EmbeddedChartBuilder — هذا المُنشئ، لتسلسل العناصر

---

getChartType()

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

الإرجاع

ChartType: نوع الرسم البياني

---

getContainer()

عرض الرسم البياني ContainerInfo الذي يحدِّد موضع ظهور الرسم البياني على الجدول

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

const 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()
const containerInfo = chartBuilder.getContainer();

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

---

getRanges()

تعرِض هذه الدالة نسخة من قائمة النطاقات التي تقدّم حاليًا بيانات لهذا الرسم البياني. استخدِم addRange(range) وremoveRange(range) لتعديل هذه القائمة.

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

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

const ranges = chartBuilder.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[]: صفيف من النطاقات التي تُستخدَم كمصدر بيانات الرسم البياني الذي سيتم إنشاؤه

---

removeRange(range)

تزيل هذه الدالة النطاق المحدّد من الرسم البياني الذي يعدّله هذا المنشئ. لا يؤدي إلى ظهور خطأ إذا لم يكن النطاق مضمّنًا في هذا الرسم البياني.

يجب أن يتطابق النطاق الذي تمت إزالته مع نطاق تمت إضافته من خلال addRange(range)، وإلا لن يتم إجراء أي تغيير على الرسم البياني. لا يمكن استخدام هذه الطريقة لإزالة القيم بشكل جزئي من نطاق.

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

const firstRange = sheet.getRange('A1:B5');
const secondRange = sheet.getRange('A6:B8');

const 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'));

const chart = chartBuilder.build();

sheet.insertChart(chart);

المعلَمات

الاسم	النوع	الوصف
range	Range	النطاق المطلوب إزالته.

الإرجاع

EmbeddedChartBuilder — هذا المُنشئ، لتسلسل العناصر

---

reverseCategories()

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

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

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setBackgroundColor(cssValue)

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

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

المعلَمات

الاسم	النوع	الوصف
cssValue	String	قيمة CSS للّون (مثل "blue" أو "#00f")

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setChartType(type)

لتغيير نوع الرسم البياني لا تتوفّر حاليًا بعض أنواع الرسوم البيانية المضمّنة. يمكنك الاطّلاع على ChartType.

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)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

المعلَمات

الاسم	النوع	الوصف
type	ChartType	النوع الذي تريد تغيير هذا الرسم البياني إليه.

الإرجاع

EmbeddedChartBuilder — هذا المُنشئ، لتسلسل العناصر

---

setColors(cssValues)

تُستخدَم لضبط ألوان الخطوط في الرسم البياني.

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

المعلَمات

الاسم	النوع	الوصف
cssValues	String[]	صفيف من قيم CSS للألوان، مثل ["red", "#acf"] يمثّل العنصر n في الصفيف لون الخط n في الرسم البياني.

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setHiddenDimensionStrategy(strategy)

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

sheet.insertChart(chart);

المعلَمات

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

الإرجاع

EmbeddedChartBuilder — هذا المُنشئ، لتسلسل العناصر

---

setLegendPosition(position)

لضبط موضع العنوان التفسيري بالنسبة إلى الرسم البياني لا يتوفّر رسم توضيحي تلقائيًا.

// Creates a line chart builder and sets the legend position to right.
const builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

المعلَمات

الاسم	النوع	الوصف
position	Position	موضع التسمية التوضيحية

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setLegendTextStyle(textStyle)

لضبط نمط النص لشرح الرسم البياني

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

المعلَمات

الاسم	النوع	الوصف
textStyle	TextStyle	نمط النص المُستخدَم لشرح الرسم البياني.

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setMergeStrategy(mergeStrategy)

لضبط استراتيجية الدمج التي سيتم استخدامها عند توفّر أكثر من نطاق واحد. إذا كان الخيار 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('C:C10');
const 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);

المعلَمات

الاسم	النوع	الوصف
mergeStrategy	ChartMergeStrategy	استراتيجية الدمج التي سيتم استخدامها.

الإرجاع

EmbeddedChartBuilder — هذا المُنشئ، لتسلسل العناصر

---

setNumHeaders(headers)

تُستخدَم لضبط عدد الصفوف أو الأعمدة في النطاق التي يجب التعامل معها كعناوين.

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

sheet.insertChart(chart);

المعلَمات

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

الإرجاع

EmbeddedChartBuilder — هذا المُنشئ، لتسلسل العناصر

---

setOption(option, value)

لضبط الخيارات المتقدّمة لهذا الرسم البياني للاطّلاع على قائمة بالخيارات المتاحة، راجِع خيارات إعداد الرسم البياني.

لا تتحقّق هذه الطريقة من أنّ الخيار الذي تحدّده صالح لنوع الرسم البياني هذا أو ما إذا كانت قيمة التنسيق/البنية صحيحة.

يوضِّح هذا المثال كيفية تغيير العنوان وضبط رسم توضيحي.

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const sheet = spreadsheet.getSheets()[0];
const chart = sheet.newChart()
 .setOption('title', 'Earnings projections')
 .setOption('legend', {
   position: 'top',
   textStyle: { color: 'blue', fontSize: 16 },
 }).build();

المعلَمات

الاسم	النوع	الوصف
option	String	اسم الخيار
value	Object	قيمة الخيار

الإرجاع

EmbeddedChartBuilder: هذا المُنشئ، لتسلسل العناصر.

---

setPointStyle(style)

تُستخدَم لضبط نمط النقاط في الخط. لا تتضمّن النقاط تلقائيًا أنماطًا معيّنة، ولا يظهر سوى الخط.

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

المعلَمات

الاسم	النوع	الوصف
style	PointStyle	النمط المراد استخدامه للنقاط في الخط

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

انظر أيضًا

• PointStyle

---

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

لضبط الموضع، وتغيير مكان ظهور الرسم البياني على ورقة البيانات يتمّ ترقيم anchorRowPos و anchorColPos بدءًا من 1.

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)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

المعلَمات

الاسم	النوع	الوصف
anchorRowPos	Integer	يتم تثبيت الجانب العلوي من الرسم البياني في هذا الصف.
anchorColPos	Integer	يتم تثبيت الجانب الأيسر من الرسم البياني في هذا العمود.
offsetX	Integer	يتم تعويض الزاوية العلوية اليسرى من الرسم البياني بعدد هذا القدر من البكسل.
offsetY	Integer	يتم تعويض الزاوية اليسرى السفلية للرسم البياني بعدد هذا القدر من البكسل.

الإرجاع

EmbeddedChartBuilder — هذا المُنشئ، لتسلسل العناصر

---

setRange(start, end)

لضبط النطاق للرسم البياني.

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

المعلَمات

الاسم	النوع	الوصف
start	Number	قيمة أدنى خط شبكة لمحور النطاق
end	Number	قيمة أعلى خط شبكة لمحور النطاق

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setStacked()

يستخدم هذا المخطّط خطوطًا مكدّسة، ما يعني أنّه يتم تجميع قيم الخطوط والأشرطة (تجميعها). لا يتم تجميع العناصر تلقائيًا.

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setTitle(chartTitle)

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

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

المعلَمات

الاسم	النوع	الوصف
chartTitle	String	عنوان الرسم البياني

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setTitleTextStyle(textStyle)

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

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

المعلَمات

الاسم	النوع	الوصف
textStyle	TextStyle	نمط النص المُستخدَم لعنوان الرسم البياني. يمكنك إنشاء عنصر TextStyleBuilder من خلال استدعاء Charts.newTextStyle().

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setTransposeRowsAndColumns(transpose)

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

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)
                  .setTransposeRowsAndColumns(true)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

المعلَمات

الاسم	النوع	الوصف
transpose	Boolean	إذا كان الخيار true، يتم قلب الصفوف والأعمدة المستخدَمة لإنشاء الرسم البياني.

الإرجاع

EmbeddedChartBuilder — هذا المُنشئ، لتسلسل العناصر

---

setXAxisTextStyle(textStyle)

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

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

المعلَمات

الاسم	النوع	الوصف
textStyle	TextStyle	نمط النص المراد استخدامه لعنوان المحور الأفقي يمكنك إنشاء عنصر TextStyleBuilder من خلال استدعاء Charts.newTextStyle().

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setXAxisTitle(title)

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

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

المعلَمات

الاسم	النوع	الوصف
title	String	عنوان المحور X

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setXAxisTitleTextStyle(textStyle)

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

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

المعلَمات

الاسم	النوع	الوصف
textStyle	TextStyle	نمط النص المراد استخدامه لعنوان المحور الأفقي يمكنك إنشاء عنصر TextStyleBuilder من خلال استدعاء Charts.newTextStyle().

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setYAxisTextStyle(textStyle)

لضبط نمط نص المحور العمودي

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

المعلَمات

الاسم	النوع	الوصف
textStyle	TextStyle	نمط النص المراد استخدامه لعنوان المحور الأفقي يمكنك إنشاء عنصر TextStyleBuilder من خلال استدعاء Charts.newTextStyle().

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setYAxisTitle(title)

تُضيف عنوانًا إلى المحور العمودي. يكون العنوان في المنتصف ويظهر على يمين تصنيفات القيمة.

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

المعلَمات

الاسم	النوع	الوصف
title	String	عنوان المحور Y

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setYAxisTitleTextStyle(textStyle)

تُستخدَم لضبط نمط نص عنوان المحور العمودي.

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

المعلَمات

الاسم	النوع	الوصف
textStyle	TextStyle	نمط النص المراد استخدامه لعنوان المحور الأفقي يمكنك إنشاء عنصر TextStyleBuilder من خلال استدعاء Charts.newTextStyle().

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

useLogScale()

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

الإرجاع

‫EmbeddedAreaChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.