Class NamedRange

NamedRange

Daha sonra alınmasına izin vermek için adı ve kimliği olan bir Range. Adlar benzersiz olmak zorunda değildir. Aynı sekmedeki birkaç farklı aralık, HTML'deki bir sınıf gibi aynı adı paylaşabilir. Buna karşılık, kimlikler HTML'deki bir kimlik gibi sekme içinde benzersizdir. Bir sekmeye eklenen NamedRange değiştirilemez, yalnızca kaldırılabilir.

Bir NamedRange, sekmeye erişen tüm komut dosyaları tarafından kullanılabilir. Komut dosyaları arasında istenmeyen çakışmaları önlemek için aralık adlarının önüne benzersiz bir dize ekleyebilirsiniz. 

// Create a named range that includes every table in the active tab.
const documentTab =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
documentTab.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());

Yöntemler

YöntemDönüş türüKısa açıklama
getId()StringBu NamedRange öğesinin kimliğini alır.
getName()StringBu NamedRange öğesinin adını alır.
getRange()RangeBu NamedRange ile ilişkili öğelerin aralığını alır.
remove()voidBu 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: Sekmede benzersiz olan aralığın kimliği.

getName()

Bu NamedRange öğesinin adını alır. Adın benzersiz olması gerekmez.

Return

String: Aralık adı. Bu adın benzersiz olması gerekmez.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 öğelerin aralığını alır.

Return

Range: Ad ve kimlikle ilişkili öğe aralığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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öntemle aralıktaki içerikler silinmez, yalnızca referans kaldırılır. Bu yöntemin, daha önce kaldırılmış bir NamedRange üzerinde çağrılmasının etkisi yoktur.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents