Class NamedRange

NamedRange

Range z nazwą i identyfikatorem umożliwiającym późniejsze pobranie. Nazwy nie są musi być unikalny; kilka różnych zakresów na tej samej karcie może mieć taką samą nazwę, na przykład w kodzie HTML. Z kolei identyfikatory na karcie są unikalne, podobnie jak identyfikatory w kodzie HTML. Po dodaniu elementu NamedRange do karty nie można go zmienić – można go tylko usunąć.

Dostęp do elementu NamedRange można uzyskać za pomocą dowolnego skryptu, który uzyskuje dostęp do karty. Aby uniknąć niezamierzonego konflikty między skryptami, rozważ poprzedzenie nazw zakresów unikalnymi ciągami znaków. 

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

Metody

MetodaZwracany typKrótki opis
getId()StringPobiera identyfikator tego zasobu (NamedRange).
getName()StringPobiera nazwę tego elementu (NamedRange).
getRange()RangePobiera zakres elementów powiązanych z tym obiektem typu NamedRange.
remove()voidUsuwa element NamedRange z karty.

Szczegółowa dokumentacja

getId()

Pobiera identyfikator tego zasobu (NamedRange). Identyfikator jest unikalny w obrębie karty.

Powrót

String – unikalny identyfikator zakresu na karcie.

getName()

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

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym 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 obiektem typu NamedRange.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

remove()

Usuwa element NamedRange z karty. Ta metoda nie usuwa zawartości pliku zakres; usunięcie odwołania. Wywołuję tę metodę na urządzeniu NamedRange, które zostało już usunięte, nie ma żadnego efektu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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