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

Class EmbeddedColumnChartBuilder

ตัวสร้างแผนภูมิคอลัมน์ ดูรายละเอียดเพิ่มเติมได้ที่ เอกสารประกอบของ 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`	ตั้งค่าประเภทแผนภูมิเป็น LineChart และแสดงผล `EmbeddedLineChartBuilder`
`asPieChart()`	`EmbeddedPieChartBuilder`	ตั้งค่าประเภทแผนภูมิเป็น PieChart และแสดงผล `EmbeddedPieChartBuilder`
`asScatterChart()`	`EmbeddedScatterChartBuilder`	ตั้งค่าประเภทแผนภูมิเป็น ScatterChart และแสดงผล `EmbeddedScatterChartBuilder`
`asTableChart()`	`EmbeddedTableChartBuilder`	ตั้งค่าประเภทแผนภูมิเป็น TableChart และแสดงผล `EmbeddedTableChartBuilder`
`build()`	`EmbeddedChart`	สร้างแผนภูมิเพื่อแสดงการเปลี่ยนแปลงทั้งหมดที่ทำกับแผนภูมิ
`clearRanges()`	`EmbeddedChartBuilder`	นําช่วงทั้งหมดออกจากแผนภูมิที่เครื่องมือสร้างนี้แก้ไข
`getChartType()`	`ChartType`	แสดงผลประเภทแผนภูมิปัจจุบัน
`getContainer()`	`ContainerInfo`	แสดงแผนภูมิ `ContainerInfo` ซึ่งจะรวมตำแหน่งที่แผนภูมิปรากฏในชีต
`getRanges()`	`Range[]`	แสดงสําเนารายการช่วงที่กำลังให้ข้อมูลสําหรับแผนภูมินี้
`removeRange(range)`	`EmbeddedChartBuilder`	นําช่วงที่ระบุออกจากแผนภูมิที่เครื่องมือสร้างนี้แก้ไข
`reverseCategories()`	`EmbeddedColumnChartBuilder`	กลับการวาดชุดค่าในแกนดอมเมน
`setBackgroundColor(cssValue)`	`EmbeddedColumnChartBuilder`	กำหนดสีพื้นหลังให้กับแผนภูมิ
`setChartType(type)`	`EmbeddedChartBuilder`	เปลี่ยนประเภทแผนภูมิ
`setColors(cssValues)`	`EmbeddedColumnChartBuilder`	กำหนดสีของเส้นในแผนภูมิ
`setHiddenDimensionStrategy(strategy)`	`EmbeddedChartBuilder`	ตั้งค่ากลยุทธ์ที่จะใช้กับแถวและคอลัมน์ที่ซ่อนอยู่
`setLegendPosition(position)`	`EmbeddedColumnChartBuilder`	กำหนดตำแหน่งของคำอธิบายประกอบตามแผนภูมิ
`setLegendTextStyle(textStyle)`	`EmbeddedColumnChartBuilder`	ตั้งค่ารูปแบบข้อความของคำอธิบายแผนภูมิ
`setMergeStrategy(mergeStrategy)`	`EmbeddedChartBuilder`	ตั้งค่ากลยุทธ์การผสานที่จะใช้เมื่อมีช่วงมากกว่า 1 ช่วง
`setNumHeaders(headers)`	`EmbeddedChartBuilder`	กำหนดจำนวนแถวหรือคอลัมน์ของช่วงที่ควรถือว่าเป็นส่วนหัว
`setOption(option, value)`	`EmbeddedChartBuilder`	ตั้งค่าตัวเลือกขั้นสูงสําหรับแผนภูมินี้
`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`	`EmbeddedChartBuilder`	ตั้งค่าตําแหน่ง ซึ่งจะเปลี่ยนตําแหน่งที่แผนภูมิจะปรากฏในชีต
`setRange(start, end)`	`EmbeddedColumnChartBuilder`	กําหนดช่วงของแผนภูมิ
`setStacked()`	`EmbeddedColumnChartBuilder`	ใช้เส้นที่ซ้อนกัน ซึ่งหมายความว่าค่าเส้นและแถบจะซ้อนกัน (สะสม)
`setTitle(chartTitle)`	`EmbeddedColumnChartBuilder`	ตั้งชื่อแผนภูมิ
`setTitleTextStyle(textStyle)`	`EmbeddedColumnChartBuilder`	กำหนดรูปแบบข้อความของชื่อแผนภูมิ
`setTransposeRowsAndColumns(transpose)`	`EmbeddedChartBuilder`	กำหนดว่าจะสลับแถวและคอลัมน์ของแผนภูมิหรือไม่
`setXAxisTextStyle(textStyle)`	`EmbeddedColumnChartBuilder`	ตั้งค่ารูปแบบข้อความของแกนแนวนอน
`setXAxisTitle(title)`	`EmbeddedColumnChartBuilder`	เพิ่มชื่อให้กับแกนแนวนอน
`setXAxisTitleTextStyle(textStyle)`	`EmbeddedColumnChartBuilder`	ตั้งค่ารูปแบบข้อความชื่อแกนแนวนอน
`setYAxisTextStyle(textStyle)`	`EmbeddedColumnChartBuilder`	ตั้งค่ารูปแบบข้อความแกนแนวตั้ง
`setYAxisTitle(title)`	`EmbeddedColumnChartBuilder`	เพิ่มชื่อให้กับแกนแนวตั้ง
`setYAxisTitleTextStyle(textStyle)`	`EmbeddedColumnChartBuilder`	ตั้งค่ารูปแบบข้อความชื่อแกนแนวตั้ง
`useLogScale()`	`EmbeddedColumnChartBuilder`	ทําให้แกนช่วงเป็นมาตราส่วนเชิงลําดับเลข (ค่าทั้งหมดต้องเป็นค่าบวก)

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

`addRange(range)`

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

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

sheet.insertChart(chart);

พารามิเตอร์

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

รีเทิร์น

EmbeddedChartBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

`asAreaChart()`

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

รีเทิร์น

EmbeddedAreaChartBuilder — ตัวสร้างแผนภูมิพื้นที่

`asBarChart()`

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

รีเทิร์น

EmbeddedBarChartBuilder — ตัวสร้างแผนภูมิแท่ง

`asColumnChart()`

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

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างแผนภูมิคอลัมน์

`asComboChart()`

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

รีเทิร์น

EmbeddedComboChartBuilder — ตัวสร้างแผนภูมิผสม

`asHistogramChart()`

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

รีเทิร์น

EmbeddedHistogramChartBuilder — ตัวสร้างแผนภูมิฮิสโตแกรม

`asLineChart()`

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

รีเทิร์น

EmbeddedLineChartBuilder — ตัวสร้างแผนภูมิเส้น

`asPieChart()`

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

รีเทิร์น

EmbeddedPieChartBuilder — ตัวสร้างแผนภูมิวงกลม

`asScatterChart()`

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

รีเทิร์น

EmbeddedScatterChartBuilder — ตัวสร้างแผนภูมิกระจาย

`asTableChart()`

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

รีเทิร์น

EmbeddedTableChartBuilder — ตัวสร้างแผนภูมิตาราง

`build()`

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

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

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

sheet.insertChart(chart);

รีเทิร์น

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

`clearRanges()`

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

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

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

รีเทิร์น

EmbeddedChartBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

`getChartType()`

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

รีเทิร์น

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

`getContainer()`

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

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

const 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()
const containerInfo = chartBuilder.getContainer();

// Logs the values 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) เพื่อแก้ไขรายการนี้

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

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

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

`removeRange(range)`

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

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

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

const firstRange = sheet.getRange('A1:B5');
const secondRange = sheet.getRange('A6:B8');

const 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'));

const chart = chartBuilder.build();

sheet.insertChart(chart);

พารามิเตอร์

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

รีเทิร์น

EmbeddedChartBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

`reverseCategories()`

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

// Creates a pie chart builder and sets drawing of the slices in a
// counter-clockwise manner.
const builder = Charts.newPieChart();
builder.reverseCategories();

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม

`setBackgroundColor(cssValue)`

กำหนดสีพื้นหลังให้กับแผนภูมิ

// Creates a line chart builder and sets the background color to gray
const builder = Charts.newLineChart();
builder.setBackgroundColor('gray');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`cssValue`	`String`	ค่า CSS สำหรับสี (เช่น `"blue"` หรือ `"#00f"`)

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม

`setChartType(type)`

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

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

sheet.insertChart(chart);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`type`	`ChartType`	ประเภทที่จะเปลี่ยนแผนภูมินี้

รีเทิร์น

EmbeddedChartBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

`setColors(cssValues)`

กำหนดสีของเส้นในแผนภูมิ

// Creates a line chart builder and sets the first two lines to be drawn in
// green and red, respectively.
const builder = Charts.newLineChart();
builder.setColors(['green', 'red']);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`cssValues`	`String[]`	อาร์เรย์ของค่า CSS สี เช่น `["red", "#acf"]` องค์ประกอบที่ n ในอาร์เรย์แสดงสีของเส้นที่ n ในแผนภูมิ

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม

`setHiddenDimensionStrategy(strategy)`

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

sheet.insertChart(chart);

พารามิเตอร์

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

รีเทิร์น

EmbeddedChartBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

`setLegendPosition(position)`

กำหนดตำแหน่งของคำอธิบายประกอบตามแผนภูมิ โดยค่าเริ่มต้นจะไม่มีคำอธิบาย

// Creates a line chart builder and sets the legend position to right.
const builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`position`	`Position`	ตําแหน่งของคําอธิบาย

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม

`setLegendTextStyle(textStyle)`

ตั้งค่ารูปแบบข้อความของคำอธิบายแผนภูมิ

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
const textStyleBuilder =
    Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
const style = textStyleBuilder.build();
const builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`textStyle`	`TextStyle`	รูปแบบข้อความที่จะใช้สำหรับคำอธิบายแผนภูมิ

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม

`setMergeStrategy(mergeStrategy)`

ตั้งค่ากลยุทธ์การผสานที่จะใช้เมื่อมีช่วงมากกว่า 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('C:C10');
const 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);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`mergeStrategy`	`ChartMergeStrategy`	กลยุทธ์การผสานที่จะใช้

รีเทิร์น

EmbeddedChartBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

`setNumHeaders(headers)`

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

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

sheet.insertChart(chart);

พารามิเตอร์

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

รีเทิร์น

EmbeddedChartBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

`setOption(option, value)`

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

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

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

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const sheet = spreadsheet.getSheets()[0];
const chart = sheet.newChart()
 .setOption('title', 'Earnings projections')
 .setOption('legend', {
   position: 'top',
   textStyle: { color: 'blue', fontSize: 16 },
 }).build();

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`option`	`String`	ชื่อของตัวเลือก
`value`	`Object`	ค่าของตัวเลือก

รีเทิร์น

EmbeddedChartBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`

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

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

sheet.insertChart(chart);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`anchorRowPos`	`Integer`	ด้านบนของแผนภูมิจะยึดอยู่ในแถวนี้
`anchorColPos`	`Integer`	ทางด้านซ้ายของแผนภูมิจะยึดอยู่ในคอลัมน์นี้
`offsetX`	`Integer`	มุมขวาบนของแผนภูมิจะเลื่อนออกไปจากจุดนี้หลายพิกเซล
`offsetY`	`Integer`	มุมซ้ายล่างของแผนภูมิจะเลื่อนออกไปจากจุดนี้หลายพิกเซล

รีเทิร์น

EmbeddedChartBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

`setRange(start, end)`

กําหนดช่วงของแผนภูมิ

หากจุดข้อมูลใดไม่อยู่ในช่วง ระบบจะขยายช่วงให้รวมจุดข้อมูลเหล่านั้น

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`start`	`Number`	ค่าของเส้นตารางต่ำสุดบนแกนแนวนอน
`end`	`Number`	ค่าของเส้นตารางที่สูงที่สุดบนแกนช่วง

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม

`setStacked()`

ใช้เส้นที่ซ้อนกัน ซึ่งหมายความว่าค่าเส้นและแถบจะซ้อนกัน (สะสม) โดยค่าเริ่มต้น ระบบจะไม่ซ้อน

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม

`setTitle(chartTitle)`

ตั้งชื่อแผนภูมิ ชื่อจะแสดงอยู่ตรงกลางเหนือแผนภูมิ

// Creates a line chart builder and title to 'My Line Chart'.
const builder = Charts.newLineChart();
builder.setTitle('My Line Chart');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`chartTitle`	`String`	ชื่อแผนภูมิ

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม

`setTitleTextStyle(textStyle)`

กำหนดรูปแบบข้อความของชื่อแผนภูมิ

// Creates a line chart builder and sets it up for a  blue, 26-point title.
const textStyleBuilder =
    Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
const style = textStyleBuilder.build();
const builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`textStyle`	`TextStyle`	รูปแบบข้อความที่จะใช้สำหรับชื่อแผนภูมิ คุณสร้างออบเจ็กต์ `TextStyleBuilder` ได้โดยเรียกใช้ `Charts.newTextStyle()`

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม

`setTransposeRowsAndColumns(transpose)`

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

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

sheet.insertChart(chart);

พารามิเตอร์

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

รีเทิร์น

EmbeddedChartBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

`setXAxisTextStyle(textStyle)`

ตั้งค่ารูปแบบข้อความของแกนแนวนอน

// Creates a line chart builder and sets the X-axis text style to blue, 18-point
// font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`textStyle`	`TextStyle`	รูปแบบข้อความที่จะใช้กับชื่อแกนนอน คุณสร้างออบเจ็กต์ `TextStyleBuilder` ได้โดยเรียกใช้ `Charts.newTextStyle()`

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม

`setXAxisTitle(title)`

เพิ่มชื่อให้กับแกนแนวนอน ชื่อจะอยู่ตรงกลางและปรากฏใต้ป้ายกำกับค่าแกน

// Creates a line chart builder and sets the X-axis title.
const builder = Charts.newLineChart();
builder.setTitle('X-axis Title');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`title`	`String`	ชื่อแกน X

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม

`setXAxisTitleTextStyle(textStyle)`

ตั้งค่ารูปแบบข้อความชื่อแกนแนวนอน

// Creates a line chart builder and sets the X-axis title text style to blue,
// 18-point font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`textStyle`	`TextStyle`	รูปแบบข้อความที่จะใช้กับชื่อแกนนอน คุณสร้างออบเจ็กต์ `TextStyleBuilder` ได้โดยเรียกใช้ `Charts.newTextStyle()`

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม

`setYAxisTextStyle(textStyle)`

ตั้งค่ารูปแบบข้อความแกนแนวตั้ง

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point
// font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`textStyle`	`TextStyle`	รูปแบบข้อความที่จะใช้กับชื่อแกนนอน คุณสร้างออบเจ็กต์ `TextStyleBuilder` ได้โดยเรียกใช้ `Charts.newTextStyle()`

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม

`setYAxisTitle(title)`

เพิ่มชื่อให้กับแกนแนวตั้ง ชื่อจะอยู่กึ่งกลางและปรากฏทางด้านซ้ายของป้ายกำกับค่า

// Creates a line chart builder and sets the Y-axis title.
const builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`title`	`String`	ชื่อแกน Y

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม

`setYAxisTitleTextStyle(textStyle)`

ตั้งค่ารูปแบบข้อความชื่อแกนแนวตั้ง

// Creates a line chart builder and sets the Y-axis title text style to blue,
// 18-point font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`textStyle`	`TextStyle`	รูปแบบข้อความที่จะใช้กับชื่อแกนนอน คุณสร้างออบเจ็กต์ `TextStyleBuilder` ได้โดยเรียกใช้ `Charts.newTextStyle()`

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม

`useLogScale()`

ทําให้แกนช่วงเป็นมาตราส่วนเชิงลําดับเลข (ค่าทั้งหมดต้องเป็นค่าบวก) แกนช่วงคือแกนแนวตั้งสําหรับแผนภูมิแนวตั้ง (เช่น เส้น พื้นที่ หรือคอลัมน์) และแกนแนวนอนสําหรับแผนภูมิแนวนอน (เช่น แท่ง)

รีเทิร์น

EmbeddedColumnChartBuilder — ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม