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

Class EmbeddedChart

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

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A2:B8');
let 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) {
  const sheet = SpreadsheetApp.getActiveSheet();
  const 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'` ก็ได้ สำหรับเอกสาร Google เอกสาร จะใช้ `'text/markdown'` ก็ได้เช่นกัน

รีเทิร์น

Blob — ข้อมูลเป็น Blob

`getBlob()`

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

รีเทิร์น

Blob — ข้อมูลเป็น Blob

`getChartId()`

แสดงผลตัวระบุที่แน่นอนสำหรับแผนภูมิที่ไม่ซ้ำกันในสเปรดชีตที่มีแผนภูมินั้น หรือ null หากแผนภูมิไม่ได้อยู่ในสเปรดชีต

รีเทิร์น

Integer — ตัวระบุแผนภูมิแบบคงที่

`getContainerInfo()`

แสดงข้อมูลเกี่ยวกับตําแหน่งแผนภูมิในชีต

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(sheet.getRange('A1:B8'))
                  .setPosition(5, 5, 0, 0)
                  .build();

const 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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const 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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B10');
const range2 = sheet.getRange('C1:C10');
const 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()`

แสดงผลจํานวนแถวหรือคอลัมน์ของช่วงที่ถือว่าเป็นส่วนหัว

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const 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()`

แสดงผลช่วงวันที่ที่แผนภูมินี้ใช้เป็นแหล่งข้อมูล

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(sheet.getRange('A1:B8'))
                  .setPosition(5, 5, 0, 0)
                  .build();

const ranges = chart.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (const i in ranges) {
  const range = ranges[i];
  Logger.log(range.getA1Notation());
}

รีเทิร์น

Range[] — อาร์เรย์ของช่วงที่ใช้เป็นแหล่งข้อมูลของแผนภูมินี้

`getTransposeRowsAndColumns()`

หากเป็น true ระบบจะสลับแถวและคอลัมน์ที่ใช้ในการสร้างแผนภูมิ ค่าเริ่มต้นคือ false

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const 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) เพื่อบันทึกการเปลี่ยนแปลง

const sheet = SpreadsheetApp.getActiveSheet();
let chart = sheet.getCharts()[0];
chart = chart.modify()
            .setOption('width', 800)
            .setOption('height', 640)
            .setPosition(5, 5, 0, 0)
            .build();
sheet.updateChart(chart);

รีเทิร์น

EmbeddedChartBuilder — ตัวสร้างสำหรับสร้างแผนภูมิที่ฝัง