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
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
getId() | String | Pobiera identyfikator tego zasobu (NamedRange). |
getName() | String | Pobiera nazwę tego elementu (NamedRange). |
getRange() | Range | Pobiera zakres elementów powiązanych z tym obiektem typu NamedRange. |
remove() | void | Usuwa 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