Class Slicer

เครื่องมือแบ่งส่วน

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

เมธอด

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

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

getBackgroundColorObject()

ส่งคืนพื้นหลัง Color ของเครื่องมือแบ่งส่วน

รีเทิร์น

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

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

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

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

getColumnPosition()

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

รีเทิร์น

Integer|null — ตำแหน่งคอลัมน์ของ Slicer นี้

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

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

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

getContainerInfo()

รับข้อมูลเกี่ยวกับตำแหน่งของ Slicer ในชีต

รีเทิร์น

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

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

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

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

getFilterCriteria()

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

รีเทิร์น

FilterCriteria|null — เกณฑ์ตัวกรองของ Slicer นี้

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

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

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

getRange()

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

รีเทิร์น

Range — ช่วงของ Slicer

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

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

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

getTitle()

แสดงผลชื่อของ Slicer

รีเทิร์น

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 — รูปแบบข้อความของชื่อของ Slicer นี้

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

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

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

isAppliedToPivotTables()

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

รีเทิร์น

Booleantrue หากใช้ Slicer นี้กับตาราง 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ระบุว่าควรใช้ Slicer นี้กับตาราง Pivot หรือไม่

รีเทิร์น

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

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

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

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

setBackgroundColor(color)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setBackgroundColorObject(color)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setColumnFilterCriteria(columnPosition, filterCriteria)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setRange(rangeApi)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setTitle(title)

ตั้งชื่อ Slicer การปล่อยชื่อว่างไว้จะรีเซ็ตชื่อเป็นค่าเริ่มต้น

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setTitleHorizontalAlignment(horizontalAlignment)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setTitleTextStyle(textStyle)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

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