Class OverGridImage

Obraz powyżej

Reprezentuje obraz nad siatką w arkuszu kalkulacyjnym.

Metody

MetodaZwracany typKrótki opis
assignScript(functionName)OverGridImagePowoduje przypisanie do obrazu funkcji o określonej nazwie.
getAltTextDescription()StringZwraca opis alternatywny tekstu dla tego obrazu.
getAltTextTitle()StringZwraca tytuł alternatywnego tekstu obrazu.
getAnchorCell()RangeZwraca komórkę, w której obraz jest zakotwiczony.
getAnchorCellXOffset()IntegerZwraca odsunięcie piksela w poziomie od komórki zakotwiczonej.
getAnchorCellYOffset()IntegerZwraca odsunięcie pionowych pikseli od komórki zakotwiczonej.
getHeight()IntegerZwraca rzeczywistą wysokość obrazu w pikselach.
getInherentHeight()IntegerZwraca rzeczywistą wysokość obrazu w pikselach.
getInherentWidth()IntegerZwraca rzeczywistą wysokość obrazu w pikselach.
getScript()StringZwraca nazwę funkcji przypisanej do tego obrazu.
getSheet()SheetZwraca arkusz, w którym pojawia się obraz.
getUrl()StringPobiera źródłowy adres URL obrazu; zwraca null, jeśli adres URL jest niedostępny.
getWidth()IntegerZwraca rzeczywistą szerokość obrazu w pikselach.
remove()voidUsuwa ten obraz z arkusza kalkulacyjnego.
replace(blob)OverGridImageZastępuje ten obraz obrazem podanym w polu BlobSource.
replace(url)OverGridImageZastępuje ten obraz obrazem z określonego adresu URL.
resetSize()OverGridImageResetuje obraz do odpowiednich wymiarów.
setAltTextDescription(description)OverGridImageUstawia opis alternatywny tekstu na obrazie.
setAltTextTitle(title)OverGridImageUstawia tytuł alternatywnego tekstu obrazu.
setAnchorCell(cell)OverGridImageUstawia komórkę, w której obraz jest zakotwiczony.
setAnchorCellXOffset(offset)OverGridImageUstawia odsunięcie piksela w poziomie od komórki zakotwiczonej.
setAnchorCellYOffset(offset)OverGridImageUstawia przesunięcie piksela w pionie od komórki zakotwiczonej.
setHeight(height)OverGridImageUstawia rzeczywistą wysokość obrazu w pikselach.
setWidth(width)OverGridImageUstawia rzeczywistą szerokość obrazu w pikselach.

Szczegółowa dokumentacja

assignScript(functionName)

Powoduje przypisanie do obrazu funkcji o określonej nazwie.

Parametry

NazwaTypOpis
functionNameStringNazwa określonej funkcji. Musi to być publiczna funkcja najwyższego poziomu, a nie ta, która kończy się znakiem podkreślenia, np. privateFunction_.

Zwróć

OverGridImage – ten obraz do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getAltTextDescription()

Zwraca opis alternatywny tekstu dla tego obrazu.

Zwróć

String – opis tekstowy alternatywny

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getAltTextTitle()

Zwraca tytuł alternatywnego tekstu obrazu.

Zwróć

String – tytuł tekstu alternatywnego.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 obraz jest zakotwiczony.

Zwróć

Range – komórka zakotwiczenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getAnchorCellXOffset()

Zwraca odsunięcie piksela w poziomie od komórki zakotwiczonej.

Zwróć

Integer – przesunięcie w poziomie (w pikselach).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getAnchorCellYOffset()

Zwraca odsunięcie pionowych pikseli od komórki zakotwiczonej.

Zwróć

Integer – przesunięcie obrazu w pionie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getHeight());
}

Zwróć

Integer – wysokość obrazu w pikselach,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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.

Zwróć

Integer – rzeczywista wysokość w pikselach.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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.

Zwróć

Integer – rzeczywista szerokość w pikselach.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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.

Zwróć

String – nazwa funkcji;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 pojawia 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());
}

Zwróć

Sheet – arkusz, na którym pojawia się obraz.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 null, jeśli adres URL jest niedostępny. Jeśli obraz został wstawiony przez URL za pomocą interfejsu API, ta metoda zwróci URL podany podczas wstawiania obrazu.

Zwróć

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getWidth());
}

Zwróć

Integer – szerokość obrazu w pikselach;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 skutkuje błędem 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 korzystające z tej metody wymagają autoryzacji przy użyciu 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 podanym w polu BlobSource. Maksymalny obsługiwany rozmiar bloba to 2 MB.

Parametry

NazwaTypOpis
blobBlobSourceNowy obraz jako Blob.

Zwróć

OverGridImage – ten obraz do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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

NazwaTypOpis
urlStringAdres URL nowego obrazu.

Zwróć

OverGridImage – ten obraz do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

resetSize()

Resetuje obraz do odpowiednich wymiarów.

Zwróć

OverGridImage – ten obraz do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setAltTextDescription(description)

Ustawia opis alternatywny tekstu na obrazie.

Parametry

NazwaTypOpis
descriptionStringNowy opis alternatywny tekstu obrazu.

Zwróć

OverGridImage – ten obraz do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setAltTextTitle(title)

Ustawia tytuł alternatywnego tekstu obrazu.

Parametry

NazwaTypOpis
titleStringNowy tytuł alternatywnego tekstu obrazu.

Zwróć

OverGridImage – ten obraz do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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

NazwaTypOpis
cellRangeNowa komórka zakotwiczenia.

Zwróć

OverGridImage – ten obraz do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setAnchorCellXOffset(offset)

Ustawia odsunięcie piksela w poziomie od komórki zakotwiczonej.

Parametry

NazwaTypOpis
offsetIntegerOdsunięcie piksela w poziomie.

Zwróć

OverGridImage – ten obraz do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setAnchorCellYOffset(offset)

Ustawia przesunięcie piksela w pionie od komórki zakotwiczonej.

Parametry

NazwaTypOpis
offsetIntegerNowe przesunięcie pikseli w pionie.

Zwróć

OverGridImage – ten obraz do łańcucha.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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

NazwaTypOpis
heightIntegerŻądana wysokość w pikselach.

Zwróć

OverGridImage – obraz związany z łańcuchami.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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

NazwaTypOpis
widthIntegerWybrana szerokość w pikselach.

Zwróć

OverGridImage – obraz związany z łańcuchami.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets