تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class Selection

الوصول إلى التحديد النشط الحالي في الورقة النشطة. التحديد هو مجموعة الخلايا التي قام المستخدم بتمييزها في الورقة، والتي يمكن أن تكون نطاقات غير مجاورة. إحدى الخلايا في التحديد هي الخلية الحالية، حيث يكون التركيز الحالي للمستخدم. تم تمييز الخلية الحالية بحد أغمق في واجهة مستخدم "جداول بيانات 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());

المَعلمات

الاسم	Type	الوصف
`direction`	`Direction`	الاتجاه الذي يمكن العثور فيه على خلية حافة منطقة البيانات التالية.

استرجاع الكرة

Range: النطاق المعدَّل الذي يتضمّن خلية البيانات، أو null في حال عدم اختيار

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

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