เครื่องมือสร้างสำหรับแผนภูมิตาราง ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ 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 | นำช่วงทั้งหมดออกจากแผนภูมิที่เครื่องมือสร้างนี้แก้ไข |
enablePaging(enablePaging) | EmbeddedTableChartBuilder | ตั้งค่าว่าจะเปิดใช้การสลับหน้าของข้อมูลหรือไม่ |
enablePaging(pageSize) | EmbeddedTableChartBuilder | เปิดใช้การแบ่งหน้าและกำหนดจำนวนแถวในแต่ละหน้า |
enablePaging(pageSize, startPage) | EmbeddedTableChartBuilder | เปิดใช้งานการแบ่งหน้า ตั้งค่าจำนวนแถวในแต่ละหน้าและหน้าแรกของตารางที่จะแสดง (หน้า ตัวเลขจะเป็นศูนย์) |
enableRtlTable(rtlEnabled) | EmbeddedTableChartBuilder | เพิ่มการสนับสนุนพื้นฐานสำหรับภาษาที่เขียนจากขวาไปซ้าย (เช่น อาหรับหรือฮีบรู) โดยกลับภาษา ลำดับคอลัมน์ของตาราง เพื่อให้คอลัมน์ 0 เป็นคอลัมน์ด้านขวาสุด และคอลัมน์สุดท้ายคือ คอลัมน์ซ้ายสุด |
enableSorting(enableSorting) | EmbeddedTableChartBuilder | กำหนดว่าจะจัดเรียงคอลัมน์เมื่อผู้ใช้คลิกส่วนหัวของคอลัมน์หรือไม่ |
getChartType() | ChartType | แสดงแผนภูมิประเภทปัจจุบัน |
getContainer() | ContainerInfo | แสดงแผนภูมิ ContainerInfo ซึ่งแสดงส่วนที่แผนภูมิปรากฏใน
ชีต |
getRanges() | Range[] | แสดงผลสำเนาของรายการช่วงที่ให้ข้อมูลสำหรับแผนภูมินี้ในปัจจุบัน |
removeRange(range) | EmbeddedChartBuilder | นำช่วงที่ระบุออกจากแผนภูมิที่เครื่องมือสร้างนี้แก้ไข |
setChartType(type) | EmbeddedChartBuilder | เปลี่ยนประเภทของแผนภูมิ |
setFirstRowNumber(number) | EmbeddedTableChartBuilder | กำหนดหมายเลขแถวให้แถวแรกในตารางข้อมูล |
setHiddenDimensionStrategy(strategy) | EmbeddedChartBuilder | กำหนดกลยุทธ์ที่จะใช้กับแถวและคอลัมน์ที่ซ่อนอยู่ |
setInitialSortingAscending(column) | EmbeddedTableChartBuilder | ตั้งค่าดัชนีของคอลัมน์ตามที่ควรจัดเรียงตารางในตอนแรก (จากน้อยไปมาก) |
setInitialSortingDescending(column) | EmbeddedTableChartBuilder | ตั้งค่าดัชนีของคอลัมน์ตามที่ควรจัดเรียงตารางในตอนแรก (มากไปน้อย) |
setMergeStrategy(mergeStrategy) | EmbeddedChartBuilder | ตั้งค่ากลยุทธ์การรวมเพื่อใช้เมื่อมีมากกว่า 1 ช่วง |
setNumHeaders(headers) | EmbeddedChartBuilder | กำหนดจำนวนแถวหรือคอลัมน์ของช่วงที่ควรถือว่าเป็นส่วนหัว |
setOption(option, value) | EmbeddedChartBuilder | ตั้งค่าตัวเลือกขั้นสูงสำหรับแผนภูมินี้ |
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY) | EmbeddedChartBuilder | กำหนดตำแหน่ง ซึ่งจะเปลี่ยนตําแหน่งที่แผนภูมิจะปรากฏในชีต |
setTransposeRowsAndColumns(transpose) | EmbeddedChartBuilder | ตั้งค่าว่าจะสลับตำแหน่งแถวและคอลัมน์ของแผนภูมิหรือไม่ |
showRowNumberColumn(showRowNumber) | EmbeddedTableChartBuilder | กำหนดว่าจะแสดงหมายเลขแถวเป็นคอลัมน์แรกของตารางหรือไม่ |
useAlternatingRowStyle(alternate) | EmbeddedTableChartBuilder | กำหนดว่ามีการกำหนดรูปแบบสีสลับให้กับแถวเลขคี่และแถวคู่ของแผนภูมิตารางหรือไม่ |
เอกสารโดยละเอียด
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
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
enablePaging(enablePaging)
ตั้งค่าว่าจะเปิดใช้การสลับหน้าของข้อมูลหรือไม่
ลักษณะการทำงานเริ่มต้นคือปิดใช้การแบ่งหน้า หากเปิดใช้การแบ่งหน้า ขนาดหน้าตามค่าเริ่มต้นคือ 10
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
enablePaging | Boolean | true หากควรเปิดใช้การแบ่งหน้า มิฉะนั้นให้false |
รีเทิร์น
EmbeddedTableChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
enablePaging(pageSize)
เปิดใช้การแบ่งหน้าและกำหนดจำนวนแถวในแต่ละหน้า
ขนาดหน้าเริ่มต้นคือ 10
// Creates a table chart builder and enables paging with page size of 5. var builder = Charts.newTableChart(); builder.enablePaging(5);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
pageSize | Integer | จำนวนแถวในแต่ละหน้าของตาราง |
รีเทิร์น
EmbeddedTableChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
enablePaging(pageSize, startPage)
เปิดใช้งานการแบ่งหน้า ตั้งค่าจำนวนแถวในแต่ละหน้าและหน้าแรกของตารางที่จะแสดง (หน้า ตัวเลขจะเป็นศูนย์)
ขนาดหน้าเริ่มต้นคือ 10 และหน้าเริ่มต้นเริ่มต้นคือ 0
// Creates a table chart builder and enables paging with page size of 5 and displays page 2 // first. var builder = Charts.newTableChart(); builder.enablePaging(5, 2);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
pageSize | Integer | จำนวนแถวในแต่ละหน้าของตาราง |
startPage | Integer | หน้าแรกของตารางที่แสดง (หมายเลขหน้าจะมีฐาน 0) |
รีเทิร์น
EmbeddedTableChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
enableRtlTable(rtlEnabled)
เพิ่มการสนับสนุนพื้นฐานสำหรับภาษาที่เขียนจากขวาไปซ้าย (เช่น อาหรับหรือฮีบรู) โดยกลับภาษา ลำดับคอลัมน์ของตาราง เพื่อให้คอลัมน์ 0 เป็นคอลัมน์ด้านขวาสุด และคอลัมน์สุดท้ายคือ คอลัมน์ซ้ายสุด
โดยจะไม่ส่งผลต่อดัชนีคอลัมน์ในข้อมูลที่สำคัญ แต่ส่งผลเฉพาะกับลำดับของการแสดงผลเท่านั้น การแสดงภาพตารางไม่รองรับการแสดงภาษาแบบ 2 ทิศทาง (BiDi) แบบเต็มรูปแบบ ด้วยตัวเลือกนี้ ระบบจะไม่สนใจตัวเลือกนี้หากคุณเปิดใช้การแบ่งหน้า (โดยใช้ตัวเลือกหน้าเว็บ) หรือหาก ตารางมีแถบเลื่อน เนื่องจากคุณได้ระบุตัวเลือกความสูงและความกว้างน้อยกว่า ขนาดตารางที่กำหนด ลักษณะการทำงานเริ่มต้นคือปิดใช้การรองรับ RTL
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
rtlEnabled | Boolean | true หากควรเปิดใช้การสนับสนุนข้อความจากขวาไปซ้าย false
หรือไม่เช่นนั้น |
รีเทิร์น
EmbeddedTableChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
enableSorting(enableSorting)
กำหนดว่าจะจัดเรียงคอลัมน์เมื่อผู้ใช้คลิกส่วนหัวของคอลัมน์หรือไม่
หากเปิดใช้การจัดเรียง เมื่อผู้ใช้คลิกส่วนหัวของคอลัมน์ ระบบจะเรียงแถวให้โดยอัตโนมัติ จัดเรียงแล้ว ลักษณะการทำงานเริ่มต้นคือเปิดใช้การจัดเรียง
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
enableSorting | Boolean | true เพื่อเปิดใช้การจัดเรียงโดยคลิกส่วนหัวของคอลัมน์ หากไม่ใช่ false |
รีเทิร์น
EmbeddedTableChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
getChartType()
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
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
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
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
setFirstRowNumber(number)
กำหนดหมายเลขแถวให้แถวแรกในตารางข้อมูล
หมายเลขแถวเริ่มต้นของแถวแรกคือ 1
// Creates a table chart builder and sets the first row to be 2. var builder = Charts.newTableChart(); builder.setFirstRowNumber(2);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
number | Integer | หมายเลขแถวสำหรับแถวแรกในตารางข้อมูล |
รีเทิร์น
EmbeddedTableChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
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
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
setInitialSortingAscending(column)
ตั้งค่าดัชนีของคอลัมน์ตามที่ควรจัดเรียงตารางในตอนแรก (จากน้อยไปมาก)
ระบบปฏิบัติการของคอลัมน์จะจัดเรียงจากน้อยไปมากและมีลูกศรขนาดเล็กกำกับอยู่
// Creates a table chart builder and sorts it by the second column (ascending). var builder = Charts.newTableChart(); builder.setInitialSortingAscending(2);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
column | Integer | จำนวนคอลัมน์ตามตารางที่ควรจัดเรียงในตอนแรก |
รีเทิร์น
EmbeddedTableChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
setInitialSortingDescending(column)
ตั้งค่าดัชนีของคอลัมน์ตามที่ควรจัดเรียงตารางในตอนแรก (มากไปน้อย)
ระบบปฏิบัติการของคอลัมน์จะจัดเรียงตามลำดับจากมากไปหาน้อย และมีลูกศรเล็กๆ กำกับไว้
// Creates a table chart builder and sorts it by the second column (descending). var builder = Charts.newTableChart(); builder.setInitialSortingDescending(2);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
column | Integer | จำนวนคอลัมน์ตามตารางที่ควรจัดเรียงในตอนแรก |
รีเทิร์น
EmbeddedTableChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
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
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
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
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
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
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
showRowNumberColumn(showRowNumber)
กำหนดว่าจะแสดงหมายเลขแถวเป็นคอลัมน์แรกของตารางหรือไม่
ลักษณะการทำงานเริ่มต้นจะไม่แสดงหมายเลขแถว
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
showRowNumber | Boolean | true หากคอลัมน์แรกของตารางควรแสดงหมายเลขแถว
false หรือไม่เช่นนั้น |
รีเทิร์น
EmbeddedTableChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
useAlternatingRowStyle(alternate)
กำหนดว่ามีการกำหนดรูปแบบสีสลับให้กับแถวเลขคี่และแถวคู่ของแผนภูมิตารางหรือไม่
การทำงานเริ่มต้นคือแถวที่มีรูปแบบสลับสี
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
alternate | Boolean | true หากรูปแบบสีควรสลับกัน หรือfalse |
รีเทิร์น
EmbeddedTableChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่