Class EmbeddedBarChartBuilder

EmbeddedBarChartBuilder

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

الطُرق

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

الوثائق التفصيلية

addRange(range)

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

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

sheet.insertChart(chart);

المَعلمات

الاسمTypeالوصف
rangeRangeالنطاق المطلوب إضافته.

استرجاع الكرة

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


asAreaChart()

لضبط نوع الرسم البياني على مخطط المنطقة وعرض EmbeddedAreaChartBuilder

استرجاع الكرة

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


asBarChart()

لضبط نوع الرسم البياني على المخطط الشريطي وعرض EmbeddedBarChartBuilder

استرجاع الكرة

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


asColumnChart()

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

استرجاع الكرة

EmbeddedColumnChartBuilder - أداة إنشاء للمخطط العمودي


asComboChart()

لضبط نوع الرسم البياني على "رسم بياني مختلط" وعرض EmbeddedComboChartBuilder

استرجاع الكرة

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


asHistogramChart()

لضبط نوع الرسم البياني على مخطط تكراري وعرض القيمة EmbeddedHistogramChartBuilder

استرجاع الكرة

EmbeddedHistogramChartBuilder - أداة إنشاء للمخطط التكراري


asLineChart()

لضبط نوع الرسم البياني على رسم بياني خطي وعرض EmbeddedLineChartBuilder

استرجاع الكرة

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


asPieChart()

لضبط نوع الرسم البياني على مخطط دائري لعرض القيمة EmbeddedPieChartBuilder

استرجاع الكرة

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


asScatterChart()

لضبط نوع الرسم البياني على "رسم بياني بالنقاط المبعثرة" وعرض القيمة EmbeddedScatterChartBuilder.

استرجاع الكرة

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


asTableChart()

لضبط نوع الرسم البياني على TableChart وعرض القيمة EmbeddedTableChartBuilder

استرجاع الكرة

EmbeddedTableChartBuilder: أداة إنشاء للرسم البياني الجدولي


build()

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

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

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

sheet.insertChart(chart);

استرجاع الكرة

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


clearRanges()

تزيل جميع النطاقات من الرسم البياني الذي تعدِّله أداة الإنشاء هذه.

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

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

استرجاع الكرة

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


getChartType()

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

استرجاع الكرة

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


getContainer()

عرض الرسم البياني ContainerInfo الذي يشمل مكان ظهور الرسم البياني على الورقة

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

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

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


getRanges()

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

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

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

var ranges = chartBuilder.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[] - مصفوفة من النطاقات التي تعمل كمصدر بيانات الرسم البياني الذي سيتم إنشاؤه


removeRange(range)

لإزالة النطاق المحدد من الرسم البياني الذي تعدّله أداة الإنشاء هذه. لا يعرض خطأ إذا لم يكن النطاق في هذا المخطط.

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

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

var firstRange = sheet.getRange("A1:B5");
var secondRange = sheet.getRange("A6:B8");

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

var chart = chartBuilder.build();

sheet.insertChart(chart);

المَعلمات

الاسمTypeالوصف
rangeRangeالنطاق المطلوب إزالته.

استرجاع الكرة

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


reverseCategories()

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

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

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل


reverseDirection()

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

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل


setBackgroundColor(cssValue)

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

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

المَعلمات

الاسمTypeالوصف
cssValueStringقيمة CSS للون (مثل "blue" أو "#00f").

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل


setChartType(type)

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

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

sheet.insertChart(chart);

المَعلمات

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

استرجاع الكرة

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


setColors(cssValues)

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

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

المَعلمات

الاسمTypeالوصف
cssValuesString[]مصفوفة من قيم CSS للألوان، مثل ["red", "#acf"]. ويمثّل العنصر nth في الصفيف لون السطر nth في الرسم البياني.

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل


setHiddenDimensionStrategy(strategy)

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

sheet.insertChart(chart);

المَعلمات

الاسمTypeالوصف
strategyChartHiddenDimensionStrategyالإستراتيجية المستخدمة للصفوف والأعمدة المخفية.

استرجاع الكرة

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


setLegendPosition(position)

تعيين موضع وسيلة الإيضاح بالنسبة إلى الرسم البياني. وبشكل افتراضي، لا توجد وسيلة إيضاح.

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

المَعلمات

الاسمTypeالوصف
positionPositionموضع وسيلة الإيضاح.

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل


setLegendTextStyle(textStyle)

لتعيين نمط النص لوسيلة الإيضاح للرسم البياني.

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

المَعلمات

الاسمTypeالوصف
textStyleTextStyleنمط النص المطلوب استخدامه في وسيلة إيضاح الرسم البياني.

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل


setMergeStrategy(mergeStrategy)

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

المَعلمات

الاسمTypeالوصف
mergeStrategyChartMergeStrategyاستراتيجية الدمج المطلوب استخدامها.

استرجاع الكرة

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


setNumHeaders(headers)

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

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

sheet.insertChart(chart);

المَعلمات

الاسمTypeالوصف
headersIntegerعدد الصفوف أو الأعمدة المطلوب التعامل معها كرؤوس. تتسبب القيم السالبة في اكتشاف العناوين تلقائيًا.

استرجاع الكرة

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


setOption(option, value)

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

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

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

builder.setOption('title', 'Earnings projections');
builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});

المَعلمات

الاسمTypeالوصف
optionStringاسم الخيار
valueObjectقيمة الخيار.

استرجاع الكرة

EmbeddedChartBuilder: أداة الإنشاء هذه مخصّصة للسلاسل


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

تعيين الموضع، وتغيير مكان ظهور الرسم البياني في الورقة. تمت فهرسة anchorRowPos وanchorColPos مرة واحدة.

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

sheet.insertChart(chart);

المَعلمات

الاسمTypeالوصف
anchorRowPosIntegerتم إرساء الجانب العلوي من الرسم البياني في هذا الصف.
anchorColPosIntegerتم إرساء الجانب الأيسر من الرسم البياني في هذا العمود.
offsetXIntegerتتم التعويض عن الزاوية العلوية اليمنى في الرسم البياني بهذا العدد من وحدات البكسل.
offsetYIntegerتتم التعويض عن الزاوية السفلية اليسرى من الرسم البياني بهذا العدد من وحدات البكسل.

استرجاع الكرة

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


setRange(start, end)

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

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

المَعلمات

الاسمTypeالوصف
startNumberقيمة خط الشبكة الأدنى في محور النطاق.
endNumberقيمة أعلى خط شبكة في محور النطاق.

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل


setStacked()

تستخدم خطوطًا مكدسة، مما يعني أن قيم الخطوط والشريط تكون مكدسة (مجمعة). بشكل افتراضي، لا يوجد تكديس.

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل


setTitle(chartTitle)

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

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

المَعلمات

الاسمTypeالوصف
chartTitleStringعنوان المخطط.

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل


setTitleTextStyle(textStyle)

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

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

المَعلمات

الاسمTypeالوصف
textStyleTextStyleنمط النص المطلوب استخدامه لعنوان الرسم البياني. يمكنك إنشاء كائن TextStyleBuilder من خلال طلب Charts.newTextStyle().

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل


setTransposeRowsAndColumns(transpose)

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

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

sheet.insertChart(chart);

المَعلمات

الاسمTypeالوصف
transposeBooleanإذا تم استخدام true، سيتم تبديل موضع الصفوف والأعمدة المستخدَمة لإنشاء الرسم البياني.

استرجاع الكرة

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


setXAxisTextStyle(textStyle)

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

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

المَعلمات

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

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل


setXAxisTitle(title)

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

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

المَعلمات

الاسمTypeالوصف
titleStringعنوان المحور س.

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل


setXAxisTitleTextStyle(textStyle)

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

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

المَعلمات

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

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل


setYAxisTextStyle(textStyle)

لتعيين نمط نص المحور الرأسي.

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

المَعلمات

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

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل


setYAxisTitle(title)

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

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

المَعلمات

الاسمTypeالوصف
titleStringعنوان المحور Y.

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل


setYAxisTitleTextStyle(textStyle)

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

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

المَعلمات

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

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل


useLogScale()

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

استرجاع الكرة

EmbeddedBarChartBuilder: أداة الإنشاء هذه مفيدة للسلاسل