Daha sonra alınabilecek bir ada ve kimliğe sahip olan Range. Adlar mutlaka benzersiz değildir; HTML'deki bir sınıfa benzer şekilde, aynı dokümandaki birkaç farklı aralık aynı adı paylaşabilir. Buna karşın kimlikler, HTML'deki kimlikler gibi doküman içinde benzersizdir. NamedRange dokümana eklendikten sonra değiştirilemez, yalnızca kaldırılır.
Bir NamedRange öğesine, dokümana erişen herhangi bir komut dosyası tarafından erişilebilir. Komut dosyaları arasında istenmeyen çakışmaları önlemek için aralık adlarına benzersiz bir dize eklemeyi düşünün.
// Create a named range that includes every table in the document.
var doc = DocumentApp.getActiveDocument();
var rangeBuilder = doc.newRange();
var tables = doc.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
rangeBuilder.addElement(tables[i]);
}
doc.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şkili öğe aralığını alır. |
remove() | void | Bu NamedRange dokümandan kaldırılır. |
Ayrıntılı belgeler
getId()
Bu NamedRange öğesinin kimliğini alır. Kimlik, belge içinde benzersiz olmalıdır.
Return
String: aralığın belge içinde benzersiz olan kimliği
getName()
Bu NamedRange öğesinin adını alır. Adın benzersiz olması gerekmez.
Return
String: Aralığın adıdır. Bu adın benzersiz olması gerekmez
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getRange()
Bu NamedRange ile ilişkili öğe aralığını alır.
Return
Range: Ad ve kimlikle ilişkilendirilen öğe 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/documents.currentonly -
https://www.googleapis.com/auth/documents
remove()
Bu NamedRange dokümandan kaldırılır. Bu yöntem, aralığın içeriğini silmez, yalnızca referansı kaldırır. Bu yöntemin daha önce kaldırılmış bir NamedRange üzerinde çağrılmasının hiçbir etkisi yoktur.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents