Um PageElement
que representa um gráfico vinculado incorporado das Planilhas Google.
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
alignOnPage(alignmentPosition) | SheetsChart | Alinha o elemento à posição de alinhamento especificada na página. |
asImage() | Image | Retorna o gráfico como uma imagem ou null se ele não for uma imagem incorporada. |
bringForward() | SheetsChart | Move o elemento da página para frente em um elemento. |
bringToFront() | SheetsChart | Traz o elemento da página para a frente. |
duplicate() | PageElement | Duplica o elemento da página. |
getChartId() | Integer | Recebe o ID do gráfico específico na planilha do Google Sheets que está incorporada. |
getConnectionSites() | ConnectionSite[] | Retorna a lista de ConnectionSite s no elemento da página ou uma lista vazia se o elemento
da página não tiver sites de conexão. |
getDescription() | String | Retorna a descrição do texto alternativo do elemento da página. |
getEmbedType() | SheetsChartEmbedType | Retorna o tipo de incorporação do gráfico das Planilhas. |
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 para esse objeto. |
getPageElementType() | PageElementType | Retorna o tipo do elemento da página, representado como um tipo enumerado PageElementType . |
getParentGroup() | Group | Retorna o grupo ao qual 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 o elemento está. |
getRotation() | Number | Retorna o ângulo de rotação no sentido horário do elemento em torno do centro em graus, em que zero graus significa nenhuma rotação. |
getSpreadsheetId() | String | Recebe o ID da planilha do Google Sheets que contém o gráfico de origem. |
getTitle() | String | Retorna o título do texto alternativo do elemento da 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 da página. |
getWidth() | Number | Retorna a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando ele não tem rotação. |
preconcatenateTransform(transform) | SheetsChart | Pré-concatena a transformação fornecida à transformação atual do elemento da página. |
refresh() | void | Atualiza o gráfico substituindo-o pela versão mais recente das Planilhas Google. |
remove() | void | Remove o elemento da página. |
removeLink() | void | Remove uma Link . |
scaleHeight(ratio) | SheetsChart | Dimensiona a altura do elemento pela proporção especificada. |
scaleWidth(ratio) | SheetsChart | 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() | SheetsChart | Envia o elemento da página para trás na página por um elemento. |
sendToBack() | SheetsChart | Envia o elemento da página para a parte de trás. |
setDescription(description) | SheetsChart | Define a descrição do texto alternativo do elemento da página. |
setHeight(height) | SheetsChart | Define a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando ele não tem rotação. |
setLeft(left) | SheetsChart | 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 fornecido usando o índice baseado em zero do slide. |
setLinkSlide(slide) | Link | Define um Link para o Slide fornecido. O link é definido pelo ID do slide fornecido. |
setLinkSlide(slidePosition) | Link | Define um Link para o Slide fornecido usando a posição relativa do slide. |
setLinkUrl(url) | Link | Define um Link como a string de URL não vazia especificada. |
setRotation(angle) | SheetsChart | Define o ângulo de rotação no sentido horário do elemento em torno do centro em graus. |
setTitle(title) | SheetsChart | Define o título do texto alternativo do elemento da página. |
setTop(top) | SheetsChart | 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) | SheetsChart | Define a transformação do elemento da página com a transformação fornecida. |
setWidth(width) | SheetsChart | Define a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando ele não tem rotação. |
Documentação detalhada
alignOnPage(alignmentPosition)
Alinha o elemento à posição de alinhamento especificada na página.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
alignmentPosition | AlignmentPosition | A posição em que alinhar esse elemento na página. |
Retornar
SheetsChart
: este elemento da página, para encadeamento.
asImage()
Retorna o gráfico como uma imagem ou null
se ele não for uma imagem incorporada.
Retornar
Image
: esse gráfico como uma imagem ou null
se o gráfico não for uma imagem incorporada.
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
bringForward()
Move o elemento da página para frente em um elemento.
O elemento de página não pode estar em um grupo.
Retornar
SheetsChart
: este elemento da página, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringToFront()
Traz o elemento da página para a frente.
O elemento de página não pode estar em um grupo.
Retornar
SheetsChart
: este elemento da página, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
duplicate()
Duplica o elemento da página.
O elemento de página duplicado é colocado na mesma página e na mesma posição que o original.
Retornar
PageElement
: a nova cópia desse elemento da página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getChartId()
Recebe o ID do gráfico específico na planilha do Google Sheets que está incorporada.
Retornar
Integer
: o ID do gráfico incorporado.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getConnectionSites()
Retorna a lista de ConnectionSite
s no elemento da página ou uma lista vazia se o elemento
da página não tiver sites de conexão.
Retornar
ConnectionSite[]
: a lista de sites de conexão, que pode estar vazia se o elemento não tiver sites de conexão.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDescription()
Retorna a descrição do texto alternativo do elemento da página. A descrição é combinada com o título para exibir e ler o texto alternativo.
Retornar
String
: a descrição do 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
getEmbedType()
Retorna o tipo de incorporação do gráfico das Planilhas.
Retornar
SheetsChartEmbedType
: o tipo de incorporação do gráfico.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getHeight()
Recebe a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando ele não tem rotação.
Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de dimensionamento e posicionamento.
Retornar
Number
: a altura inerente do elemento da página em pontos ou null
se o elemento da página não tiver altura.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentHeight()
Retorna a altura inerente do elemento em pontos.
A transformação do elemento da página é relativa ao tamanho inerente dele. Use o tamanho inerente em conjunto com a transformação do elemento para determinar a aparência visual final dele.
Retornar
Number
: a altura inerente do elemento da página em pontos ou null
se o elemento da página não tiver altura.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentWidth()
Retorna a largura inerente do elemento em pontos.
A transformação do elemento da página é relativa ao tamanho inerente dele. Use o tamanho inerente em conjunto com a transformação do elemento para determinar a aparência visual final dele.
Retornar
Number
: a largura inerente do elemento de página em pontos ou null
se o elemento de página não tiver largura.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLeft()
Retorna a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
Retornar
Number
: a posição horizontal desse elemento em pontos, a partir do canto superior esquerdo da página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLink()
Retorna Link
ou null
se não houver link.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; const link = shape.getLink(); if (link != null) { Logger.log(`Shape has a link of type: ${link.getLinkType()}`); }
Retornar
Link
: o Link
ou null
se não houver um link.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getObjectId()
Retorna o ID exclusivo para esse objeto. Os IDs de objeto usados por páginas e elementos de página compartilham o mesmo namespace.
Retornar
String
: o ID exclusivo para esse objeto.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementType()
Retorna o tipo do elemento da página, representado como um tipo enumerado PageElementType
.
Retornar
PageElementType
: o tipo do elemento da página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentGroup()
Retorna o grupo ao qual esse elemento de página pertence ou null
se o elemento não estiver em um
grupo.
Retornar
Group
: o grupo ao qual o elemento da página pertence ou null
.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentPage()
getRotation()
Retorna o ângulo de rotação no sentido horário do elemento em torno do centro em graus, em que zero graus significa nenhuma rotação.
Retornar
Number
: é o ângulo de rotação em graus entre 0 (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
getSpreadsheetId()
Recebe o ID da planilha do Google Sheets que contém o gráfico de origem.
Retornar
String
: o ID da planilha que contém o gráfico de origem.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTitle()
Retorna o título do texto alternativo do elemento da página. O título é combinado com a descrição para 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 exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTop()
Recebe a posição vertical do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
Retornar
Number
: a posição vertical desse elemento em pontos, a partir do canto superior esquerdo da página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTransform()
Retorna a transformação do elemento da página.
A aparência visual do elemento da página é determinada pela transformação absoluta. Para calcular a transformação absoluta, pré-concatene a transformação de um elemento da página com as transformações de todos os grupos pais. Se o elemento da página não estiver em um grupo, a transformação absoluta será igual ao valor nesse campo.
Retornar
AffineTransform
: a transformação do elemento da página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWidth()
Retorna a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando ele não tem rotação.
Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de dimensionamento e posicionamento.
Retornar
Number
: a largura inerente do elemento de página em pontos ou null
se o elemento de página não tiver largura.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
preconcatenateTransform(transform)
Pré-concatena a transformação fornecida à transformação atual do elemento da página.
newTransform = argument * existingTransform;
Por exemplo, para mover um elemento da página 36 pontos para a esquerda:
const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; element.preconcatenateTransform( SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(), );
Também é possível substituir a transformação do elemento da página por setTransform(transform)
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
transform | AffineTransform | A transformação a ser pré-concatenada na transformação do elemento da página. |
Retornar
SheetsChart
: este elemento da página, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
refresh()
Atualiza o gráfico substituindo-o pela versão mais recente das Planilhas Google. Se o gráfico já estiver atualizado, não faça nenhuma mudança nele na apresentaçã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/spreadsheets.readonly
remove()
Remove o elemento da página.
Se, após uma operação de remoção, um Group
tiver apenas um ou nenhum elemento da página, o
grupo também será removido.
Se um marcador de posição PageElement
for removido em um mestre ou layout, todos os marcadores de posição vazios
herdados também serão removidos.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeLink()
Remove uma Link
.
const slides = SlidesApp.getActivePresentation().getSlides(); slides[1].getShapes()[0].removeLink();
scaleHeight(ratio)
Dimensiona a altura do elemento pela proporção especificada. A altura do elemento é a altura da caixa delimitadora quando o elemento não tem rotação.
Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de dimensionamento e posicionamento.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
ratio | Number | A proporção para dimensionar a altura desse elemento da página. |
Retornar
SheetsChart
: este elemento da página, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
Dimensiona a largura do elemento pela proporção especificada. A largura do elemento é a largura da caixa delimitadora quando o elemento não tem rotação.
Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de dimensionamento e posicionamento.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
ratio | Number | A proporção para dimensionar a largura desse elemento da página. |
Retornar
SheetsChart
: este elemento da página, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
Seleciona apenas 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 somente se ele estiver vinculado à apresentação.
Isso define a Page
pai da PageElement
como a current page selection
.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = slide.getPageElements()[0]; // Only select this page element and replace any previous selection. pageElement.select();
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select(replace)
Seleciona o PageElement
na apresentação ativa.
Um script só pode acessar a seleção do usuário que está executando o script e somente se ele estiver vinculado à apresentação.
Transmita true
para este método para selecionar apenas o PageElement
e remover qualquer
seleção anterior. Isso também define o Page
pai do PageElement
como o
current page selection
.
Transmita false
para selecionar vários objetos PageElement
. Os objetos PageElement
precisam estar no mesmo Page
.
As seguintes condições precisam ser atendidas ao selecionar um elemento da página usando um parâmetro
false
:
- O
Page
pai do objetoPageElement
precisa ser ocurrent page selection
. - Não devem haver vários objetos
Page
selecionados.
Para garantir que esse seja o caso, a abordagem recomendada é selecionar a Page
pai primeiro usando Page.selectAsCurrentPage()
e, em seguida, selecionar os elementos da página.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // First select the slide page, as the current page selection. slide.selectAsCurrentPage(); // Then select all the page elements in the selected slide page. const pageElements = slide.getPageElements(); for (let i = 0; i < pageElements.length; i++) { pageElements[i].select(false); }
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
replace | Boolean | Se true , a seleção substitui qualquer seleção anterior. Caso contrário, a
seleção é adicionada a qualquer seleção anterior. |
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendBackward()
Envia o elemento da página para trás na página por um elemento.
O elemento de página não pode estar em um grupo.
Retornar
SheetsChart
: este elemento da página, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendToBack()
Envia o elemento da página para a parte de trás.
O elemento de página não pode estar em um grupo.
Retornar
SheetsChart
: este elemento da página, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setDescription(description)
Define a descrição do texto alternativo do elemento da página.
O método não é compatível com elementos Group
.
// Set the first page element's alt text description to "new alt text // description". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setDescription('new alt text description'); Logger.log(pageElement.getDescription());
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
description | String | A string para definir a descrição do texto alternativo. |
Retornar
SheetsChart
: este elemento da página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
Define a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando ele não tem rotação.
Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de dimensionamento e posicionamento.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
height | Number | A nova altura desse elemento da página a ser definida, em pontos. |
Retornar
SheetsChart
: este elemento da página, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
Define a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
left | Number | A nova posição horizontal a ser definida, em pontos. |
Retornar
SheetsChart
: este elemento da página, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slideIndex)
Define um Link
para o Slide
fornecido usando o índice baseado em zero do slide.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(0);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
slideIndex | Integer | O índice do slide com base em zero. |
Retornar
Link
: o Link
que foi definido.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slide)
Define um Link
para o Slide
fornecido. O link é definido pelo ID do slide fornecido.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(slides[0]);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
slide | Slide | O Slide a ser vinculado. |
Retornar
Link
: o Link
que foi definido.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slidePosition)
Define um Link
para o Slide
fornecido usando a posição relativa do slide.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
slidePosition | SlidePosition | O SlidePosition relativo. |
Retornar
Link
: o Link
que foi definido.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkUrl(url)
Define um Link
como a string de URL não vazia especificada.
// Set a link to the URL. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkUrl('https://slides.google.com');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
url | String | A string do URL. |
Retornar
Link
: o Link
que foi definido.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setRotation(angle)
Define o ângulo de rotação no sentido horário do elemento em torno do centro em graus.
Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de dimensionamento e posicionamento.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
angle | Number | O novo ângulo de rotação no sentido horário a ser definido, em graus. |
Retornar
SheetsChart
: este elemento da página, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTitle(title)
Define o título do texto alternativo do elemento da página.
O método não é compatível com elementos Group
.
// Set the first page element's alt text title to "new alt text title". const 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. |
Retornar
SheetsChart
: este elemento da página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
Define a posição vertical do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
top | Number | A nova posição vertical a ser definida, em pontos. |
Retornar
SheetsChart
: este elemento da página, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTransform(transform)
Define a transformação do elemento da página com a transformação fornecida.
Atualizar a transformação de um grupo muda a transformação absoluta dos elementos da página nesse grupo, o que pode mudar a aparência visual deles.
Atualizar a transformação de um elemento de página que está em um grupo só muda a transformação desse elemento, não afeta as transformações do grupo ou de outros elementos de página no grupo.
Para saber 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 da página. |
Retornar
SheetsChart
: este elemento, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
Define a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando ele não tem rotação.
Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de dimensionamento e posicionamento.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
width | Number | A nova largura desse elemento da página a ser definida, em pontos. |
Retornar
SheetsChart
: este elemento da página, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations