Um PageElement
que representa um formato genérico 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 da página para a frente 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 dentro dessa 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 esse elemento 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 o elemento 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 um link. |
getObjectId() | String | Retorna o ID exclusivo desse objeto. |
getPageElementType() | PageElementType | Retorna o tipo de elemento de página, representado como um tipo enumerado PageElementType . |
getParentGroup() | Group | Retorna o grupo a que esse elemento de página pertence ou null se o elemento não estiver em um grupo. |
getParentPage() | Page | Retorna a página em que esse elemento de página está. |
getParentPlaceholder() | PageElement | Retorna o elemento de página pai do marcador de posição. |
getPlaceholderIndex() | Integer | Retorna o índice de marcador de posição da forma. |
getPlaceholderType() | PlaceholderType | Retorna o tipo de marcador da forma ou PlaceholderType.NONE se ela não for um marcador de posição. |
getRotation() | Number | Retorna o ângulo de rotação no sentido horário do elemento em torno do centro em graus, no qual zero grau significa sem rotação. |
getShapeType() | ShapeType | Retorna o tipo do polígono. |
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 | Acessa a posição vertical do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação. |
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 | Preconcateiza a transformação fornecida à transformação atual 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 esta forma por um gráfico do Planilhas Google. |
replaceWithSheetsChartAsImage(sourceChart) | Image | Substitui esta forma por uma imagem de um gráfico do Planilhas Google. |
scaleHeight(ratio) | Shape | Redimensiona a altura do elemento pela proporção especificada. |
scaleWidth(ratio) | Shape | Redimensiona 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 de página para o fundo 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 o elemento não tem rotação. |
setLeft(left) | Shape | 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. |
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 fornecido. |
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 no sentido horário do elemento em torno do centro em graus. |
setTitle(title) | Shape | Define o título do texto alternativo do elemento de 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 a que este elemento de página será alinhado na página. |
Retorno
Shape
: esse elemento de página para encadeamento.
bringForward()
Traz o elemento da página para a frente por um elemento.
O elemento de página não pode estar em um grupo.
Retorno
Shape
: esse elemento de página para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringToFront()
Traz o elemento de página para a frente da página.
O elemento de página não pode estar em um grupo.
Retorno
Shape
: esse elemento de página para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
duplicate()
Duplica o elemento de página.
O elemento de página duplicado é colocado na mesma página e na mesma posição que o original.
Retorno
PageElement
: a nova cópia do elemento da página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getAutofit()
Retorna o Autofit
do texto dentro dessa forma. Esse valor será null
se a forma
não permitir texto.
Retorno
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()
getConnectionSites()
Retorna a lista de ConnectionSite
s no elemento de página ou uma lista vazia se esse elemento não tiver sites de conexão.
Retorno
ConnectionSite[]
: a lista de sites de conexão, que poderá ficar vazia se esse elemento não tiver sites de conexão.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getContentAlignment()
Retorna o ContentAlignment
do texto na forma.
Retorno
ContentAlignment
: o alinhamento do texto dentro dessa forma.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDescription()
Retorna a descrição do texto alternativo do elemento de página. A descrição é combinada com o título para exibir e ler o texto alternativo.
Retorno
String
: a descrição do texto alternativo do elemento da página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getFill()
getHeight()
Recebe a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando o elemento não tem rotação.
Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de tamanho e posicionamento.
Retorno
Number
: a altura inerente do elemento de página em pontos ou null
se ele não tiver uma altura.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentHeight()
Retorna a altura inerente do elemento em pontos.
A transformação do elemento de página é relativa ao seu tamanho inerente. Use o tamanho inerente em conjunto com a transformação do elemento para determinar a aparência final dele.
Retorno
Number
: a altura inerente do elemento de página em pontos ou null
se ele não tiver uma altura.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentWidth()
Retorna a largura inerente do elemento em pontos.
A transformação do elemento de página é relativa ao seu tamanho inerente. Use o tamanho inerente em conjunto com a transformação do elemento para determinar a aparência final dele.
Retorno
Number
: a largura inerente do elemento de página em pontos ou null
se ele não tiver uma largura.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLeft()
Retorna a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
Retorno
Number
: a posição horizontal desse elemento em pontos, do canto superior esquerdo da página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLink()
Retorna Link
ou null
se não houver um link.
var link = shape.getLink(); if (link != null) { Logger.log('Shape has a link of type: ' + link.getLinkType()); }
Retorno
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getObjectId()
Retorna o ID exclusivo desse objeto. Os IDs de objeto usados por páginas e elementos de página compartilham o mesmo namespace.
Retorno
String
: o ID exclusivo desse objeto.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementType()
Retorna o tipo de elemento de página, representado como um tipo enumerado PageElementType
.
Retorno
PageElementType
: o tipo do elemento da página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentGroup()
Retorna o grupo a que esse elemento de página pertence ou null
se o elemento não estiver em um grupo.
Retorno
Group
: o grupo a que este elemento de página pertence ou null
.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentPage()
Retorna a página em que esse elemento de página está.
Retorno
Page
: a página em que esse elemento reside.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentPlaceholder()
Retorna o elemento de página pai do marcador de posição. Retornará null
se a forma não for um marcador ou não tiver pai.
Retorno
PageElement
: o elemento de página pai desse marcador de posição da 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 delas terá um valor de índice exclusivo. Retorna null
se a forma não for um marcador de posição.
Retorno
Integer
: o índice de marcador dessa forma ou null
se ela não for um marcador de posição.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderType()
Retorna o tipo de marcador da forma ou PlaceholderType.NONE
se ela não for um marcador de posição.
Retorno
PlaceholderType
: o tipo de marcador de posição da 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, no qual zero grau significa sem rotação.
Retorno
Number
: o ângulo de rotação em graus entre 0 (inclusive) e 360 (exclusivo).
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getShapeType()
getText()
Retorna o conteúdo de texto do formato.
O texto em uma forma sempre termina com um caractere de nova linha.
Retorno
TextRange
: o conteúdo de texto da forma.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTitle()
Retorna o título do texto alternativo do elemento de página. O título é combinado com a descrição para exibir e ler o texto alternativo.
Retorno
String
: o título do texto alternativo do elemento da página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTop()
Acessa a posição vertical do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
Retorno
Number
: a posição vertical desse elemento em pontos, no canto superior esquerdo da página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTransform()
Retorna a transformação do elemento de página.
A aparência do elemento de página é determinada pela transformação absoluta. Para calcular a transformação absoluta, faça a pré-concatenação da transformação de um elemento de página com as transformações de todos os grupos pais. Se o elemento de página não estiver em um grupo, a transformação absoluta dele será igual ao valor nesse campo.
Retorno
AffineTransform
: a transformação do elemento de página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWidth()
Retorna a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando o elemento não tem rotação.
Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de tamanho e posicionamento.
Retorno
Number
: a largura inerente do elemento de página em pontos ou null
se ele não tiver uma largura.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
preconcatenateTransform(transform)
Preconcateiza a transformação fornecida à transformação atual do elemento de página.
newTransform = argument * existingTransform
Por exemplo, para mover os elementos 36 de uma página para a esquerda:
element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder() .setTranslateX(-36.0) .build());
Também é possível substituir a transformação do elemento de página por setTransform(transform)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
transform | AffineTransform | A transformação para preconcatenar na transformação desse elemento de página. |
Retorno
Shape
: esse elemento de página para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
Remove o elemento de página.
Se, após uma operação de remoção, um Group
tiver apenas um ou nenhum elemento de página, o
próprio grupo também será removido.
Se um marcador PageElement
for removido em um mestre ou layout, todos os marcadores herdados
vazios também serão removidos.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
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 dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem
exceder 25 megapixels e precisam estar no formato PNG, JPEG ou GIF.
Para manter a proporção da imagem, ela é dimensionada e centralizada em relação ao tamanho da 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
Nome | Tipo | Descrição |
---|---|---|
blobSource | BlobSource | Dados da imagem. |
Retorno
Image
: o Image
que substituiu a forma.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceWithImage(blobSource, crop)
Substitui essa forma por uma imagem fornecida por um BlobSource
.
A inserção da imagem faz com que ela seja buscada do BlobSource
uma vez, e uma cópia é armazenada para
exibição dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25
megapixels e precisam estar 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 | Se for true , a imagem vai ser cortada para se ajustar ao tamanho da forma existente. Caso contrário, a
imagem será dimensionada e centralizada. |
Retorno
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 faz com que ela seja buscada no URL uma vez, e uma cópia é armazenada para exibição dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar nos formatos PNG, JPEG ou GIF.
O URL fornecido precisa ser acessível publicamente e não pode ter mais de 2 KB. O URL em si é salvo
com a imagem e exposto por Image.getSourceUrl()
.
Para manter a proporção da imagem, ela é dimensionada e centralizada em relação ao tamanho da forma existente.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
imageUrl | String | O URL da imagem de onde a imagem será transferida por download. |
Retorno
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 faz com que ela seja buscada no URL uma vez, e uma cópia é armazenada para exibição dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar nos formatos PNG, JPEG ou GIF.
O URL fornecido não pode ter mais de 2 KB. O URL em si é salvo com a imagem e
exposto usando Image.getSourceUrl()
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
imageUrl | String | O URL da imagem de onde a imagem será transferida por download. |
crop | Boolean | Se for true , a imagem vai ser cortada para se ajustar ao tamanho da forma existente. Caso contrário, a
imagem será dimensionada e centralizada. |
Retorno
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 esta forma por um gráfico do Planilhas Google.
O gráfico é vinculado ao gráfico de origem 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 em uma planilha que substitui a forma. |
Retorno
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 esta 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 existente.
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 em uma planilha que substitui a forma. |
Retorno
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)
Redimensiona a altura do elemento pela proporção especificada. A altura do elemento é a altura da caixa delimitadora quando ele não tem rotação.
Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de tamanho e posicionamento.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
ratio | Number | A proporção pela qual dimensionar a altura deste elemento da página. |
Retorno
Shape
: esse elemento de página para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
Redimensiona a largura do elemento pela proporção especificada. A largura do elemento é a largura da caixa delimitadora quando ele não tem rotação.
Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de tamanho e posicionamento.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
ratio | Number | A proporção pela qual dimensionar a largura deste elemento da página. |
Retorno
Shape
: esse elemento de página para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
Seleciona apenas o PageElement
na apresentação ativa e remove qualquer seleção
anterior. Isso é o mesmo que chamar select(replace)
com true
.
Um script só pode acessar a seleção do usuário que está executando o script e apenas se ele estiver vinculado à apresentação.
Isso define a Page
mãe da PageElement
como a current page selection
.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var pageElement = slide.getPageElements()[0]; // Only select this page element and replace any previous selection. pageElement.select();
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select(replace)
Seleciona o PageElement
na apresentação ativa.
Um script só pode acessar a seleção do usuário que está executando o script e apenas se ele estiver vinculado à apresentação.
Transmita true
a esse método para selecionar apenas PageElement
e remover qualquer
seleção anterior. Isso também define o Page
pai da PageElement
como o
current page selection
.
Transmita false
para selecionar vários objetos PageElement
. Os objetos PageElement
precisam estar no mesmo Page
.
As seguintes condições precisam ser atendidas ao selecionar um elemento de página usando um parâmetro false
:
- O
Page
pai do objetoPageElement
precisa ser ocurrent page selection
. - Não deve haver vários objetos
Page
selecionados.
Para garantir que esse seja o caso, a abordagem preferencial é selecionar a Page
mãe
primeiro usando Page.selectAsCurrentPage()
e, em seguida, selecionar os elementos da página nessa página.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // First select the slide page, as the current page selection. slide.selectAsCurrentPage(); // Then select all the page elements in the selected slide page. var pageElements = slide.getPageElements(); for (var i = 0; i < pageElements.length; i++) { pageElements[i].select(false); }
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
replace | Boolean | Se for true , a seleção substituirá qualquer anterior. Caso contrário, será adicionada a qualquer anterior. |
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendBackward()
Envia o elemento de página para trás na página por um elemento.
O elemento de página não pode estar em um grupo.
Retorno
Shape
: esse elemento de página para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendToBack()
Envia o elemento de página para o fundo da página.
O elemento de página não pode estar em um grupo.
Retorno
Shape
: esse elemento de página para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
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. |
Retorno
Shape
: esse 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 de página.
O método não é compatível com elementos Group
.
// Set the first page element's alt text description to "new alt text description". var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setDescription('new alt text description'); Logger.log(pageElement.getDescription());
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
description | String | A string para definir a descrição do texto alternativo. |
Retorno
Shape
— Este elemento de página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
Define a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando o elemento não tem rotação.
Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de tamanho e posicionamento.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
height | Number | A nova altura do elemento da página a ser definido, em pontos. |
Retorno
Shape
: esse elemento de página para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
Define a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
left | Number | A nova posição horizontal a ser definida, em pontos. |
Retorno
Shape
: esse elemento de página para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slideIndex)
Define um Link
para o Slide
especificado usando o índice baseado em zero do slide.
// Set a link to the first slide of the presentation. shape.setLinkSlide(0);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
slideIndex | Integer | O índice baseado em zero para o slide. |
Retorno
Link
: o Link
que foi definido.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slide)
Define um Link
para o Slide
especificado, o link é definido pelo ID do slide fornecido.
// Set a link to the first slide of the presentation. var slide = presentation.getSlides()[0]; shape.setLinkSlide(slide);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
slide | Slide | O Slide que será vinculado. |
Retorno
Link
: o Link
que foi definido.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slidePosition)
Define um Link
para o Slide
especificado usando a posição relativa do slide.
// Set a link to the first slide of the presentation. shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
slidePosition | SlidePosition | O SlidePosition relativo. |
Retorno
Link
: o Link
que foi definido.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkUrl(url)
Define um Link
para a string de URL não vazia fornecida.
// Set a link to the URL. shape.setLinkUrl("https://slides.google.com");
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
url | String | A string do URL. |
Retorno
Link
: o Link
que foi definido.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setRotation(angle)
Define o ângulo de rotação no sentido horário do elemento em torno do centro em graus.
Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de tamanho e posicionamento.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
angle | Number | O novo ângulo de rotação no sentido horário a ser definido, em graus. |
Retorno
Shape
: esse elemento de página para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTitle(title)
Define o título do texto alternativo do elemento de página.
O método não é compatível com elementos Group
.
// Set the first page element's alt text title to "new alt text title". var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setTitle('new alt text title'); Logger.log(pageElement.getTitle());
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
title | String | A string para definir o título do texto alternativo. |
Retorno
Shape
— Este elemento de página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
Define a posição vertical do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
top | Number | A nova posição vertical a ser definida, em pontos. |
Retorno
Shape
: esse elemento de página para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTransform(transform)
Define a transformação do elemento de página com a transformação fornecida.
A atualização da transformação de um grupo muda a transformação absoluta dos elementos da página nesse grupo, o que pode alterar a aparência deles.
A atualização da transformação de um elemento de página que está em um grupo muda apenas a transformação desse elemento. Isso não afeta as transformações do grupo ou de outros elementos de página do grupo.
Para detalhes sobre como as transformações afetam a aparência visual dos elementos da página, consulte getTransform()
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
transform | AffineTransform | A transformação definida para esse elemento de página. |
Retorno
Shape
: esse elemento para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
Define a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando o elemento não tem rotação.
Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de tamanho e posicionamento.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
width | Number | A nova largura do elemento da página a ser definido, em pontos. |
Retorno
Shape
: esse elemento de página para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations