Class Selection

Seçim

Etkin sayfada geçerli etkin seçime erişme. Seçim, kullanıcının sayfada vurguladığı hücre grubudur ve bitişik olmayan aralıklar olabilir. Seçimdeki bir hücre, kullanıcının o anda odaklandığı geçerli hücredir. Geçerli hücre, Google E-Tablolar kullanıcı arayüzünde daha koyu bir kenarlıkla vurgulanır. 

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

const 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
const ranges = selection.getActiveRangeList().getRanges();
for (let i = 0; i < ranges.length; i++) {
  console.log(`Active Ranges: ${ranges[i].getA1Notation()}`);
}
console.log(`Active Sheet: ${selection.getActiveSheet().getName()}`);

Yöntemler

YöntemDönüş türüKısa açıklama
getActiveRange()RangeEtkin sayfadaki seçili aralığı veya etkin bir aralık yoksa null değerini döndürür.
getActiveRangeList()RangeListEtkin e-tablodaki etkin aralıkların listesini veya etkin aralık yoksa null değerini döndürür.
getActiveSheet()SheetE-tablodaki etkin sayfayı döndürür.
getCurrentCell()RangeEtkin aralıklardan birinde seçili olan mevcut (vurgulanmış) hücreyi veya mevcut hücre yoksa null değerini döndürür.
getNextDataRange(direction)Rangecurrent cell ve active range'ten başlayıp belirtilen yönde hareket ettiğinizde, geçerli hücreyi kapsarken aralığın uygun kenarının next data cell'yi de kapsayacak şekilde kaydırıldığı ayarlanmış bir aralık döndürülür.

Ayrıntılı dokümanlar

getActiveRange()

Etkin sayfadaki seçili aralığı veya etkin bir 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. 

const selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
const activeRange = selection.getActiveRange();

Return

Range: Etkin aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getActiveRangeList()

Etkin e-tablodaki etkin aralıkların listesini veya etkin aralık yoksa null değerini döndürür.

Tek bir aralık seçiliyse bu, getActiveRange() çağrısı gibi davranır. 

const sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
const activeRangeList = sheet.getActiveRangeList();

Return

RangeList: Etkin aralıkların listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getActiveSheet()

E-tablodaki etkin sayfayı döndürür. 

const selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
const activeSheet = selection.getActiveSheet();

Return

Sheet: E-tablodaki etkin sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getCurrentCell()

Etkin aralıklardan birinde seçili olan mevcut (vurgulanmış) hücreyi veya mevcut hücre yoksa null değerini döndürür. 

const selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
// Returns the current highlighted cell in the one of the active ranges.
const currentCell = selection.getCurrentCell();

Return

Range: Geçerli hücre.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getNextDataRange(direction)

current cell ve active range'ten başlayıp belirtilen yönde hareket ettiğinizde, geçerli hücreyi kapsarken aralığın uygun kenarının next data cell'yi de kapsayacak şekilde kaydırıldığı ayarlanmış bir aralık döndürülür. Etkin aralık, yönün dimension boyunca sınırsızsa orijinal etkin aralık döndürülür. Geçerli bir 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.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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

AdTürAçıklama
directionDirectionSonraki veri bölgesi kenar hücresinin bulunacağı yön.

Return

Range: Veri hücresini içeren ayarlanmış aralık veya seçim yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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