Class Selection

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الاختيار

الوصول إلى الاختيار النشط الحالي في ورقة البيانات النشطة الاختيار هو مجموعة الخلايا التي ميّزها المستخدم في ورقة البيانات، والتي يمكن أن تكون نطاقات غير متجاورة. الخلية الواحدة المحددة هي الخلية الحالية، حيث يتم التركيز على المستخدم الحالي. ويتم تمييز الخلية الحالية بحد أغمق في واجهة مستخدم "جداول بيانات Google".

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

var selection = activeSheet.getSelection();
// Current Cell: D1
Logger.log('Current Cell: ' + selection.getCurrentCell().getA1Notation());
// Active Range: D1:E4
Logger.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++) {
  Logger.log('Active Ranges: ' + ranges[i].getA1Notation());
}
Logger.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"
Logger.log(SpreadsheetApp.getSelection().getNextDataRange(Direction.UP).getA1Notation());

المعلّمات

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

تذكرة ذهاب وعودة

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

التفويض

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

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