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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
range	Range	ช่วงที่จะเพิ่ม

รีเทิร์น

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
range	Range	ช่วงที่จะนำออก

รีเทิร์น

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
cssValue	String	ค่า 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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
type	ChartType	ประเภทที่จะใช้เป็นแผนภูมินี้

รีเทิร์น

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
cssValues	String[]	อาร์เรย์ของค่า 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)

พารามิเตอร์

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

รีเทิร์น

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

ดูเพิ่มเติม

• CurveStyle

---

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
strategy	ChartHiddenDimensionStrategy	กลยุทธ์ที่ใช้สำหรับแถวและคอลัมน์ที่ซ่อนอยู่

รีเทิร์น

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

---

setLegendPosition(position)

กำหนดตำแหน่งของคำอธิบายตามแผนภูมิ โดยค่าเริ่มต้นจะไม่มีคำอธิบาย

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
position	Position	ตำแหน่งของคำอธิบาย

รีเทิร์น

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
textStyle	TextStyle	รูปแบบข้อความที่ใช้สำหรับคำอธิบายแผนภูมิ

รีเทิร์น

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
mergeStrategy	ChartMergeStrategy	กลยุทธ์การรวมที่จะใช้

รีเทิร์น

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
headers	Integer	จำนวนแถวหรือคอลัมน์ที่จะถือเป็นส่วนหัว ส่วนหัวที่มีค่าเป็นลบ ตรวจหาอัตโนมัติ

รีเทิร์น

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

---

setOption(option, value)

ตั้งค่าตัวเลือกขั้นสูงสำหรับแผนภูมินี้ โปรดดูรายการตัวเลือกที่มีที่แผนภูมิ ตัวเลือกการกำหนดค่า

วิธีการนี้ไม่ได้ตรวจสอบว่าตัวเลือกที่คุณระบุถูกต้องสำหรับแผนภูมิประเภทนี้ หรือ มีรูปแบบ/โครงสร้างที่ถูกต้อง

ตัวอย่างนี้แสดงวิธีเปลี่ยนชื่อและตั้งค่าคำอธิบาย

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
option	String	ชื่อของตัวเลือก
value	Object	ค่าของตัวเลือก

รีเทิร์น

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

---

setPointStyle(style)

ตั้งค่ารูปแบบสำหรับจุดในเส้น โดยค่าเริ่มต้น จุดจะไม่มีรูปแบบเฉพาะ และมีเพียง เส้นนั้นจะปรากฏ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
style	PointStyle	รูปแบบที่ใช้สำหรับจุดในเส้น

รีเทิร์น

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

ดูเพิ่มเติม

• PointStyle

---

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
anchorRowPos	Integer	ด้านบนของแผนภูมิจะตรึงอยู่ในแถวนี้
anchorColPos	Integer	ด้านซ้ายของแผนภูมิจะตรึงอยู่กับคอลัมน์นี้
offsetX	Integer	มุมขวาบนของแผนภูมิจะชดเชยด้วยจำนวนพิกเซลนี้
offsetY	Integer	มุมซ้ายล่างของแผนภูมิจะชดเชยด้วยจำนวนพิกเซลนี้

รีเทิร์น

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

---

setRange(start, end)

กำหนดช่วงสำหรับแผนภูมิ

หากจุดข้อมูลใดๆ อยู่นอกช่วง ช่วงดังกล่าวจะขยายเพื่อรวมข้อมูลดังกล่าว คะแนน

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
start	Number	ค่าสำหรับเส้นตารางต่ำสุดของแกนช่วง
end	Number	ค่าสำหรับเส้นตารางสูงสุดของแกนช่วง

รีเทิร์น

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

---

setTitle(chartTitle)

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

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
textStyle	TextStyle	รูปแบบข้อความที่ใช้สำหรับชื่อแผนภูมิ คุณสามารถสร้างออบเจ็กต์ 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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
transpose	Boolean	หากเป็น 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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
textStyle	TextStyle	รูปแบบข้อความที่ใช้สำหรับชื่อแกนแนวนอน คุณสามารถสร้างออบเจ็กต์ 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')

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
title	String	ชื่อของแกน 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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
textStyle	TextStyle	รูปแบบข้อความที่ใช้สำหรับชื่อแกนแนวนอน คุณสามารถสร้างออบเจ็กต์ 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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
textStyle	TextStyle	รูปแบบข้อความที่ใช้สำหรับชื่อแกนแนวนอน คุณสามารถสร้างออบเจ็กต์ 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')

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
title	String	ชื่อของแกน 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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
textStyle	TextStyle	รูปแบบข้อความที่ใช้สำหรับชื่อแกนแนวนอน คุณสามารถสร้างออบเจ็กต์ TextStyleBuilder ได้โดยเรียกใช้ Charts.newTextStyle()

รีเทิร์น

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

---

useLogScale()

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

รีเทิร์น

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