Class OverGridImage

Nadsiatkaobraz

Reprezentuje obraz nad siatką w arkuszu kalkulacyjnym.

Metody

MetodaZwracany typKrótki opis
assignScript(functionName)OverGridImagePrzypisuje do tego obrazu funkcję o określonej nazwie.
getAltTextDescription()StringZwraca tekst alternatywny dla tego obrazu.
getAltTextTitle()StringZwraca tytuł tekstu alternatywnego dla tego obrazu.
getAnchorCell()RangeZwraca komórkę, w której jest zakotwiczony obraz.
getAnchorCellXOffset()IntegerZwraca przesunięcie poziome w pikselach od komórki kotwicy.
getAnchorCellYOffset()IntegerZwraca pionowe przesunięcie w pikselach od komórki kotwicy.
getHeight()IntegerZwraca rzeczywistą wysokość tego obrazu w pikselach.
getInherentHeight()IntegerZwraca wysokość tego obrazu w pikselach.
getInherentWidth()IntegerZwraca wysokość tego obrazu w pikselach.
getScript()StringZwraca nazwę funkcji przypisanej do tego obrazu.
getSheet()SheetZwraca arkusz, na którym znajduje się obraz.
getUrl()StringPobiera adres URL źródła obrazu; jeśli adres URL jest niedostępny, zwraca wartość null.
getWidth()IntegerZwraca rzeczywistą szerokość tego obrazu w pikselach.
remove()voidusuwa to zdjęcie z arkusza kalkulacyjnego.
replace(blob)OverGridImageZastępuje ten obraz obrazem określonym przez podany identyfikator BlobSource.
replace(url)OverGridImageZastępuje ten obraz obrazem z podanego adresu URL.
resetSize()OverGridImagePrzywraca ten obraz do jego pierwotnych wymiarów.
setAltTextDescription(description)OverGridImageUstawia tekst alternatywny dla tego obrazu.
setAltTextTitle(title)OverGridImageUstawia tytuł tekstu alternatywnego dla tego obrazu.
setAnchorCell(cell)OverGridImageUstawia komórkę, w której obraz jest zakotwiczony.
setAnchorCellXOffset(offset)OverGridImageUstawia przesunięcie poziome w pikselach od komórki kotwicy.
setAnchorCellYOffset(offset)OverGridImageUstawia przesunięcie pionowe w pikselach od komórki kotwicznej.
setHeight(height)OverGridImageUstawia rzeczywistą wysokość tego obrazu w pikselach.
setWidth(width)OverGridImageUstawia rzeczywistą szerokość tego obrazu w pikselach.

Szczegółowa dokumentacja

assignScript(functionName)

Przypisuje do tego obrazu funkcję o określonej nazwie.

Parametry

NazwaTypOpis
functionNameStringNazwa podanej funkcji. Musi to być publiczna funkcja najwyższego poziomu, a nie funkcja kończąca się podkreśleniem, np. privateFunction_.

Powrót

OverGridImage – ten obraz do łańcucha.

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

getAltTextDescription()

Zwraca tekst alternatywny dla tego obrazu.

Powrót

String – tekst alternatywny.

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

getAltTextTitle()

Zwraca tytuł tekstu alternatywnego dla tego obrazu.

Powrót

String – tytuł tekstu alternatywnego.

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

getAnchorCell()

Zwraca komórkę, w której jest zakotwiczony obraz.

Powrót

Range – komórka kotwiczy.

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

getAnchorCellXOffset()

Zwraca przesunięcie poziome w pikselach od komórki kotwicy.

Powrót

Integer – przesunięcie w poziomie w pikselach.

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

getAnchorCellYOffset()

Zwraca pionowe przesunięcie w pikselach od komórki kotwicy.

Powrót

Integer – pionowe przesunięcie w pikselach.

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

getHeight()

Zwraca rzeczywistą wysokość tego obrazu w pikselach.

// Logs the height of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getHeight());
}

Powrót

Integer – wysokość obrazu w pikselach.

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

getInherentHeight()

Zwraca wysokość tego obrazu w pikselach.

Powrót

Integer – wysokość w pikselach.

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

getInherentWidth()

Zwraca wysokość tego obrazu w pikselach.

Powrót

Integer – domyślna szerokość w pikselach.

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

getScript()

Zwraca nazwę funkcji przypisanej do tego obrazu.

Powrót

String – nazwa funkcji.

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

getSheet()

Zwraca arkusz, na którym znajduje się obraz.

// Logs the parent sheet of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getSheet());
}

Powrót

Sheet – arkusz, na którym ma się pojawić obraz.

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

getUrl()

Pobiera adres URL źródła obrazu; jeśli adres URL jest niedostępny, zwraca wartość null. Jeśli obraz został wstawiony za pomocą adresu URL za pomocą interfejsu API, ta metoda zwraca adres URL podany podczas wstawiania obrazu.

Powrót

String – adres URL obrazu, jeśli jest dostępny; zwraca null, jeśli obraz jest niedostępny lub nie ma adresu URL źródłowego.

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

getWidth()

Zwraca rzeczywistą szerokość tego obrazu w pikselach.

// Logs the width of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getWidth());
}

Powrót

Integer – szerokość obrazu w pikselach.

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 to zdjęcie z arkusza kalkulacyjnego. Dalsze operacje na obrazie spowodują błąd skryptu.

// Deletes all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  images[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

replace(blob)

Zastępuje ten obraz obrazem określonym przez podany identyfikator BlobSource. Maksymalny obsługiwany rozmiar bloba to 2 MB.

Parametry

NazwaTypOpis
blobBlobSourceNowy obraz jako obiekt Blob.

Powrót

OverGridImage – ten obraz do łańcucha.

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

replace(url)

Zastępuje ten obraz obrazem z podanego adresu URL.

Parametry

NazwaTypOpis
urlStringAdres URL nowego obrazu.

Powrót

OverGridImage – ten obraz do łańcucha.

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

resetSize()

Przywraca ten obraz do jego pierwotnych wymiarów.

Powrót

OverGridImage – ten obraz do łańcucha.

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

setAltTextDescription(description)

Ustawia tekst alternatywny dla tego obrazu.

Parametry

NazwaTypOpis
descriptionStringNowy tekst alternatywny obrazu.

Powrót

OverGridImage – ten obraz do łańcucha.

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

setAltTextTitle(title)

Ustawia tytuł tekstu alternatywnego dla tego obrazu.

Parametry

NazwaTypOpis
titleStringNowy tytuł tekstu alternatywnego obrazu.

Powrót

OverGridImage – ten obraz do łańcucha.

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

setAnchorCell(cell)

Ustawia komórkę, w której obraz jest zakotwiczony.

Parametry

NazwaTypOpis
cellRangeNowa komórka kotwicy.

Powrót

OverGridImage – ten obraz do łańcucha.

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

setAnchorCellXOffset(offset)

Ustawia przesunięcie poziome w pikselach od komórki kotwicy.

Parametry

NazwaTypOpis
offsetIntegerNowy przesunięcie poziome pikseli.

Powrót

OverGridImage – ten obraz do łańcucha.

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

setAnchorCellYOffset(offset)

Ustawia przesunięcie pionowe w pikselach od komórki kotwicznej.

Parametry

NazwaTypOpis
offsetIntegerNowe pionowe przesunięcie pikseli.

Powrót

OverGridImage – ten obraz do łańcucha.

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

setHeight(height)

Ustawia rzeczywistą wysokość tego obrazu w pikselach.

Parametry

NazwaTypOpis
heightIntegerPożądana wysokość w pikselach.

Powrót

OverGridImage – obraz do łańcucha.

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

setWidth(width)

Ustawia rzeczywistą szerokość tego obrazu w pikselach.

Parametry

NazwaTypOpis
widthIntegerPożądana szerokość w pikselach.

Powrót

OverGridImage – obraz do łańcucha.

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