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