Class EmbeddedLineChartBuilder

EmbeddedLineChartBuilder

เครื่องมือสร้างแผนภูมิเส้น สำหรับรายละเอียดเพิ่มเติม โปรดดู 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ตั้งค่าประเภทแผนภูมิเป็นแผนภูมิเส้นและแสดงผล 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()EmbeddedLineChartBuilderกลับการวาดอนุกรมในแกนโดเมน
setBackgroundColor(cssValue)EmbeddedLineChartBuilderกำหนดสีพื้นหลังของแผนภูมิ
setChartType(type)EmbeddedChartBuilderเปลี่ยนประเภทของแผนภูมิ
setColors(cssValues)EmbeddedLineChartBuilderตั้งค่าสีสำหรับเส้นในแผนภูมิ
setCurveStyle(style)EmbeddedLineChartBuilderตั้งค่ารูปแบบที่จะใช้กับเส้นโค้งในแผนภูมิ
setHiddenDimensionStrategy(strategy)EmbeddedChartBuilderกำหนดกลยุทธ์ที่จะใช้กับแถวและคอลัมน์ที่ซ่อนอยู่
setLegendPosition(position)EmbeddedLineChartBuilderกำหนดตำแหน่งของคำอธิบายตามแผนภูมิ
setLegendTextStyle(textStyle)EmbeddedLineChartBuilderตั้งค่ารูปแบบข้อความของคำอธิบายแผนภูมิ
setMergeStrategy(mergeStrategy)EmbeddedChartBuilderตั้งค่ากลยุทธ์การรวมเพื่อใช้เมื่อมีมากกว่า 1 ช่วง
setNumHeaders(headers)EmbeddedChartBuilderกำหนดจำนวนแถวหรือคอลัมน์ของช่วงที่ควรถือว่าเป็นส่วนหัว
setOption(option, value)EmbeddedChartBuilderตั้งค่าตัวเลือกขั้นสูงสำหรับแผนภูมินี้
setPointStyle(style)EmbeddedLineChartBuilderตั้งค่ารูปแบบสำหรับจุดในเส้น
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)EmbeddedChartBuilderกำหนดตำแหน่ง ซึ่งจะเปลี่ยนตําแหน่งที่แผนภูมิจะปรากฏในชีต
setRange(start, end)EmbeddedLineChartBuilderกำหนดช่วงสำหรับแผนภูมิ
setTitle(chartTitle)EmbeddedLineChartBuilderตั้งชื่อแผนภูมิ
setTitleTextStyle(textStyle)EmbeddedLineChartBuilderตั้งค่ารูปแบบข้อความของชื่อแผนภูมิ
setTransposeRowsAndColumns(transpose)EmbeddedChartBuilderตั้งค่าว่าจะสลับตำแหน่งแถวและคอลัมน์ของแผนภูมิหรือไม่
setXAxisTextStyle(textStyle)EmbeddedLineChartBuilderตั้งค่ารูปแบบข้อความของแกนแนวนอน
setXAxisTitle(title)EmbeddedLineChartBuilderเพิ่มชื่อให้กับแกนแนวนอน
setXAxisTitleTextStyle(textStyle)EmbeddedLineChartBuilderตั้งค่ารูปแบบข้อความสำหรับชื่อแกนแนวนอน
setYAxisTextStyle(textStyle)EmbeddedLineChartBuilderตั้งค่ารูปแบบข้อความของแกนแนวตั้ง
setYAxisTitle(title)EmbeddedLineChartBuilderเพิ่มชื่อให้กับแกนแนวตั้ง
setYAxisTitleTextStyle(textStyle)EmbeddedLineChartBuilderตั้งค่ารูปแบบข้อความสำหรับชื่อแกนแนวตั้ง
useLogScale()EmbeddedLineChartBuilderทำให้แกนช่วงเป็นสเกลลอการิทึม (ค่าทั้งหมดต้องเป็นบวก)

เอกสารโดยละเอียด

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

ตั้งค่าประเภทแผนภูมิเป็น AreaChart และแสดง EmbeddedAreaChartBuilder

รีเทิร์น

EmbeddedAreaChartBuilder — เครื่องมือสร้างแผนภูมิพื้นที่


asBarChart()

ตั้งค่าประเภทแผนภูมิเป็น BarChart และแสดง EmbeddedBarChartBuilder

รีเทิร์น

EmbeddedBarChartBuilder — เครื่องมือสร้างแผนภูมิแท่ง


asColumnChart()

ตั้งค่าประเภทแผนภูมิเป็น ColumnChart และแสดง EmbeddedColumnChartBuilder

รีเทิร์น

EmbeddedColumnChartBuilder — เครื่องมือสร้างสำหรับแผนภูมิคอลัมน์


asComboChart()

ตั้งค่าประเภทแผนภูมิเป็น ComboChart และแสดง EmbeddedComboChartBuilder

รีเทิร์น

EmbeddedComboChartBuilder — เครื่องมือสร้างแผนภูมิผสม


asHistogramChart()

ตั้งค่าประเภทแผนภูมิเป็น HistogramChart และแสดง 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();

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


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

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


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 ในอาร์เรย์จะแสดงสีของเส้นที่ n ในแผนภูมิ

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


setCurveStyle(style)

ตั้งค่ารูปแบบที่จะใช้กับเส้นโค้งในแผนภูมิ ดูเส้นโค้งที่อนุญาตได้ที่ CurveStyle รูปแบบ

// Creates a line chart builder and curves the lines in the chart.
var builder = Charts.newLineChart();
builder.setCurveStyle(Charts.CurveStyle.SMOOTH)

พารามิเตอร์

ชื่อประเภทคำอธิบาย
styleCurveStyleรูปแบบของเส้นโค้งในแผนภูมิ

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

ดูเพิ่มเติม


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ตำแหน่งของคำอธิบาย

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


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รูปแบบข้อความที่ใช้สำหรับคำอธิบายแผนภูมิ

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


setMergeStrategy(mergeStrategy)

ตั้งค่ากลยุทธ์การรวมเพื่อใช้เมื่อมีมากกว่า 1 ช่วง หากเป็น 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รูปแบบที่ใช้สำหรับจุดในเส้น

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

ดูเพิ่มเติม


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ค่าสำหรับเส้นตารางสูงสุดของแกนช่วง

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


setTitle(chartTitle)

ตั้งชื่อแผนภูมิ ชื่อจะแสดงตรงกลางเหนือแผนภูมิ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
chartTitleStringชื่อแผนภูมิ

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


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

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


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

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


setXAxisTitle(title)

เพิ่มชื่อให้กับแกนแนวนอน ชื่อจะอยู่ตรงกลางและอยู่ใต้ค่าแกน ป้ายกำกับ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
titleStringชื่อของแกน X

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


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

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


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

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


setYAxisTitle(title)

เพิ่มชื่อให้กับแกนแนวตั้ง ชื่ออยู่ตรงกลางและปรากฏอยู่ทางด้านซ้ายของค่า ป้ายกำกับ

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
titleStringชื่อของแกน Y

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


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

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


useLogScale()

ทำให้แกนช่วงเป็นสเกลลอการิทึม (ค่าทั้งหมดต้องเป็นบวก) ช่วง แกน คือแกนแนวตั้งสำหรับแผนภูมิแนวตั้ง (เช่น เส้น พื้นที่ หรือคอลัมน์) และ แกนแนวนอนสำหรับแผนภูมิแนวนอน (เช่น แท่ง)

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่