Class Slicer

Slicer

แสดงตัวควบคุมตัวกรอง ซึ่งใช้เพื่อกรองช่วง แผนภูมิ และตาราง Pivot ในลักษณะที่ไม่ใช่การทำงานร่วมกัน คลาสนี้มีวิธีเข้าถึงและแก้ไขตัวแบ่งส่วนที่มีอยู่ หากต้องการสร้างตัวแบ่งส่วนข้อมูลใหม่ ให้ใช้ Sheet.insertSlicer(range, anchorRowPos, anchorColPos)

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
getBackgroundColorObject()	Color	เปลี่ยนพื้นหลัง Color ของตัวแบ่งส่วน
getColumnPosition()	Integer	แสดงผลตําแหน่งคอลัมน์ (สัมพันธ์กับช่วงข้อมูลของตัวแบ่งข้อมูล) ที่มีการใช้ตัวกรองในตัวแบ่งข้อมูล หรือ null หากไม่ได้ตั้งค่าตําแหน่งคอลัมน์
getContainerInfo()	ContainerInfo	รับข้อมูลเกี่ยวกับตําแหน่งของเครื่องมือแบ่งข้อมูลในชีต
getFilterCriteria()	FilterCriteria	แสดงผลเกณฑ์ตัวกรองของตัวแบ่งส่วน หรือ null หากไม่ได้ตั้งค่าเกณฑ์ตัวกรอง
getRange()	Range	รับช่วงข้อมูลที่จะใช้ตัวควบคุมตัวกรอง
getTitle()	String	แสดงผลชื่อของส่วนแบ่งข้อมูล
getTitleHorizontalAlignment()	String	รับการจัดแนวนอนของชื่อ
getTitleTextStyle()	TextStyle	แสดงผลรูปแบบข้อความของชื่อส่วนแบ่งข้อมูล
isAppliedToPivotTables()	Boolean	แสดงผลว่ามีส่วนหัวย่อยที่ระบุในตาราง Pivot หรือไม่
remove()	void	ลบตัวควบคุมตัวกรอง
setApplyToPivotTables(applyToPivotTables)	Slicer	ตั้งค่าว่าควรใช้ตัวควบคุมตัวกรองที่ระบุกับตาราง Pivot ในเวิร์กชีตหรือไม่
setBackgroundColor(color)	Slicer	ตั้งค่าสีพื้นหลังของตัวแบ่ง
setBackgroundColorObject(color)	Slicer	ตั้งค่าColorพื้นหลังของตัวแบ่ง
setColumnFilterCriteria(columnPosition, filterCriteria)	Slicer	ตั้งค่าดัชนีคอลัมน์และเกณฑ์การกรองของตัวแบ่งส่วน
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)	Slicer	ตั้งค่าตําแหน่งที่ตัวแบ่งข้อมูลจะปรากฏในชีต
setRange(rangeApi)	Slicer	กำหนดช่วงข้อมูลที่จะใช้ตัวแบ่งข้อมูล
setTitle(title)	Slicer	ตั้งชื่อตัวแบ่งส่วน
setTitleHorizontalAlignment(horizontalAlignment)	Slicer	ตั้งค่าการจัดแนวแนวนอนของชื่อในเครื่องมือแบ่งส่วน
setTitleTextStyle(textStyle)	Slicer	ตั้งค่ารูปแบบข้อความของตัวแบ่งส่วน

วิธีการที่เลิกใช้งาน

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
getBackgroundColor()	String	แสดงสีพื้นหลังของตัวแบ่งส่วนในเครื่องหมาย CSS (เช่น #ffffff)

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

getBackgroundColorObject()

เปลี่ยนพื้นหลัง Color ของตัวแบ่งส่วน

รีเทิร์น

Color — สีพื้นหลังของตัวแบ่งส่วนนี้ แสดงผล null หากไม่ได้ตั้งค่าสี

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getColumnPosition()

แสดงผลตําแหน่งคอลัมน์ (สัมพันธ์กับช่วงข้อมูลของตัวแบ่งข้อมูล) ที่มีการใช้ตัวกรองในตัวแบ่งข้อมูล หรือ null หากไม่ได้ตั้งค่าตําแหน่งคอลัมน์ ซึ่งควรเป็นตําแหน่ง 1-indexed ของคอลัมน์ที่คล้ายกับตัวกรอง

รีเทิร์น

Integer — ตําแหน่งคอลัมน์ของตัวแบ่งส่วนข้อมูลนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getContainerInfo()

รับข้อมูลเกี่ยวกับตําแหน่งของเครื่องมือแบ่งข้อมูลในชีต

รีเทิร์น

ContainerInfo — ออบเจ็กต์ที่มีตำแหน่งคอนเทนเนอร์ของตัวแบ่งส่วน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getFilterCriteria()

แสดงผลเกณฑ์ตัวกรองของตัวแบ่งส่วน หรือ null หากไม่ได้ตั้งค่าเกณฑ์ตัวกรอง

รีเทิร์น

FilterCriteria — เกณฑ์ตัวกรองของส่วนข้อมูลนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getRange()

รับช่วงข้อมูลที่จะใช้ตัวควบคุมตัวกรอง

รีเทิร์น

Range — ช่วงของตัวควบคุมตัวกรอง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getTitle()

แสดงผลชื่อของส่วนแบ่งข้อมูล

รีเทิร์น

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

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getTitleHorizontalAlignment()

รับการจัดแนวนอนของชื่อ

รีเทิร์น

String — การจัดแนวนอนของชื่อตัวแบ่งส่วนนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getTitleTextStyle()

แสดงผลรูปแบบข้อความของชื่อส่วนแบ่งข้อมูล

รีเทิร์น

TextStyle — รูปแบบข้อความของชื่อส่วนข้อมูลนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

isAppliedToPivotTables()

แสดงผลว่ามีส่วนหัวย่อยที่ระบุในตาราง Pivot หรือไม่

รีเทิร์น

Boolean — true หากใช้ตัวแบ่งส่วนข้อมูลนี้กับตาราง Pivot หรือ false หากไม่ได้ใช้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

remove()

ลบตัวควบคุมตัวกรอง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setApplyToPivotTables(applyToPivotTables)

ตั้งค่าว่าควรใช้ตัวควบคุมตัวกรองที่ระบุกับตาราง Pivot ในเวิร์กชีตหรือไม่

พารามิเตอร์

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

รีเทิร์น

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

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setBackgroundColor(color)

ตั้งค่าสีพื้นหลังของตัวแบ่ง ค่า null จะรีเซ็ตสีพื้นหลัง

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
color	String	สีพื้นหลังใหม่ของตัวแบ่งส่วนนี้ในรูปแบบ CSS (เช่น #ffffff)

รีเทิร์น

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

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setBackgroundColorObject(color)

ตั้งค่าColorพื้นหลังของตัวแบ่ง ค่า null จะรีเซ็ตสีพื้นหลัง

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
color	Color	สีพื้นหลังใหม่ของตัวแบ่งส่วนนี้

รีเทิร์น

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

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setColumnFilterCriteria(columnPosition, filterCriteria)

ตั้งค่าดัชนีคอลัมน์และเกณฑ์การกรองของตัวแบ่งส่วน ค่า null จะรีเซ็ตตัวกรองส่วนตัด

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
columnPosition	Integer	ตำแหน่งคอลัมน์ใหม่ของตัวแบ่งส่วนนี้
filterCriteria	FilterCriteria	เกณฑ์การกรองใหม่ของตัวแบ่งส่วนนี้

รีเทิร์น

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

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

ตั้งค่าตําแหน่งที่ตัวแบ่งข้อมูลจะปรากฏในชีต ดัชนีตำแหน่งแถวและคอลัมน์ของจุดยึดจะเริ่มต้นที่ 1

พารามิเตอร์

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

รีเทิร์น

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

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setRange(rangeApi)

กำหนดช่วงข้อมูลที่จะใช้ตัวแบ่งข้อมูล

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
rangeApi	Range	ช่วงใหม่สำหรับตัวแบ่งส่วนนี้

รีเทิร์น

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

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setTitle(title)

ตั้งชื่อตัวแบ่งส่วน ชื่อที่ว่างเปล่าจะรีเซ็ตชื่อเป็นค่าเริ่มต้น

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
title	String	ชื่อใหม่ของส่วนข้อมูลนี้

รีเทิร์น

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

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setTitleHorizontalAlignment(horizontalAlignment)

ตั้งค่าการจัดแนวแนวนอนของชื่อในเครื่องมือแบ่งส่วน ค่า null จะรีเซ็ตการจัดแนว

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
horizontalAlignment	String	การจัดแนวนอนใหม่ของชื่อเครื่องมือแบ่งส่วนนี้

รีเทิร์น

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

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setTitleTextStyle(textStyle)

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
textStyle	TextStyle	สไตล์ข้อความใหม่ของชื่อเครื่องมือแบ่งส่วน

รีเทิร์น

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

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

วิธีการที่เลิกใช้งาน

getBackgroundColor()

เลิกใช้งานแล้ว แทนที่โดย getBackgroundColorObject()

แสดงสีพื้นหลังของตัวแบ่งส่วนในเครื่องหมาย CSS (เช่น #ffffff)

รีเทิร์น

String — สีพื้นหลังของตัวแบ่งส่วนนี้ แสดงผล null หากไม่ได้ตั้งค่าสี

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets