Reprezentuje obraz nad siatką w arkuszu kalkulacyjnym.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
assign | Over | Przypisuje do tego obrazu funkcję o określonej nazwie. |
get | String | Zwraca tekst alternatywny dla tego obrazu. |
get | String | Zwraca tytuł tekstu alternatywnego dla tego obrazu. |
get | Range | Zwraca komórkę, w której jest zakotwiczony obraz. |
get | Integer | Zwraca przesunięcie poziome w pikselach od komórki kotwicy. |
get | Integer | Zwraca pionowe przesunięcie w pikselach od komórki kotwicy. |
get | Integer | Zwraca rzeczywistą wysokość tego obrazu w pikselach. |
get | Integer | Zwraca wysokość tego obrazu w pikselach. |
get | Integer | Zwraca wysokość tego obrazu w pikselach. |
get | String | Zwraca nazwę funkcji przypisanej do tego obrazu. |
get | Sheet | Zwraca arkusz, na którym znajduje się obraz. |
get | String | Pobiera adres URL źródła obrazu; jeśli adres URL jest niedostępny, zwraca wartość null . |
get | Integer | Zwraca rzeczywistą szerokość tego obrazu w pikselach. |
remove() | void | usuwa to zdjęcie z arkusza kalkulacyjnego. |
replace(blob) | Over | Zastępuje ten obraz obrazem określonym przez podany identyfikator Blob . |
replace(url) | Over | Zastępuje ten obraz obrazem z podanego adresu URL. |
reset | Over | Przywraca ten obraz do jego pierwotnych wymiarów. |
set | Over | Ustawia tekst alternatywny dla tego obrazu. |
set | Over | Ustawia tytuł tekstu alternatywnego dla tego obrazu. |
set | Over | Ustawia komórkę, w której obraz jest zakotwiczony. |
set | Over | Ustawia przesunięcie poziome w pikselach od komórki kotwicy. |
set | Over | Ustawia przesunięcie pionowe w pikselach od komórki kotwicznej. |
set | Over | Ustawia rzeczywistą wysokość tego obrazu w pikselach. |
set | Over | Ustawia rzeczywistą szerokość tego obrazu w pikselach. |
Szczegółowa dokumentacja
assign Script(functionName)
Przypisuje do tego obrazu funkcję o określonej nazwie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
function | String | Nazwa podanej funkcji. Musi to być publiczna funkcja najwyższego poziomu, a nie funkcja kończąca się podkreśleniem, np. private . |
Powrót
Over
– 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
get Alt Text Description()
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
get Alt Text Title()
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
get Anchor Cell()
get Anchor Cell XOffset()
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
get Anchor Cell YOffset()
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
get Height()
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
get Inherent Height()
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
get Inherent Width()
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
get Script()
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
get Sheet()
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
get Url()
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
get Width()
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 Blob
. Maksymalny obsługiwany rozmiar bloba to 2 MB.
Parametry
Nazwa | Typ | Opis |
---|---|---|
blob | Blob | Nowy obraz jako obiekt Blob. |
Powrót
Over
– 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
Nazwa | Typ | Opis |
---|---|---|
url | String | Adres URL nowego obrazu. |
Powrót
Over
– 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
reset Size()
Przywraca ten obraz do jego pierwotnych wymiarów.
Powrót
Over
– 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
set Alt Text Description(description)
Ustawia tekst alternatywny dla tego obrazu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
description | String | Nowy tekst alternatywny obrazu. |
Powrót
Over
– 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
set Alt Text Title(title)
Ustawia tytuł tekstu alternatywnego dla tego obrazu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | Nowy tytuł tekstu alternatywnego obrazu. |
Powrót
Over
– 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
set Anchor Cell(cell)
Ustawia komórkę, w której obraz jest zakotwiczony.
Parametry
Nazwa | Typ | Opis |
---|---|---|
cell | Range | Nowa komórka kotwicy. |
Powrót
Over
– 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
set Anchor Cell XOffset(offset)
Ustawia przesunięcie poziome w pikselach od komórki kotwicy.
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Integer | Nowy przesunięcie poziome pikseli. |
Powrót
Over
– 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
set Anchor Cell YOffset(offset)
Ustawia przesunięcie pionowe w pikselach od komórki kotwicznej.
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Integer | Nowe pionowe przesunięcie pikseli. |
Powrót
Over
– 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
set Height(height)
Ustawia rzeczywistą wysokość tego obrazu w pikselach.
Parametry
Nazwa | Typ | Opis |
---|---|---|
height | Integer | Pożądana wysokość w pikselach. |
Powrót
Over
– 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
set Width(width)
Ustawia rzeczywistą szerokość tego obrazu w pikselach.
Parametry
Nazwa | Typ | Opis |
---|---|---|
width | Integer | Pożądana szerokość w pikselach. |
Powrót
Over
– 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