Class OverGridImage

OverGridImage

Representa uma imagem sobre a grade em uma planilha.

Métodos

MétodoTipo de retornoBreve descrição
assignScript(functionName)OverGridImageAtribui a função com o nome especificado à imagem.
getAltTextDescription()StringRetorna a descrição do texto alternativo para esta imagem.
getAltTextTitle()StringRetorna o título do texto alternativo para esta imagem.
getAnchorCell()RangeRetorna a célula em que uma imagem está ancorada.
getAnchorCellXOffset()IntegerRetorna o deslocamento de pixel horizontal da célula âncora.
getAnchorCellYOffset()IntegerRetorna o deslocamento de pixels verticais da célula âncora.
getHeight()IntegerRetorna a altura real desta imagem em pixels.
getInherentHeight()IntegerRetorna a altura inerente desta imagem em pixels.
getInherentWidth()IntegerRetorna a altura inerente desta imagem em pixels.
getScript()StringRetorna o nome da função atribuída a essa imagem.
getSheet()SheetRetorna a página em que a imagem aparece.
getUrl()StringRecebe o URL de origem da imagem. Retorna null se o URL não estiver disponível.
getWidth()IntegerRetorna a largura real dessa imagem em pixels.
remove()voidExclui essa imagem da planilha.
replace(blob)OverGridImageSubstitui essa imagem pela especificada pelo BlobSource fornecido.
replace(url)OverGridImageSubstitui esta imagem pela do URL especificado.
resetSize()OverGridImageRedefine a imagem com as dimensões inerentes.
setAltTextDescription(description)OverGridImageDefine a descrição do texto alternativo para a imagem.
setAltTextTitle(title)OverGridImageDefine o título do texto alternativo para a imagem.
setAnchorCell(cell)OverGridImageDefine a célula em que uma imagem está ancorada.
setAnchorCellXOffset(offset)OverGridImageDefine o deslocamento horizontal dos pixels a partir da célula âncora.
setAnchorCellYOffset(offset)OverGridImageDefine o deslocamento de pixels verticais a partir da célula âncora.
setHeight(height)OverGridImageDefine a altura real desta imagem em pixels.
setWidth(width)OverGridImageDefine a largura real dessa imagem em pixels.

Documentação detalhada

assignScript(functionName)

Atribui a função com o nome especificado à imagem.

Parâmetros

NomeTipoDescrição
functionNameStringNome da função especificada. Precisa ser uma função pública de nível superior, não uma que termine em sublinhado, como privateFunction_.

Retorno

OverGridImage: esta imagem para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getAltTextDescription()

Retorna a descrição do texto alternativo para esta imagem.

Retorno

String: a descrição do texto alternativo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getAltTextTitle()

Retorna o título do texto alternativo para esta imagem.

Retorno

String: o título do texto alternativo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getAnchorCell()

Retorna a célula em que uma imagem está ancorada.

Retorno

Range: a célula âncora.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getAnchorCellXOffset()

Retorna o deslocamento de pixel horizontal da célula âncora.

Retorno

Integer: o deslocamento horizontal dos pixels.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getAnchorCellYOffset()

Retorna o deslocamento de pixels verticais da célula âncora.

Retorno

Integer: o deslocamento vertical dos pixels.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getHeight()

Retorna a altura real desta imagem em pixels.

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

Retorno

Integer: a altura da imagem em pixels.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getInherentHeight()

Retorna a altura inerente desta imagem em pixels.

Retorno

Integer: a altura inerente em pixels.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getInherentWidth()

Retorna a altura inerente desta imagem em pixels.

Retorno

Integer: a largura inerente em pixels.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getScript()

Retorna o nome da função atribuída a essa imagem.

Retorno

String: o nome da função.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getSheet()

Retorna a página em que a imagem aparece.

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

Retorno

Sheet: a página em que a imagem aparece.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getUrl()

Recebe o URL de origem da imagem. Retorna null se o URL não estiver disponível. Se a imagem tiver sido inserida pelo URL usando uma API, esse método retornará o URL fornecido durante a inserção da imagem.

Retorno

String: o URL da imagem, se disponível. Retorna null se a imagem não estiver disponível ou não tiver um URL de origem.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getWidth()

Retorna a largura real dessa imagem em pixels.

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

Retorno

Integer: a largura da imagem em pixels.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

remove()

Exclui essa imagem da planilha. Qualquer outra operação na imagem resulta em um erro de script.

// Deletes all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  images[i].remove();
}

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

replace(blob)

Substitui essa imagem pela especificada pelo BlobSource fornecido. O tamanho máximo de blob com suporte é 2 MB.

Parâmetros

NomeTipoDescrição
blobBlobSourceA nova imagem como um Blob.

Retorno

OverGridImage: esta imagem para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

replace(url)

Substitui esta imagem pela do URL especificado.

Parâmetros

NomeTipoDescrição
urlStringO URL da nova imagem.

Retorno

OverGridImage: esta imagem para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

resetSize()

Redefine a imagem com as dimensões inerentes.

Retorno

OverGridImage: esta imagem para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

setAltTextDescription(description)

Define a descrição do texto alternativo para a imagem.

Parâmetros

NomeTipoDescrição
descriptionStringA nova descrição do texto alternativo para a imagem.

Retorno

OverGridImage: esta imagem para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

setAltTextTitle(title)

Define o título do texto alternativo para a imagem.

Parâmetros

NomeTipoDescrição
titleStringO novo título do texto alternativo para a imagem.

Retorno

OverGridImage: esta imagem para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

setAnchorCell(cell)

Define a célula em que uma imagem está ancorada.

Parâmetros

NomeTipoDescrição
cellRangeA nova célula âncora.

Retorno

OverGridImage: esta imagem para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

setAnchorCellXOffset(offset)

Define o deslocamento horizontal dos pixels a partir da célula âncora.

Parâmetros

NomeTipoDescrição
offsetIntegerO novo deslocamento de pixel horizontal.

Retorno

OverGridImage: esta imagem para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

setAnchorCellYOffset(offset)

Define o deslocamento de pixels verticais a partir da célula âncora.

Parâmetros

NomeTipoDescrição
offsetIntegerO novo deslocamento vertical de pixels.

Retorno

OverGridImage: esta imagem para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

setHeight(height)

Define a altura real desta imagem em pixels.

Parâmetros

NomeTipoDescrição
heightIntegerA altura desejada em pixels.

Retorno

OverGridImage: a imagem para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

setWidth(width)

Define a largura real dessa imagem em pixels.

Parâmetros

NomeTipoDescrição
widthIntegerA largura desejada em pixels.

Retorno

OverGridImage: a imagem para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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