Class EmbeddedAreaChartBuilder

EmbeddedAreaChartBuilder

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

الطُرق

الطريقةنوع الإرجاعوصف قصير
addRange(range)EmbeddedChartBuilderتضيف هذه الطريقة نطاقًا إلى الرسم البياني الذي تعدِّله هذه الأداة.
asAreaChart()EmbeddedAreaChartBuilderلضبط نوع الرسم البياني على "مخطط مساحي" وعرض EmbeddedAreaChartBuilder
asBarChart()EmbeddedBarChartBuilderلضبط نوع الرسم البياني على "مخطط شريطي" وعرض EmbeddedBarChartBuilder
asColumnChart()EmbeddedColumnChartBuilderلضبط نوع الرسم البياني على "مخطط عمودي" وعرض EmbeddedColumnChartBuilder
asComboChart()EmbeddedComboChartBuilderلضبط نوع الرسم البياني على "رسم بياني للتحرير والسرد" وعرض EmbeddedComboChartBuilder
asHistogramChart()EmbeddedHistogramChartBuilderلضبط نوع الرسم البياني على "مخطّط تكرار بياني" وعرض EmbeddedHistogramChartBuilder.
asLineChart()EmbeddedLineChartBuilderلضبط نوع الرسم البياني على "رسم بياني خطي" وعرض 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)

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

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

المعلمات

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

الإرجاع

EmbeddedChartBuilder — أداة الإنشاء هذه، للسلاسل


asAreaChart()

لضبط نوع الرسم البياني على "مخطط مساحي" وعرض EmbeddedAreaChartBuilder

الإرجاع

EmbeddedAreaChartBuilder — أداة إنشاء لمخطط مساحي


asBarChart()

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

الإرجاع

EmbeddedBarChartBuilder — أداة إنشاء للمخطط الشريطي


asColumnChart()

لضبط نوع الرسم البياني على "مخطط عمودي" وعرض EmbeddedColumnChartBuilder

الإرجاع

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


asComboChart()

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

الإرجاع

EmbeddedComboChartBuilder — أداة إنشاء لمخطط مختلط


asHistogramChart()

لضبط نوع الرسم البياني على "مخطّط تكرار بياني" وعرض EmbeddedHistogramChartBuilder.

الإرجاع

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


asLineChart()

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

الإرجاع

EmbeddedLineChartBuilder — أداة إنشاء لمخطط خطي


asPieChart()

لضبط نوع الرسم البياني على PieChart وعرض EmbeddedPieChartBuilder

الإرجاع

EmbeddedPieChartBuilder — أداة إنشاء للمخطط الدائري


asScatterChart()

لضبط نوع الرسم البياني على ScatterChart وعرض 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);

المعلمات

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

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.


setBackgroundColor(cssValue)

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

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

المعلمات

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

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.


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

المعلمات

الاسمالنوعالوصف
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"]);

المعلمات

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

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.


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

المعلمات

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

المعلمات

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

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.


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

المعلمات

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

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.


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

المعلمات

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

المعلمات

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

الإرجاع

EmbeddedChartBuilder — أداة الإنشاء هذه، للسلاسل


setOption(option, value)

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

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

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

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

المعلمات

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

الإرجاع

EmbeddedChartBuilder — أداة الإنشاء هذه، للسلاسل


setPointStyle(style)

لتعيين نمط النقاط في الخط. ولا تكون للنقاط بشكل افتراضي أنماط معينة، الخط مرئي.

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

المعلمات

الاسمالنوعالوصف
stylePointStyleالنمط المستخدم للنقاط في الخط.

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.

انظر أيضًا


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

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

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

المعلمات

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

الإرجاع

EmbeddedChartBuilder — أداة الإنشاء هذه، للسلاسل


setRange(start, end)

تعين نطاق الرسم البياني.

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

المعلمات

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

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.


setStacked()

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

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.


setTitle(chartTitle)

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

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

المعلمات

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

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.


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

المعلمات

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

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.


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

المعلمات

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

المعلمات

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

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.


setXAxisTitle(title)

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

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

المعلمات

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

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.


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

المعلمات

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

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.


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

المعلمات

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

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.


setYAxisTitle(title)

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

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

المعلمات

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

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.


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

المعلمات

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

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.


useLogScale()

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

الإرجاع

EmbeddedAreaChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.