Class NamedRange

AdlandırılmışAralık

Daha sonra alınmasına olanak tanıyan bir ad ve kimliğe sahip bir Range. Adlar her zaman benzersiz değildir. Aynı sekmedeki birkaç farklı aralık, HTML'deki sınıflara benzer şekilde aynı adı paylaşabilir. Buna karşılık, kimlikler HTML'deki kimlikler gibi sekme içinde benzersizdir. Bir sekmeye eklenen NamedRange değiştirilemez, yalnızca kaldırılabilir.

NamedRange, sekmeye erişen tüm komut dosyaları tarafından erişilebilir. Komut dosyaları arasında istenmeyen çakışmaları önlemek için aralık adlarına benzersiz bir dize ön ekleyerek başlayabilirsiniz. 

// 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 özelliğinin kimliğini alır.
getName()StringBu NamedRange öğesinin adını alır.
getRange()RangeBu NamedRange ile ilişkili öğe aralığını alır.
remove()voidBu NamedRange öğesini sekmeden kaldırır.

Ayrıntılı dokümanlar

getId()

Bu NamedRange özelliğinin kimliğini alır. Kimlik, sekme içinde benzersizdir.

Return

String: Aralıktaki benzersiz kimlik.

getName()

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

Return

String: Aralık adı. Benzersiz olması gerekmez.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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şkili öğe aralığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ığın içeriğini silmez, yalnızca referansı kaldırır. Bu yöntemin, kaldırılmış bir NamedRange üzerinde çağrılmasının bir etkisi yoktur.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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