Class Shape

Forma

Um PageElement que representa uma forma genérica que não tem uma forma mais específica classificação. 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()ShapeTraz o elemento de página para a frente na página por um elemento.
bringToFront()ShapeTraz o elemento de página para a frente da página.
duplicate()PageElementDuplica o elemento de página.
getAutofit()AutofitRetorna o Autofit do texto nessa forma.
getBorder()BorderRetorna o Border do formato.
getConnectionSites()ConnectionSite[]Retorna a lista de ConnectionSites no elemento de página ou uma lista vazia se a página não possui sites de conexão.
getContentAlignment()ContentAlignmentRetorna o ContentAlignment do texto na forma.
getDescription()StringRetorna a descrição do texto alternativo do elemento de página.
getFill()FillRetorna o Fill do formato.
getHeight()NumberExtrai a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando o 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 do página quando o elemento não tem rotação.
getLink()LinkRetorna Link ou null se não houver link.
getObjectId()StringRetorna o ID exclusivo deste objeto.
getPageElementType()PageElementTypeRetorna o tipo do elemento de página, representado como um tipo enumerado PageElementType.
getParentGroup()GroupRetorna o grupo a que o elemento de página pertence ou null se o elemento não estiver em um grupo.
getParentPage()PageRetorna a página em que o elemento está.
getParentPlaceholder()PageElementRetorna o elemento de página principal do marcador de posição.
getPlaceholderIndex()IntegerRetorna o índice do marcador da forma.
getPlaceholderType()PlaceholderTypeRetorna o tipo de marcador 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 em torno do centro do elemento em graus, onde zero grau significa que não há rotação.
getShapeType()ShapeTypeRetorna o tipo de forma.
getText()TextRangeRetorna o conteúdo de texto do formato.
getTitle()StringRetorna o título do texto alternativo do elemento de 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 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)ShapePré-concatena a transformação fornecida à transformação existente do elemento de página.
remove()voidRemove o elemento de 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 a forma por um gráfico do Planilhas Google.
replaceWithSheetsChartAsImage(sourceChart)ImageSubstitui essa forma por uma imagem de um gráfico do 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 os itens anteriores
select(replace)voidSeleciona o PageElement na apresentação ativa.
sendBackward()ShapeEnvia o elemento de página para trás na página por um elemento.
sendToBack()ShapeEnvia o elemento da página para a parte de trás da página.
setContentAlignment(contentAlignment)ShapeDefine o ContentAlignment do texto na forma.
setDescription(description)ShapeDefine a descrição do texto alternativo do elemento de página.
setHeight(height)ShapeDefine a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando o não tem rotação.
setLeft(left)ShapeDefine a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo do 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 fornecida.
setRotation(angle)ShapeDefine o ângulo de rotação do elemento no sentido horário 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 de 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 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 à qual esse elemento de página será alinhado.

Retornar

Shape: elemento de página para encadeamento.


bringForward()

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

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

Retornar

Shape: elemento de página para encadeamento.

Autorização

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

  • https://www.googleapis.com/auth/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.

Retornar

Shape: elemento de página para encadeamento.

Autorização

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

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

duplicate()

Duplica o elemento de página.

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

Retornar

PageElement: a nova cópia deste elemento de página.

Autorização

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

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

getAutofit()

Retorna o Autofit do texto nessa forma. Este será null se o formato não permite texto.

Retornar

Autofit: o ajuste automático do texto dentro da forma.

Autorização

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

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

getBorder()

Retorna o Border do formato.

Retornar

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

Autorização

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

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

getConnectionSites()

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

Retornar

ConnectionSite[]: a lista de sites de conexão, que pode ficar vazia se esse elemento não tiver sites de conexão.

Autorização

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

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

getContentAlignment()

Retorna o ContentAlignment do texto na forma.

Retornar

ContentAlignment: o alinhamento do texto no formato.

Autorização

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

  • https://www.googleapis.com/auth/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.

Retornar

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

Autorização

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

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

getFill()

Retorna o Fill do formato.

Retornar

Fill: é a configuração de preenchimento da forma.

Autorização

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

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

getHeight()

Extrai a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando o 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 estão compatíveis com este método, consulte o limitações de tamanho e posicionamento.

Retornar

Number: a altura inerente do elemento da página em pontos, ou null se o elemento da página não não têm altura.

Autorização

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

  • https://www.googleapis.com/auth/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 tamanho inerente dele. Use o tamanho inerente juntamente com a transformação do elemento para determinar a aparência final do elemento.

Retornar

Number: a altura inerente do elemento da página em pontos, ou null se o elemento da página não não têm altura.

Autorização

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

  • https://www.googleapis.com/auth/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 tamanho inerente dele. Use o tamanho inerente juntamente com a transformação do elemento para determinar a aparência final do elemento.

Retornar

Number: a largura inerente do elemento de página em pontos, ou null se o elemento de página não não têm largura.

Autorização

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

  • https://www.googleapis.com/auth/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 do página quando o elemento não tem rotação.

Retornar

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

Autorização

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

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

Retorna Link ou null se não houver 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 precisam de 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 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 precisam de 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 de página, representado como um tipo enumerado PageElementType.

Retornar

PageElementType: o tipo do elemento de página.

Autorização

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

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

getParentGroup()

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

Retornar

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

Autorização

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

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

getParentPage()

Retorna a página em que o elemento está.

Retornar

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

Autorização

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

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

getParentPlaceholder()

Retorna o elemento de página principal do marcador de posição. Retorna null se o formato não for um ou não tem pai.

Retornar

PageElement: o elemento de página pai desse marcador de posição da forma ou null se a forma não for um marcador ou não tem um pai.

Autorização

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

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

getPlaceholderIndex()

Retorna o índice do marcador da forma. Se duas ou mais instâncias do mesmo marcador estão presentes na mesma página, cada um deles tem seu 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 de posição.

Autorização

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

  • https://www.googleapis.com/auth/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 de posição.

Retornar

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

Autorização

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

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

getRotation()

Retorna o ângulo de rotação no sentido horário em torno do centro do elemento em graus, onde 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 precisam de 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 do polígono.

Retornar

ShapeType: o tipo do formato.


getText()

Retorna o conteúdo de texto do formato.

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

Retornar

TextRange: o conteúdo de texto do formato.

Autorização

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

  • https://www.googleapis.com/auth/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.

Retornar

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

Autorização

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

  • https://www.googleapis.com/auth/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 do elemento em pontos, a partir do canto superior esquerdo da página.

Autorização

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

  • https://www.googleapis.com/auth/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 computa a transformação absoluta e pré-concatena a transformação de um elemento de página com as transformações de todos os grupos principais. Se o elemento de página não estiver em um grupo, sua transformação absoluta será é igual ao valor neste campo.

Retornar

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

Autorização

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

  • https://www.googleapis.com/auth/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 estão compatíveis com este método, consulte o limitações de tamanho e posicionamento.

Retornar

Number: a largura inerente do elemento de página em pontos, ou null se o elemento de página não não têm largura.

Autorização

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

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

preconcatenateTransform(transform)

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

newTransform = argument * existingTransform

Por exemplo, para mover os elementos de uma página 36 pontos 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 a ser pré-concatenizada na transformação desse elemento de página.

Retornar

Shape: elemento de página para encadeamento.

Autorização

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

  • https://www.googleapis.com/auth/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 o grupo também é removido.

Se um marcador PageElement for removido em um mestre ou layout, todos os valores de os espaços reservados também são removidos.

Autorização

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

  • https://www.googleapis.com/auth/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 no BlobSource fornecido uma vez no momento da inserção, e uma cópia é armazenado para exibição dentro da apresentação. As imagens devem ter menos de 50 MB, não é possível ter mais de 25 megapixels e estar no formato PNG, JPEG ou GIF.

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

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: a Image que substituiu a forma.

Autorização

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

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

replaceWithImage(blobSource, crop)

Substitui essa forma por uma imagem fornecida por um BlobSource.

Inserir a imagem faz com que ela seja buscada no BlobSource uma vez, e uma cópia é armazenada para serão exibidos dentro da apresentação. As imagens devem ter menos de 50 MB, não pode exceder 25 megapixels e deve 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.
cropBooleanNo caso de true, a imagem é cortada para se ajustar ao tamanho da forma existente. Caso contrário, o é dimensionada e centralizada.

Retornar

Image: a Image que substituiu a forma.

Autorização

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

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

replaceWithImage(imageUrl)

Substitui essa forma por uma imagem.

A inserção da imagem faz com que ela seja buscada no URL uma vez, e uma cópia é armazenada para exibição no apresentação. As imagens devem ter menos de 50 MB, não podem exceder 25 megapixels e devem ter 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 é salvo. com a imagem e exposta por Image.getSourceUrl().

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

Parâmetros

NomeTipoDescrição
imageUrlStringO URL da imagem a partir do qual a imagem será transferida por download.

Retornar

Image: a Image que substituiu a forma.

Autorização

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

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

replaceWithImage(imageUrl, crop)

Substitui essa forma por uma imagem.

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

O URL fornecido não pode ser maior do que 2 KB. O URL é salvo com a imagem e exposto via Image.getSourceUrl().

Parâmetros

NomeTipoDescrição
imageUrlStringO URL da imagem a partir do qual a imagem será transferida por download.
cropBooleanNo caso de true, a imagem é cortada para se ajustar ao tamanho da forma existente. Caso contrário, o é dimensionada e centralizada.

Retornar

Image: a Image que substituiu a forma.

Autorização

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

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

replaceWithSheetsChart(sourceChart)

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

O gráfico está vinculado ao gráfico original do Planilhas Google, o que permite que ele seja atualizado. Outra opção os 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 de uma planilha que substitui a forma.

Retornar

SheetsChart: o gráfico que substituiu a forma.

Autorização

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

  • https://www.googleapis.com/auth/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 da forma 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 de 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 precisam de 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 do 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 estão compatíveis com este método, consulte o limitações de tamanho e posicionamento.

Parâmetros

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

Retornar

Shape: elemento de página para encadeamento.

Autorização

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

  • https://www.googleapis.com/auth/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 estão compatíveis com este método, consulte o limitações de tamanho e posicionamento.

Parâmetros

NomeTipoDescrição
ratioNumberA proporção de acordo com o dimensionamento da largura deste elemento de página.

Retornar

Shape: elemento de página para encadeamento.

Autorização

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

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

select()

Seleciona apenas o PageElement na apresentação ativa e remove os itens 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 somente se o script está 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 precisam de 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 somente se o script está vinculado à apresentação.

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

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

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

  1. O Page pai 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 recomendada é selecionar a Page mãe. primeiro usando Page.selectAsCurrentPage() e, em seguida, selecione 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 seleção anterior. caso contrário, será adicionada a qualquer seleção anterior.

Autorização

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

  • https://www.googleapis.com/auth/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.

Retornar

Shape: elemento de página para encadeamento.

Autorização

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

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

sendToBack()

Envia o elemento da página para a parte de trás da página.

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

Retornar

Shape: elemento de página para encadeamento.

Autorização

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

  • https://www.googleapis.com/auth/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: esta forma, para encadeamento.

Autorização

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

  • https://www.googleapis.com/auth/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 tem suporte para 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.

Retornar

Shape: este elemento de página.

Autorização

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

  • https://www.googleapis.com/auth/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 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 estão compatíveis com este método, consulte o limitações de tamanho e posicionamento.

Parâmetros

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

Retornar

Shape: elemento de página para encadeamento.

Autorização

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

  • https://www.googleapis.com/auth/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 do 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: elemento de página para encadeamento.

Autorização

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

  • https://www.googleapis.com/auth/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.

Retornar

Link: o Link que foi definido

Autorização

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

  • https://www.googleapis.com/auth/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.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

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

Retornar

Link: o Link que foi definido

Autorização

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

  • https://www.googleapis.com/auth/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.

Retornar

Link: o Link que foi definido

Autorização

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

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

setRotation(angle)

Define o ângulo de rotação do elemento no sentido horário 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 estão compatíveis com este método, consulte o 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.

Retornar

Shape: elemento de página para encadeamento.

Autorização

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

  • https://www.googleapis.com/auth/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 tem suporte para 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.

Retornar

Shape: este elemento de página.

Autorização

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

  • https://www.googleapis.com/auth/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: elemento de página para encadeamento.

Autorização

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

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

setTransform(transform)

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

Atualizar a transformação de um grupo altera a transformação absoluta dos elementos da página em desse grupo, o que pode mudar sua aparência.

Atualizar a transformação de um elemento de página que está em um grupo altera apenas a transformação de esse elemento de página. ele não afeta as transformações do grupo ou outros elementos de página na 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.

Retornar

Shape: este elemento, para encadeamento.

Autorização

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

  • https://www.googleapis.com/auth/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 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 estão compatíveis com este método, consulte o limitações de tamanho e posicionamento.

Parâmetros

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

Retornar

Shape: elemento de página para encadeamento.

Autorização

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

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