Class Selection

Seçim

Etkin sayfadaki geçerli etkin seçime erişir. Seçim, kullanıcının sayfada vurguladığı hücre grubudur. Bu hücreler, bitişik olmayan aralıklar olabilir. Seçimdeki bir hücre, kullanıcının mevcut 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. 

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()Range|nullEtkin sayfadaki seçili aralığı veya etkin bir aralık yoksa null değerini döndürür.
getActiveRangeList()RangeList|nullEtkin sayfadaki 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()Range|nullEtkin aralıklardan birinde seçilen geçerli (vurgulanmış) hücreyi veya geçerli bir hücre yoksa null değerini döndürür.
getNextDataRange(direction)Range|nullcurrent cell ve active range hücrelerinden başlayıp belirtilen yönde ilerleyerek, aralığın uygun kenarının next data cell hücresini kapsayacak şekilde kaydırıldığı ve geçerli hücreyi de kapsadığı ayarlanmış bir aralık döndürür.

Ayrıntılı belgeler

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|null: Etkin aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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, getActiveRange() çağrısı gibi davranır. 

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

Return

RangeList|null: Etkin aralıkların listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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. 

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

Return

Sheet: E-tablodaki etkin sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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çilen geçerli (vurgulanmış) hücreyi veya geçerli bir 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|null: Geçerli hücre.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 hücrelerinden başlayıp belirtilen yönde ilerleyerek, aralığın uygun kenarının next data cell hücresini kapsayacak şekilde kaydırıldığı ve geçerli hücreyi de kapsadığı ayarlanmış bir aralık döndürür. Etkin aralık, yönün dimension 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.
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|null: Veri hücresini içeren ayarlanmış aralık veya seçim yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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