Reprezentuje obraz nad siatką w arkuszu kalkulacyjnym.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
assignScript(functionName) | OverGridImage | Przypisuje do tego obrazu funkcję o określonej nazwie. |
getAltTextDescription() | String | Zwraca opis tekstu alternatywnego obrazu. |
getAltTextTitle() | String | Zwraca tytuł tekstu alternatywnego obrazu. |
getAnchorCell() | Range | Zwraca komórkę, w której obraz jest zakotwiczony. |
getAnchorCellXOffset() | Integer | Zwraca odsunięcie piksela w poziomie od komórki zakotwiczenia. |
getAnchorCellYOffset() | Integer | Zwraca odsunięcie piksela w pionie od komórki zakotwiczenia. |
getHeight() | Integer | Zwraca rzeczywistą wysokość obrazu w pikselach. |
getInherentHeight() | Integer | Zwraca nieodłączną wysokość obrazu w pikselach. |
getInherentWidth() | Integer | Zwraca nieodłączną wysokość obrazu w pikselach. |
getScript() | String | Zwraca nazwę funkcji przypisanej do tego obrazu. |
getSheet() | Sheet | Wyświetla arkusz, w którym pojawia się ten obraz. |
getUrl() | String | Pobiera źródłowy adres URL obrazu. Zwraca wartość null , jeśli adres URL jest niedostępny. |
getWidth() | Integer | Zwraca rzeczywistą szerokość obrazu w pikselach. |
remove() | void | Usuwa obraz z arkusza kalkulacyjnego. |
replace(blob) | OverGridImage | Zastępuje ten obraz obrazem określonym przez podaną wartość BlobSource . |
replace(url) | OverGridImage | Zastępuje ten obraz obrazem z określonego adresu URL. |
resetSize() | OverGridImage | Powoduje przywrócenie podstawowych wymiarów obrazu. |
setAltTextDescription(description) | OverGridImage | Ustawia tekst alternatywny opisu dla obrazu. |
setAltTextTitle(title) | OverGridImage | Ustawia tytuł tekstu alternatywnego obrazu. |
setAnchorCell(cell) | OverGridImage | Ustawia komórkę, w której obraz jest zakotwiczony. |
setAnchorCellXOffset(offset) | OverGridImage | Określa odsunięcie piksela w poziomie od komórki zakotwiczenia. |
setAnchorCellYOffset(offset) | OverGridImage | Określa odsunięcie piksela w pionie od komórki zakotwiczenia. |
setHeight(height) | OverGridImage | Ustawia faktyczną wysokość obrazu w pikselach. |
setWidth(width) | OverGridImage | Ustawia rzeczywistą szerokość obrazu w pikselach. |
Szczegółowa dokumentacja
assignScript(functionName)
Przypisuje do tego obrazu funkcję o określonej 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_ . |
Powroty
OverGridImage
– obraz do wiązania w łańcuchach.
Upoważnienie
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
getAltTextDescription()
Zwraca opis tekstu alternatywnego obrazu.
Powroty
String
– opis tekstu alternatywnego.
Upoważnienie
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
getAltTextTitle()
Zwraca tytuł tekstu alternatywnego obrazu.
Powroty
String
– tytuł tekstu alternatywnego.
Upoważnienie
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
getAnchorCell()
getAnchorCellXOffset()
Zwraca odsunięcie piksela w poziomie od komórki zakotwiczenia.
Powroty
Integer
– odsunięcie piksela w poziomie.
Upoważnienie
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
getAnchorCellYOffset()
Zwraca odsunięcie piksela w pionie od komórki zakotwiczenia.
Powroty
Integer
– odsunięcie w pionie (w pikselach).
Upoważnienie
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
getHeight()
Zwraca rzeczywistą wysokość 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()); }
Powroty
Integer
– wysokość obrazu w pikselach.
Upoważnienie
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
getInherentHeight()
Zwraca nieodłączną wysokość obrazu w pikselach.
Powroty
Integer
– rzeczywista wysokość w pikselach.
Upoważnienie
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
getInherentWidth()
Zwraca nieodłączną wysokość obrazu w pikselach.
Powroty
Integer
– rzeczywista szerokość w pikselach.
Upoważnienie
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
getScript()
Zwraca nazwę funkcji przypisanej do tego obrazu.
Powroty
String
– nazwa funkcji.
Upoważnienie
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
getSheet()
Wyświetla arkusz, w którym pojawia się ten 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()); }
Powroty
Sheet
– arkusz, na którym pojawia się obraz.
Upoważnienie
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
getUrl()
Pobiera źródłowy adres URL obrazu. Zwraca wartość null
, jeśli adres URL jest niedostępny. Jeśli obraz został wstawiony przez URL przy użyciu interfejsu API, ta metoda zwraca adres URL podany podczas wstawiania obrazu.
Powroty
String
– adres URL obrazu, jeśli jest dostępny. Zwraca wartość null
, jeśli obraz jest niedostępny lub nie ma źródłowego adresu URL.
Upoważnienie
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
getWidth()
Zwraca rzeczywistą szerokość 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()); }
Powroty
Integer
– szerokość obrazu w pikselach.
Upoważnienie
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 obraz z arkusza kalkulacyjnego. Każda kolejna operacja na obrazie spowoduje wystąpienie błędu skryptu.
// Deletes all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { images[i].remove(); }
Upoważnienie
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
replace(blob)
Zastępuje ten obraz obrazem określonym przez podaną wartość BlobSource
. Maksymalny obsługiwany rozmiar bloba to 2 MB.
Parametry
Nazwa | Typ | Opis |
---|---|---|
blob | BlobSource | Nowy obraz jako obiekt blob. |
Powroty
OverGridImage
– obraz do wiązania w łańcuchach.
Upoważnienie
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
replace(url)
Zastępuje ten obraz obrazem z określonego adresu URL.
Parametry
Nazwa | Typ | Opis |
---|---|---|
url | String | Adres URL nowego obrazu. |
Powroty
OverGridImage
– obraz do wiązania w łańcuchach.
Upoważnienie
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
resetSize()
Powoduje przywrócenie podstawowych wymiarów obrazu.
Powroty
OverGridImage
– obraz do wiązania w łańcuchach.
Upoważnienie
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
setAltTextDescription(description)
Ustawia tekst alternatywny opisu dla obrazu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
description | String | Nowy tekst alternatywny obrazu. |
Powroty
OverGridImage
– obraz do wiązania w łańcuchach.
Upoważnienie
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
setAltTextTitle(title)
Ustawia tytuł tekstu alternatywnego obrazu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | Nowy tekst alternatywny obrazu. |
Powroty
OverGridImage
– obraz do wiązania w łańcuchach.
Upoważnienie
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
setAnchorCell(cell)
Ustawia komórkę, w której obraz jest zakotwiczony.
Parametry
Nazwa | Typ | Opis |
---|---|---|
cell | Range | Nowa komórka zakotwiczenia. |
Powroty
OverGridImage
– obraz do wiązania w łańcuchach.
Upoważnienie
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
setAnchorCellXOffset(offset)
Określa odsunięcie piksela w poziomie od komórki zakotwiczenia.
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Integer | Nowe przesunięcie piksela w poziomie. |
Powroty
OverGridImage
– obraz do wiązania w łańcuchach.
Upoważnienie
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
setAnchorCellYOffset(offset)
Określa odsunięcie piksela w pionie od komórki zakotwiczenia.
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Integer | Nowa wartość odsunięcia pikseli w pionie. |
Powroty
OverGridImage
– obraz do wiązania w łańcuchach.
Upoważnienie
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
setHeight(height)
Ustawia faktyczną wysokość obrazu w pikselach.
Parametry
Nazwa | Typ | Opis |
---|---|---|
height | Integer | Wymagana wysokość w pikselach. |
Powroty
OverGridImage
– obraz do łańcuchów.
Upoważnienie
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
setWidth(width)
Ustawia rzeczywistą szerokość obrazu w pikselach.
Parametry
Nazwa | Typ | Opis |
---|---|---|
width | Integer | Żądana szerokość w pikselach. |
Powroty
OverGridImage
– obraz do łańcuchów.
Upoważnienie
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