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ตั้งค่ารูปแบบข้อความของตัวแบ่งส่วน

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

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 ในเวิร์กชีตหรือไม่

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setBackgroundColor(color)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setBackgroundColorObject(color)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setColumnFilterCriteria(columnPosition, filterCriteria)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setRange(rangeApi)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setTitle(title)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setTitleHorizontalAlignment(horizontalAlignment)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setTitleTextStyle(textStyle)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

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