Class NamedRange

NamedRange

Tworzenie, otwieranie i modyfikowanie zakresów nazwanych w arkuszu kalkulacyjnym. Zakresy nazwane to zakresy zawierające powiązane aliasy ciągów znaków. Można je wyświetlać i edytować w interfejsie Arkuszy w sekcji Dane > Menu zakresów nazwanych...

Metody

MetodaZwracany typKrótki opis
getName()StringPobiera nazwę tego nazwanego zakresu.
getRange()RangePobiera zakres, do którego odwołuje się ten nazwany zakres.
remove()voidUsuwa ten zakres nazwany.
setName(name)NamedRangeUstawia/aktualizuje nazwę nazwanego zakresu.
setRange(range)NamedRangeUstawia/aktualizuje zakres tego nazwanego zakresu.

Szczegółowa dokumentacja

getName()

Pobiera nazwę tego nazwanego zakresu.

Powrót

String – nazwa tego nazwanego zakresu,

Autoryzacja

Skrypty korzystające 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 nazwany zakres.

Powrót

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

Autoryzacja

Skrypty korzystające 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.
var namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (var i = 0; i < namedRanges.length; i++) {
  namedRanges[i].remove();
}

Autoryzacja

Skrypty korzystające 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/aktualizuje nazwę nazwanego zakresu. 

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

Parametry

NazwaTypOpis
nameStringNowa nazwa nazwanego zakresu.

Powrót

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

Autoryzacja

Skrypty korzystające 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/aktualizuje zakres tego nazwanego zakresu.

Parametry

NazwaTypOpis
rangeRangeZakres arkusza kalkulacyjnego do powiązania z tym nazwanym zakresem.

Powrót

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

Autoryzacja

Skrypty korzystające 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