เข้าถึงส่วนที่ใช้งานอยู่ในปัจจุบันในชีตที่ใช้งานอยู่ รายการที่เลือกคือชุดของเซลล์ที่ผู้ใช้ ที่ไฮไลต์ในชีต ซึ่งอาจเป็นช่วงที่ไม่ติดกัน เซลล์หนึ่งในรายการที่เลือกคือ เซลล์ปัจจุบัน ซึ่งโฟกัสปัจจุบันของผู้ใช้อยู่ เซลล์ปัจจุบันถูกไฮไลต์ด้วย เส้นขอบสีเข้มขึ้นใน 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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
direction | Direction | ทิศทางในการค้นหาเซลล์ขอบของเขตข้อมูลถัดไป |
รีเทิร์น
Range
— ช่วงที่ปรับแล้วซึ่งมีเซลล์ข้อมูล หรือ null
หากไม่มี
มากมาย
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets