Class Shape

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.
Forma

Um PageElement que representa uma forma genérica que não tem 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()ShapeLeva o elemento da página para frente na página em um elemento.
bringToFront()ShapeTraz o elemento da página para a frente da página.
duplicate()PageElementDuplicar o elemento da página.
getAutofit()AutofitRetorna a Autofit do texto nesse formato.
getBorder()BorderRetorna a Border do formato.
getConnectionSites()ConnectionSite[]Retorna a lista de ConnectionSites no elemento da página ou uma lista vazia se o elemento da página não tiver sites de conexão.
getContentAlignment()ContentAlignmentRetorna a ContentAlignment do texto na forma.
getDescription()StringRetorna a descrição do elemento da página.
getFill()FillRetorna a Fill do formato.
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()LinkRetornará Link ou null se não houver um link.
getObjectId()StringRetorna o ID exclusivo do objeto.
getPageElementType()PageElementTypeRetorna o tipo do elemento da página, representado como uma enumeração PageElementType.
getParentGroup()GroupRetorna o grupo a que esse elemento da página pertence ou null se o elemento não estiver em um grupo.
getParentPage()PageRetorna a página em que este elemento da página está.
getParentPlaceholder()PageElementRetorna o elemento da página mãe do marcador.
getPlaceholderIndex()IntegerRetorna o índice de marcador de posição da forma.
getPlaceholderType()PlaceholderTypeRetorna o tipo de marcador da forma 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, em que zero graus significa nenhuma rotação.
getShapeType()ShapeTypeRetorna o tipo da forma.
getText()TextRangeRetorna o conteúdo de texto da forma.
getTitle()StringRetorna o título do elemento da página.
getTop()NumberRecebe 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 da 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)ShapePré-concatena a transformação fornecida na transformação atual do elemento da página.
remove()voidRemove o elemento da página.
removeLink()voidRemove um 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 essa forma por uma imagem.
replaceWithImage(imageUrl, crop)ImageSubstitui essa forma por uma imagem.
replaceWithSheetsChart(sourceChart)SheetsChartSubstitui esse formato por um gráfico do Planilhas Google.
replaceWithSheetsChartAsImage(sourceChart)ImageSubstitui essa forma por uma imagem de um gráfico do Planilhas Google.
scaleHeight(ratio)ShapeEscalona a altura do elemento pela proporção especificada.
scaleWidth(ratio)ShapeDimensiona a largura do elemento de acordo com a proporção especificada.
select()voidSeleciona apenas PageElement na apresentação ativa e remove todas as seleções anteriores.
select(replace)voidSeleciona a PageElement na apresentação ativa.
sendBackward()ShapeEnvia o elemento da página de volta na página por um elemento.
sendToBack()ShapeEnvia o elemento da página para o verso.
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 o elemento não tem rotação.
setLeft(left)ShapeDefine 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 valor Slide especificado usando o índice baseado no zero do slide.
setLinkSlide(slide)LinkDefine um Link para a Slide especificada. O link é definido pelo ID do slide fornecido.
setLinkSlide(slidePosition)LinkDefine um Link para a Slide especificada 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 a partir do canto superior esquerdo da página quando o elemento não tem rotação.
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 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
alignmentPositionAlignmentPositionÉ a posição de alinhamento do elemento da página.

Retornar

Shape: este elemento da página para encadeamento.


bringForward()

Leva o elemento da página para frente na página em um elemento.

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

Retornar

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

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

Retornar

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

Duplicar o elemento da página.

O elemento de página duplicada é posicionado na mesma posição do original.

Retornar

PageElement: a nova cópia deste 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 a Autofit do texto nesse formato. Esse valor será null se a forma não permitir texto.

Retornar

Autofit: o ajuste automático do texto nessa 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 a Border do formato.

Retornar

Border: a configuração de borda deste formato.

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 da página não tiver sites de conexão.

Retornar

ConnectionSite[]: a lista de sites de conexão, que pode estar vazia se este 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 a ContentAlignment do texto na forma.

Retornar

ContentAlignment: o alinhamento do texto nessa 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 elemento da página. A descrição é combinada com o título para exibir e ler o texto alternativo.

Retornar

String: a descriçã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

getFill()

Retorna a Fill do formato.

Retornar

Fill: a configuração de preenchimento do formato.

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.

Retornar

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

Retornar

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

Retornar

Number: o elemento inerente 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 a partir do canto superior esquerdo da página quando o elemento não tem rotação.

Retornar

Number: é a posição horizonal deste 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

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

Retornar

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 do objeto. Os IDs de objeto usados por páginas e elementos de página compartilham o mesmo namespace.

Retornar

String: o ID exclusivo do 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 esse elemento da página pertence ou null se o elemento não estiver em um grupo.

Retornar

Group: 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 da página está.

Retornar

Page: a página em que o 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 da página mãe do marcador. Retornará null se a forma não for um marcador ou não tiver pai.

Retornar

PageElement: o elemento da página mãe desse marcador de forma ou null se essa forma 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 de marcador de posição da forma. Se duas ou mais instâncias dos mesmos tipos de marcador estiverem presentes na mesma página, cada uma vai ter o próprio valor de índice exclusivo. Retornará null se a forma não for um marcador.

Retornar

Integer: o índice de marcador dessa forma, ou null se a forma 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 forma ou PlaceholderType.NONE se a forma não for um marcador.

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, em que zero graus significa nenhuma 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 deste formato.


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

getTitle()

Retorna o título do elemento da página. O título é combinado com a descrição para exibir e ler textos alternativos.

Retornar

String: o título 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 a partir do canto superior esquerdo da página quando o elemento não tem rotação.

Retornar

Number: é a posição vertical deste elemento em pontos, a partir 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 pais dela. Se o elemento de 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 o elemento não tem rotação.

Retornar

Number: o elemento inerente 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 na 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, faça o seguinte:

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

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

Parâmetros

NomeTipoDescrição
transformAffineTransformA transformação a ser pré-concatenada neste elemento de página.

Retornar

Shape: este elemento da 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 próprio grupo também será removido.

Se um marcador PageElement for removido de um mestre ou layout, os marcadores herdados herdados 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();

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 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, a imagem é dimensionada e centralizada em relação ao tamanho da forma atual.

var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
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.

Inserir a imagem a busca do BlobSource uma vez e uma cópia é armazenada para exibir 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 shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

Parâmetros

NomeTipoDescrição
blobSourceBlobSourceDados da imagem.
cropBooleanSe true, corta a imagem para que ela se ajuste 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 essa forma por uma imagem.

A inserção da imagem a busca 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 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 por Image.getSourceUrl().

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

Parâmetros

NomeTipoDescrição
imageUrlStringURL da imagem que você quer usar 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 essa forma por uma imagem.

A inserção da imagem a busca 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 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 por Image.getSourceUrl().

Parâmetros

NomeTipoDescrição
imageUrlStringURL da imagem que você quer usar para fazer o download.
cropBooleanSe true, corta a imagem para que ela se ajuste 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 esse formato por um gráfico do Planilhas Google.

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

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
var 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 essa forma por uma imagem de um gráfico do Planilhas Google.

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

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

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
var 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)

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

Parâmetros

NomeTipoDescrição
ratioNumberA proporção em que a altura desse elemento da página é dimensionada.

Retornar

Shape: este elemento da 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 de acordo com a proporção especificada. A largura do elemento é a largura da caixa delimitadora quando o elemento não tem rotação.

Parâmetros

NomeTipoDescrição
ratioNumberA proporção em que a largura deste elemento da página é dimensionada.

Retornar

Shape: este elemento da 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 PageElement na apresentação ativa e remove todas as seleções anteriores. 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 o script estiver vinculado à apresentação.

Isso define o Page pai da PageElement como o 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 a PageElement na apresentação ativa.

Um script só pode acessar a seleção do usuário que está executando o script e apenas se o script 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 da PageElement como o current page selection.

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

As condições a seguir precisam ser atendidas ao selecionar um elemento da 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 essa seja a situação, selecione a abordagem mãe Page usando Page.selectAsCurrentPage() e, em seguida, os elementos da 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 true, a seleção substituirá qualquer seleção anterior. Caso contrário, a seleção será adicionada a qualquer seleção 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 da página de volta na página por um elemento.

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

Retornar

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

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

Retornar

Shape: este elemento da 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".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Parâmetros

NomeTipoDescrição
descriptionStringString em que a descrição alternativa do texto será definida.

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 o elemento não tem rotação.

Parâmetros

NomeTipoDescrição
heightNumberÉ a nova altura desse elemento de página a ser definida, em pontos.

Retornar

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

Retornar

Shape: este elemento da 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 valor Slide especificado usando o índice baseado no 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.

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

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 a Slide especificada 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

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.
shape.setLinkUrl("https://slides.google.com");

Parâmetros

NomeTipoDescrição
urlStringString de 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.

Parâmetros

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

Retornar

Shape: este elemento da 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".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Parâmetros

NomeTipoDescrição
titleStringString em que o título do texto alternativo será definido.

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

Retornar

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

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.

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

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

Parâmetros

NomeTipoDescrição
transformAffineTransformÉ a 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 o elemento não tem rotação.

Parâmetros

NomeTipoDescrição
widthNumberÉ a nova largura deste elemento de página a ser definida, em pontos.

Retornar

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