Class OverGridImage

OverGridImage

Reprezentuje obraz na siatce w arkuszu kalkulacyjnym.

Metody

MetodaZwracany typKrótki opis
assignScript(functionName)OverGridImagePrzypisuje do tego obrazu funkcję o podanej nazwie funkcji.
getAltTextDescription()StringZwraca tekst alternatywny obrazu.
getAltTextTitle()StringZwraca tytuł tekstu alternatywnego obrazu.
getAnchorCell()RangeZwraca komórkę, w której obraz jest zakotwiczony.
getAnchorCellXOffset()IntegerZwraca przesunięcie w pikselach w poziomie od komórki zakotwiczonej.
getAnchorCellYOffset()IntegerZwraca przesunięcie w pionie w pikselach od komórki kotwicy.
getHeight()IntegerZwraca faktyczną 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()SheetZwraca arkusz, w którym znajduje się ten obraz.
getUrl()StringPobiera źródłowy adres URL obrazu. jeśli adres URL jest niedostępny, zwraca wartość null.
getWidth()IntegerZwraca rzeczywistą szerokość obrazu w pikselach.
remove()voidUsuwa obraz z arkusza kalkulacyjnego.
replace(blob)OverGridImageZastępuje ten obraz obrazem określonym w atrybucie BlobSource.
replace(url)OverGridImageZastępuje ten obraz obrazem z podanego adresu URL.
resetSize()OverGridImageResetuje obraz do pierwotnych wymiarów.
setAltTextDescription(description)OverGridImageUstawia tekst alternatywny dla tego obrazu.
setAltTextTitle(title)OverGridImageUstawia tytuł tekstu alternatywnego dla tego obrazu.
setAnchorCell(cell)OverGridImageUstawia komórkę, w której obraz jest zakotwiczony.
setAnchorCellXOffset(offset)OverGridImageOkreśla odsunięcie w pikselach w poziomie od komórki zakotwiczonej.
setAnchorCellYOffset(offset)OverGridImageOkreśla odsunięcie w pikselach od komórki zakotwiczonej w pionie.
setHeight(height)OverGridImageUstawia rzeczywistą wysokość obrazu w pikselach.
setWidth(width)OverGridImageUstawia rzeczywistą szerokość obrazu w pikselach.

Szczegółowa dokumentacja

assignScript(functionName)

Przypisuje do tego obrazu funkcję o podanej nazwie funkcji.

Parametry

NazwaTypOpis
functionNameStringNazwa określonej funkcji. Musi to być publiczny najwyższy poziom funkcji, a nie takiej, która kończy się podkreśleniem, np. privateFunction_.

Powrót

OverGridImage – obraz do łańcuchów.

Autoryzacja

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 tekst alternatywny obrazu.

Powrót

String – opis tekstu alternatywnego.

Autoryzacja

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.

Powrót

String – tytuł tekstu alternatywnego.

Autoryzacja

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.

Powrót

Range – komórka kotwicy.

Autoryzacja

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 przesunięcie w pikselach w poziomie od komórki zakotwiczonej.

Powrót

Integer – przesunięcie w pikselach w poziomie.

Autoryzacja

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 przesunięcie w pionie w pikselach od komórki kotwicy.

Powrót

Integer – przesunięcie w pionie w pikselach.

Autoryzacja

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 faktyczną 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());
}

Powrót

Integer – wysokość obrazu w pikselach.

Autoryzacja

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.

Powrót

Integer – nieodłączna wysokość w pikselach.

Autoryzacja

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.

Powrót

Integer – nieodłączna szerokość w pikselach.

Autoryzacja

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.

Powrót

String – nazwa funkcji.

Autoryzacja

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

Zwraca arkusz, w którym znajduje 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());
}

Powrót

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

Autoryzacja

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. jeśli adres URL jest niedostępny, zwraca wartość null. Jeśli obraz był wstawiany przez adres 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 wartość null, jeśli obraz jest niedostępny lub nie mają URL źródła.

Autoryzacja

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());
}

Powrót

Integer – szerokość obrazu w pikselach.

Autoryzacja

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 dalsza operacja na obrazie spowoduje powstanie 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 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 w atrybucie BlobSource. Maksymalna wartość rozmiar obsługiwanego bloba to 2 MB.

Parametry

NazwaTypOpis
blobBlobSourceNowy obraz jako obiekt blob.

Powrót

OverGridImage – obraz do łańcuchów.

Autoryzacja

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 podanego adresu URL.

Parametry

NazwaTypOpis
urlStringAdres URL nowego obrazu.

Powrót

OverGridImage – obraz do łańcuchów.

Autoryzacja

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

Resetuje obraz do pierwotnych wymiarów.

Powrót

OverGridImage – obraz do łańcuchów.

Autoryzacja

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 dla tego obrazu.

Parametry

NazwaTypOpis
descriptionStringNowy tekst alternatywny obrazu.

Powrót

OverGridImage – obraz do łańcuchów.

Autoryzacja

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 dla tego obrazu.

Parametry

NazwaTypOpis
titleStringNowy tekst alternatywny obrazu.

Powrót

OverGridImage – obraz do łańcuchów.

Autoryzacja

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 kotwicy.

Powrót

OverGridImage – obraz do łańcuchów.

Autoryzacja

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 w pikselach w poziomie od komórki zakotwiczonej.

Parametry

NazwaTypOpis
offsetIntegerNowe poziome przesunięcie w pikselach.

Powrót

OverGridImage – obraz do łańcuchów.

Autoryzacja

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 w pikselach od komórki zakotwiczonej w pionie.

Parametry

NazwaTypOpis
offsetIntegerNowe przesunięcie w pionie w pikselach.

Powrót

OverGridImage – obraz do łańcuchów.

Autoryzacja

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 rzeczywistą wysokość obrazu w pikselach.

Parametry

NazwaTypOpis
heightIntegerWymagana wysokość w pikselach.

Powrót

OverGridImage – obraz służący do tworzenia łańcuchów.

Autoryzacja

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.

Powrót

OverGridImage – obraz służący do tworzenia łańcuchów.

Autoryzacja

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