Class EmbeddedChart

EmbeddedChart

แสดงแผนภูมิที่ฝังอยู่ในสเปรดชีต

ตัวอย่างนี้แสดงวิธีแก้ไขแผนภูมิที่มีอยู่ 

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คำอธิบาย
contentTypeStringประเภท MIME ที่จะแปลงเป็น สำหรับ Blob ส่วนใหญ่ 'application/pdf' เป็นตัวเลือกเดียวที่ใช้ได้ สำหรับรูปภาพในรูปแบบ BMP, GIF, JPEG หรือ PNG คุณสามารถใช้ 'image/bmp', 'image/gif', 'image/jpeg' หรือ 'image/png' ได้เช่นกัน

รีเทิร์น

Blob — ข้อมูลในรูปแบบ BLOB

getBlob()

แสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น Blob

รีเทิร์น

Blob — ข้อมูลในรูปแบบ BLOB

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 — เครื่องมือสร้างแผนภูมิที่ฝัง