Class NamedRange

NamedRange

Tworzenie zakresów nazwanych w arkuszu kalkulacyjnym, uzyskiwanie do nich dostępu i modyfikowanie ich. Zakresy nazwane to zakresy, które mają powiązane aliasy ciągów znaków. Możesz je wyświetlać i edytować w interfejsie Arkuszy w menu Dane > Nazwane zakresy....

Metody

Metoda	Zwracany typ	Krótki opis
getName()	String	Pobiera nazwę tego nazwanego zakresu.
getRange()	Range	Pobiera zakres, do którego odnosi się ten zakres nazwany.
remove()	void	Usuwa ten zakres nazwany.
setName(name)	NamedRange	Ustawia lub aktualizuje nazwę zakresu nazwanego.
setRange(range)	NamedRange	Ustawia lub aktualizuje zakres dla tego zakresu nazwanego.

Szczegółowa dokumentacja

getName()

Pobiera nazwę tego nazwanego zakresu.

Powrót

String – nazwa tego zakresu nazwanego.

Autoryzacja

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

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

---

getRange()

Pobiera zakres, do którego odnosi się ten zakres nazwany.

Powrót

Range – zakres arkusza kalkulacyjnego powiązany z tym zakresem nazwanym.

Autoryzacja

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

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

---

remove()

Usuwa ten zakres nazwany.

// The code below deletes all the named ranges in the spreadsheet.
const namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (let i = 0; i < namedRanges.length; i++) {
  namedRanges[i].remove();
}

Autoryzacja

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

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

---

setName(name)

Ustawia lub aktualizuje nazwę zakresu nazwanego.

// The code below updates the name for the first named range.
const namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName('UpdatedNamedRange');
}

Parametry

Nazwa	Typ	Opis
name	String	Nowa nazwa zakresu nazwanego.

Powrót

NamedRange – zakres, którego nazwa została ustawiona przez wywołanie.

Autoryzacja

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

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

---

setRange(range)

Ustawia lub aktualizuje zakres dla tego zakresu nazwanego.

Parametry

Nazwa	Typ	Opis
range	Range	Zakres arkusza kalkulacyjnego, który ma być powiązany z tym zakresem nazwanym.

Powrót

NamedRange – zakres nazwany, dla którego ustawiono zakres arkusza kalkulacyjnego.

Autoryzacja

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

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