Class SheetsChart

Planilhas

Um PageElement que representa um gráfico vinculado incorporado do Planilhas Google.

Métodos

MétodoTipo de retornoBreve descrição
alignOnPage(alignmentPosition)SheetsChartAlinha o elemento à posição de alinhamento especificada na página.
asImage()ImageRetorna o gráfico como uma imagem ou null se ele não for uma imagem incorporada.
bringForward()SheetsChartTraz o elemento da página para frente na página em um elemento.
bringToFront()SheetsChartTraz o elemento da página para a frente da página.
duplicate()PageElementDuplicar o elemento da página.
getChartId()IntegerRecebe o ID do gráfico específico na planilha do Planilhas Google incorporada.
getConnectionSites()ConnectionSite[]Retorna a lista de ConnectionSites no elemento de página ou uma lista vazia se o elemento de página não tiver sites de conexão.
getDescription()StringRetorna a descrição de texto alternativo do elemento de página.
getEmbedType()SheetsChartEmbedTypeRetorna o tipo de incorporação do gráfico do Planilhas.
getHeight()NumberRecebe a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando o elemento não tem rotação.
getInherentHeight()NumberRetorna a altura inerente do elemento em pontos.
getInherentWidth()NumberRetorna a largura inerente do elemento em pontos.
getLeft()NumberRetorna a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
getLink()LinkRetornará Link ou null se não houver um link.
getObjectId()StringRetorna o ID exclusivo do objeto.
getPageElementType()PageElementTypeRetorna o tipo do elemento de página, representado como uma enumeração PageElementType.
getParentGroup()GroupRetorna o grupo a que esse elemento de página pertence ou null se o elemento não estiver em um grupo.
getParentPage()PageRetorna a página em que o elemento da página está.
getRotation()NumberRetorna o ângulo de rotação no sentido horário do elemento em torno do centro, em graus, em que zero grau significa que não há rotação.
getSpreadsheetId()StringAcessa o ID da planilha do Planilhas Google que contém o gráfico de origem.
getTitle()StringRetorna o título do texto alternativo do elemento da página.
getTop()NumberRecebe a posição vertical do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
getTransform()AffineTransformRetorna a transformação do elemento de página.
getWidth()NumberRetorna a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando o elemento não tem rotação.
preconcatenateTransform(transform)SheetsChartPreconceita a transformação fornecida na transformação atual do elemento de página.
refresh()voidAtualiza o gráfico substituindo-o pela versão mais recente do gráfico no Planilhas Google.
remove()voidRemove o elemento de página.
removeLink()voidRemove um Link.
scaleHeight(ratio)SheetsChartEscalona a altura do elemento pela proporção especificada.
scaleWidth(ratio)SheetsChartEscalona a largura do elemento pela proporção especificada.
select()voidSeleciona somente o PageElement na apresentação ativa e remove qualquer seleção anterior.
select(replace)voidSeleciona a PageElement na apresentação ativa.
sendBackward()SheetsChartEnvia o elemento de página de volta na página por um elemento.
sendToBack()SheetsChartEnvia o elemento da página para o verso.
setDescription(description)SheetsChartDefine a descrição de texto alternativo do elemento de página.
setHeight(height)SheetsChartDefine a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando o elemento não tem rotação.
setLeft(left)SheetsChartDefine a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
setLinkSlide(slideIndex)LinkDefine um Link para o Slide especificado usando o índice baseado em zero do slide.
setLinkSlide(slide)LinkDefine um Link para o Slide especificado, o link é definido pelo ID do slide fornecido.
setLinkSlide(slidePosition)LinkDefine um Link para o Slide especificado usando a posição relativa do slide.
setLinkUrl(url)LinkDefine um Link para a string de URL não vazia especificada.
setRotation(angle)SheetsChartDefine o ângulo de rotação no sentido horário do elemento em torno do centro em graus.
setTitle(title)SheetsChartDefine o título do texto alternativo do elemento da página.
setTop(top)SheetsChartDefine 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)SheetsChartDefine a transformação do elemento de página com a transformação fornecida.
setWidth(width)SheetsChartDefine a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando o elemento não tem rotação.

Documentação detalhada

alignOnPage(alignmentPosition)

Alinha o elemento à posição de alinhamento especificada na página.

Parâmetros

NomeTipoDescrição
alignmentPositionAlignmentPositionA posição para alinhar este elemento de página na página.

Retornar

SheetsChart: esse elemento de 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 é uma imagem ou null se ele 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()

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

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

Retornar

SheetsChart: 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 da página para a frente da página.

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

Retornar

SheetsChart: 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()

Duplicar o elemento da página.

O elemento de página duplicado é colocado na mesma página que a original.

Retornar

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

Autorização

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

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

getChartId()

Recebe o ID do gráfico específico na planilha do Planilhas Google 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 ConnectionSites no elemento de página ou uma lista vazia se o elemento de página não tiver sites de conexão.

Retornar

ConnectionSite[]: a lista de sites de conexão, que pode estar 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

getDescription()

Retorna a descrição de texto alternativo do elemento de página. A descrição é combinada com o título para mostrar e ler o texto alternativo.

Retornar

String: a descrição de texto alternativo 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

getEmbedType()

Retorna o tipo de incorporação do gráfico do Planilhas.

Retornar

SheetsChartEmbedType: o tipo de incorporação deste 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 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.

Retornar

Number: a altura inerente do elemento da página em pontos ou null se o elemento da página não tiver uma altura.

Autorização

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

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

getInherentHeight()

Retorna a altura inerente do elemento em pontos.

A transformação do elemento 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.

Retornar

Number: a altura inerente do elemento da página em pontos ou null se o elemento da página não tiver uma altura.

Autorização

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

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

getInherentWidth()

Retorna a largura inerente do elemento em pontos.

A transformação do elemento 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.

Retornar

Number: a largura inerente do elemento da página em pontos ou null se o elemento da página não tiver uma largura.

Autorização

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

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

getLeft()

Retorna a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.

Retornar

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

Autorização

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

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

Retornará Link ou null se não houver um link.

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

Retornar

Link

Autorização

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

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

getObjectId()

Retorna o ID exclusivo do objeto. Os IDs de objeto usados por páginas e elementos de página compartilham o mesmo namespace.

Retornar

String: o ID exclusivo do objeto.

Autorização

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

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

getPageElementType()

Retorna o tipo do elemento de página, representado como uma enumeração PageElementType.

Retornar

PageElementType: o tipo de 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

getParentGroup()

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

Retornar

Group: grupo a que este elemento da página pertence ou null.

Autorização

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

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

getParentPage()

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

Retornar

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

Autorização

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

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

getRotation()

Retorna o ângulo de rotação no sentido horário do elemento em torno do centro, em graus, em que zero grau significa que não há rotação.

Retornar

Number: o ângulo de rotação em graus entre 0 (incluso) 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()

Acessa o ID da planilha do Planilhas Google 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 mostrar 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: 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 de página.

A aparência visual do elemento de página é determinada pela transformação absoluta. Para calcular a transformação absoluta, pré-concatene a transformação de um elemento da página com as transformações de todos os grupos pais dela. Se o elemento de página não estiver em um grupo, a transformação absoluta dele será igual ao valor neste campo.

Retornar

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

Autorização

Os scripts que usam esse método 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.

Retornar

Number: a largura inerente do elemento da página em pontos ou null se o elemento da página não tiver uma largura.

Autorização

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

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

preconcatenateTransform(transform)

Preconceita a transformação fornecida na transformação atual do elemento de página.

newTransform = argument * existingTransform

Por exemplo, para mover um elemento de página 36 pontos para a esquerda:

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

Também é possível substituir a transformação do elemento de página por setTransform(transform).

Parâmetros

NomeTipoDescrição
transformAffineTransformA transformação a ser preconceitada na transformação desse elemento de página.

Retornar

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

refresh()

Atualiza o gráfico substituindo-o pela versão mais recente do gráfico no Planilhas Google. Se o gráfico já estiver atualizado, o gráfico não vai mudar.

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 de página.

Se, após uma operação de remoção, um Group contiver apenas um ou nenhum elemento de página, o próprio grupo também será removido.

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

Autorização

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

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

Remove um Link.

shape.removeLink();

scaleHeight(ratio)

Escalona a altura do elemento pela proporção especificada. A altura do elemento é a altura da caixa delimitadora quando o elemento não tem rotação.

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

NomeTipoDescrição
ratioNumberÉ a proporção para ajustar a altura desse elemento de página.

Retornar

SheetsChart: 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)

Escalona 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 tamanho e posicionamento.

Parâmetros

NomeTipoDescrição
ratioNumberÉ a proporção para ajustar a largura desse elemento de página.

Retornar

SheetsChart: 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 somente 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 o está executando 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 exigem autorização com um ou mais dos seguintes escopos:

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

select(replace)

Seleciona a PageElement na apresentação ativa.

Um script só pode acessar a seleção do usuário que o está executando e somente se ele estiver vinculado à apresentação.

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

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

As condições a seguir precisam ser atendidas ao selecionar um elemento de página usando um parâmetro false:

  1. O pai Page do objeto PageElement precisa ser current page selection.
  2. Não pode haver vários objetos Page selecionados.

Para garantir que seja assim, selecione a Page mãe primeiro usando Page.selectAsCurrentPage() e, em seguida, selecione os elementos da página.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
var pageElements = slide.getPageElements();
for (var i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Parâmetros

NomeTipoDescrição
replaceBooleanSe true, a seleção substituirá qualquer seleção anterior. Caso contrário, a seleção será adicionada a qualquer seleção anterior.

Autorização

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

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

sendBackward()

Envia o elemento de página de volta na página por um elemento.

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

Retornar

SheetsChart: 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 da página para o verso.

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

Retornar

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

setDescription(description)

Define a descrição de texto alternativo do elemento de página.

O método não é compatível com os elementos Group.

// Set the first page element's alt text description to "new alt text description".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Parâmetros

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

Retornar

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

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

Retornar

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

NomeTipoDescrição
leftNumberNova posição horizontal a ser definida, em pontos.

Retornar

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

NomeTipoDescrição
slideIndexIntegerO índice de zero no slide.

Retornar

Link: o Link que foi definido

Autorização

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

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

setLinkSlide(slide)

Define um Link para 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

NomeTipoDescrição
slideSlideO 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 especificado usando a posição relativa do slide.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

Parâmetros

NomeTipoDescrição
slidePositionSlidePositionO SlidePosition relativo.

Retornar

Link: o Link que foi definido

Autorização

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

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

setLinkUrl(url)

Define um Link para a string de URL não vazia especificada.

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

Parâmetros

NomeTipoDescrição
urlStringA 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 tamanho e posicionamento.

Parâmetros

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

Retornar

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

O método não é compatível com os elementos Group.

// Set the first page element's alt text title to "new alt text title".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Parâmetros

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

Retornar

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

NomeTipoDescrição
topNumberNova posição vertical definida, em pontos.

Retornar

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

Atualizar a transformação de um grupo muda a transformação absoluta dos elementos de página nesse grupo, o que pode alterar a aparência.

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

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

Parâmetros

NomeTipoDescrição
transformAffineTransformA transformação definida para esse elemento de 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 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

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

Retornar

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