Class OverGridImage

OverGridImage

Reprezentuje obraz nad siatką w arkuszu kalkulacyjnym.

Metody

Metoda	Zwracany typ	Krótki opis
assignScript(functionName)	OverGridImage	Przypisuje do tego obrazu funkcję o podanej nazwie.
getAltTextDescription()	String	Zwraca tekst alternatywny tego obrazu.
getAltTextTitle()	String	Zwraca tytuł tekstu alternatywnego tego obrazu.
getAnchorCell()	Range	Zwraca komórkę, w której zakotwiczony jest obraz.
getAnchorCellXOffset()	Integer	Zwraca poziome przesunięcie w pikselach od komórki zakotwiczenia.
getAnchorCellYOffset()	Integer	Zwraca pionowe przesunięcie w pikselach od komórki zakotwiczenia.
getHeight()	Integer	Zwraca rzeczywistą wysokość obrazu w pikselach.
getInherentHeight()	Integer	Zwraca rzeczywistą wysokość obrazu w pikselach.
getInherentWidth()	Integer	Zwraca rzeczywistą wysokość obrazu w pikselach.
getScript()	String	Zwraca nazwę funkcji przypisanej do tego obrazu.
getSheet()	Sheet	Zwraca arkusz, w którym znajduje się ten obraz.
getWidth()	Integer	Zwraca rzeczywistą szerokość obrazu w pikselach.
remove()	void	Usuwa ten obraz z arkusza kalkulacyjnego.
replace(blob)	OverGridImage	Zastępuje ten obraz obrazem określonym przez podany element BlobSource.
replace(url)	OverGridImage	Zastępuje ten obraz obrazem z określonego adresu URL.
resetSize()	OverGridImage	Przywraca pierwotne wymiary obrazu.
setAltTextDescription(description)	OverGridImage	Ustawia tekst alternatywny dla tego obrazu.
setAltTextTitle(title)	OverGridImage	Ustawia tytuł tekstu alternatywnego dla tego obrazu.
setAnchorCell(cell)	OverGridImage	Ustawia komórkę, w której obraz jest zakotwiczony.
setAnchorCellXOffset(offset)	OverGridImage	Ustawia poziome przesunięcie w pikselach od komórki zakotwiczenia.
setAnchorCellYOffset(offset)	OverGridImage	Ustawia pionowe przesunięcie w pikselach od komórki zakotwiczenia.
setHeight(height)	OverGridImage	Ustawia rzeczywistą wysokość obrazu w pikselach.
setWidth(width)	OverGridImage	Ustawia rzeczywistą szerokość obrazu w pikselach.

Wycofane metody

Metoda	Zwracany typ	Krótki opis
getUrl()	String	Pobiera adres URL źródła obrazu.

Szczegółowa dokumentacja

assignScript(functionName)

Przypisuje do tego obrazu funkcję o podanej nazwie.

Parametry

Nazwa	Typ	Opis
functionName	String	Nazwa określonej funkcji. Musi to być publiczna funkcja najwyższego poziomu, a nie funkcja kończąca się znakiem podkreślenia, np. privateFunction_.

Powrót

OverGridImage – ten obraz do łączenia.

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

---

getAltTextDescription()

Zwraca tekst alternatywny tego obrazu.

Powrót

String – tekst alternatywny opisu.

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

---

getAltTextTitle()

Zwraca tytuł tekstu alternatywnego tego obrazu.

Powrót

String – tytuł tekstu alternatywnego.

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

---

getAnchorCell()

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

Powrót

Range – komórka zakotwiczenia.

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

---

getAnchorCellXOffset()

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

Powrót

Integer – przesunięcie piksela w poziomie.

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

---

getAnchorCellYOffset()

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

Powrót

Integer – pionowe przesunięcie pikseli.

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

---

getHeight()

Zwraca rzeczywistą wysokość obrazu w pikselach.

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

Powrót

Integer – wysokość obrazu w pikselach.

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

---

getInherentHeight()

Zwraca rzeczywistą wysokość obrazu w pikselach.

Powrót

Integer – wysokość w pikselach.

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

---

getInherentWidth()

Zwraca rzeczywistą wysokość obrazu w pikselach.

Powrót

Integer – szerokość w pikselach.

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

---

getScript()

Zwraca nazwę funkcji przypisanej do tego obrazu.

Powrót

String – nazwa funkcji.

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

---

getSheet()

Zwraca arkusz, w którym znajduje się ten obraz.

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

Powrót

Sheet – arkusz, w którym znajduje się obraz.

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

---

getWidth()

Zwraca rzeczywistą szerokość obrazu w pikselach.

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

Powrót

Integer – szerokość obrazu w pikselach.

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 obraz z arkusza kalkulacyjnego. Każda kolejna operacja na obrazie powoduje błąd skryptu.

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

---

replace(blob)

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

Parametry

Nazwa	Typ	Opis
blob	BlobSource	Nowy obraz jako obiekt Blob.

Powrót

OverGridImage – ten obraz do łączenia.

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

---

replace(url)

Zastępuje ten obraz obrazem z określonego adresu URL.

Parametry

Nazwa	Typ	Opis
url	String	Adres URL nowego obrazu.

Powrót

OverGridImage – ten obraz do łączenia.

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

---

resetSize()

Przywraca pierwotne wymiary obrazu.

Powrót

OverGridImage – ten obraz do łączenia.

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

---

setAltTextDescription(description)

Ustawia tekst alternatywny dla tego obrazu.

Parametry

Nazwa	Typ	Opis
description	String	Nowy tekst alternatywny obrazu.

Powrót

OverGridImage – ten obraz do łączenia.

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

---

setAltTextTitle(title)

Ustawia tytuł tekstu alternatywnego dla tego obrazu.

Parametry

Nazwa	Typ	Opis
title	String	Nowy tytuł tekstu alternatywnego obrazu.

Powrót

OverGridImage – ten obraz do łączenia.

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

---

setAnchorCell(cell)

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

Parametry

Nazwa	Typ	Opis
cell	Range	nowa komórka zakotwiczenia;

Powrót

OverGridImage – ten obraz do łączenia.

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

---

setAnchorCellXOffset(offset)

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

Parametry

Nazwa	Typ	Opis
offset	Integer	Nowe poziome przesunięcie pikseli.

Powrót

OverGridImage – ten obraz do łączenia.

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

---

setAnchorCellYOffset(offset)

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

Parametry

Nazwa	Typ	Opis
offset	Integer	Nowe pionowe przesunięcie piksela.

Powrót

OverGridImage – ten obraz do łączenia.

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

---

setHeight(height)

Ustawia rzeczywistą wysokość obrazu w pikselach.

Parametry

Nazwa	Typ	Opis
height	Integer	Oczekiwana wysokość w pikselach.

Powrót

OverGridImage – obraz do łączenia.

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

---

setWidth(width)

Ustawia rzeczywistą szerokość obrazu w pikselach.

Parametry

Nazwa	Typ	Opis
width	Integer	Żądana szerokość w pikselach.

Powrót

OverGridImage – obraz do łączenia.

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

Wycofane metody

getUrl()

Wycofano. W przypadku większości nowo wstawionych obrazów adres URL źródła jest niedostępny.

Pobiera adres URL źródła obrazu. Jeśli adres URL jest niedostępny, zwraca pusty ciąg znaków. W przypadku większości nowo wstawionych obrazów adres URL źródła jest niedostępny niezależnie od sposobu wstawienia obrazu.

Powrót

String – adres URL źródła obrazu, jeśli jest dostępny; w przeciwnym razie zwraca pusty ciąg znaków.

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