Class NamedRange

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
NamedRange

Range, który ma nazwę i identyfikator, aby móc je później pobrać. Nazwy nie muszą być niepowtarzalne. Różne zakresy w tym samym dokumencie mogą mieć tę samą nazwę, podobnie jak klasa w kodzie HTML. Z kolei identyfikatory w obrębie dokumentu są unikalne, np. identyfikatory w kodzie HTML. Gdy dodasz NamedRange do dokumentu, nie będzie można go zmodyfikować tylko usunąć.

Dokument NamedRange jest dostępny przez dowolny skrypt uzyskujący dostęp do dokumentu. Aby uniknąć niezamierzonych konfliktów między skryptami, rozważ dodanie nazw zakresów z unikalnym ciągiem znaków.

// 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());

Metody

MetodaZwracany typKrótki opis
getId()StringPobiera identyfikator tego elementu: NamedRange.
getName()StringPobiera nazwę tego elementu: NamedRange.
getRange()RangePobiera zakres elementów powiązanych z tym elementem NamedRange.
remove()voidUsuwa ten dokument NamedRange z dokumentu.

Szczegółowa dokumentacja

getId()

Pobiera identyfikator tego elementu: NamedRange. Identyfikator jest unikalny w dokumencie.

Zwróć

String – identyfikator zakresu niepowtarzalny w dokumencie;


getName()

Pobiera nazwę tego elementu: NamedRange. Nazwa nie musi być unikalna.

Zwróć

String – nazwa zakresu, która nie musi być unikalna;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

getRange()

Pobiera zakres elementów powiązanych z tym elementem NamedRange.

Zwróć

Range – zakres elementów powiązanych z nazwą i identyfikatorem;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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

remove()

Usuwa ten dokument NamedRange z dokumentu. Nie powoduje to usunięcia treści z zakresu, a jedynie usunięcie pliku referencyjnego. Wywoływanie tej metody w NamedRange, która została już usunięta, nie ma skutków.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

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