แสดงแผนภูมิที่ฝังอยู่ในสเปรดชีต
ตัวอย่างนี้แสดงวิธีแก้ไขแผนภูมิที่มีอยู่
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A2:B8") var chart = sheet.getCharts()[0]; chart = chart.modify() .addRange(range) .setOption('title', 'Updated!') .setOption('animation.duration', 500) .setPosition(2,2,0,0) .build(); sheet.updateChart(chart);
ตัวอย่างนี้แสดงวิธีสร้างแผนภูมิใหม่
function newChart(range, sheet) { var sheet = SpreadsheetApp.getActiveSheet(); var chartBuilder = sheet.newChart(); chartBuilder.addRange(range) .setChartType(Charts.ChartType.LINE) .setOption('title', 'My Line Chart!'); sheet.insertChart(chartBuilder.build()); }
วิธีการ
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
asDataSourceChart() | DataSourceChart | แคสต์ไปยังอินสแตนซ์แผนภูมิแหล่งข้อมูล หากแผนภูมิเป็นแผนภูมิแหล่งข้อมูล หรือnull
ในกรณีที่แผนภูมิเป็นแผนภูมิแหล่งข้อมูล |
getAs(contentType) | Blob | แสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น Blob ที่แปลงเป็นประเภทเนื้อหาที่ระบุ |
getBlob() | Blob | แสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น Blob |
getChartId() | Integer | แสดงผลตัวระบุแบบคงที่สำหรับแผนภูมิที่ไม่ซ้ำกันในสเปรดชีตที่มีแผนภูมินั้น หรือแสดง null หากแผนภูมิไม่ได้อยู่ในสเปรดชีต |
getContainerInfo() | ContainerInfo | แสดงผลข้อมูลเกี่ยวกับตำแหน่งของแผนภูมิภายในชีต |
getHiddenDimensionStrategy() | ChartHiddenDimensionStrategy | แสดงกลยุทธ์ที่จะใช้ในการจัดการแถวและคอลัมน์ที่ซ่อน |
getMergeStrategy() | ChartMergeStrategy | แสดงผลกลยุทธ์การรวมที่ใช้เมื่อมีช่วงมากกว่า 1 ช่วง |
getNumHeaders() | Integer | แสดงผลจำนวนแถวหรือคอลัมน์ในช่วงที่ถือว่าเป็นส่วนหัว |
getOptions() | ChartOptions | แสดงตัวเลือกสำหรับแผนภูมินี้ เช่น ความสูง สี และแกน |
getRanges() | Range[] | แสดงผลช่วงที่แผนภูมินี้ใช้เป็นแหล่งข้อมูล |
getTransposeRowsAndColumns() | Boolean | หากตั้งค่าเป็น true แถวและคอลัมน์ที่ใช้ในการสร้างแผนภูมิจะเปลี่ยนไป |
modify() | EmbeddedChartBuilder | แสดงผล EmbeddedChartBuilder ที่ใช้แก้ไขแผนภูมินี้ได้ |
เอกสารประกอบโดยละเอียด
asDataSourceChart()
แคสต์ไปยังอินสแตนซ์แผนภูมิแหล่งข้อมูล หากแผนภูมิเป็นแผนภูมิแหล่งข้อมูล หรือnull
ในกรณีที่แผนภูมิเป็นแผนภูมิแหล่งข้อมูล
รีเทิร์น
DataSourceChart
— แผนภูมิแหล่งข้อมูล
getAs(contentType)
แสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น Blob ที่แปลงเป็นประเภทเนื้อหาที่ระบุ วิธีนี้จะเพิ่มส่วนขยายที่เหมาะสมลงในชื่อไฟล์ เช่น "myfile.pdf" อย่างไรก็ตาม สมมติว่าส่วนของชื่อไฟล์ที่อยู่หลังเครื่องหมายจุดสุดท้าย (ถ้ามี) เป็นส่วนขยายที่มีอยู่แล้วซึ่งควรแทนที่ ดังนั้น "ShoppingList.12.25.2014" จะกลายเป็น "ShoppingList.12.25.pdf"
ดูโควต้ารายวันสำหรับ Conversion ได้ที่โควต้าสำหรับบริการของ Google โดเมน Google Workspace ที่สร้างใหม่อาจอยู่ภายใต้โควต้าที่เข้มงวดเป็นการชั่วคราว
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
contentType | String | ประเภท MIME ที่จะแปลงเป็น สำหรับ Blob ส่วนใหญ่ 'application/pdf' เป็นตัวเลือกเดียวที่ใช้ได้ สำหรับรูปภาพในรูปแบบ BMP, GIF, JPEG หรือ PNG คุณสามารถใช้ 'image/bmp' , 'image/gif' , 'image/jpeg' หรือ 'image/png' ได้เช่นกัน |
รีเทิร์น
Blob
— ข้อมูลในรูปแบบ BLOB
getBlob()
getChartId()
แสดงผลตัวระบุแบบคงที่สำหรับแผนภูมิที่ไม่ซ้ำกันในสเปรดชีตที่มีแผนภูมินั้น หรือแสดง null
หากแผนภูมิไม่ได้อยู่ในสเปรดชีต
รีเทิร์น
Integer
— ตัวระบุแผนภูมิแบบคงที่
getContainerInfo()
แสดงผลข้อมูลเกี่ยวกับตำแหน่งของแผนภูมิภายในชีต
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(); var containerInfo = chart.getContainerInfo(); // 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
— ออบเจ็กต์ที่มีตำแหน่งของคอนเทนเนอร์แผนภูมิ
getHiddenDimensionStrategy()
แสดงกลยุทธ์ที่จะใช้ในการจัดการแถวและคอลัมน์ที่ซ่อน ค่าเริ่มต้นคือ 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() // Logs the strategy to use for hidden rows and columns which is // Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS in this case. Logger.log(chart.getHiddenDimensionStrategy());
รีเทิร์น
ChartHiddenDimensionStrategy
— กลยุทธ์ที่จะใช้กับแถวและคอลัมน์ที่ซ่อน
getMergeStrategy()
แสดงผลกลยุทธ์การรวมที่ใช้เมื่อมีช่วงมากกว่า 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("C1:C10"); var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .addRange(range2) .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS) .setPosition(5, 5, 0, 0) .build() // Logs whether rows of multiple ranges are merged, which is MERGE_ROWS in this case. Logger.log(chart.getMergeStrategy());
รีเทิร์น
ChartMergeStrategy
— MERGE_ROWS
หากมีการผสานแถวในหลายช่วง MERGE_COLUMNS
หากมีการผสานคอลัมน์ในหลายช่วง
getNumHeaders()
แสดงผลจำนวนแถวหรือคอลัมน์ในช่วงที่ถือว่าเป็นส่วนหัว
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() // Logs the number of rows or columns to use as headers, which is 1 in this case. Logger.log(chart.getHeaders());
รีเทิร์น
Integer
— จำนวนแถวหรือคอลัมน์ที่ถือว่าเป็นส่วนหัว ค่าลบหมายความว่าระบบตรวจพบส่วนหัวโดยอัตโนมัติ
getOptions()
แสดงตัวเลือกสำหรับแผนภูมินี้ เช่น ความสูง สี และแกน
ตัวเลือกที่แสดงผลจะเปลี่ยนแปลงไม่ได้
รีเทิร์น
ChartOptions
— ตัวเลือกสำหรับแผนภูมินี้ เช่น ความสูง สี และแกน
getRanges()
แสดงผลช่วงที่แผนภูมินี้ใช้เป็นแหล่งข้อมูล
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(); var ranges = chart.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[]
— อาร์เรย์ของช่วงที่ใช้เป็นแหล่งข้อมูลของแผนภูมินี้
getTransposeRowsAndColumns()
หากตั้งค่าเป็น true
แถวและคอลัมน์ที่ใช้ในการสร้างแผนภูมิจะเปลี่ยนไป ค่าเริ่มต้นคือ false
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B5"); var chart = sheet.newChart() .addRange(range) .setChartType(Charts.ChartType.BAR) .setTransposeRowsAndColumns(true) .setPosition(5, 5, 0, 0) .build() // Logs whether rows and columns should be transposed, which is true in this case. Logger.log(chart.getTransposeRowsAndColumns());
รีเทิร์น
Boolean
— true
หากแถวและคอลัมน์ที่ใช้สร้างแผนภูมิมีการสลับตำแหน่งกัน
modify()
แสดงผล EmbeddedChartBuilder
ที่ใช้แก้ไขแผนภูมินี้ได้ เรียกใช้ sheet.updateChart(chart)
เพื่อบันทึกการเปลี่ยนแปลงทั้งหมด
var sheet = SpreadsheetApp.getActiveSheet(); var chart = sheet.getCharts()[0]; chart = chart.modify() .setOption('width', 800) .setOption('height', 640) .setPosition(5, 5, 0, 0) .build(); sheet.updateChart(chart);
รีเทิร์น
EmbeddedChartBuilder
— เครื่องมือสร้างแผนภูมิที่ฝัง