Class Filter

กรอง

ใช้คลาสนี้เพื่อแก้ไขตัวกรองที่มีอยู่ในสเปรดชีต Grid ซึ่งเป็นสเปรดชีตประเภทเริ่มต้น ชีตตารางกริดคือชีตปกติที่มีข้อมูลที่ไม่ได้เชื่อมต่อกับฐานข้อมูล

หากยังไม่มีตัวกรองในสเปรดชีต ให้สร้างตัวกรองโดยใช้ Range.createFilter()

หากต้องการใช้คลาสนี้ คุณต้องเข้าถึงตัวกรองชีตตารางกริดก่อนโดยใช้ Range.getFilter() หรือ Sheet.getFilter()

การใช้งานทั่วไป

นำตัวกรองออก

ตัวอย่างด้านล่างจะรับตัวกรองในสเปรดชีตที่ใช้งานอยู่และนำออก 
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Removes the filter from the active sheet.
filter.remove();

รับช่วงที่ใช้ตัวกรอง

ตัวอย่างด้านล่างจะรับตัวกรองในสเปรดชีตที่ใช้งานอยู่ จากนั้นใช้เมธอด getRange() จากคลาสนี้เพื่อบันทึกช่วงที่ใช้ตัวกรอง 
const ss = SpreadsheetApp.getActiveSheet();
// Gets the existing filter on the active sheet.
const filter = ss.getFilter();
// Logs the range that the filter applies to in A1 notation.
console.log(filter.getRange().getA1Notation());

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getColumnFilterCriteria(columnPosition)FilterCriteriaรับเกณฑ์ตัวกรองในคอลัมน์ที่ระบุ หรือ null หากคอลัมน์ไม่มีเกณฑ์ตัวกรอง
getRange()Rangeรับช่วงที่ใช้ตัวกรองนี้
remove()voidนำตัวกรองนี้ออก
removeColumnFilterCriteria(columnPosition)Filterนำเกณฑ์ตัวกรองออกจากคอลัมน์ที่ระบุ
setColumnFilterCriteria(columnPosition, filterCriteria)Filterตั้งค่าเกณฑ์ตัวกรองในคอลัมน์ที่ระบุ
sort(columnPosition, ascending)Filterจัดเรียงช่วงที่กรองตามคอลัมน์ที่ระบุ ยกเว้นแถวแรก (แถวส่วนหัว) ในช่วงที่ใช้ตัวกรองนี้

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

getColumnFilterCriteria(columnPosition)

รับเกณฑ์ตัวกรองในคอลัมน์ที่ระบุ หรือ null หากคอลัมน์ไม่มีเกณฑ์ตัวกรอง

หากต้องการดูรายละเอียดเพิ่มเติมเกี่ยวกับเกณฑ์ตัวกรอง ให้ใช้เมธอดนี้ร่วมกับเมธอดจากคลาส FilterCriteria 

const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Gets the filter criteria applied to column B of the active sheet
// and logs the hidden values.
const filterCriteria = filter.getColumnFilterCriteria(2).getHiddenValues();
console.log(filterCriteria);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnPositionIntegerตำแหน่งที่เริ่มต้นด้วย 1 ของคอลัมน์ เช่น ดัชนีของคอลัมน์ B คือ 2

รีเทิร์น

FilterCriteria — เกณฑ์ตัวกรอง

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

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

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

getRange()

รับช่วงที่ใช้ตัวกรองนี้ 

// Gets the existing filter on the active sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Logs the range that the filter applies to in A1 notation.
console.log(filter.getRange().getA1Notation());

รีเทิร์น

Range — ช่วงของตัวกรอง หากต้องการรับช่วงในรูปแบบ A1 ให้ใช้เมธอดนี้ร่วมกับ Range.getA1Notation()

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

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

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

remove()

นำตัวกรองนี้ออก 

// Removes the filter from the active sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
filter.remove();

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

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

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

removeColumnFilterCriteria(columnPosition)

นำเกณฑ์ตัวกรองออกจากคอลัมน์ที่ระบุ 

// Removes the filter criteria from column B.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
filter.removeColumnFilterCriteria(2);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnPositionIntegerตำแหน่งที่เริ่มต้นด้วย 1 ของคอลัมน์ เช่น ดัชนีของคอลัมน์ B คือ 2

รีเทิร์น

Filter — ตัวกรองสําหรับการต่อเชื่อม

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

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

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

setColumnFilterCriteria(columnPosition, filterCriteria)

ตั้งค่าเกณฑ์ตัวกรองในคอลัมน์ที่ระบุ ก่อนอื่น ให้สร้างเครื่องมือสร้างเกณฑ์ตัวกรองโดยใช้ SpreadsheetApp.newFilterCriteria() จากนั้นเพิ่มเกณฑ์ลงในเครื่องมือสร้างโดยใช้คลาส FilterCriteriaBuilder หลังจากสร้างเกณฑ์แล้ว ให้ตั้งค่าเกณฑ์เป็นพารามิเตอร์ filterCriteria สําหรับวิธีการนี้ 

const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Builds the filter criteria to use as a parameter for setColumnFilterCriteria.
const criteria = SpreadsheetApp.newFilterCriteria()
                     .setHiddenValues(['Hello', 'World'])
                     .build();
// Sets the filter criteria for column C.
filter.setColumnFilterCriteria(3, criteria);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnPositionIntegerตำแหน่งที่เริ่มต้นด้วย 1 ของคอลัมน์ เช่น ดัชนีของคอลัมน์ B คือ 2
filterCriteriaFilterCriteriaเกณฑ์ตัวกรองที่จะตั้งค่า หากคุณตั้งค่าเกณฑ์เป็น null ระบบจะนำเกณฑ์ตัวกรองออกจากคอลัมน์ที่ระบุ หรือจะใช้ removeColumnFilterCriteria(columnPosition) ก็ได้

รีเทิร์น

Filter — ตัวกรองสําหรับการต่อเชื่อม

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

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

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

sort(columnPosition, ascending)

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

// Gets the existing filter and sorts it by column B in ascending order.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
filter.sort(2, true);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnPositionIntegerตำแหน่งที่เริ่มต้นด้วย 1 ของคอลัมน์ เช่น ดัชนีของคอลัมน์ B คือ 2
ascendingBooleanหากเป็น true ระบบจะจัดเรียงช่วงที่มีการกรองจากน้อยไปมาก หากเป็น false ระบบจะจัดเรียงช่วงที่มีการกรองจากมากไปน้อย

รีเทิร์น

Filter — ตัวกรองสําหรับการต่อเชื่อม

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

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

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