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

MetodaZwracany typKrótki opis
getName()StringPobiera nazwę tego zakresu nazwanego.
getRange()RangePobiera zakres, do którego odwołuje się ten zakres nazwany.
remove()voidUsuwa ten zakres nazwany.
setName(name)NamedRangeUstawia lub aktualizuje nazwę zakresu nazwanego.
setRange(range)NamedRangeUstawia 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

NazwaTypOpis
nameStringNowa 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

NazwaTypOpis
rangeRangeZakres 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