หน้านี้ได้รับการแปลโดย Cloud Translation API

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 ที่สร้างใหม่อาจมีข้อกำหนดที่เข้มงวดขึ้นชั่วคราว โควต้า

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`contentType`	`String`	ประเภท MIME ที่จะแปลง สำหรับ BLOB ส่วนใหญ่ `'application/pdf'` คือ เป็นตัวเลือกเดียวที่ใช้ได้ สำหรับรูปภาพในรูปแบบ BMP, GIF, JPEG หรือ PNG ระบบจะใช้ `'image/bmp'`, `'image/gif'`, `'image/jpeg'` หรือ `'image/png'` ด้วย ใช้ได้ ใช้ `'text/markdown'` สำหรับเอกสารของ Google เอกสารได้ด้วย

รีเทิร์น

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