เครื่องมือสร้างสำหรับแผนภูมิวงกลม สำหรับรายละเอียดเพิ่มเติม โปรดดู Gviz เอกสารประกอบ
เมธอด
เอกสารโดยละเอียด
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()
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();
รีเทิร์น
EmbeddedPieChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
set3D()
ตั้งค่าแผนภูมิให้เป็น 3 มิติ
รีเทิร์น
EmbeddedPieChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
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" ) |
รีเทิร์น
EmbeddedPieChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
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 ในแผนภูมิ |
รีเทิร์น
EmbeddedPieChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
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 | ตำแหน่งของคำอธิบาย |
รีเทิร์น
EmbeddedPieChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
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 | รูปแบบข้อความที่ใช้สำหรับคำอธิบายแผนภูมิ |
รีเทิร์น
EmbeddedPieChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
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
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
setTitle(chartTitle)
ตั้งชื่อแผนภูมิ ชื่อจะแสดงตรงกลางเหนือแผนภูมิ
// Creates a line chart builder and title to 'My Line Chart'. var builder = Charts.newLineChart(); builder.setTitle('My Line Chart')
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
chartTitle | String | ชื่อแผนภูมิ |
รีเทิร์น
EmbeddedPieChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
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() |
รีเทิร์น
EmbeddedPieChartBuilder
— เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่
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
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่