Class Shape

Forma

Um PageElement que representa uma forma genérica sem uma classificação mais específica. Inclui caixas de texto, retângulos e outras formas predefinidas.

Métodos

MétodoTipo de retornoBreve descrição
alignOnPage(alignmentPosition)ShapeAlinha o elemento à posição de alinhamento especificada na página.
bringForward()ShapeAvança o elemento da página em um elemento.
bringToFront()ShapeTraz o elemento da página para a frente.
duplicate()PageElementDuplica o elemento da página.
getAutofit()Autofit|nullRetorna o Autofit do texto dentro dessa forma.
getBorder()BorderRetorna o Border da forma.
getConnectionSites()ConnectionSite[]Retorna a lista de ConnectionSites no elemento da página ou uma lista vazia se o elemento não tiver sites de conexão.
getContentAlignment()ContentAlignmentRetorna o ContentAlignment do texto na forma.
getDescription()StringRetorna a descrição do texto alternativo do elemento da página.
getFill()FillRetorna o Fill da forma.
getHeight()Number|nullRecebe a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando ele não tem rotação.
getInherentHeight()Number|nullRetorna a altura inerente do elemento em pontos.
getInherentWidth()Number|nullRetorna a largura inerente do elemento em pontos.
getLeft()NumberRetorna a posição horizontal do elemento em pontos, medida do canto superior esquerdo da página quando o elemento não está girado.
getLink()Link|nullRetorna o Link ou null se não houver um link.
getObjectId()StringRetorna o ID exclusivo deste objeto.
getPageElementType()PageElementTypeRetorna o tipo do elemento da página, representado como uma enumeração PageElementType.
getParentGroup()Group|nullRetorna o grupo a que este elemento de página pertence ou null se o elemento não estiver em um grupo.
getParentPage()PageRetorna a página em que este elemento está.
getParentPlaceholder()PageElement|nullRetorna o elemento da página principal do marcador de posição.
getPlaceholderIndex()Integer|nullRetorna o índice do marcador de posição da forma.
getPlaceholderType()PlaceholderTypeRetorna o tipo de marcador de posição da forma ou PlaceholderType.NONE se a forma não for um marcador de posição.
getRotation()NumberRetorna o ângulo de rotação no sentido horário do elemento em torno do centro, em graus. Zero grau significa que não há rotação.
getShapeType()ShapeTypeRetorna o tipo da forma.
getText()TextRangeRetorna o conteúdo de texto da forma.
getTitle()StringRetorna o título do texto alternativo do elemento da página.
getTop()NumberRecebe a posição vertical do elemento em pontos, medida do canto superior esquerdo da página quando o elemento não está girado.
getTransform()AffineTransformRetorna a transformação do elemento da página.
getWidth()Number|nullRetorna a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando ele não tem rotação.
preconcatenateTransform(transform)ShapePré-concatena a transformação fornecida à transformação atual do elemento da página.
remove()voidRemove o elemento da página.
removeLink()voidRemove uma Link.
replaceWithImage(blobSource)ImageSubstitui essa forma por uma imagem fornecida por um BlobSource.
replaceWithImage(blobSource, crop)ImageSubstitui essa forma por uma imagem fornecida por um BlobSource.
replaceWithImage(imageUrl)ImageSubstitui a forma por uma imagem.
replaceWithImage(imageUrl, crop)ImageSubstitui a forma por uma imagem.
replaceWithSheetsChart(sourceChart)SheetsChartSubstitui a forma por um gráfico das Planilhas Google.
replaceWithSheetsChartAsImage(sourceChart)ImageSubstitui a forma por uma imagem de um gráfico das Planilhas Google.
scaleHeight(ratio)ShapeDimensiona a altura do elemento pela proporção especificada.
scaleWidth(ratio)ShapeDimensiona 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()ShapeEnvia o elemento da página para trás em um elemento.
sendToBack()ShapeEnvia o elemento da página para o fundo dela.
setContentAlignment(contentAlignment)ShapeDefine o ContentAlignment do texto na forma.
setDescription(description)ShapeDefine a descrição do texto alternativo do elemento da página.
setHeight(height)ShapeDefine a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando ele não tem rotação.
setLeft(left)ShapeDefine a posição horizontal do elemento em pontos, medida 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 especificado.
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 especificada.
setRotation(angle)ShapeDefine o ângulo de rotação no sentido horário do elemento em torno do centro, em graus.
setTitle(title)ShapeDefine o título do texto alternativo do elemento da página.
setTop(top)ShapeDefine a posição vertical do elemento em pontos, medida do canto superior esquerdo da página quando o elemento não está girado.
setTransform(transform)ShapeDefine a transformação do elemento da página com a transformação fornecida.
setWidth(width)ShapeDefine a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando ele 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 para alinhar esse elemento da página.

Retornar

Shape: este elemento de página, para encadeamento.

bringForward()

Avança o elemento da página em um elemento.

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

Retornar

Shape: este 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 da página para a frente.

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

Retornar

Shape: este 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 da página.

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

Retornar

PageElement: o novo duplicado desse 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

getAutofit()

Retorna o Autofit do texto dentro dessa forma. É null se a forma não permitir texto.

Retornar

Autofit|null: o ajuste automático do texto dentro dessa forma.

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

getBorder()

Retorna o Border da forma.

Retornar

Border: a configuração de borda desta forma.

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 da página ou uma lista vazia se o elemento não tiver sites de conexão.

Retornar

ConnectionSite[]: a lista de sites de conexão, que pode estar vazia se o 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

getContentAlignment()

Retorna o ContentAlignment do texto na forma.

Retornar

ContentAlignment: o alinhamento do texto dentro dessa forma.

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 da página. A descrição é combinada com o título para mostrar e ler o texto alternativo.

Retornar

String: 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

getFill()

Retorna o Fill da forma.

Retornar

Fill: a configuração de preenchimento desta forma.

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 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 dimensionamento e posicionamento.

Retornar

Number|null: a altura inerente do elemento de página em pontos ou null se o elemento de página 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 da página é relativa ao tamanho inerente dele. Use o tamanho inerente em conjunto com a transformação do elemento para determinar a aparência visual final dele.

Retornar

Number|null: a altura inerente do elemento de página em pontos ou null se o elemento de página 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 da página é relativa ao tamanho inerente dele. Use o tamanho inerente em conjunto com a transformação do elemento para determinar a aparência visual final dele.

Retornar

Number|null: a largura inerente do elemento da página em pontos ou null se o elemento da página 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 do canto superior esquerdo da página quando o elemento não está girado.

Retornar

Number: posição horizontal do 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 o Link ou null se não houver um link. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

Retornar

Link|null: o Link ou null se não houver um 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 deste objeto. Os IDs de objetos usados por páginas e elementos de página compartilham o mesmo namespace.

Retornar

String: o ID exclusivo deste 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 do elemento da página, representado como uma enumeração PageElementType.

Retornar

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 este elemento de página pertence ou null se o elemento não estiver em um grupo.

Retornar

Group|null: o grupo a que esse elemento da 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 este elemento está.

Retornar

Page: a página em que o elemento está.

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 da página principal do marcador de posição. Retorna null se a forma não for um marcador de posição ou não tiver um elemento pai.

Retornar

PageElement|null: o elemento de página pai deste marcador de posição de forma ou null se a forma não for um marcador de posição 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 do marcador de posição da forma. Se duas ou mais instâncias dos mesmos tipos de marcador de posição estiverem presentes na mesma página, cada uma terá um valor de índice exclusivo. Retorna null se a forma não for um marcador de posição.

Retornar

Integer|null: o índice do marcador de posição dessa forma ou null se a forma não for um marcador de posiçã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

getPlaceholderType()

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

Retornar

PlaceholderType: o tipo de marcador de posição dessa forma.

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. Zero grau significa que não há rotação.

Retornar

Number: o ângulo de rotação em graus entre 0 (inclusivo) 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

getShapeType()

Retorna o tipo da forma.

Retornar

ShapeType: o tipo da forma.

getText()

Retorna o conteúdo de texto da forma.

O texto dentro de uma forma sempre termina com um caractere de nova linha.

Retornar

TextRange: o conteúdo de texto dessa forma.

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 da página. O título é combinado com a descrição para mostrar e ler o texto alternativo.

Retornar

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

Recebe a posição vertical do elemento em pontos, medida do canto superior esquerdo da página quando o elemento não está girado.

Retornar

Number: a posição vertical 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

getTransform()

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

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

Retornar

AffineTransform: a transformação 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

getWidth()

Retorna a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento 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 dimensionamento e posicionamento.

Retornar

Number|null: a largura inerente do elemento da página em pontos ou null se o elemento da página 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)

Pré-concatena a transformação fornecida à transformação atual do elemento da página. 

newTransform = argument * existingTransform;

Por exemplo, para mover um elemento da página 36 pontos para a esquerda: 

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

Você também pode substituir a transformação do elemento da página por setTransform(transform).

Parâmetros

NomeTipoDescrição
transformAffineTransformA transformação a ser pré-concatenada na transformação deste elemento da página.

Retornar

Shape: este 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 da página.

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

Se um marcador de posição PageElement for removido de um modelo ou layout, todos os marcadores de posição vazios que herdam dele 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 uma Link. 

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

replaceWithImage(blobSource)

Substitui essa forma por uma imagem fornecida por um BlobSource.

A imagem é buscada do BlobSource fornecido uma vez no momento da inserção, e uma cópia é armazenada para exibição na 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 forma atual. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
shape.replaceWithImage(driveImage);

Parâmetros

NomeTipoDescrição
blobSourceBlobSourceDados da imagem.

Retornar

Image: o Image que substituiu a forma.

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

replaceWithImage(blobSource, crop)

Substitui essa forma por uma imagem fornecida por um BlobSource.

A inserção busca a imagem do BlobSource uma vez, e uma cópia é armazenada para exibição na 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. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

Parâmetros

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

Retornar

Image: o Image que substituiu a forma.

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

replaceWithImage(imageUrl)

Substitui a forma por uma imagem.

Ao inserir a imagem, ela é buscada no URL uma vez, e uma cópia é armazenada para exibição na 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.

O URL fornecido precisa ser acessível publicamente e ter no máximo 2 kB. O URL é salvo com a imagem e exposto via Image.getSourceUrl().

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

Parâmetros

NomeTipoDescrição
imageUrlStringO URL da imagem para fazer o download.

Retornar

Image: o Image que substituiu a forma.

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

replaceWithImage(imageUrl, crop)

Substitui a forma por uma imagem.

Ao inserir a imagem, ela é buscada no URL uma vez, e uma cópia é armazenada para exibição na 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.

O URL fornecido não pode ter mais de 2 kB. O URL é salvo com a imagem e exposto via Image.getSourceUrl().

Parâmetros

NomeTipoDescrição
imageUrlStringO URL da imagem para fazer o download.
cropBooleanSe true, corta a imagem para ajustar ao tamanho da forma atual. Caso contrário, a imagem será dimensionada e centralizada.

Retornar

Image: o Image que substituiu a forma.

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

replaceWithSheetsChart(sourceChart)

Substitui a forma por um gráfico das Planilhas Google.

O gráfico está vinculado ao gráfico de origem do Google Planilhas, o que permite que ele seja atualizado. Outros colaboradores podem ver o link para a planilha de origem. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChart(chart);

Parâmetros

NomeTipoDescrição
sourceChartEmbeddedChartO gráfico em uma planilha que substitui a forma.

Retornar

SheetsChart: o gráfico que substituiu a forma.

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

replaceWithSheetsChartAsImage(sourceChart)

Substitui a forma por uma imagem de um gráfico do Google Sheets.

Para manter a proporção do gráfico do Google Sheets, a imagem é dimensionada e centralizada em relação ao tamanho da forma atual.

A imagem do gráfico não está vinculada ao gráfico de origem das Planilhas Google. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChartAsImage(chart);

Parâmetros

NomeTipoDescrição
sourceChartEmbeddedChartO gráfico em uma planilha que substitui a forma.

Retornar

Image: a imagem do gráfico que substituiu a forma.

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)

Dimensiona a altura do elemento pela proporção especificada. A altura do elemento é a altura da caixa delimitadora 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 dimensionamento e posicionamento.

Parâmetros

NomeTipoDescrição
ratioNumberA proporção para dimensionar a altura desse elemento da página.

Retornar

Shape: este 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)

Dimensiona a largura do elemento pela proporção especificada. A largura do elemento é a largura da caixa delimitadora 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 dimensionamento e posicionamento.

Parâmetros

NomeTipoDescrição
ratioNumberA proporção para dimensionar a largura desse elemento da página.

Retornar

Shape: este 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 o está executando e apenas se ele estiver vinculado à apresentação.

Isso define o Page pai do PageElement como o current page selection. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const 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 o está executando e apenas se ele estiver vinculado à apresentação.

Transmita true para esse método para selecionar apenas o PageElement e remover qualquer seleção anterior. Isso também define o Page pai do 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 da página usando um parâmetro false:

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

Para garantir que esse seja o caso, a abordagem preferida é selecionar primeiro o Page pai usando Page.selectAsCurrentPage() e depois selecionar os elementos da página. 

const 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.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Parâmetros

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

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 da página para trás em um elemento.

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

Retornar

Shape: este 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 da página para o fundo dela.

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

Retornar

Shape: este 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

setContentAlignment(contentAlignment)

Define o ContentAlignment do texto na forma.

Esse método desativa automaticamente as propriedades de ajuste automático de texto nas formas atualizadas.

Parâmetros

NomeTipoDescrição
contentAlignmentContentAlignmentO alinhamento a ser definido.

Retornar

Shape: este formato, 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 da 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".
const 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.

Retornar

Shape: este 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

setHeight(height)

Define a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento 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 dimensionamento e posicionamento.

Parâmetros

NomeTipoDescrição
heightNumberA nova altura a ser definida para esse elemento da página, em pontos.

Retornar

Shape: este 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 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.

Retornar

Shape: este 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.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

Parâmetros

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

Retornar

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

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

Parâmetros

NomeTipoDescrição
slideSlideO Slide a ser vinculado.

Retornar

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.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Parâmetros

NomeTipoDescrição
slidePositionSlidePositionO SlidePosition relativo.

Retornar

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

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

Parâmetros

NomeTipoDescrição
urlStringA string do URL.

Retornar

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 dimensionamento e posicionamento.

Parâmetros

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

Retornar

Shape: este 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 da 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".
const 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.

Retornar

Shape: este 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

setTop(top)

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

Parâmetros

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

Retornar

Shape: este 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 da página com a transformação fornecida.

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

Atualizar a transformação de um elemento de página que está em um grupo só muda a transformação desse elemento. Não afeta as transformações do grupo ou de outros elementos de página nele.

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 este elemento da página.

Retornar

Shape: este 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 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 dimensionamento e posicionamento.

Parâmetros

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

Retornar

Shape: este 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