Class OverGridImage

OverGridImage

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 opis tekstu alternatywnego obrazu.
getAltTextTitle()StringZwraca tytuł tekstu alternatywnego obrazu.
getAnchorCell()RangeZwraca komórkę, w której obraz jest zakotwiczony.
getAnchorCellXOffset()IntegerZwraca odsunięcie piksela w poziomie od komórki zakotwiczenia.
getAnchorCellYOffset()IntegerZwraca odsunięcie piksela w pionie od komórki zakotwiczenia.
getHeight()IntegerZwraca rzeczywistą wysokość obrazu w pikselach.
getInherentHeight()IntegerZwraca nieodłączną wysokość obrazu w pikselach.
getInherentWidth()IntegerZwraca nieodłączną wysokość obrazu w pikselach.
getScript()StringZwraca nazwę funkcji przypisanej do tego obrazu.
getSheet()SheetWyświetla arkusz, w którym pojawia się ten obraz.
getUrl()StringPobiera źródłowy adres URL obrazu. Zwraca wartość null, jeśli adres URL jest niedostępny.
getWidth()IntegerZwraca rzeczywistą szerokość obrazu w pikselach.
remove()voidUsuwa obraz z arkusza kalkulacyjnego.
replace(blob)OverGridImageZastępuje ten obraz obrazem określonym przez podaną wartość BlobSource.
replace(url)OverGridImageZastępuje ten obraz obrazem z określonego adresu URL.
resetSize()OverGridImagePowoduje przywrócenie podstawowych wymiarów obrazu.
setAltTextDescription(description)OverGridImageUstawia tekst alternatywny opisu dla obrazu.
setAltTextTitle(title)OverGridImageUstawia tytuł tekstu alternatywnego obrazu.
setAnchorCell(cell)OverGridImageUstawia komórkę, w której obraz jest zakotwiczony.
setAnchorCellXOffset(offset)OverGridImageOkreśla odsunięcie piksela w poziomie od komórki zakotwiczenia.
setAnchorCellYOffset(offset)OverGridImageOkreśla odsunięcie piksela w pionie od komórki zakotwiczenia.
setHeight(height)OverGridImageUstawia faktyczną wysokość obrazu w pikselach.
setWidth(width)OverGridImageUstawia rzeczywistą szerokość obrazu w pikselach.

Szczegółowa dokumentacja

assignScript(functionName)

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

Parametry

NazwaTypOpis
functionNameStringNazwa 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()

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

Powroty

Range – komórka zakotwiczenia.

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

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

NazwaTypOpis
blobBlobSourceNowy 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

NazwaTypOpis
urlStringAdres 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

NazwaTypOpis
descriptionStringNowy 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

NazwaTypOpis
titleStringNowy 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

NazwaTypOpis
cellRangeNowa 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

NazwaTypOpis
offsetIntegerNowe 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

NazwaTypOpis
offsetIntegerNowa 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

NazwaTypOpis
heightIntegerWymagana 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

NazwaTypOpis
widthIntegerŻą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