تمت ترجمة هذه الصفحة بواسطة 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());

المعلمات

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

الإرجاع

Range - النطاق المعدّل الذي يتضمن خلية البيانات أو null إذا لم تكن هناك التحديد.

التفويض

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

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