Class EmbeddedScatterChartBuilder

EmbeddedScatterChartBuilder

أداة إنشاء الرسوم البيانية بالنقاط المبعثرة لمزيد من التفاصيل، يُرجى الاطّلاع على المستندات الخاصة بأداة 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	يزيل النطاق المحدّد من الرسم البياني الذي يعدّله هذا المنشئ.
setBackgroundColor(cssValue)	EmbeddedScatterChartBuilder	تضبط هذه السمة لون الخلفية للمخطّط.
setChartType(type)	EmbeddedChartBuilder	تغيير نوع الرسم البياني
setColors(cssValues)	EmbeddedScatterChartBuilder	تضبط هذه السمة ألوان الخطوط في الرسم البياني.
setHiddenDimensionStrategy(strategy)	EmbeddedChartBuilder	تضبط هذه السمة الاستراتيجية التي سيتم استخدامها للصفوف والأعمدة المخفية.
setLegendPosition(position)	EmbeddedScatterChartBuilder	تضبط هذه السمة موضع وسيلة الإيضاح بالنسبة إلى الرسم البياني.
setLegendTextStyle(textStyle)	EmbeddedScatterChartBuilder	تضبط هذه السمة نمط نص وسيلة الإيضاح في الرسم البياني.
setMergeStrategy(mergeStrategy)	EmbeddedChartBuilder	تضبط هذه السمة استراتيجية الدمج التي سيتم استخدامها عند توفّر أكثر من نطاق واحد.
setNumHeaders(headers)	EmbeddedChartBuilder	تضبط هذه السمة عدد صفوف أو أعمدة النطاق التي يجب التعامل معها كعناوين.
setOption(option, value)	EmbeddedChartBuilder	تضبط هذه السمة الخيارات المتقدّمة لهذا الرسم البياني.
setPointStyle(style)	EmbeddedScatterChartBuilder	تضبط هذه السمة نمط النقاط في الخط.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)	EmbeddedChartBuilder	تضبط هذه السمة الموضع، ما يؤدي إلى تغيير مكان ظهور الرسم البياني في ورقة البيانات.
setTitle(chartTitle)	EmbeddedScatterChartBuilder	تضبط هذه السمة عنوان الرسم البياني.
setTitleTextStyle(textStyle)	EmbeddedScatterChartBuilder	تضبط هذه السمة نمط النص لعنوان الرسم البياني.
setTransposeRowsAndColumns(transpose)	EmbeddedChartBuilder	تضبط هذه السمة ما إذا كان سيتم نقل صفوف المخطط وأعمدته.
setXAxisLogScale()	EmbeddedScatterChartBuilder	يحوّل المحور الأفقي إلى مقياس لوغاريتمي (يتطلّب أن تكون جميع القيم موجبة).
setXAxisRange(start, end)	EmbeddedScatterChartBuilder	تضبط هذه السمة نطاق المحور الأفقي للرسم البياني.
setXAxisTextStyle(textStyle)	EmbeddedScatterChartBuilder	تضبط هذه السمة نمط نص المحور الأفقي.
setXAxisTitle(title)	EmbeddedScatterChartBuilder	تضيف هذه السمة عنوانًا إلى المحور الأفقي.
setXAxisTitleTextStyle(textStyle)	EmbeddedScatterChartBuilder	تضبط هذه السمة نمط نص عنوان المحور الأفقي.
setYAxisLogScale()	EmbeddedScatterChartBuilder	يحوّل المحور العمودي إلى مقياس لوغاريتمي (يجب أن تكون جميع القيم موجبة).
setYAxisRange(start, end)	EmbeddedScatterChartBuilder	تضبط هذه السمة نطاق المحور العمودي للرسم البياني.
setYAxisTextStyle(textStyle)	EmbeddedScatterChartBuilder	تضبط هذه السمة نمط نص المحور العمودي.
setYAxisTitle(title)	EmbeddedScatterChartBuilder	تضيف هذه السمة عنوانًا إلى المحور العمودي.
setYAxisTitleTextStyle(textStyle)	EmbeddedScatterChartBuilder	تضبط هذه السمة نمط نص عنوان المحور العمودي.

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

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 renders 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
// is not removed, and does not throw an exception
chartBuilder.removeRange(firstRange);
chartBuilder.removeRange(sheet.getRange('A6:B8'));

const chart = chartBuilder.build();

sheet.insertChart(chart);

المعلمات

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

الإرجاع

‫EmbeddedChartBuilder: أداة إنشاء السلاسل

---

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

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

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 في الرسم البياني.

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

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	موضع وسيلة الإيضاح

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

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	نمط النص الذي سيتم استخدامه لتسمية الرسم البياني التوضيحية.

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

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	نمط النقاط المطلوب استخدامه في الخط

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

انظر أيضًا

• 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: أداة إنشاء السلاسل

---

setTitle(chartTitle)

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

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

المعلمات

الاسم	النوع	الوصف
chartTitle	String	تمثّل هذه السمة عنوان المخطط.

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

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

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

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: أداة إنشاء السلاسل

---

setXAxisLogScale()

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

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

setXAxisRange(start, end)

تضبط هذه السمة نطاق المحور الأفقي للرسم البياني.

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

// Creates a scatter chart builder and sets the X-axis range to be 0 to 100.
const builder = Charts.newTableChart();
builder.setXAxisRange(0, 100);

المعلمات

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

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

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

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

setXAxisTitle(title)

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

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

المعلمات

الاسم	النوع	الوصف
title	String	تمثّل هذه السمة عنوان المحور الأفقي.

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

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

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

setYAxisLogScale()

يحوّل المحور العمودي إلى مقياس لوغاريتمي (يجب أن تكون جميع القيم موجبة).

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

setYAxisRange(start, end)

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

// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100.
const builder = Charts.newTableChart();
builder.setYAxisRange(0, 100);

المعلمات

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

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

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

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

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.

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

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

الإرجاع

‫EmbeddedScatterChartBuilder: أداة إنشاء مفيدة للتسلسل