Class Line

Line

Uma PageElement que representa uma linha.

Métodos

MétodoTipo de retornoBreve descrição
alignOnPage(alignmentPosition)LineAlinha o elemento à posição de alinhamento especificada na página.
bringForward()LineTraz o elemento de página para a frente na página por um elemento.
bringToFront()LineTraz o elemento de página para a frente da página.
duplicate()PageElementDuplica o elemento de página.
getConnectionSites()ConnectionSite[]Retorna a lista de ConnectionSites no elemento de página ou uma lista vazia se o elemento da página não tiver sites de conexão.
getDashStyle()DashStyleRecebe o DashStyle da linha.
getDescription()StringRetorna a descrição do texto alternativo do elemento de página.
getEnd()PointRetorna o ponto final da linha, medido a partir do canto superior esquerdo da página.
getEndArrow()ArrowStyleRecebe o ArrowStyle da seta no fim da linha.
getEndConnection()ConnectionSiteRetorna a conexão no fim da linha ou null se não houver conexão.
getHeight()NumberRecebe a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando ele 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.
getLineCategory()LineCategoryRecebe o LineCategory da linha.
getLineFill()LineFillRecebe o LineFill da linha.
getLineType()LineTypeRecebe o LineType da linha.
getLink()LinkRetorna Link ou null se não houver link.
getObjectId()StringRetorna o ID exclusivo deste objeto.
getPageElementType()PageElementTypeRetorna o tipo do elemento de página, representado como um tipo enumerado PageElementType.
getParentGroup()GroupRetorna o grupo a que o elemento de página pertence ou null se o elemento não estiver em um grupo.
getParentPage()PageRetorna a página em que o elemento está.
getRotation()NumberRetorna o ângulo de rotação no sentido horário em torno do centro do elemento em graus, em que zero grau significa que não há rotação.
getStart()PointRetorna o ponto inicial da linha, medido a partir do canto superior esquerdo da página.
getStartArrow()ArrowStyleRecebe o ArrowStyle da seta no início da linha.
getStartConnection()ConnectionSiteRetorna a conexão no início da linha ou null se não houver conexão.
getTitle()StringRetorna o título do texto alternativo do elemento de página.
getTop()NumberRecebe a posição vertical do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
getTransform()AffineTransformRetorna a transformação do elemento de página.
getWeight()NumberRetorna a espessura da linha em pontos.
getWidth()NumberRetorna a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando o elemento não tem rotação.
isConnector()BooleanRetorna true se a linha for um conector ou false se não for.
preconcatenateTransform(transform)LinePré-concatena a transformação fornecida à transformação existente do elemento de página.
remove()voidRemove o elemento de página.
removeLink()voidRemove um Link.
reroute()LineRedireciona o início e o fim da linha para os dois locais de conexão mais próximos nos elementos de página conectados.
scaleHeight(ratio)LineDimensiona a altura do elemento pela proporção especificada.
scaleWidth(ratio)LineDimensiona a largura do elemento pela proporção especificada.
select()voidSeleciona apenas o PageElement na apresentação ativa e remove qualquer seleção anterior.
select(replace)voidSeleciona o PageElement na apresentação ativa.
sendBackward()LineEnvia o elemento de página para trás na página por um elemento.
sendToBack()LineEnvia o elemento da página para a parte de trás da página.
setDashStyle(style)LineDefine o DashStyle da linha.
setDescription(description)LineDefine a descrição do texto alternativo do elemento de página.
setEnd(left, top)LineDefine a posição do ponto final da linha.
setEnd(point)LineDefine a posição do ponto final da linha.
setEndArrow(style)LineDefine o ArrowStyle da seta no final da linha.
setEndConnection(connectionSite)LineDefine a conexão no fim da linha.
setHeight(height)LineDefine a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando ele não tem rotação.
setLeft(left)LineDefine a posição horizontal do elemento em pontos, medida no canto superior esquerdo da página quando o elemento não tem rotação.
setLineCategory(lineCategory)LineDefine o LineCategory da linha.
setLinkSlide(slideIndex)LinkDefine um Link para o Slide especificado usando o índice baseado em zero do slide.
setLinkSlide(slide)LinkDefine um Link para o Slide especificado. O link é definido pelo ID do slide especificado.
setLinkSlide(slidePosition)LinkDefine um Link para o Slide especificado usando a posição relativa do slide.
setLinkUrl(url)LinkDefine um Link para a string de URL não vazia fornecida.
setRotation(angle)LineDefine o ângulo de rotação do elemento no sentido horário em torno do centro, em graus.
setStart(left, top)LineDefine a posição do ponto inicial da linha.
setStart(point)LineDefine a posição do ponto inicial da linha.
setStartArrow(style)LineDefine o ArrowStyle da seta no início da linha.
setStartConnection(connectionSite)LineDefine a conexão no início da linha.
setTitle(title)LineDefine o título do texto alternativo do elemento da página.
setTop(top)LineDefine 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)LineDefine a transformação do elemento de página com a transformação fornecida.
setWeight(points)LineDefine a espessura da linha em pontos.
setWidth(width)LineDefine 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 à qual esse elemento de página será alinhado.

Devolução

Line: elemento de página para encadeamento.


bringForward()

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

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

Devolução

Line: elemento de página para encadeamento.

Autorização

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

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

bringToFront()

Traz o elemento de página para a frente da página.

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

Devolução

Line: elemento de página para encadeamento.

Autorização

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

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

duplicate()

Duplica o elemento de página.

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

Devolução

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

Autorização

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

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

getConnectionSites()

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

Devolução

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

Autorização

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

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

getDashStyle()

Recebe o DashStyle da linha.

Devolução

DashStyle: o estilo do traço usado com essa linha.

Autorização

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

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

getDescription()

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

Devolução

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

Autorização

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

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

getEnd()

Retorna o ponto final da linha, medido a partir do canto superior esquerdo da página.

Devolução

Point: o ponto final da linha.

Autorização

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

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

getEndArrow()

Recebe o ArrowStyle da seta no fim da linha.

Devolução

ArrowStyle: o estilo da seta no final dessa linha.

Autorização

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

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

getEndConnection()

Retorna a conexão no fim da linha ou null se não houver conexão.

Devolução

ConnectionSite: a conexão no fim da linha.

Autorização

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

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

getHeight()

Recebe a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando ele não tem rotação.

Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de dimensionamento e posicionamento.

Devolução

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

Autorização

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

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

getInherentHeight()

Retorna a altura inerente do elemento em pontos.

A transformação do elemento de página é relativa ao tamanho inerente dele. Use o tamanho inerente em conjunto com a transformação do elemento para determinar a aparência final dele.

Devolução

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

Autorização

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

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

getInherentWidth()

Retorna a largura inerente do elemento em pontos.

A transformação do elemento de página é relativa ao tamanho inerente dele. Use o tamanho inerente em conjunto com a transformação do elemento para determinar a aparência final dele.

Devolução

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

Autorização

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

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

getLeft()

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

Devolução

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

Autorização

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

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

getLineCategory()

Recebe o LineCategory da linha.

Devolução

LineCategory: a categoria da linha.

Autorização

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

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

getLineFill()

Recebe o LineFill da linha.

Devolução

LineFill: a configuração de preenchimento dessa linha.

Autorização

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

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

getLineType()

Recebe o LineType da linha.

Devolução

LineType: o tipo da linha.

Autorização

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

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

Retorna Link ou null se não houver link.

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

Devolução

Link

Autorização

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

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

getObjectId()

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

Devolução

String: o ID exclusivo do objeto.

Autorização

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

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

getPageElementType()

Retorna o tipo do elemento de página, representado como um tipo enumerado PageElementType.

Devolução

PageElementType: o tipo do elemento de página.

Autorização

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

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

getParentGroup()

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

Devolução

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

Autorização

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

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

getParentPage()

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

Devolução

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

Autorização

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

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

getRotation()

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

Devolução

Number: o ângulo de rotação em graus entre 0 (inclusivo) e 360 (exclusivo).

Autorização

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

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

getStart()

Retorna o ponto inicial da linha, medido a partir do canto superior esquerdo da página.

Devolução

Point: o ponto de partida da linha.

Autorização

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

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

getStartArrow()

Recebe o ArrowStyle da seta no início da linha.

Devolução

ArrowStyle: o estilo da seta no início dessa linha.

Autorização

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

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

getStartConnection()

Retorna a conexão no início da linha ou null se não houver conexão.

Devolução

ConnectionSite: a conexão no início da linha.

Autorização

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

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

getTitle()

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

Devolução

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

Autorização

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

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

getTop()

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

Devolução

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

Autorização

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

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

getTransform()

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

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

Devolução

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

Autorização

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

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

getWeight()

Retorna a espessura da linha em pontos.

Devolução

Number: a espessura da linha em pontos.

Autorização

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

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

getWidth()

Retorna a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando o elemento não tem rotação.

Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de dimensionamento e posicionamento.

Devolução

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

Autorização

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

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

isConnector()

Retorna true se a linha for um conector ou false se não for.

O conector é um tipo de linha usado para conectar sites de conexões em elementos de página aplicáveis. Cada extremidade do conector pode ser conectada a, no máximo, um local de conexão.

Devolução

Boolean: True se a linha for um conector ou false se não for.

Autorização

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

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

preconcatenateTransform(transform)

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

newTransform = argument * existingTransform

Por exemplo, para mover os elementos de uma página 36 pontos para a esquerda:

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

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

Parâmetros

NomeTipoDescrição
transformAffineTransformA transformação a ser pré-concatenizada na transformação desse elemento de página.

Devolução

Line: elemento de página para encadeamento.

Autorização

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

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

remove()

Remove o elemento de página.

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

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

Autorização

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

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

Remove um Link.

shape.removeLink();

reroute()

Redireciona o início e o fim da linha para os dois locais de conexão mais próximos nos elementos de página conectados. O início e o fim da linha precisam estar conectados a diferentes elementos de página.

Devolução

Line: a linha.

Autorização

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

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

scaleHeight(ratio)

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

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

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

Devolução

Line: elemento de página para encadeamento.

Autorização

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

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

scaleWidth(ratio)

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

Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de dimensionamento e posicionamento.

Parâmetros

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

Devolução

Line: elemento de página para encadeamento.

Autorização

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

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

select()

Seleciona apenas o PageElement na apresentação ativa e remove qualquer seleção anterior. Isso é o mesmo que chamar select(replace) com true.

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

Isso define o Page pai da PageElement como o current page selection.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

Autorização

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

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

select(replace)

Seleciona o PageElement na apresentação ativa.

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

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

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

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

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

Para garantir que esse seja o caso, a abordagem recomendada é selecionar a Page mãe primeiro usando Page.selectAsCurrentPage() e, em seguida, selecionar os elementos dessa página.

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

Parâmetros

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

Autorização

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

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

sendBackward()

Envia o elemento de página para trás na página por um elemento.

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

Devolução

Line: elemento de página para encadeamento.

Autorização

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

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

sendToBack()

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

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

Devolução

Line: elemento de página para encadeamento.

Autorização

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

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

setDashStyle(style)

Define o DashStyle da linha.

Parâmetros

NomeTipoDescrição
styleDashStyleO estilo do traço a ser definido para esta linha.

Devolução

Line: esta linha, para encadeamento.

Autorização

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

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

setDescription(description)

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

O método não tem suporte para elementos Group.

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

Parâmetros

NomeTipoDescrição
descriptionStringA string para definir a descrição do texto alternativo.

Devolução

Line: este elemento de página.

Autorização

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

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

setEnd(left, top)

Define a posição do ponto final da linha.

O caminho da linha pode ser ajustado depois que a posição é alterada.

Parâmetros

NomeTipoDescrição
leftNumberA posição horizontal do ponto final da linha, medida em pontos a partir do canto superior esquerdo da página.
topNumberA posição vertical do ponto final da linha, medida em pontos a partir do canto superior esquerdo da página.

Devolução

Line: esta linha, para encadeamento.

Autorização

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

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

setEnd(point)

Define a posição do ponto final da linha.

O caminho da linha pode ser ajustado depois que a posição é alterada.

Parâmetros

NomeTipoDescrição
pointPointO ponto final da linha, cuja posição é medida a partir do canto superior esquerdo da página.

Devolução

Line: esta linha, para encadeamento.

Autorização

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

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

setEndArrow(style)

Define o ArrowStyle da seta no final da linha.

Parâmetros

NomeTipoDescrição
styleArrowStyleEstilo a ser definido.

Devolução

Line: esta linha, para encadeamento.

Autorização

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

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

setEndConnection(connectionSite)

Define a conexão no fim da linha. Ele move o final da linha para o local de conexão especificado, mantendo a outra extremidade intacta.

Parâmetros

NomeTipoDescrição
connectionSiteConnectionSiteO local de conexão para o qual a conexão final é atualizada, ou null se a conexão final for removida.

Devolução

Line: a linha.

Autorização

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

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

setHeight(height)

Define a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando ele não tem rotação.

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

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

Devolução

Line: elemento de página para encadeamento.

Autorização

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

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

setLeft(left)

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

Parâmetros

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

Devolução

Line: elemento de página para encadeamento.

Autorização

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

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

setLineCategory(lineCategory)

Define o LineCategory da linha.

Só é possível definir a categoria no connectors. O conector pode ser reencaminhado após a alteração da categoria.

Parâmetros

NomeTipoDescrição
lineCategoryLineCategoryA categoria de linha a ser definida.

Devolução

Line: a linha.

Autorização

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

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

setLinkSlide(slideIndex)

Define um Link para o Slide especificado usando o índice baseado em zero do slide.

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

Parâmetros

NomeTipoDescrição
slideIndexIntegerO índice baseado em zero para o slide.

Devolução

Link: o Link que foi definido

Autorização

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

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

setLinkSlide(slide)

Define um Link para o Slide especificado. O link é definido pelo ID do slide especificado.

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

Parâmetros

NomeTipoDescrição
slideSlideO Slide a ser vinculado.

Devolução

Link: o Link que foi definido

Autorização

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

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

setLinkSlide(slidePosition)

Define um Link para o Slide especificado usando a posição relativa do slide.

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

Parâmetros

NomeTipoDescrição
slidePositionSlidePositionO SlidePosition relativo.

Devolução

Link: o Link que foi definido

Autorização

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

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

setLinkUrl(url)

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

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

Parâmetros

NomeTipoDescrição
urlStringA string do URL.

Devolução

Link: o Link que foi definido

Autorização

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

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

setRotation(angle)

Define o ângulo de rotação do elemento no sentido horário em torno do centro, em graus.

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

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

Devolução

Line: elemento de página para encadeamento.

Autorização

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

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

setStart(left, top)

Define a posição do ponto inicial da linha.

O caminho da linha pode ser ajustado depois que a posição é alterada.

Parâmetros

NomeTipoDescrição
leftNumberA posição horizontal do ponto de início da linha, medida em pontos a partir do canto superior esquerdo da página.
topNumberA posição vertical do ponto inicial da linha, medida em pontos a partir do canto superior esquerdo da página.

Devolução

Line: esta linha, para encadeamento.

Autorização

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

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

setStart(point)

Define a posição do ponto inicial da linha.

O caminho da linha pode ser ajustado depois que a posição é alterada.

Parâmetros

NomeTipoDescrição
pointPointO ponto inicial da linha, cuja posição é medida a partir do canto superior esquerdo da página.

Devolução

Line: esta linha, para encadeamento.

Autorização

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

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

setStartArrow(style)

Define o ArrowStyle da seta no início da linha.

Parâmetros

NomeTipoDescrição
styleArrowStyleO novo estilo de seta a ser definido.

Devolução

Line: esta linha, para encadeamento.

Autorização

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

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

setStartConnection(connectionSite)

Define a conexão no início da linha. Ele move o início da linha para o local de conexão especificado, mantendo a outra extremidade intacta.

Parâmetros

NomeTipoDescrição
connectionSiteConnectionSiteO site de conexão para o qual a conexão inicial é atualizada, ou null se a conexão inicial for removida.

Devolução

Line: a linha.

Autorização

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

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

setTitle(title)

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

O método não tem suporte para elementos Group.

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

Parâmetros

NomeTipoDescrição
titleStringA string para definir o título do texto alternativo.

Devolução

Line: este elemento de página.

Autorização

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

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

setTop(top)

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

Parâmetros

NomeTipoDescrição
topNumberA nova posição vertical a ser definida, em pontos.

Devolução

Line: elemento de página para encadeamento.

Autorização

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

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

setTransform(transform)

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

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

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

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

Parâmetros

NomeTipoDescrição
transformAffineTransformA transformação definida para esse elemento de página.

Devolução

Line: este elemento, para encadeamento.

Autorização

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

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

setWeight(points)

Define a espessura da linha em pontos.

Parâmetros

NomeTipoDescrição
pointsNumberA nova espessura da linha em pontos.

Devolução

Line: esta linha, para encadeamento.

Autorização

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

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

setWidth(width)

Define a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando o elemento não tem rotação.

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

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

Devolução

Line: elemento de página para encadeamento.

Autorização

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

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