Class NamedRange

Zakres nazwany

Range, który ma nazwę i identyfikator umożliwiający późniejsze wyszukiwanie. Nazwy nie muszą być unikalne. Wiele różnych zakresów na tej samej karcie może mieć tę samą nazwę, podobnie jak klasa w HTML. Identyfikatory są natomiast unikalne na karcie, podobnie jak identyfikator w HTML. Gdy dodasz NamedRange do karty, nie możesz go zmodyfikować, tylko usunąć.

Do NamedRange może uzyskać dostęp dowolny skrypt, który uzyskuje dostęp do karty. Aby uniknąć niezamierzonych konfliktów między skryptami, rozważ dodanie do nazw zakresów unikalnego ciągu znaków. 

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

Metody

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

Szczegółowa dokumentacja

getId()

Pobiera identyfikator tego NamedRange. Identyfikator jest unikalny na karcie.

Powrót

String – identyfikator zakresu, który jest unikalny na karcie.

getName()

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

Powrót

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

Autoryzacja

Skrypty, które korzystają 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 elementem NamedRange.

Powrót

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

Autoryzacja

Skrypty, które korzystają 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 z karty element NamedRange. Ta metoda nie usuwa zawartości zakresu, tylko usuwa odwołanie. Wywołanie tej metody w przypadku NamedRange, który został już usunięty, nie ma żadnego efektu.

Autoryzacja

Skrypty, które korzystają 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