Class NamedRange

Zakres nazwany

tworzyć zakresy nazwane, uzyskiwać do nich dostęp i je modyfikować w arkuszu kalkulacyjnym; Zakresy nazwane to zakresy, które mają powiązane aliasy ciągu znaków. Można je wyświetlać i edytować w interfejsie Arkuszy w menu Dane > Zakresy o nazwie….

Metody

Metoda	Zwracany typ	Krótki opis
getName()	String	Pobiera nazwę tego zakresu nazwanego.
getRange()	Range	Pobiera zakres, do którego odwołuje 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 tego zakresu nazwanego.

Szczegółowa dokumentacja

getName()

Pobiera nazwę tego zakresu nazwanego.

Powrót

String – nazwa tego zakresu nazwanego

Autoryzacja

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

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

---

getRange()

Pobiera zakres, do którego odwołuje się ten zakres nazwany.

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym 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, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym 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 nazwa.

Powrót

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

Autoryzacja

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

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

---

setRange(range)

Ustawia lub aktualizuje zakres tego zakresu nazwanego.

Parametry

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

Powrót

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

Autoryzacja

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

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