Class Selection

การเลือก

เข้าถึงส่วนที่ใช้งานอยู่ในปัจจุบันในชีตที่ใช้งานอยู่ รายการที่เลือกคือชุดของเซลล์ที่ผู้ใช้ ที่ไฮไลต์ในชีต ซึ่งอาจเป็นช่วงที่ไม่ติดกัน เซลล์หนึ่งในรายการที่เลือกคือ เซลล์ปัจจุบัน ซึ่งโฟกัสปัจจุบันของผู้ใช้อยู่ เซลล์ปัจจุบันถูกไฮไลต์ด้วย เส้นขอบสีเข้มขึ้นใน UI ของ Google ชีต 

var activeSheet = SpreadsheetApp.getActiveSheet();
var rangeList = activeSheet.getRangeList(['A1:B4', 'D1:E4']);
rangeList.activate();

var selection = activeSheet.getSelection();
// Current Cell: D1
console.log('Current Cell: ' + selection.getCurrentCell().getA1Notation());
// Active Range: D1:E4
console.log('Active Range: ' + selection.getActiveRange().getA1Notation());
// Active Ranges: A1:B4, D1:E4
var ranges =  selection.getActiveRangeList().getRanges();
for (var i = 0; i < ranges.length; i++) {
  console.log('Active Ranges: ' + ranges[i].getA1Notation());
}
console.log('Active Sheet: ' + selection.getActiveSheet().getName());

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getActiveRange()Rangeแสดงผลช่วงที่เลือกในชีตที่ใช้งานอยู่ หรือ null หากไม่มีช่วงที่ใช้งานอยู่
getActiveRangeList()RangeListแสดงรายการช่วงที่มีการใช้งานอยู่ในชีตที่ใช้งานอยู่หรือ null ถ้าไม่มีการใช้งาน
getActiveSheet()Sheetแสดงชีตที่ใช้งานอยู่ในสเปรดชีต
getCurrentCell()Rangeแสดงผลเซลล์ปัจจุบัน (ที่ไฮไลต์) ที่เลือกไว้ในช่วงใดช่วงหนึ่งที่ใช้งานอยู่หรือ null หากไม่มีเซลล์ปัจจุบัน
getNextDataRange(direction)Rangeเริ่มจาก current cell และ active range และเคลื่อนที่ไปในทิศทางที่กำหนด จะแสดงช่วงที่ปรับตามขอบที่เหมาะสมของ ได้เลื่อนช่วงให้ครอบคลุม next data cell ขณะที่ยังคง ครอบคลุมเซลล์ปัจจุบัน

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

getActiveRange()

แสดงผลช่วงที่เลือกในชีตที่ใช้งานอยู่ หรือ null หากไม่มีช่วงที่ใช้งานอยู่ ถ้า การเลือกหลายช่วงวิธีนี้จะแสดงเฉพาะช่วงที่เลือกล่าสุดเท่านั้น 

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
var activeRange = selection.getActiveRange();

รีเทิร์น

Range — ช่วงที่ใช้งานอยู่

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

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

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

getActiveRangeList()

แสดงรายการช่วงที่มีการใช้งานอยู่ในชีตที่ใช้งานอยู่หรือ null ถ้าไม่มีการใช้งาน

หากเลือกช่วงเดียวไว้ การดำเนินการนี้จะทำงานเป็นการโทร getActiveRange() 

var sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
var activeRangeList = sheet.getActiveRangeList();

รีเทิร์น

RangeList — รายการช่วงที่มีการใช้งานอยู่

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

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

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

getActiveSheet()

แสดงชีตที่ใช้งานอยู่ในสเปรดชีต 

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
var activeSheet = selection.getActiveSheet();

รีเทิร์น

Sheet — แผ่นงานที่ใช้งานอยู่ในสเปรดชีต

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

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

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

getCurrentCell()

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

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
// Returns the current highlighted cell in the one of the active ranges.
var currentCell = selection.getCurrentCell();

รีเทิร์น

Range — เซลล์ปัจจุบัน

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

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

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

getNextDataRange(direction)

เริ่มจาก current cell และ active range แล้วเคลื่อนที่ไปในทิศทางที่กำหนด จะแสดงช่วงที่ปรับตามขอบที่เหมาะสมของ ได้เลื่อนช่วงให้ครอบคลุม next data cell ขณะที่ยังคง ครอบคลุมเซลล์ปัจจุบัน หากช่วงที่ใช้งานอยู่ไม่มีขอบเขตตาม dimension ของทิศทาง ระบบจะแสดงผลช่วงที่ใช้งานอยู่เดิม หากไม่มีเซลล์ปัจจุบัน หรือช่วงที่ใช้งานอยู่ ระบบจะแสดงผล null ซึ่งเทียบเท่ากับการเลือกช่วงใน Editor และกดปุ่ม Ctrl+Shift+[arrow key] 

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Makes C3 the current cell and C3:E5 the active range.
sheet.getRange('C3:E5').activate();
// Logs 'C1:E3'
console.log(SpreadsheetApp.getSelection()
                          .getNextDataRange(SpreadsheetApp.Direction.UP)
                          .getA1Notation());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
directionDirectionทิศทางในการค้นหาเซลล์ขอบของเขตข้อมูลถัดไป

รีเทิร์น

Range — ช่วงที่ปรับแล้วซึ่งมีเซลล์ข้อมูล หรือ null หากไม่มี มากมาย

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

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

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