Esta página foi traduzida pela API Cloud Translation.

Class SpeakerSpotlight

Um PageElement que representa um apresentador em destaque.

const speakerSpotlight = slide.getPageElements()[0];
console.log(`Page element is of type: ${speakerSpotlight.getPageElementType().toString()}`);

Métodos

Método	Tipo de retorno	Breve descrição
`alignOnPage(alignmentPosition)`	`SpeakerSpotlight`	Alinha o elemento à posição de alinhamento especificada na página.
`bringForward()`	`SpeakerSpotlight`	Traz o elemento de página para a frente na página por um elemento.
`bringToFront()`	`SpeakerSpotlight`	Traz o elemento de página para a frente da página.
`duplicate()`	`PageElement`	Duplica o elemento de página.
`getBorder()`	`Border`	Retorna o `Border` do apresentador em destaque.
`getConnectionSites()`	`ConnectionSite[]`	Retorna a lista de `ConnectionSite`s no elemento de página ou uma lista vazia se a página não possui sites de conexão.
`getDescription()`	`String`	Retorna a descrição do texto alternativo do elemento de página.
`getHeight()`	`Number`	Extrai a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando o 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 do página quando o elemento não tem rotação.
`getMaskShapeType()`	`ShapeType`	Retorna o `ShapeType` da máscara aplicada ao apresentador em destaque, ou `null` se não há máscara.
`getObjectId()`	`String`	Retorna o ID exclusivo deste objeto.
`getPageElementType()`	`PageElementType`	Retorna o tipo do elemento de página, representado como um tipo enumerado `PageElementType`.
`getParentGroup()`	`Group`	Retorna o grupo a que o elemento de página pertence ou `null` se o elemento não estiver em um grupo.
`getParentPage()`	`Page`	Retorna a página em que o elemento está.
`getRotation()`	`Number`	Retorna o ângulo de rotação no sentido horário em torno do centro do elemento em graus, onde zero grau significa que não há rotação.
`getTitle()`	`String`	Retorna o título do texto alternativo do elemento de página.
`getTop()`	`Number`	Recebe a posição vertical do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
`getTransform()`	`AffineTransform`	Retorna a transformação do elemento de página.
`getWidth()`	`Number`	Retorna a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando o elemento não tem rotação.
`preconcatenateTransform(transform)`	`SpeakerSpotlight`	Pré-concatena a transformação fornecida à transformação existente do elemento de página.
`remove()`	`void`	Remove o elemento de página.
`scaleHeight(ratio)`	`SpeakerSpotlight`	Dimensiona a altura do elemento pela proporção especificada.
`scaleWidth(ratio)`	`SpeakerSpotlight`	Dimensiona a largura do elemento pela proporção especificada.
`select()`	`void`	Seleciona apenas o `PageElement` na apresentação ativa e remove os itens anteriores
`select(replace)`	`void`	Seleciona o `PageElement` na apresentação ativa.
`sendBackward()`	`SpeakerSpotlight`	Envia o elemento de página para trás na página por um elemento.
`sendToBack()`	`SpeakerSpotlight`	Envia o elemento da página para a parte de trás da página.
`setDescription(description)`	`SpeakerSpotlight`	Define a descrição do texto alternativo do elemento de página.
`setHeight(height)`	`SpeakerSpotlight`	Define a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando o não tem rotação.
`setLeft(left)`	`SpeakerSpotlight`	Define a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo do página quando o elemento não tem rotação.
`setRotation(angle)`	`SpeakerSpotlight`	Define o ângulo de rotação do elemento no sentido horário em torno do centro, em graus.
`setTitle(title)`	`SpeakerSpotlight`	Define o título do texto alternativo do elemento da página.
`setTop(top)`	`SpeakerSpotlight`	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)`	`SpeakerSpotlight`	Define a transformação do elemento de página com a transformação fornecida.
`setWidth(width)`	`SpeakerSpotlight`	Define a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando o não tem rotação.

Documentação detalhada

`alignOnPage(alignmentPosition)`

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

Parâmetros

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

Retornar

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

Retornar

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

Retornar

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

Retornar

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

`getBorder()`

Retorna o Border do apresentador em destaque.

// Gets the first element on the page, which in
// this example is of type speaker spotlight.
const speakerSpotlight = slide.getPageElements()[0];
// Gets the border of the speaker spotlight.
const border = speakerSpotlight.getBorder();

Retornar

Border: a borda do apresentador em destaque.

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 a página não possui sites de conexão.

Retornar

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

`getDescription()`

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

Retornar

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

`getHeight()`

Extrai a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando o 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 estão compatíveis com este método, consulte o 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 não têm 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 juntamente com a transformação do elemento para determinar a aparência final do elemento.

Retornar

Number: a altura inerente do elemento da página em pontos, ou null se o elemento da página não não têm 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 juntamente com a transformação do elemento para determinar a aparência final do elemento.

Retornar

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

Retornar

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

`getMaskShapeType()`

Retorna o ShapeType da máscara aplicada ao apresentador em destaque, ou null se não há máscara.

// Gets the first element on the page, which in
// this example is of type speaker spotlight.
const speakerSpotlight = slide.getPageElements()[0];
// Gets the shape type of the mask on the speaker spotlight.
const maskShapeType = speakerSpotlight.getMaskShapeType();

Retornar

ShapeType: o tipo da máscara de apresentador em destaque.

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.

Retornar

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.

Retornar

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.

Retornar

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

Retornar

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

Retornar

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

`getTitle()`

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

Retornar

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.

Retornar

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 computa a transformação absoluta e pré-concatena a transformação de um elemento de página com as transformações de todos os grupos principais. Se o elemento de página não estiver em um grupo, sua transformação absoluta 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 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.

Retornar

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

Autorização

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

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

`preconcatenateTransform(transform)`

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

newTransform = argument * existingTransform

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

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

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

Parâmetros

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

Retornar

SpeakerSpotlight: 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, um Group tiver apenas um ou nenhum elemento de página, o o grupo também é removido.

Se um marcador PageElement for removido em um mestre ou layout, todos os valores de os espaços reservados também sã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

`scaleHeight(ratio)`

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

Parâmetros

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

Retornar

SpeakerSpotlight: elemento de página para encadeamento.

Autorização

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

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

`scaleWidth(ratio)`

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

Parâmetros

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

Retornar

SpeakerSpotlight: 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 os itens anteriores 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 o script está 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ó pode acessar a seleção do usuário que está executando o script e somente se o script está vinculado à apresentação.

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

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

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

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

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

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

Parâmetros

Nome	Tipo	Descrição
`replace`	`Boolean`	Se for `true`, a seleção substituirá qualquer seleção anterior. caso contrário, 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.

Retornar

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

Retornar

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

`setDescription(description)`

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

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

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

Parâmetros

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

Retornar

SpeakerSpotlight: este elemento de página.

Autorização

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

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

`setHeight(height)`

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

Parâmetros

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

Retornar

SpeakerSpotlight: 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 a partir do canto superior esquerdo do 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

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

`setRotation(angle)`

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

Parâmetros

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

Retornar

SpeakerSpotlight: elemento de página para encadeamento.

Autorização

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

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

`setTitle(title)`

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

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

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

Parâmetros

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

Retornar

SpeakerSpotlight: este elemento de página.

Autorização

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

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

`setTop(top)`

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

Parâmetros

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

Retornar

SpeakerSpotlight: 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 em desse grupo, o que pode mudar sua aparência.

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

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

Parâmetros

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

Retornar

SpeakerSpotlight: este elemento, para encadeamento.

Autorização

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

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

`setWidth(width)`

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

Parâmetros

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

Retornar

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