Class 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 รายการที่จัดทำดัชนีของคอลัมน์ที่คล้ายกับตัวกรอง

รีเทิร์น

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
applyToPivotTablesBooleanระบุว่าควรใช้ตัวควบคุมตัวกรองนี้กับตาราง Pivot หรือไม่

รีเทิร์น

Slicer — ตัวควบคุมตัวกรองนี้สำหรับการทำเชน

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

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

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

setBackgroundColor(color)

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

พารามิเตอร์

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

รีเทิร์น

Slicer — ตัวควบคุมตัวกรองนี้สำหรับการทำเชน

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

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

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

setBackgroundColorObject(color)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
colorColorสีพื้นหลังใหม่ของตัวควบคุมตัวกรองนี้

รีเทิร์น

Slicer — ตัวควบคุมตัวกรองนี้สำหรับการทำเชน

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

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

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

setColumnFilterCriteria(columnPosition, filterCriteria)

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

พารามิเตอร์

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

รีเทิร์น

Slicer — ตัวควบคุมตัวกรองนี้สำหรับการทำเชน

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

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

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

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

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

พารามิเตอร์

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

รีเทิร์น

Slicer — ตัวควบคุมตัวกรองนี้สำหรับการทำเชน

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

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

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

setRange(rangeApi)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
rangeApiRangeช่วงใหม่สำหรับตัวควบคุมตัวกรองนี้

รีเทิร์น

Slicer — ตัวควบคุมตัวกรองนี้สำหรับการทำเชน

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

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

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

setTitle(title)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
titleStringชื่อใหม่ของตัวควบคุมตัวกรองนี้

รีเทิร์น

Slicer — ตัวควบคุมตัวกรองนี้สำหรับการทำเชน

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

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

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

setTitleHorizontalAlignment(horizontalAlignment)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
horizontalAlignmentStringการจัดข้อความแนวนอนใหม่ของชื่อตัวควบคุมตัวกรองนี้

รีเทิร์น

Slicer — ตัวควบคุมตัวกรองนี้สำหรับการทำเชน

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

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

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

setTitleTextStyle(textStyle)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
textStyleTextStyleรูปแบบข้อความใหม่ของชื่อตัวควบคุมตัวกรอง

รีเทิร์น

Slicer — ตัวควบคุมตัวกรองนี้สำหรับการทำเชน

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

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

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

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