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ı olan aralıklardır. Bu aralıklar, E-Tablolar kullanıcı arayüzündeki Veri > Adlandırılmış aralıklar... menüsü üzerinden görüntülenebilir ve düzenlenebilir.
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
getName() | String | Bu adlandırılmış aralığın adını alır. |
getRange() | Range | Bu adlandırılmış aralık tarafından başvurulan aralığı getirir. |
remove() | void | Bu adlandırılmış aralığı siler. |
setName(name) | NamedRange | Adlandırılmış aralığın adını ayarlar/günceller. |
setRange(range) | NamedRange | Bu 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 kapsamların biri 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şvurulan aralığı getirir.
Return
Range: Bu adlandırılmış aralıkla ilişkili e-tablo aralığı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 kapsamların biri 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
| Ad | Tür | Açıklama |
|---|---|---|
name | String | Adlandırılmış aralığın yeni adı. |
Return
NamedRange: Adı çağrı tarafından ayarlanan aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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
| Ad | Tür | Açıklama |
|---|---|---|
range | Range | Bu 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets