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öntem	Dönüş türü	Kısa açıklama
getActiveRange()	Range	Etkin sayfadaki seçili aralığı veya etkin bir aralık yoksa null değerini döndürür.
getActiveRangeList()	RangeList	Etkin e-tablodaki 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 olan mevcut (vurgulanmış) hücreyi veya mevcut hücre yoksa null değerini döndürür.
getNextDataRange(direction)	Range	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.

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

Ad	Tür	Açıklama
direction	Direction	Sonraki 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