Esta página foi traduzida pela API Cloud Translation.

Class OverGridImage

Representa uma imagem sobre a grade em uma planilha.

Métodos

Método	Tipo de retorno	Breve descrição
`assignScript(functionName)`	`OverGridImage`	Atribui a função com o nome especificado a esta imagem.
`getAltTextDescription()`	`String`	Retorna a descrição do texto alternativo para essa imagem.
`getAltTextTitle()`	`String`	Retorna o título do texto alternativo para essa imagem.
`getAnchorCell()`	`Range`	Retorna a célula em que uma imagem está ancorada.
`getAnchorCellXOffset()`	`Integer`	Retorna o deslocamento horizontal em pixels da célula de âncora.
`getAnchorCellYOffset()`	`Integer`	Retorna o deslocamento vertical em pixels da célula de âncora.
`getHeight()`	`Integer`	Retorna a altura real da imagem em pixels.
`getInherentHeight()`	`Integer`	Retorna a altura inerente dessa imagem em pixels.
`getInherentWidth()`	`Integer`	Retorna a altura inerente dessa imagem em pixels.
`getScript()`	`String`	Retorna o nome da função atribuída a esta imagem.
`getSheet()`	`Sheet`	Retorna a planilha em que a imagem aparece.
`getWidth()`	`Integer`	Retorna a largura real da imagem em pixels.
`remove()`	`void`	Exclui essa imagem da planilha.
`replace(blob)`	`OverGridImage`	Substitui esta imagem pela especificada pelo `BlobSource` fornecido.
`replace(url)`	`OverGridImage`	Substitui esta imagem pela do URL especificado.
`resetSize()`	`OverGridImage`	Redefine a imagem para as dimensões inerentes.
`setAltTextDescription(description)`	`OverGridImage`	Define a descrição do texto alternativo para essa imagem.
`setAltTextTitle(title)`	`OverGridImage`	Define o título do texto alternativo para essa imagem.
`setAnchorCell(cell)`	`OverGridImage`	Define a célula em que uma imagem está ancorada.
`setAnchorCellXOffset(offset)`	`OverGridImage`	Define o deslocamento horizontal de pixels da célula de âncora.
`setAnchorCellYOffset(offset)`	`OverGridImage`	Define o deslocamento vertical em pixels da célula de âncora.
`setHeight(height)`	`OverGridImage`	Define a altura real da imagem em pixels.
`setWidth(width)`	`OverGridImage`	Define a largura real da imagem em pixels.

Métodos obsoletos

Método	Tipo de retorno	Breve descrição
`getUrl()`	`String`	Consegue o URL de origem da imagem.

Documentação detalhada

`assignScript(functionName)`

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

Parâmetros

Nome	Tipo	Descrição
`functionName`	`String`	O nome da função especificada. Ela precisa ser uma função pública de nível superior, não uma que termine em sublinhado, como `privateFunction_`.

Retornar

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 essa imagem.

Retornar

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 essa imagem.

Retornar

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.

Retornar

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 horizontal em pixels da célula de âncora.

Retornar

Integer: o deslocamento horizontal 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

`getAnchorCellYOffset()`

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

Retornar

Integer: o deslocamento vertical 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

`getHeight()`

Retorna a altura real da imagem em pixels.

// Logs the height of all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  Logger.log(images[i].getHeight());
}

Retornar

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 dessa imagem em pixels.

Retornar

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 dessa imagem em pixels.

Retornar

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 esta imagem.

Retornar

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 planilha em que a imagem aparece.

// Logs the parent sheet of all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  Logger.log(images[i].getSheet());
}

Retornar

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

`getWidth()`

Retorna a largura real da imagem em pixels.

// Logs the width of all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  Logger.log(images[i].getWidth());
}

Retornar

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
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let 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 esta imagem pela especificada pelo BlobSource fornecido. O tamanho máximo do blob aceito é 2 MB.

Parâmetros

Nome	Tipo	Descrição
`blob`	`BlobSource`	A nova imagem como um blob.

Retornar

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

Nome	Tipo	Descrição
`url`	`String`	O URL da nova imagem.

Retornar

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 para as dimensões inerentes.

Retornar

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 essa imagem.

Parâmetros

Nome	Tipo	Descrição
`description`	`String`	A nova descrição do texto alternativo da imagem.

Retornar

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 essa imagem.

Parâmetros

Nome	Tipo	Descrição
`title`	`String`	O novo título do texto alternativo da imagem.

Retornar

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

Nome	Tipo	Descrição
`cell`	`Range`	A nova célula de âncora.

Retornar

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 de pixels da célula de âncora.

Parâmetros

Nome	Tipo	Descrição
`offset`	`Integer`	O novo deslocamento horizontal em pixels.

Retornar

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 vertical em pixels da célula de âncora.

Parâmetros

Nome	Tipo	Descrição
`offset`	`Integer`	O novo deslocamento vertical em pixels.

Retornar

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 da imagem em pixels.

Parâmetros

Nome	Tipo	Descrição
`height`	`Integer`	A altura desejada em pixels.

Retornar

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 da imagem em pixels.

Parâmetros

Nome	Tipo	Descrição
`width`	`Integer`	A largura desejada em pixels.

Retornar

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

Métodos obsoletos

`getUrl()`

Obsoleto. Para a maioria das imagens recém-inseridas, o URL da origem não está disponível.

Consegue o URL de origem da imagem. Retorna uma string vazia se o URL estiver indisponível. Para a maioria das imagens novamente inseridas, o URL da origem fica indisponível, independentemente de como a imagem é inserida.

Retornar

String: o URL de origem da imagem, se disponível. Caso contrário, retorna uma string vazia.

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