Daha sonra almaya izin verecek bir ada ve kimliğe sahip olan Range. Adlar
benzersiz olması gerekir. aynı sekmedeki birkaç farklı aralık aynı adı paylaşabilir (örneğin,
sınıfını kullanır. Buna karşılık, kimlikler sekme içinde benzersizdir (HTML'deki bir kimlik gibi). Bir sekmeye NamedRange eklendikten sonra değiştirilemez, yalnızca kaldırılabilir.
NamedRange uygulamasına, sekmeye erişen herhangi bir komut dosyası tarafından erişilebilir. İstenmeyen değişikliklerden kaçınmak için
komut dosyaları arasında çakışma varsa aralık adlarının önüne benzersiz bir dize ekleyebilirsiniz.
// Create a named range that includes every table in the active tab.
var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
rangeBuilder.addElement(tables[i]);
}
documentTab.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
getId() | String | Bu NamedRange öğesinin kimliğini alır. |
getName() | String | Bu NamedRange öğesinin adını alır. |
getRange() | Range | Bu NamedRange ile ilişkilendirilen öğe aralığını alır. |
remove() | void | Bu NamedRange öğesini sekmeden kaldırır. |
Ayrıntılı belgeler
getId()
Bu NamedRange öğesinin kimliğini alır. Kimlik, sekme içinde benzersizdir.
Return
String: Sekme içinde benzersiz olan aralık kimliği.
getName()
Bu NamedRange öğesinin adını alır. Adın benzersiz olması gerekmez.
Return
String: Aralığın adı. Bu adın benzersiz olması gerekmez.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getRange()
Bu NamedRange ile ilişkilendirilen öğe aralığını alır.
Return
Range: Ad ve kimlikle ilişkili öğe aralığı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
remove()
Bu NamedRange öğesini sekmeden kaldırır. Bu yöntem,
aralık; referans kaldırılır. Şu özelliklere sahip bir NamedRange üzerinde bu yöntemi çağırmak:
değerinin zaten kaldırıldığının bir etkisi yoktur.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents