Etkin sayfadaki geçerli etkin seçime erişin. Seçim, kullanıcının sayfada vurguladığı ve bitişik olmayan aralıklar olabilecek hücre grubudur. Seçimdeki bir hücre, kullanıcının geçerli odağının bulunduğu geçerli hücredir. Geçerli hücre, Google E-Tablolar kullanıcı arayüzünde daha koyu bir kenarlıkla vurgulanır.
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());
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
getActiveRange() | Range | Etkin sayfada seçilen aralığı veya etkin aralık yoksa null değerini döndürür. |
getActiveRangeList() | RangeList | Etkin sayfadaki etkin aralıkların listesini veya etkin aralık yoksa null değerini döndürür. |
getActiveSheet() | Sheet | E-tablodaki etkin sayfayı döndürür. |
getCurrentCell() | Range | Etkin aralıklardan birinde seçili geçerli (vurgulu) hücreyi veya geçerli hücre yoksa null değerini döndürür. |
getNextDataRange(direction) | Range | current cell ve active range noktasından başlayıp belirtilen yönde hareket ederek, ayarlanmış bir aralığı döndürür. Burada aralığın uygun kenarı, geçerli hücreyi kaplarken hâlâ next data cell değerini kapsayacak şekilde kaydırılır. |
Ayrıntılı belgeler
getActiveRange()
Etkin sayfada seçilen aralığı veya etkin aralık yoksa null
değerini döndürür. Birden fazla aralık seçilirse bu yöntem yalnızca son seçilen aralığı döndürür.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var activeRange = selection.getActiveRange();
Return
Range
: Etkin aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveRangeList()
Etkin sayfadaki etkin aralıkların listesini veya etkin aralık yoksa null
değerini döndürür.
Tek bir aralık seçiliyse bu bir getActiveRange()
çağrısı olarak davranır.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var activeRangeList = sheet.getActiveRangeList();
Return
RangeList
: Etkin aralıkların listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveSheet()
E-tablodaki etkin sayfayı döndürür.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var activeSheet = selection.getActiveSheet();
Return
Sheet
: E-tablodaki etkin sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCurrentCell()
Etkin aralıklardan birinde seçili geçerli (vurgulu) hücreyi veya geçerli hücre yoksa null
değerini döndürür.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = selection.getCurrentCell();
Return
Range
: Geçerli hücre.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNextDataRange(direction)
current cell
ve active range
noktasından başlayıp belirtilen yönde hareket ederek, ayarlanmış bir aralığı döndürür. Burada aralığın uygun kenarı, geçerli hücreyi kaplarken hâlâ next data cell
değerini kapsayacak şekilde kaydırılır. Etkin aralık, yönün dimension
çizgisi boyunca sınırsızsa orijinal etkin aralık döndürülür. Geçerli hücre veya etkin aralık yoksa null
döndürülür. Bu, düzenleyicide bir aralık seçip Ctrl+Shift+[arrow key]
tuşuna basmaya eşdeğerdir.
// 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());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
direction | Direction | Sonraki veri bölgesi kenar hücresinin bulunacağı yön. |
Return
Range
: Veri hücresini içeren ayarlanan aralık veya seçim yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets