เครื่องมือสร้างแผนภูมิตาราง โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบของ 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 | เปิดใช้การแบ่งหน้า กำหนดจำนวนแถวในแต่ละหน้าและหน้าเว็บแรกในตารางที่จะแสดง (เลขหน้าไม่อิงกับ 0) |
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);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
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
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
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);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
pageSize | Integer | จำนวนแถวในแต่ละหน้าของตาราง |
รีเทิร์น
EmbeddedTableChartBuilder
— เครื่องมือสร้างนี้มีประโยชน์ต่อการทำเชน
enablePaging(pageSize, startPage)
เปิดใช้การแบ่งหน้า กำหนดจำนวนแถวในแต่ละหน้าและหน้าเว็บแรกในตารางที่จะแสดง (เลขหน้าไม่อิงกับ 0)
ขนาดหน้าเริ่มต้นคือ 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);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
pageSize | Integer | จำนวนแถวในแต่ละหน้าของตาราง |
startPage | Integer | ตารางหน้าแรกที่จะแสดง (หมายเลขหน้าจะเป็น 0) |
รีเทิร์น
EmbeddedTableChartBuilder
— เครื่องมือสร้างนี้มีประโยชน์ต่อการทำเชน
enableRtlTable(rtlEnabled)
เพิ่มการสนับสนุนพื้นฐานสำหรับภาษาที่อ่านจากขวาไปซ้าย (เช่น อาหรับหรือฮีบรู) โดยการกลับลำดับคอลัมน์ของตาราง เพื่อให้คอลัมน์ 0 เป็นคอลัมน์ด้านขวาสุด และคอลัมน์สุดท้ายคือคอลัมน์ซ้ายสุด
การดำเนินการนี้ไม่ส่งผลต่อดัชนีคอลัมน์ในข้อมูลพื้นฐาน แต่ส่งผลเฉพาะกับลำดับการแสดงผลเท่านั้น การแสดงภาพตารางไม่รองรับการแสดงภาษาแบบ 2 ทิศทางแบบเต็ม (BiDi) แม้ว่าจะมีตัวเลือกนี้ก็ตาม ระบบจะไม่สนใจตัวเลือกนี้หากคุณเปิดใช้การแบ่งหน้า (โดยใช้ตัวเลือกหน้าเว็บ) หรือหากตารางมีแถบเลื่อนเนื่องจากคุณระบุตัวเลือกความสูงและความกว้างไว้น้อยกว่าขนาดตารางที่กำหนด ลักษณะการทำงานเริ่มต้นคือปิดใช้การรองรับ RTL
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
rtlEnabled | Boolean | true หากควรเปิดใช้การสนับสนุนแบบขวาไปซ้าย false มิฉะนั้น |
รีเทิร์น
EmbeddedTableChartBuilder
— เครื่องมือสร้างนี้มีประโยชน์ต่อการทำเชน
enableSorting(enableSorting)
ตั้งค่าว่าจะจัดเรียงคอลัมน์หรือไม่เมื่อผู้ใช้คลิกส่วนหัวของคอลัมน์
หากเปิดใช้การจัดเรียง เมื่อผู้ใช้คลิกที่ส่วนหัวของคอลัมน์ ระบบจะจัดเรียงแถวโดยอัตโนมัติ ลักษณะการทำงานเริ่มต้นคือการเปิดใช้การจัดเรียง
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
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);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
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 | คำอธิบาย |
---|---|---|
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);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
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);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
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);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
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);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
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);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
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);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
headers | Integer | จำนวนแถวหรือคอลัมน์ที่จะถือเป็นส่วนหัว ค่าติดลบจะทำให้ระบบตรวจหาส่วนหัวโดยอัตโนมัติ |
รีเทิร์น
EmbeddedChartBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
setOption(option, value)
ตั้งค่าตัวเลือกขั้นสูงสำหรับแผนภูมินี้ โปรดดูรายการตัวเลือกที่ใช้ได้ที่หัวข้อตัวเลือกการกำหนดค่าแผนภูมิ
วิธีการนี้ไม่ได้ตรวจสอบว่าตัวเลือกที่คุณระบุใช้ได้กับแผนภูมิประเภทนี้หรือไม่ รวมถึงในกรณีที่ค่าอยู่ในรูปแบบ/โครงสร้างที่ถูกต้อง
ตัวอย่างนี้แสดงวิธีเปลี่ยนชื่อและตั้งค่าคำอธิบาย
builder.setOption('title', 'Earnings projections'); builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
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);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
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);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
transpose | Boolean | หากเป็น true แถวและคอลัมน์ที่ใช้สร้างแผนภูมิจะถูกสลับสับเปลี่ยนกัน |
รีเทิร์น
EmbeddedChartBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
showRowNumberColumn(showRowNumber)
ตั้งค่าว่าจะแสดงหมายเลขแถวเป็นคอลัมน์แรกของตารางหรือไม่
ลักษณะการทำงานเริ่มต้นจะไม่แสดงหมายเลขแถว
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
showRowNumber | Boolean | true หากคอลัมน์แรกของตารางควรแสดงหมายเลขแถว false ในกรณีอื่นๆ |
รีเทิร์น
EmbeddedTableChartBuilder
— เครื่องมือสร้างนี้มีประโยชน์ต่อการทำเชน
useAlternatingRowStyle(alternate)
ตั้งค่าว่าจะกำหนดรูปแบบการสลับสีให้กับแถวคี่และแถวคู่ของแผนภูมิตารางหรือไม่
ลักษณะการทำงานเริ่มต้นคือแถวที่มีลักษณะสีสลับกัน
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
alternate | Boolean | true หากรูปแบบสีควรสลับกัน false หรือมิเช่นนั้น |
รีเทิร์น
EmbeddedTableChartBuilder
— เครื่องมือสร้างนี้มีประโยชน์ต่อการทำเชน