Class EmbeddedTableChartBuilder

EmbeddedTableChartBuilder

เครื่องมือสร้างสำหรับแผนภูมิตาราง ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Gviz

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
addRange(range)EmbeddedChartBuilderเพิ่มช่วงในแผนภูมิที่เครื่องมือสร้างนี้แก้ไข
asAreaChart()EmbeddedAreaChartBuilderตั้งค่าประเภทแผนภูมิเป็น AreaChart และแสดง EmbeddedAreaChartBuilder
asBarChart()EmbeddedBarChartBuilderตั้งค่าประเภทแผนภูมิเป็น BarChart และแสดง EmbeddedBarChartBuilder
asColumnChart()EmbeddedColumnChartBuilderตั้งค่าประเภทแผนภูมิเป็น ColumnChart และแสดง EmbeddedColumnChartBuilder
asComboChart()EmbeddedComboChartBuilderตั้งค่าประเภทแผนภูมิเป็น ComboChart และแสดง EmbeddedComboChartBuilder
asHistogramChart()EmbeddedHistogramChartBuilderตั้งค่าประเภทแผนภูมิเป็น HistogramChart และแสดง EmbeddedHistogramChartBuilder
asLineChart()EmbeddedLineChartBuilderตั้งค่าประเภทแผนภูมิเป็นแผนภูมิเส้นและแสดงผล EmbeddedLineChartBuilder
asPieChart()EmbeddedPieChartBuilderตั้งค่าประเภทแผนภูมิเป็น PieChart และแสดง EmbeddedPieChartBuilder
asScatterChart()EmbeddedScatterChartBuilderตั้งค่าประเภทแผนภูมิเป็น ScatterChart และแสดงผล EmbeddedScatterChartBuilder
asTableChart()EmbeddedTableChartBuilderตั้งค่าประเภทแผนภูมิเป็น TableChart และแสดง EmbeddedTableChartBuilder
build()EmbeddedChartสร้างแผนภูมิเพื่อแสดงการเปลี่ยนแปลงทั้งหมดที่ทำ
clearRanges()EmbeddedChartBuilderนำช่วงทั้งหมดออกจากแผนภูมิที่เครื่องมือสร้างนี้แก้ไข
enablePaging(enablePaging)EmbeddedTableChartBuilderตั้งค่าว่าจะเปิดใช้การสลับหน้าของข้อมูลหรือไม่
enablePaging(pageSize)EmbeddedTableChartBuilderเปิดใช้การแบ่งหน้าและกำหนดจำนวนแถวในแต่ละหน้า
enablePaging(pageSize, startPage)EmbeddedTableChartBuilderเปิดใช้งานการแบ่งหน้า ตั้งค่าจำนวนแถวในแต่ละหน้าและหน้าแรกในตารางที่จะแสดง (หน้า ตัวเลขจะเป็นศูนย์)
enableRtlTable(rtlEnabled)EmbeddedTableChartBuilderเพิ่มการสนับสนุนพื้นฐานสำหรับภาษาที่เขียนจากขวาไปซ้าย (เช่น อาหรับหรือฮีบรู) โดยกลับภาษา ลำดับคอลัมน์ของตาราง เพื่อให้คอลัมน์ 0 เป็นคอลัมน์ด้านขวาสุด และคอลัมน์สุดท้ายคือ คอลัมน์ซ้ายสุด
enableSorting(enableSorting)EmbeddedTableChartBuilderกำหนดว่าจะจัดเรียงคอลัมน์เมื่อผู้ใช้คลิกส่วนหัวของคอลัมน์หรือไม่
getChartType()ChartTypeแสดงแผนภูมิประเภทปัจจุบัน
getContainer()ContainerInfoแสดงแผนภูมิ ContainerInfo ซึ่งแสดงส่วนที่แผนภูมิปรากฏใน ชีต
getRanges()Range[]แสดงผลสำเนาของรายการช่วงที่ให้ข้อมูลสำหรับแผนภูมินี้ในปัจจุบัน
removeRange(range)EmbeddedChartBuilderนำช่วงที่ระบุออกจากแผนภูมิที่เครื่องมือสร้างนี้แก้ไข
setChartType(type)EmbeddedChartBuilderเปลี่ยนประเภทของแผนภูมิ
setFirstRowNumber(number)EmbeddedTableChartBuilderกำหนดหมายเลขแถวให้แถวแรกในตารางข้อมูล
setHiddenDimensionStrategy(strategy)EmbeddedChartBuilderกำหนดกลยุทธ์ที่จะใช้กับแถวและคอลัมน์ที่ซ่อนอยู่
setInitialSortingAscending(column)EmbeddedTableChartBuilderตั้งค่าดัชนีของคอลัมน์ตามที่ควรจัดเรียงตารางในตอนแรก (จากน้อยไปมาก)
setInitialSortingDescending(column)EmbeddedTableChartBuilderตั้งค่าดัชนีของคอลัมน์ตามที่ควรจัดเรียงตารางในตอนแรก (มากไปน้อย)
setMergeStrategy(mergeStrategy)EmbeddedChartBuilderตั้งค่ากลยุทธ์การรวมเพื่อใช้เมื่อมีมากกว่า 1 ช่วง
setNumHeaders(headers)EmbeddedChartBuilderกำหนดจำนวนแถวหรือคอลัมน์ของช่วงที่ควรถือว่าเป็นส่วนหัว
setOption(option, value)EmbeddedChartBuilderตั้งค่าตัวเลือกขั้นสูงสำหรับแผนภูมินี้
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)EmbeddedChartBuilderกำหนดตำแหน่ง ซึ่งจะเปลี่ยนตําแหน่งที่แผนภูมิจะปรากฏในชีต
setTransposeRowsAndColumns(transpose)EmbeddedChartBuilderตั้งค่าว่าจะสลับตำแหน่งแถวและคอลัมน์ของแผนภูมิหรือไม่
showRowNumberColumn(showRowNumber)EmbeddedTableChartBuilderกำหนดว่าจะแสดงหมายเลขแถวเป็นคอลัมน์แรกของตารางหรือไม่
useAlternatingRowStyle(alternate)EmbeddedTableChartBuilderกำหนดว่ามีการกำหนดรูปแบบสีสลับให้กับแถวเลขคี่และแถวคู่ของแผนภูมิตารางหรือไม่

เอกสารโดยละเอียด

addRange(range)

เพิ่มช่วงในแผนภูมิที่เครื่องมือสร้างนี้แก้ไข ไม่เพิ่มช่วงหากมีอยู่แล้ว เพิ่มลงในแผนภูมิแล้ว

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();

sheet.insertChart(chart);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
rangeRangeช่วงที่จะเพิ่ม

รีเทิร์น

EmbeddedChartBuilder — เครื่องมือสร้างนี้สำหรับการทำสายโซ่


asAreaChart()

ตั้งค่าประเภทแผนภูมิเป็น AreaChart และแสดง EmbeddedAreaChartBuilder

รีเทิร์น

EmbeddedAreaChartBuilder — เครื่องมือสร้างแผนภูมิพื้นที่


asBarChart()

ตั้งค่าประเภทแผนภูมิเป็น BarChart และแสดง EmbeddedBarChartBuilder

รีเทิร์น

EmbeddedBarChartBuilder — เครื่องมือสร้างแผนภูมิแท่ง


asColumnChart()

ตั้งค่าประเภทแผนภูมิเป็น ColumnChart และแสดง EmbeddedColumnChartBuilder

รีเทิร์น

EmbeddedColumnChartBuilder — เครื่องมือสร้างสำหรับแผนภูมิคอลัมน์


asComboChart()

ตั้งค่าประเภทแผนภูมิเป็น ComboChart และแสดง EmbeddedComboChartBuilder

รีเทิร์น

EmbeddedComboChartBuilder — เครื่องมือสร้างแผนภูมิผสม


asHistogramChart()

ตั้งค่าประเภทแผนภูมิเป็น HistogramChart และแสดง EmbeddedHistogramChartBuilder

รีเทิร์น

EmbeddedHistogramChartBuilder — เครื่องมือสร้างแผนภูมิฮิสโตแกรม


asLineChart()

ตั้งค่าประเภทแผนภูมิเป็นแผนภูมิเส้นและแสดงผล EmbeddedLineChartBuilder

รีเทิร์น

EmbeddedLineChartBuilder — เครื่องมือสร้างแผนภูมิเส้น


asPieChart()

ตั้งค่าประเภทแผนภูมิเป็น PieChart และแสดง EmbeddedPieChartBuilder

รีเทิร์น

EmbeddedPieChartBuilder — เครื่องมือสร้างแผนภูมิวงกลม


asScatterChart()

ตั้งค่าประเภทแผนภูมิเป็น ScatterChart และแสดงผล EmbeddedScatterChartBuilder

รีเทิร์น

EmbeddedScatterChartBuilder — เครื่องมือสร้างแผนภูมิกระจาย


asTableChart()

ตั้งค่าประเภทแผนภูมิเป็น TableChart และแสดง EmbeddedTableChartBuilder

รีเทิร์น

EmbeddedTableChartBuilder — เครื่องมือสร้างแผนภูมิตาราง


build()

สร้างแผนภูมิเพื่อแสดงการเปลี่ยนแปลงทั้งหมดที่ทำ

วิธีการนี้จะไม่วาดแผนภูมิที่ด้านบนของสเปรดชีตโดยอัตโนมัติ แผนภูมิใหม่ ต้องแทรกผ่าน sheet.insertChart(chart) และควรอัปเดตแผนภูมิที่มีอยู่ ผ่าน sheet.updateChart(chart)

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)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

รีเทิร์น

EmbeddedChart — แผนภูมิที่สร้างขึ้น ซึ่งต้องเพิ่มลงในสเปรดชีต


clearRanges()

นำช่วงทั้งหมดออกจากแผนภูมิที่เครื่องมือสร้างนี้แก้ไข

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

// This code updates the chart to use only the new ranges while preserving the existing
// formatting of the chart.
var chart = sheet.getCharts()[0];
var newChart = chart
    .modify()
    .clearRanges()
    .addRange(sheet.getRange("A1:A5"))
    .addRange(sheet.getRange("B1:B5"))
    .build();
sheet.updateChart(newChart);

รีเทิร์น

EmbeddedChartBuilder — เครื่องมือสร้างนี้สำหรับการทำสายโซ่


enablePaging(enablePaging)

ตั้งค่าว่าจะเปิดใช้การสลับหน้าของข้อมูลหรือไม่

ลักษณะการทำงานเริ่มต้นคือปิดใช้การแบ่งหน้า หากเปิดใช้การแบ่งหน้า ขนาดหน้าตามค่าเริ่มต้นคือ 10

พารามิเตอร์

ชื่อประเภทคำอธิบาย
enablePagingBooleantrue หากควรเปิดใช้การแบ่งหน้า มิฉะนั้นให้false

รีเทิร์น

EmbeddedTableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


enablePaging(pageSize)

เปิดใช้การแบ่งหน้าและกำหนดจำนวนแถวในแต่ละหน้า

ขนาดหน้าเริ่มต้นคือ 10

// Creates a table chart builder and enables paging with page size of 5.
var builder = Charts.newTableChart();
builder.enablePaging(5);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
pageSizeIntegerจำนวนแถวในแต่ละหน้าของตาราง

รีเทิร์น

EmbeddedTableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


enablePaging(pageSize, startPage)

เปิดใช้งานการแบ่งหน้า ตั้งค่าจำนวนแถวในแต่ละหน้าและหน้าแรกของตารางที่จะแสดง (หน้า ตัวเลขจะเป็นศูนย์)

ขนาดหน้าเริ่มต้นคือ 10 และหน้าเริ่มต้นเริ่มต้นคือ 0

// Creates a table chart builder and enables paging with page size of 5 and displays page 2
// first.
var builder = Charts.newTableChart();
builder.enablePaging(5, 2);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
pageSizeIntegerจำนวนแถวในแต่ละหน้าของตาราง
startPageIntegerหน้าแรกของตารางที่แสดง (หมายเลขหน้าจะมีฐาน 0)

รีเทิร์น

EmbeddedTableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


enableRtlTable(rtlEnabled)

เพิ่มการสนับสนุนพื้นฐานสำหรับภาษาที่เขียนจากขวาไปซ้าย (เช่น อาหรับหรือฮีบรู) โดยกลับภาษา ลำดับคอลัมน์ของตาราง เพื่อให้คอลัมน์ 0 เป็นคอลัมน์ด้านขวาสุด และคอลัมน์สุดท้ายคือ คอลัมน์ซ้ายสุด

โดยจะไม่ส่งผลต่อดัชนีคอลัมน์ในข้อมูลที่สำคัญ แต่ส่งผลเฉพาะกับลำดับของการแสดงผลเท่านั้น การแสดงภาพตารางไม่รองรับการแสดงภาษาแบบ 2 ทิศทาง (BiDi) แบบเต็มรูปแบบ ด้วยตัวเลือกนี้ ระบบจะไม่สนใจตัวเลือกนี้หากคุณเปิดใช้การแบ่งหน้า (โดยใช้ตัวเลือกหน้าเว็บ) หรือหาก ตารางมีแถบเลื่อน เนื่องจากคุณได้ระบุตัวเลือกความสูงและความกว้างน้อยกว่า ขนาดตารางที่กำหนด ลักษณะการทำงานเริ่มต้นคือปิดใช้การรองรับ RTL

พารามิเตอร์

ชื่อประเภทคำอธิบาย
rtlEnabledBooleantrue หากควรเปิดใช้การสนับสนุนข้อความจากขวาไปซ้าย false หรือไม่เช่นนั้น

รีเทิร์น

EmbeddedTableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


enableSorting(enableSorting)

กำหนดว่าจะจัดเรียงคอลัมน์เมื่อผู้ใช้คลิกส่วนหัวของคอลัมน์หรือไม่

หากเปิดใช้การจัดเรียง เมื่อผู้ใช้คลิกส่วนหัวของคอลัมน์ ระบบจะเรียงแถวให้โดยอัตโนมัติ จัดเรียงแล้ว ลักษณะการทำงานเริ่มต้นคือเปิดใช้การจัดเรียง

พารามิเตอร์

ชื่อประเภทคำอธิบาย
enableSortingBooleantrue เพื่อเปิดใช้การจัดเรียงโดยคลิกส่วนหัวของคอลัมน์ หากไม่ใช่ false

รีเทิร์น

EmbeddedTableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


getChartType()

แสดงแผนภูมิประเภทปัจจุบัน

รีเทิร์น

ChartType — ประเภทของแผนภูมิ


getContainer()

แสดงแผนภูมิ ContainerInfo ซึ่งแสดงส่วนที่แผนภูมิปรากฏใน ชีต

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

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0);

// This method returns the exact same data as Chart#getContainerInfo()
var containerInfo = chartBuilder.getContainer();

// 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 — ออบเจ็กต์ที่มีตำแหน่งของคอนเทนเนอร์แผนภูมิ


getRanges()

แสดงผลสำเนาของรายการช่วงที่ให้ข้อมูลสำหรับแผนภูมินี้ในปัจจุบัน ใช้ addRange(range) และ removeRange(range) เพื่อแก้ไขรายการนี้

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

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0);

var ranges = chartBuilder.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[] — อาร์เรย์ของช่วงที่ใช้เป็นแผนภูมิในการสร้างแหล่งข้อมูล


removeRange(range)

นำช่วงที่ระบุออกจากแผนภูมิที่เครื่องมือสร้างนี้แก้ไข ไม่แสดงข้อผิดพลาดหาก ช่วงไม่ได้อยู่ในแผนภูมินี้

ช่วงที่นำออกต้องตรงกับช่วงที่เพิ่มผ่าน addRange(range) มิฉะนั้นจะไม่มีการเปลี่ยนแปลงใดๆ ในแผนภูมิ ใช้วิธีนี้เพื่อนำค่าออกบางส่วนไม่ได้ จากช่วง

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

var firstRange = sheet.getRange("A1:B5");
var secondRange = sheet.getRange("A6:B8");

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(firstRange)
    // This range will render in a different color
    .addRange(secondRange)
    .setPosition(5, 5, 0, 0);

// Note that you can use either of these two formats, but the range
// MUST match up with a range that was added via addRange(), or it
// will not be removed, and will not throw an exception
chartBuilder.removeRange(firstRange);
chartBuilder.removeRange(sheet.getRange("A6:B8"));

var chart = chartBuilder.build();

sheet.insertChart(chart);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
rangeRangeช่วงที่จะนำออก

รีเทิร์น

EmbeddedChartBuilder — เครื่องมือสร้างนี้สำหรับการทำสายโซ่


setChartType(type)

เปลี่ยนประเภทของแผนภูมิ ขณะนี้ระบบยังไม่รองรับแผนภูมิแบบฝังบางประเภท ดูChartType

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)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
typeChartTypeประเภทที่จะใช้เป็นแผนภูมินี้

รีเทิร์น

EmbeddedChartBuilder — เครื่องมือสร้างนี้สำหรับการทำสายโซ่


setFirstRowNumber(number)

กำหนดหมายเลขแถวให้แถวแรกในตารางข้อมูล

หมายเลขแถวเริ่มต้นของแถวแรกคือ 1

// Creates a table chart builder and sets the first row to be 2.
var builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberIntegerหมายเลขแถวสำหรับแถวแรกในตารางข้อมูล

รีเทิร์น

EmbeddedTableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


setHiddenDimensionStrategy(strategy)

กำหนดกลยุทธ์ที่จะใช้กับแถวและคอลัมน์ที่ซ่อนอยู่ ค่าเริ่มต้นคือ 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();

sheet.insertChart(chart);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
strategyChartHiddenDimensionStrategyกลยุทธ์ที่ใช้สำหรับแถวและคอลัมน์ที่ซ่อนอยู่

รีเทิร์น

EmbeddedChartBuilder — เครื่องมือสร้างนี้สำหรับการทำสายโซ่


setInitialSortingAscending(column)

ตั้งค่าดัชนีของคอลัมน์ตามที่ควรจัดเรียงตารางในตอนแรก (จากน้อยไปมาก)

ระบบปฏิบัติการของคอลัมน์จะจัดเรียงจากน้อยไปมากและมีลูกศรขนาดเล็กกำกับอยู่

// Creates a table chart builder and sorts it by the second column (ascending).
var builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnIntegerจำนวนคอลัมน์ตามตารางที่ควรจัดเรียงในตอนแรก

รีเทิร์น

EmbeddedTableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


setInitialSortingDescending(column)

ตั้งค่าดัชนีของคอลัมน์ตามที่ควรจัดเรียงตารางในตอนแรก (มากไปน้อย)

ระบบปฏิบัติการของคอลัมน์จะจัดเรียงตามลำดับจากมากไปหาน้อย และมีลูกศรเล็กๆ กำกับไว้

// Creates a table chart builder and sorts it by the second column (descending).
var builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnIntegerจำนวนคอลัมน์ตามตารางที่ควรจัดเรียงในตอนแรก

รีเทิร์น

EmbeddedTableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


setMergeStrategy(mergeStrategy)

ตั้งค่ากลยุทธ์การรวมเพื่อใช้เมื่อมีมากกว่า 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("C:C10");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .addRange(range2)
    .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
mergeStrategyChartMergeStrategyกลยุทธ์การรวมที่จะใช้

รีเทิร์น

EmbeddedChartBuilder — เครื่องมือสร้างนี้สำหรับการทำสายโซ่


setNumHeaders(headers)

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

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();

sheet.insertChart(chart);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
headersIntegerจำนวนแถวหรือคอลัมน์ที่จะถือเป็นส่วนหัว ส่วนหัวที่มีค่าเป็นลบ ตรวจหาอัตโนมัติ

รีเทิร์น

EmbeddedChartBuilder — เครื่องมือสร้างนี้สำหรับการทำสายโซ่


setOption(option, value)

ตั้งค่าตัวเลือกขั้นสูงสำหรับแผนภูมินี้ โปรดดูรายการตัวเลือกที่มีที่แผนภูมิ ตัวเลือกการกำหนดค่า

วิธีการนี้ไม่ได้ตรวจสอบว่าตัวเลือกที่คุณระบุถูกต้องสำหรับแผนภูมิประเภทนี้ หรือ มีรูปแบบ/โครงสร้างที่ถูกต้อง

ตัวอย่างนี้แสดงวิธีเปลี่ยนชื่อและตั้งค่าคำอธิบาย

builder.setOption('title', 'Earnings projections');
builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});

พารามิเตอร์

ชื่อประเภทคำอธิบาย
optionStringชื่อของตัวเลือก
valueObjectค่าของตัวเลือก

รีเทิร์น

EmbeddedChartBuilder — เครื่องมือสร้างนี้สำหรับการทำสายโซ่


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

กำหนดตำแหน่ง ซึ่งจะเปลี่ยนตําแหน่งที่แผนภูมิจะปรากฏในชีต anchorRowPos และ anchorColPos ได้รับการจัดทำดัชนี 1 ครั้ง

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)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
anchorRowPosIntegerด้านบนของแผนภูมิจะตรึงอยู่ในแถวนี้
anchorColPosIntegerด้านซ้ายของแผนภูมิจะตรึงอยู่กับคอลัมน์นี้
offsetXIntegerมุมขวาบนของแผนภูมิจะชดเชยด้วยจำนวนพิกเซลนี้
offsetYIntegerมุมซ้ายล่างของแผนภูมิจะชดเชยด้วยจำนวนพิกเซลนี้

รีเทิร์น

EmbeddedChartBuilder — เครื่องมือสร้างนี้สำหรับการทำสายโซ่


setTransposeRowsAndColumns(transpose)

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

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)
    .setTransposeRowsAndColumns(true)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

พารามิเตอร์

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

รีเทิร์น

EmbeddedChartBuilder — เครื่องมือสร้างนี้สำหรับการทำสายโซ่


showRowNumberColumn(showRowNumber)

กำหนดว่าจะแสดงหมายเลขแถวเป็นคอลัมน์แรกของตารางหรือไม่

ลักษณะการทำงานเริ่มต้นจะไม่แสดงหมายเลขแถว

พารามิเตอร์

ชื่อประเภทคำอธิบาย
showRowNumberBooleantrue หากคอลัมน์แรกของตารางควรแสดงหมายเลขแถว false หรือไม่เช่นนั้น

รีเทิร์น

EmbeddedTableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่


useAlternatingRowStyle(alternate)

กำหนดว่ามีการกำหนดรูปแบบสีสลับให้กับแถวคู่และแถวคี่ของแผนภูมิตารางหรือไม่

การทำงานเริ่มต้นคือแถวที่มีรูปแบบสลับสี

พารามิเตอร์

ชื่อประเภทคำอธิบาย
alternateBooleantrue หากรูปแบบสีควรสลับกัน หรือfalse

รีเทิร์น

EmbeddedTableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่