Class 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 ที่สร้างใหม่อาจมีโควต้าที่ตายตัวเป็นการชั่วคราว

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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 — เครื่องมือสร้างแผนภูมิแบบฝัง