Class NamedRange

NamedRange

E-tabloda adlandırılmış aralıklar oluşturma, bu aralıklara erişme ve bu aralıkları değiştirme. Adlandırılmış aralıklar, ilişkili dize takma adları. E-Tablolar kullanıcı arayüzünde Veri > Adlandırılmış aralıklar... menüsü.

Yöntemler

YöntemDönüş türüKısa açıklama
getName()StringBu adlandırılmış aralığın adını alır.
getRange()RangeBu adlandırılmış aralık tarafından başvuruda bulunulan aralığı alır.
remove()voidBu adlandırılmış aralığı siler.
setName(name)NamedRangeAdlandırılmış aralığın adını ayarlar/günceller.
setRange(range)NamedRangeBu adlandırılmış aralık için aralığı ayarlar/günceller.

Ayrıntılı belgeler

getName()

Bu adlandırılmış aralığın adını alır.

Return

String — bu adlandırılmış aralığın adı

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

getRange()

Bu adlandırılmış aralık tarafından başvuruda bulunulan aralığı alır.

Return

Range: Bu adlandırılmış aralıkla ilişkilendirilen e-tablo aralığı

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

remove()

Bu adlandırılmış aralığı siler.

// The code below deletes all the named ranges in the spreadsheet.
var namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (var i = 0; i < namedRanges.length; i++) {
  namedRanges[i].remove();
}

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

setName(name)

Adlandırılmış aralığın adını ayarlar/günceller.

// The code below updates the name for the first named range.
var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName("UpdatedNamedRange");
}

Parametreler

AdTürAçıklama
nameStringAdlandırılmış aralığın yeni adı.

Return

NamedRange: Adı görüşme tarafından belirlenen 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

setRange(range)

Bu adlandırılmış aralık için aralığı ayarlar/günceller.

Parametreler

AdTürAçıklama
rangeRangeBu adlandırılmış aralıkla ilişkilendirilecek e-tablo aralığı.

Return

NamedRange - E-tablo aralığının ayarlandığı adlandırılmış 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