Class Image

Imagem

Um PageElement que representa uma imagem.

Métodos

MétodoTipo de retornoBreve descrição
alignOnPage(alignmentPosition)ImageAlinha o elemento à posição de alinhamento especificada na página.
bringForward()ImageTraz o elemento da página para a frente por um elemento.
bringToFront()ImageTraz o elemento de página para a frente da página.
duplicate()PageElementDuplica o elemento de página.
getAs(contentType)BlobRetorne os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado.
getBlob()BlobRetorne os dados dentro dessa imagem como um blob.
getBorder()BorderRetorna o Border da imagem.
getConnectionSites()ConnectionSite[]Retorna a lista de ConnectionSites no elemento de página ou uma lista vazia se esse elemento não tiver sites de conexão.
getContentUrl()StringRecebe um URL para a imagem.
getDescription()StringRetorna a descrição do texto alternativo do elemento de página.
getHeight()NumberRecebe a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando o elemento não tem rotação.
getInherentHeight()NumberRetorna a altura inerente do elemento em pontos.
getInherentWidth()NumberRetorna a largura inerente do elemento em pontos.
getLeft()NumberRetorna a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
getLink()LinkRetorna Link ou null se não houver um link.
getObjectId()StringRetorna o ID exclusivo desse objeto.
getPageElementType()PageElementTypeRetorna o tipo de elemento de página, representado como um tipo enumerado PageElementType.
getParentGroup()GroupRetorna o grupo a que esse elemento de página pertence ou null se o elemento não estiver em um grupo.
getParentPage()PageRetorna a página em que esse elemento de página está.
getParentPlaceholder()PageElementRetorna o elemento de página pai do marcador de posição.
getPlaceholderIndex()IntegerRetorna o índice da imagem do marcador de posição.
getPlaceholderType()PlaceholderTypeRetorna o tipo de marcador da imagem ou PlaceholderType.NONE se a forma não for um marcador.
getRotation()NumberRetorna o ângulo de rotação no sentido horário do elemento em torno do centro em graus, no qual zero grau significa sem rotação.
getSourceUrl()StringExtrai o URL de origem da imagem, se disponível.
getTitle()StringRetorna o título do texto alternativo do elemento de página.
getTop()NumberAcessa a posição vertical do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
getTransform()AffineTransformRetorna a transformação do elemento de página.
getWidth()NumberRetorna a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando o elemento não tem rotação.
preconcatenateTransform(transform)ImagePreconcateiza a transformação fornecida à transformação atual do elemento de página.
remove()voidRemove o elemento de página.
removeLink()voidRemove um Link.
replace(blobSource)ImageSubstitui essa imagem por uma descrita por um objeto BlobSource.
replace(blobSource, crop)ImageSubstitui essa imagem por uma descrita por um objeto Image, cortando-a opcionalmente para caber.
replace(imageUrl)ImageSubstitui essa imagem por outra imagem transferida por download do URL fornecido.
replace(imageUrl, crop)ImageSubstitui essa imagem por outra imagem transferida por download do URL fornecido, cortando-a opcionalmente para que se encaixe.
scaleHeight(ratio)ImageRedimensiona a altura do elemento pela proporção especificada.
scaleWidth(ratio)ImageRedimensiona a largura do elemento pela proporção especificada.
select()voidSeleciona apenas o PageElement na apresentação ativa e remove qualquer seleção anterior.
select(replace)voidSeleciona o PageElement na apresentação ativa.
sendBackward()ImageEnvia o elemento de página para trás na página por um elemento.
sendToBack()ImageEnvia o elemento de página para o fundo da página.
setDescription(description)ImageDefine a descrição do texto alternativo do elemento de página.
setHeight(height)ImageDefine a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando o elemento não tem rotação.
setLeft(left)ImageDefine a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
setLinkSlide(slideIndex)LinkDefine um Link para o Slide especificado usando o índice baseado em zero do slide.
setLinkSlide(slide)LinkDefine um Link para o Slide especificado, o link é definido pelo ID do slide fornecido.
setLinkSlide(slidePosition)LinkDefine um Link para o Slide especificado usando a posição relativa do slide.
setLinkUrl(url)LinkDefine um Link para a string de URL não vazia fornecida.
setRotation(angle)ImageDefine o ângulo de rotação no sentido horário do elemento em torno do centro em graus.
setTitle(title)ImageDefine o título do texto alternativo do elemento de página.
setTop(top)ImageDefine a posição vertical do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
setTransform(transform)ImageDefine a transformação do elemento de página com a transformação fornecida.
setWidth(width)ImageDefine a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando o elemento não tem rotação.

Documentação detalhada

alignOnPage(alignmentPosition)

Alinha o elemento à posição de alinhamento especificada na página.

Parâmetros

NomeTipoDescrição
alignmentPositionAlignmentPositionA posição a que este elemento de página será alinhado na página.

Retorno

Image: esse elemento de página para encadeamento.


bringForward()

Traz o elemento da página para a frente por um elemento.

O elemento de página não pode estar em um grupo.

Retorno

Image: esse elemento de página 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

bringToFront()

Traz o elemento de página para a frente da página.

O elemento de página não pode estar em um grupo.

Retorno

Image: esse elemento de página 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

duplicate()

Duplica o elemento de página.

O elemento de página duplicado é colocado na mesma página e na mesma posição que o original.

Retorno

PageElement: a nova cópia do elemento da página.

Autorização

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

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

getAs(contentType)

Retorne os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado. Esse método adiciona a extensão apropriada ao nome do arquivo, por exemplo, "meuarquivo.pdf". No entanto, ela pressupõe que a parte do nome do arquivo que segue o último ponto (se houver) é uma extensão que precisa ser substituída. Consequentemente, "ShoppingList.12.25.2014" se torna "ShoppingList.12.25.pdf".

Para ver as cotas diárias de conversões, consulte Cotas para Serviços do Google. Os domínios do Google Workspace recém-criados podem estar temporariamente sujeitos a cotas mais rigorosas.

Parâmetros

NomeTipoDescrição
contentTypeStringO tipo MIME para conversão. Para a maioria dos blobs, 'application/pdf' é a única opção válida. Para imagens no formato BMP, GIF, JPEG ou PNG, qualquer elemento 'image/bmp', 'image/gif', 'image/jpeg' ou 'image/png' também é válido.

Retorno

Blob: os dados como um blob.


getBlob()

Retorne os dados dentro dessa imagem como um blob.

Retorno

Blob: os dados da imagem como um blob.


getBorder()

Retorna o Border da imagem.

Retorno

Border: a borda da imagem.

Autorização

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

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

getConnectionSites()

Retorna a lista de ConnectionSites no elemento de página ou uma lista vazia se esse elemento não tiver sites de conexão.

Retorno

ConnectionSite[]: a lista de sites de conexão, que poderá ficar vazia se esse elemento não tiver sites de conexã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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getContentUrl()

Recebe um URL para a imagem.

Esse URL é marcado com a conta do solicitante. Assim, qualquer pessoa com o URL acessa a imagem como o requerente original. O acesso à imagem poderá ser perdido se as configurações de compartilhamento da apresentação forem alteradas. O URL retornado expira após um curto período.

Retorno

String

Autorização

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

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

getDescription()

Retorna a descrição do texto alternativo do elemento de página. A descrição é combinada com o título para exibir e ler o texto alternativo.

Retorno

String: a descrição do texto alternativo do elemento da página.

Autorização

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

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

getHeight()

Recebe a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando o elemento não tem rotação.

Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de tamanho e posicionamento.

Retorno

Number: a altura inerente do elemento de página em pontos ou null se ele não tiver uma altura.

Autorização

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

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

getInherentHeight()

Retorna a altura inerente do elemento em pontos.

A transformação do elemento de página é relativa ao seu tamanho inerente. Use o tamanho inerente em conjunto com a transformação do elemento para determinar a aparência final dele.

Retorno

Number: a altura inerente do elemento de página em pontos ou null se ele não tiver uma altura.

Autorização

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

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

getInherentWidth()

Retorna a largura inerente do elemento em pontos.

A transformação do elemento de página é relativa ao seu tamanho inerente. Use o tamanho inerente em conjunto com a transformação do elemento para determinar a aparência final dele.

Retorno

Number: a largura inerente do elemento de página em pontos ou null se ele não tiver uma largura.

Autorização

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

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

getLeft()

Retorna a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.

Retorno

Number: a posição horizontal desse elemento em pontos, do canto superior esquerdo da página.

Autorização

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

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

Retorna Link ou null se não houver um link.

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

Retorno

Link

Autorização

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

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

getObjectId()

Retorna o ID exclusivo desse objeto. Os IDs de objeto usados por páginas e elementos de página compartilham o mesmo namespace.

Retorno

String: o ID exclusivo desse objeto.

Autorização

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

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

getPageElementType()

Retorna o tipo de elemento de página, representado como um tipo enumerado PageElementType.

Retorno

PageElementType: o tipo do elemento da página.

Autorização

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

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

getParentGroup()

Retorna o grupo a que esse elemento de página pertence ou null se o elemento não estiver em um grupo.

Retorno

Group: o grupo a que este elemento de página pertence ou null.

Autorização

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

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

getParentPage()

Retorna a página em que esse elemento de página está.

Retorno

Page: a página em que esse elemento reside.

Autorização

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

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

getParentPlaceholder()

Retorna o elemento de página pai do marcador de posição. Retorna null se a imagem não for um marcador ou não tiver pai.

Retorno

PageElement: o elemento da página pai desse marcador de posição de imagem ou null se essa imagem não for um marcador ou não tiver um pai.

Autorização

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

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

getPlaceholderIndex()

Retorna o índice da imagem do marcador de posição. Se duas ou mais imagens de marcador na mesma página forem do mesmo tipo, cada uma terá um valor de índice exclusivo. Retorna null se a imagem não for um marcador.

Retorno

Integer: o índice do marcador dessa imagem ou null se a imagem não for um marcador.

Autorização

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

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

getPlaceholderType()

Retorna o tipo de marcador da imagem ou PlaceholderType.NONE se a forma não for um marcador.

Retorno

PlaceholderType: o tipo de marcador de posição da imagem.

Autorização

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

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

getRotation()

Retorna o ângulo de rotação no sentido horário do elemento em torno do centro em graus, no qual zero grau significa sem rotação.

Retorno

Number: o ângulo de rotação em graus entre 0 (inclusive) e 360 (exclusivo).

Autorização

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

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

getSourceUrl()

Extrai o URL de origem da imagem, se disponível.

Quando uma imagem é inserida pelo URL, retorna o URL fornecido durante a inserção da imagem.

Retorno

String: o URL da imagem, ou null se a imagem 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getTitle()

Retorna o título do texto alternativo do elemento de página. O título é combinado com a descrição para exibir e ler o texto alternativo.

Retorno

String: o título do texto alternativo do elemento da página.

Autorização

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

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

getTop()

Acessa a posição vertical do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.

Retorno

Number: a posição vertical desse elemento em pontos, no canto superior esquerdo da página.

Autorização

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

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

getTransform()

Retorna a transformação do elemento de página.

A aparência do elemento de página é determinada pela transformação absoluta. Para calcular a transformação absoluta, faça a pré-concatenação da transformação de um elemento de página com as transformações de todos os grupos pais. Se o elemento de página não estiver em um grupo, a transformação absoluta dele será igual ao valor nesse campo.

Retorno

AffineTransform: a transformação do elemento de página.

Autorização

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

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

getWidth()

Retorna a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando o elemento não tem rotação.

Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de tamanho e posicionamento.

Retorno

Number: a largura inerente do elemento de página em pontos ou null se ele não tiver uma largura.

Autorização

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

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

preconcatenateTransform(transform)

Preconcateiza a transformação fornecida à transformação atual do elemento de página.

newTransform = argument * existingTransform

Por exemplo, para mover os elementos 36 de uma página para a esquerda:

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

Também é possível substituir a transformação do elemento de página por setTransform(transform).

Parâmetros

NomeTipoDescrição
transformAffineTransformA transformação para preconcatenar na transformação desse elemento de página.

Retorno

Image: esse elemento de página 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

remove()

Remove o elemento de página.

Se, após uma operação de remoção, um Group tiver apenas um ou nenhum elemento de página, o próprio grupo também será removido.

Se um marcador PageElement for removido em um mestre ou layout, todos os marcadores herdados vazios também serão removidos.

Autorização

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

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

Remove um Link.

shape.removeLink();

replace(blobSource)

Substitui essa imagem por uma descrita por um objeto BlobSource.

A inserção da imagem faz com que ela seja buscada no BlobSource uma vez, e uma cópia é armazenada para exibição dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar no formato PNG, JPEG ou GIF.

Para manter a proporção da imagem, ela é dimensionada e centralizada em relação ao tamanho da imagem atual.

var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
image.replace(driveImage);

Parâmetros

NomeTipoDescrição
blobSourceBlobSourceDados da imagem.

Retorno

Image: este Image após a substituiçã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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replace(blobSource, crop)

Substitui essa imagem por uma descrita por um objeto Image, cortando-a opcionalmente para caber.

A inserção da imagem faz com que ela seja buscada no BlobSource uma vez, e uma cópia é armazenada para exibição dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar no formato PNG, JPEG ou GIF.

var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
// Replace and crop the drive image.
image.replace(driveImage, true);

Parâmetros

NomeTipoDescrição
blobSourceBlobSourceDados da imagem.
cropBooleanSe for true, a imagem vai ser cortada para se ajustar ao tamanho da atual. Caso contrário, a imagem será dimensionada e centralizada.

Retorno

Image: este Image após a substituiçã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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replace(imageUrl)

Substitui essa imagem por outra imagem transferida por download do URL fornecido.

A inserção da imagem faz com que ela seja buscada no URL uma vez, e uma cópia é armazenada para exibição dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar nos formatos PNG, JPEG ou GIF.

O URL fornecido precisa ser acessível publicamente e não pode ter mais de 2 KB. O URL em si é salvo com a imagem e exposto por getSourceUrl().

Para manter a proporção da imagem, ela é dimensionada e centralizada em relação ao tamanho da imagem atual.

Parâmetros

NomeTipoDescrição
imageUrlStringO URL de onde a imagem será transferida por download.

Retorno

Image: este Image após a substituiçã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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replace(imageUrl, crop)

Substitui essa imagem por outra imagem transferida por download do URL fornecido, cortando-a opcionalmente para que se encaixe.

A inserção da imagem faz com que ela seja buscada no URL uma vez, e uma cópia é armazenada para exibição dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar nos formatos PNG, JPEG ou GIF.

O URL fornecido não pode ter mais de 2 KB.

Parâmetros

NomeTipoDescrição
imageUrlStringO URL de onde a imagem será transferida por download.
cropBooleanSe for true, a imagem vai ser cortada para se ajustar ao tamanho da atual. Caso contrário, a imagem será dimensionada e centralizada.

Retorno

Image: este Image após a substituiçã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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

scaleHeight(ratio)

Redimensiona a altura do elemento pela proporção especificada. A altura do elemento é a altura da caixa delimitadora quando ele não tem rotação.

Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de tamanho e posicionamento.

Parâmetros

NomeTipoDescrição
ratioNumberA proporção pela qual dimensionar a altura deste elemento da página.

Retorno

Image: esse elemento de página 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

scaleWidth(ratio)

Redimensiona a largura do elemento pela proporção especificada. A largura do elemento é a largura da caixa delimitadora quando ele não tem rotação.

Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de tamanho e posicionamento.

Parâmetros

NomeTipoDescrição
ratioNumberA proporção pela qual dimensionar a largura deste elemento da página.

Retorno

Image: esse elemento de página 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

select()

Seleciona apenas o PageElement na apresentação ativa e remove qualquer seleção anterior. Isso é o mesmo que chamar select(replace) com true.

Um script só pode acessar a seleção do usuário que está executando o script e apenas se ele estiver vinculado à apresentação.

Isso define a Page mãe da PageElement como a current page selection.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

Autorização

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

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

select(replace)

Seleciona o PageElement na apresentação ativa.

Um script só pode acessar a seleção do usuário que está executando o script e apenas se ele estiver vinculado à apresentação.

Transmita true a esse método para selecionar apenas PageElement e remover qualquer seleção anterior. Isso também define o Page pai da PageElement como o current page selection.

Transmita false para selecionar vários objetos PageElement. Os objetos PageElement precisam estar no mesmo Page.

As seguintes condições precisam ser atendidas ao selecionar um elemento de página usando um parâmetro false:

  1. O Page pai do objeto PageElement precisa ser o current page selection.
  2. Não deve haver vários objetos Page selecionados.

Para garantir que esse seja o caso, a abordagem preferencial é selecionar a Page mãe primeiro usando Page.selectAsCurrentPage() e, em seguida, selecionar os elementos da página nessa página.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
var pageElements = slide.getPageElements();
for (var i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Parâmetros

NomeTipoDescrição
replaceBooleanSe for true, a seleção substituirá qualquer anterior. Caso contrário, será adicionada a qualquer anterior.

Autorização

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

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

sendBackward()

Envia o elemento de página para trás na página por um elemento.

O elemento de página não pode estar em um grupo.

Retorno

Image: esse elemento de página 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

sendToBack()

Envia o elemento de página para o fundo da página.

O elemento de página não pode estar em um grupo.

Retorno

Image: esse elemento de página 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setDescription(description)

Define a descrição do texto alternativo do elemento de página.

O método não é compatível com elementos Group.

// Set the first page element's alt text description to "new alt text description".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Parâmetros

NomeTipoDescrição
descriptionStringA string para definir a descrição do texto alternativo.

Retorno

Image — Este elemento de página.

Autorização

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

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

setHeight(height)

Define a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando o elemento não tem rotação.

Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de tamanho e posicionamento.

Parâmetros

NomeTipoDescrição
heightNumberA nova altura do elemento da página a ser definido, em pontos.

Retorno

Image: esse elemento de página 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLeft(left)

Define a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.

Parâmetros

NomeTipoDescrição
leftNumberA nova posição horizontal a ser definida, em pontos.

Retorno

Image: esse elemento de página 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slideIndex)

Define um Link para o Slide especificado usando o índice baseado em zero do slide.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

Parâmetros

NomeTipoDescrição
slideIndexIntegerO índice baseado em zero para o slide.

Retorno

Link: o Link que foi definido.

Autorização

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

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

setLinkSlide(slide)

Define um Link para o Slide especificado, o link é definido pelo ID do slide fornecido.

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

Parâmetros

NomeTipoDescrição
slideSlideO Slide que será vinculado.

Retorno

Link: o Link que foi definido.

Autorização

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

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

setLinkSlide(slidePosition)

Define um Link para o Slide especificado usando a posição relativa do slide.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

Parâmetros

NomeTipoDescrição
slidePositionSlidePositionO SlidePosition relativo.

Retorno

Link: o Link que foi definido.

Autorização

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

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

setLinkUrl(url)

Define um Link para a string de URL não vazia fornecida.

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

Parâmetros

NomeTipoDescrição
urlStringA string do URL.

Retorno

Link: o Link que foi definido.

Autorização

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

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

setRotation(angle)

Define o ângulo de rotação no sentido horário do elemento em torno do centro em graus.

Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de tamanho e posicionamento.

Parâmetros

NomeTipoDescrição
angleNumberO novo ângulo de rotação no sentido horário a ser definido, em graus.

Retorno

Image: esse elemento de página 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setTitle(title)

Define o título do texto alternativo do elemento de página.

O método não é compatível com elementos Group.

// Set the first page element's alt text title to "new alt text title".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Parâmetros

NomeTipoDescrição
titleStringA string para definir o título do texto alternativo.

Retorno

Image — Este elemento de página.

Autorização

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

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

setTop(top)

Define a posição vertical do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.

Parâmetros

NomeTipoDescrição
topNumberA nova posição vertical a ser definida, em pontos.

Retorno

Image: esse elemento de página 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setTransform(transform)

Define a transformação do elemento de página com a transformação fornecida.

A atualização da transformação de um grupo muda a transformação absoluta dos elementos da página nesse grupo, o que pode alterar a aparência deles.

A atualização da transformação de um elemento de página que está em um grupo muda apenas a transformação desse elemento. Isso não afeta as transformações do grupo ou de outros elementos de página do grupo.

Para detalhes sobre como as transformações afetam a aparência visual dos elementos da página, consulte getTransform().

Parâmetros

NomeTipoDescrição
transformAffineTransformA transformação definida para esse elemento de página.

Retorno

Image: esse elemento 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setWidth(width)

Define a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando o elemento não tem rotação.

Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de tamanho e posicionamento.

Parâmetros

NomeTipoDescrição
widthNumberA nova largura do elemento da página a ser definido, em pontos.

Retorno

Image: esse elemento de página 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/presentations.currentonly
  • https://www.googleapis.com/auth/presentations