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 de função especificado à imagem.
`getAltTextDescription()`	`String`	Retorna a descrição do texto alternativo para esta imagem.
`getAltTextTitle()`	`String`	Retorna o título do texto alternativo da imagem.
`getAnchorCell()`	`Range`	Retorna a célula em que uma imagem está ancorada.
`getAnchorCellXOffset()`	`Integer`	Retorna o deslocamento horizontal de pixels da célula âncora.
`getAnchorCellYOffset()`	`Integer`	Retorna o deslocamento de pixel vertical da célula âncora.
`getHeight()`	`Integer`	Retorna a altura real da imagem em pixels.
`getInherentHeight()`	`Integer`	Retorna a altura inerente da imagem em pixels.
`getInherentWidth()`	`Integer`	Retorna a altura inerente da imagem em pixels.
`getScript()`	`String`	Retorna o nome da função atribuída a essa imagem.
`getSheet()`	`Sheet`	Retorna a página em que a imagem aparece.
`getUrl()`	`String`	Extrai o URL de origem da imagem. Retornará `null` se o URL não estiver disponível.
`getWidth()`	`Integer`	Retorna a largura real da imagem em pixels.
`remove()`	`void`	Exclui esta imagem da planilha.
`replace(blob)`	`OverGridImage`	Substitui essa imagem pela especificada pelo `BlobSource` fornecido.
`replace(url)`	`OverGridImage`	Substitui essa 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 esta imagem.
`setAltTextTitle(title)`	`OverGridImage`	Define o título do texto alternativo para esta 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 âncora.
`setAnchorCellYOffset(offset)`	`OverGridImage`	Define o deslocamento vertical de pixels da célula âncora.
`setHeight(height)`	`OverGridImage`	Define a altura real da imagem em pixels.
`setWidth(width)`	`OverGridImage`	Define a largura real da imagem em pixels.

Documentação detalhada

`assignScript(functionName)`

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

Parâmetros

Nome	Tipo	Descrição
`functionName`	`String`	O nome da função que está sendo especificada. Precisa ser um nível superior público diferente de um que termina em sublinhado, como `privateFunction_`.

Retornar

OverGridImage: esta imagem, para encadeamento.

Autorização

Os scripts que usam esse método precisam de 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.

Retornar

String: é a descrição do texto alternativo.

Autorização

Os scripts que usam esse método precisam de 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 da imagem.

Retornar

String: o título do texto alternativo.

Autorização

Os scripts que usam esse método precisam de 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 precisam de 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 de pixels da célula âncora.

Retornar

Integer: o deslocamento horizontal dos pixels.

Autorização

Os scripts que usam esse método precisam de 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 pixel vertical da célula âncora.

Retornar

Integer: o deslocamento vertical dos pixels.

Autorização

Os scripts que usam esse método precisam de 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
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var 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 precisam de 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 da imagem em pixels.

Retornar

Integer: a altura inerente em pixels.

Autorização

Os scripts que usam esse método precisam de 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 da imagem em pixels.

Retornar

Integer: a largura inerente em pixels.

Autorização

Os scripts que usam esse método precisam de 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.

Retornar

String: o nome da função.

Autorização

Os scripts que usam esse método precisam de 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());
}

Retornar

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

Autorização

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

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

`getUrl()`

Extrai o URL de origem da imagem. Retornará null se o URL não estiver disponível. Se a imagem foi inserido pelo URL usando uma API, esse método retorna o URL fornecido durante a inserção de imagem.

Retornar

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

Autorização

Os scripts que usam esse método precisam de 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
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var 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 precisam de autorização com um ou mais dos seguintes escopos:

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

`remove()`

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

// 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 precisam de 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 máximo com suporte é de 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 precisam de 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 essa 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 precisam de 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 precisam de 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 esta imagem.

Parâmetros

Nome	Tipo	Descrição
`description`	`String`	A nova descrição de texto alternativo para a imagem.

Retornar

OverGridImage: esta imagem, para encadeamento.

Autorização

Os scripts que usam esse método precisam de 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 esta imagem.

Parâmetros

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

Retornar

OverGridImage: esta imagem, para encadeamento.

Autorização

Os scripts que usam esse método precisam de 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 âncora.

Retornar

OverGridImage: esta imagem, para encadeamento.

Autorização

Os scripts que usam esse método precisam de 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 âncora.

Parâmetros

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

Retornar

OverGridImage: esta imagem, para encadeamento.

Autorização

Os scripts que usam esse método precisam de 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 de pixels da célula âncora.

Parâmetros

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

Retornar

OverGridImage: esta imagem, para encadeamento.

Autorização

Os scripts que usam esse método precisam de 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 a ser encadeada.

Autorização

Os scripts que usam esse método precisam de 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 a ser encadeada.

Autorização

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

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