Class Selection

Seçim

Etkin sayfada mevcut etkin seçime erişin. Seçim, kullanıcının hücre kümesidir altında bitişik olmayan aralıklar olabilir. Seçimdeki bir hücre geçerli hücre (kullanıcının o anda odaklandığı hücre). Geçerli hücre şununla vurgulanır: daha koyu bir kenarlık görebilirsiniz. 

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öntemDönüş türüKısa açıklama
getActiveRange()RangeEtkin sayfada seçili aralığı veya etkin bir aralık yoksa null değerini döndürür.
getActiveRangeList()RangeListEtkin sayfadaki etkin aralıkların listesini veya etkin aralık yoksa null'i döndürür. değerleridir.
getActiveSheet()SheetE-tablodaki etkin sayfayı döndürür.
getCurrentCell()RangeEtkin aralıklardan birinde seçilmiş olan geçerli (vurgulanan) hücreyi veya geçerli hücre yoksa null değerini döndürür.
getNextDataRange(direction)RangeBaşlangıç noktası: current cell ve active range ve verilen yönde hareket etmesi, grafiğin uygun kenarının bulunduğu, ayarlanan bir aralığı hâlâ korunmuş durumdayken aralık next data cell aralığını kapsayacak şekilde kaydırıldı mevcut hücrenin üzerini kapatıyor.

Ayrıntılı belgeler

getActiveRange()

Etkin sayfada seçili aralığı veya etkin bir aralık yoksa null değerini döndürür. Eğer birden çok aralık seçilir. Bu yöntem yalnızca en 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 kapsamlardan bir 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'i döndürür. değerleridir.

Tek bir aralık seçildiyse bu bir getActiveRange() çağrısı gibi 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 kapsamlardan bir 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 kapsamlardan bir 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çilmiş olan geçerli (vurgulanan) 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getNextDataRange(direction)

Başlangıç noktası: current cell ve active range ve verilen yönde hareket etmesi, grafiğin uygun kenarının bulunduğu, ayarlanan bir aralığı hâlâ korunmuş durumdayken aralık next data cell aralığını kapsayacak şekilde kaydırıldı mevcut hücrenin üzerini kapatıyor. Etkin aralık, yönün dimension boyunca sınırsızsa orijinal etkin aralık döndürülür. Mevcut hücre yoksa veya etkin aralıktaysa null döndürülür. Bu, yardım merkezinden bir aralık seçmeye düzenleyici ve Ctrl+Shift+[arrow key] tuşuna basın. 

// 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

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

Return

Range — Veri hücresini içeren düzenlenen aralık veya hücre yoksa null seçim.

Yetkilendirme

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

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