Esta página foi traduzida pela API Cloud Translation.

Class Shape

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étodo	Tipo de retorno	Breve descrição
`alignOnPage(alignmentPosition)`	`Shape`	Alinha o elemento à posição de alinhamento especificada na página.
`bringForward()`	`Shape`	Traz o elemento de página para a frente na página por um elemento.
`bringToFront()`	`Shape`	Traz o elemento de página para a frente da página.
`duplicate()`	`PageElement`	Duplica o elemento de página.
`getAutofit()`	`Autofit`	Retorna o `Autofit` do texto nessa forma.
`getBorder()`	`Border`	Retorna o `Border` do formato.
`getConnectionSites()`	`ConnectionSite[]`	Retorna a lista de `ConnectionSite`s no elemento de página ou uma lista vazia se o elemento da página não tiver sites de conexão.
`getContentAlignment()`	`ContentAlignment`	Retorna o `ContentAlignment` do texto na forma.
`getDescription()`	`String`	Retorna a descrição do texto alternativo do elemento de página.
`getFill()`	`Fill`	Retorna o `Fill` do formato.
`getHeight()`	`Number`	Recebe a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando ele não tem rotação.
`getInherentHeight()`	`Number`	Retorna a altura inerente do elemento em pontos.
`getInherentWidth()`	`Number`	Retorna a largura inerente do elemento em pontos.
`getLeft()`	`Number`	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.
`getLink()`	`Link`	Retorna `Link` ou `null` se não houver link.
`getObjectId()`	`String`	Retorna o ID exclusivo deste objeto.
`getPageElementType()`	`PageElementType`	Retorna o tipo do elemento de página, representado como um tipo enumerado `PageElementType`.
`getParentGroup()`	`Group`	Retorna o grupo a que o elemento de página pertence ou `null` se o elemento não estiver em um grupo.
`getParentPage()`	`Page`	Retorna a página em que o elemento está.
`getParentPlaceholder()`	`PageElement`	Retorna o elemento de página principal do marcador de posição.
`getPlaceholderIndex()`	`Integer`	Retorna o índice do marcador da forma.
`getPlaceholderType()`	`PlaceholderType`	Retorna o tipo de marcador da forma ou `PlaceholderType.NONE` se a forma não for um marcador.
`getRotation()`	`Number`	Retorna o ângulo de rotação no sentido horário em torno do centro do elemento em graus, em que zero grau significa que não há rotação.
`getShapeType()`	`ShapeType`	Retorna o tipo de forma.
`getText()`	`TextRange`	Retorna o conteúdo de texto do formato.
`getTitle()`	`String`	Retorna o título do texto alternativo do elemento de página.
`getTop()`	`Number`	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.
`getTransform()`	`AffineTransform`	Retorna a transformação do elemento de página.
`getWidth()`	`Number`	Retorna a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando o elemento não tem rotação.
`preconcatenateTransform(transform)`	`Shape`	Pré-concatena a transformação fornecida à transformação existente do elemento de página.
`remove()`	`void`	Remove o elemento de página.
`removeLink()`	`void`	Remove um `Link`.
`replaceWithImage(blobSource)`	`Image`	Substitui essa forma por uma imagem fornecida por um `BlobSource`.
`replaceWithImage(blobSource, crop)`	`Image`	Substitui essa forma por uma imagem fornecida por um `BlobSource`.
`replaceWithImage(imageUrl)`	`Image`	Substitui essa forma por uma imagem.
`replaceWithImage(imageUrl, crop)`	`Image`	Substitui essa forma por uma imagem.
`replaceWithSheetsChart(sourceChart)`	`SheetsChart`	Substitui a forma por um gráfico do Planilhas Google.
`replaceWithSheetsChartAsImage(sourceChart)`	`Image`	Substitui essa forma por uma imagem de um gráfico do Planilhas Google.
`scaleHeight(ratio)`	`Shape`	Dimensiona a altura do elemento pela proporção especificada.
`scaleWidth(ratio)`	`Shape`	Dimensiona a largura do elemento pela proporção especificada.
`select()`	`void`	Seleciona apenas o `PageElement` na apresentação ativa e remove qualquer seleção anterior.
`select(replace)`	`void`	Seleciona o `PageElement` na apresentação ativa.
`sendBackward()`	`Shape`	Envia o elemento de página para trás na página por um elemento.
`sendToBack()`	`Shape`	Envia o elemento da página para a parte de trás da página.
`setContentAlignment(contentAlignment)`	`Shape`	Define o `ContentAlignment` do texto na forma.
`setDescription(description)`	`Shape`	Define a descrição do texto alternativo do elemento de página.
`setHeight(height)`	`Shape`	Define a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando ele não tem rotação.
`setLeft(left)`	`Shape`	Define a posição horizontal do elemento em pontos, medida no canto superior esquerdo da página quando o elemento não tem rotação.
`setLinkSlide(slideIndex)`	`Link`	Define um `Link` para o `Slide` especificado usando o índice baseado em zero do slide.
`setLinkSlide(slide)`	`Link`	Define um `Link` para o `Slide` especificado. O link é definido pelo ID do slide especificado.
`setLinkSlide(slidePosition)`	`Link`	Define um `Link` para o `Slide` especificado usando a posição relativa do slide.
`setLinkUrl(url)`	`Link`	Define um `Link` para a string de URL não vazia fornecida.
`setRotation(angle)`	`Shape`	Define o ângulo de rotação do elemento no sentido horário em torno do centro, em graus.
`setTitle(title)`	`Shape`	Define o título do texto alternativo do elemento da página.
`setTop(top)`	`Shape`	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.
`setTransform(transform)`	`Shape`	Define a transformação do elemento de página com a transformação fornecida.
`setWidth(width)`	`Shape`	Define 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

Nome	Tipo	Descrição
`alignmentPosition`	`AlignmentPosition`	A posição à qual esse elemento de página será alinhado.

Devolução

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.

Devolução

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.

Devolução

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.

Devolução

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. Esse valor será null se a forma não permitir texto.

Devolução

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.

Devolução

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

Devolução

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.

Devolução

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 mostrar e ler o texto alternativo.

Devolução

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.

Devolução

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

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.

Devolução

Number: 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 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 em conjunto com a transformação do elemento para determinar a aparência final dele.

Devolução

Number: 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 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 em conjunto com a transformação do elemento para determinar a aparência final dele.

Devolução

Number: a largura inerente do elemento de página em pontos, ou null se o elemento de página não tem uma 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 da página, quando o elemento não tem rotação.

Devolução

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

`getLink()`

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

Devolução

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.

Devolução

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.

Devolução

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.

Devolução

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

Devolução

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. Retornará null se a forma não for um marcador ou não tiver pai.

Devolução

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 tiver 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 dos mesmos tipos de marcador estiverem presentes na mesma página, cada uma delas terá o próprio valor de índice exclusivo. Retornará null se a forma não for um marcador.

Devolução

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.

Devolução

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

Devolução

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

Devolução

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.

Devolução

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 mostrar e ler o texto alternativo.

Devolução

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.

Devolução

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 calcular a transformação absoluta, pré-concatena a transformação de um elemento de página com as transformações de todos os grupos pais. Se o elemento de página não estiver em um grupo, a transformação absoluta será igual ao valor nesse campo.

Devolução

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.

Devolução

Number: a largura inerente do elemento de página em pontos, ou null se o elemento de página não tem uma 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

Nome	Tipo	Descrição
`transform`	`AffineTransform`	A transformação a ser pré-concatenizada na transformação desse elemento de página.

Devolução

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, uma Group contiver apenas um ou nenhum elemento de página, o próprio grupo também será removido.

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

Autorização

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

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

`removeLink()`

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

Nome	Tipo	Descrição
`blobSource`	`BlobSource`	Dados da imagem.

Devolução

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.

A inserção da imagem faz a busca dela no BlobSource uma vez, e uma cópia é armazenada para exibição dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e estar nos formatos 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

Nome	Tipo	Descrição
`blobSource`	`BlobSource`	Dados da imagem.
`crop`	`Boolean`	No caso de `true`, a imagem é cortada para se ajustar ao tamanho da forma existente. Caso contrário, a imagem é dimensionada e centralizada.

Devolução

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.

Inserir a imagem faz a busca do URL uma vez, e uma cópia é armazenada para exibição dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar nos formatos PNG, JPEG ou GIF.

O URL fornecido precisa estar acessível publicamente e não pode ter mais de 2 KB. O próprio URL é salvo com a imagem e exposto por Image.getSourceUrl().

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

Parâmetros

Nome	Tipo	Descrição
`imageUrl`	`String`	O URL da imagem a partir do qual a imagem será transferida por download.

Devolução

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.

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

Parâmetros

Nome	Tipo	Descrição
`imageUrl`	`String`	O URL da imagem a partir do qual a imagem será transferida por download.
`crop`	`Boolean`	No caso de `true`, a imagem é cortada para se ajustar ao tamanho da forma existente. Caso contrário, a imagem é dimensionada e centralizada.

Devolução

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

Nome	Tipo	Descrição
`sourceChart`	`EmbeddedChart`	O gráfico de uma planilha que substitui a forma.

Devolução

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

Nome	Tipo	Descrição
`sourceChart`	`EmbeddedChart`	O gráfico de uma planilha que substitui a forma.

Devolução

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

Parâmetros

Nome	Tipo	Descrição
`ratio`	`Number`	A proporção pela qual a altura deste elemento da página será dimensionada.

Devolução

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.

Parâmetros

Nome	Tipo	Descrição
`ratio`	`Number`	A proporção de acordo com o dimensionamento da largura deste elemento de página.

Devolução

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 qualquer seleção anterior. Isso é o mesmo que chamar select(replace) com true.

Um script só poderá acessar a seleção do usuário que está executando o script e somente se ele 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 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ó poderá acessar a seleção do usuário que está executando o script e somente se ele estiver vinculado à apresentação.

Transmita true a 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 de página usando um parâmetro false:

O Page pai do objeto PageElement precisa ser o current page selection.
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, selecionar os elementos dessa 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

Nome	Tipo	Descrição
`replace`	`Boolean`	Se for `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 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.

Devolução

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.

Devolução

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

Nome	Tipo	Descrição
`contentAlignment`	`ContentAlignment`	O alinhamento a ser definido.

Devolução

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

Nome	Tipo	Descrição
`description`	`String`	A string para definir a descrição do texto alternativo.

Devolução

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

Parâmetros

Nome	Tipo	Descrição
`height`	`Number`	A nova altura desse elemento de página a ser definida, em pontos.

Devolução

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 no canto superior esquerdo da página quando o elemento não tem rotação.

Parâmetros

Nome	Tipo	Descrição
`left`	`Number`	A nova posição horizontal a ser definida, em pontos.

Devolução

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

Nome	Tipo	Descrição
`slideIndex`	`Integer`	O índice baseado em zero para o slide.

Devolução

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

Nome	Tipo	Descrição
`slide`	`Slide`	O `Slide` a ser vinculado.

Devolução

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

Nome	Tipo	Descrição
`slidePosition`	`SlidePosition`	O `SlidePosition` relativo.

Devolução

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

Nome	Tipo	Descrição
`url`	`String`	A string do URL.

Devolução

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.

Parâmetros

Nome	Tipo	Descrição
`angle`	`Number`	O novo ângulo de rotação no sentido horário a ser definido, em graus.

Devolução

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

Nome	Tipo	Descrição
`title`	`String`	A string para definir o título do texto alternativo.

Devolução

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

Nome	Tipo	Descrição
`top`	`Number`	A nova posição vertical a ser definida, em pontos.

Devolução

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 desse grupo, o que pode alterar a aparência visual deles.

Atualizar a transformação de um elemento de página que está em um grupo altera somente a transformação desse elemento de página. Isso não afeta as transformações do grupo ou de outros elementos de página do grupo.

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

Parâmetros

Nome	Tipo	Descrição
`transform`	`AffineTransform`	A transformação definida para esse elemento de página.

Devolução

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

Parâmetros

Nome	Tipo	Descrição
`width`	`Number`	A nova largura desse elemento de página a ser definida, em pontos.

Devolução

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