به انتخاب فعال فعلی در برگه فعال دسترسی پیدا کنید. انتخاب مجموعه سلول هایی است که کاربر در برگه برجسته کرده است که می توانند محدوده های غیر مجاور باشند. یک سلول در انتخاب، سلول فعلی است که تمرکز فعلی کاربر در آن است. سلول فعلی با حاشیه تیرهتر در رابط کاربر کاربرگنگار 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
- محدوده فعال.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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
- لیست محدوده های فعال.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveSheet()
برگه فعال در صفحه گسترده را برمی گرداند.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var activeSheet = selection.getActiveSheet();
برگشت
Sheet
- صفحه فعال در صفحه گسترده.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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
- سلول فعلی.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNextDataRange(direction)
با شروع از current cell
و active range
و حرکت در جهت داده شده، یک محدوده تنظیم شده را برمی گرداند که در آن لبه مناسب محدوده برای پوشش next data cell
در حالی که هنوز سلول فعلی را پوشش می دهد، جابجا شده است. اگر محدوده فعال در dimension
بعد جهت نامحدود باشد، محدوده فعال اولیه برگردانده می شود. اگر سلول فعلی یا محدوده فعال وجود نداشته باشد، null
برگردانده می شود. این معادل انتخاب یک محدوده در ویرایشگر و زدن 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
است.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets