Esta página foi traduzida pela API Cloud Translation.

Class SlidesApp

Cria e abre um Presentations que pode ser editado.

// Open a presentation by ID.
var preso = SlidesApp.openById('PRESENTATION_ID_GOES_HERE');

// Create and open a presentation.
preso = SlidesApp.create('Presentation Name');

Propriedades

Propriedade	Tipo	Descrição
`AlignmentPosition`	`AlignmentPosition`	Uma enumeração dos tipos de posições de alinhamento.
`ArrowStyle`	`ArrowStyle`	Uma enumeração dos diferentes estilos de seta que uma `Line` pode ter.
`AutoTextType`	`AutoTextType`	Uma enumeração dos tipos de texto automático.
`AutofitType`	`AutofitType`	Uma enumeração dos tipos de ajuste automático.
`CellMergeState`	`CellMergeState`	Uma enumeração dos diferentes estados de mesclagem de uma célula da tabela.
`ColorType`	`ColorType`	Uma enumeração de tipos de cores.
`ContentAlignment`	`ContentAlignment`	Uma enumeração de valores usados para especificar o alinhamento de conteúdo.
`DashStyle`	`DashStyle`	Uma enumeração dos diferentes estilos de traços que uma `Line` pode ter.
`FillType`	`FillType`	Uma enumeração de tipos de preenchimento.
`LineCategory`	`LineCategory`	Uma enumeração das categorias de `Line`.
`LineFillType`	`LineFillType`	Uma enumeração dos tipos de `LineFill`.
`LineType`	`LineType`	Uma enumeração dos tipos de `Line`.
`LinkType`	`LinkType`	Uma enumeração dos tipos de links.
`ListPreset`	`ListPreset`	Uma enumeração dos tipos de predefinições da lista.
`PageBackgroundType`	`PageBackgroundType`	Uma enumeração dos tipos de planos de fundo da página.
`PageElementType`	`PageElementType`	Uma enumeração dos tipos de elementos de página.
`PageType`	`PageType`	Uma enumeração dos tipos de páginas.
`ParagraphAlignment`	`ParagraphAlignment`	Uma enumeração dos tipos de alinhamento de parágrafo.
`PlaceholderType`	`PlaceholderType`	Uma enumeração dos tipos de marcadores de posição.
`PredefinedLayout`	`PredefinedLayout`	Uma enumeração dos layouts predefinidos.
`SelectionType`	`SelectionType`	Uma enumeração dos tipos de seleções.
`ShapeType`	`ShapeType`	Uma enumeração dos tipos de formas.
`SheetsChartEmbedType`	`SheetsChartEmbedType`	Uma enumeração dos tipos de incorporação de gráficos do app Planilhas.
`SlideLinkingMode`	`SlideLinkingMode`	Uma enumeração das formas como os slides podem ser vinculados.
`SlidePosition`	`SlidePosition`	Uma enumeração dos tipos de posições de slide.
`SpacingMode`	`SpacingMode`	Uma enumeração dos tipos de modos de espaçamento.
`TextBaselineOffset`	`TextBaselineOffset`	Uma enumeração dos tipos de deslocamento da linha de base de texto.
`TextDirection`	`TextDirection`	Uma enumeração dos tipos de direções de texto.
`ThemeColorType`	`ThemeColorType`	Uma enumeração de cores de tema.
`VideoSourceType`	`VideoSourceType`	Uma enumeração dos tipos de origem de vídeo.

Métodos

Método	Tipo de retorno	Breve descrição
`create(name)`	`Presentation`	Cria e abre um novo `Presentation`.
`getActivePresentation()`	`Presentation`	Retorna a apresentação ativa no momento para a qual o script está vinculado ao contêiner ou `null` se não houver apresentação ativa.
`getUi()`	`Ui`	Retorna uma instância do ambiente da interface do usuário da apresentação que permite ao script adicione recursos como menus, caixas de diálogo e barras laterais.
`newAffineTransformBuilder()`	`AffineTransformBuilder`	Retorna um novo `AffineTransformBuilder` para criar um `AffineTransform`.
`openById(id)`	`Presentation`	Abre o `Presentation` com o ID fornecido.
`openByUrl(url)`	`Presentation`	Abre o `Presentation` com o URL fornecido.

Documentação detalhada

`create(name)`

Cria e abre um novo Presentation.

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	O nome que será dado à apresentação criada.

Retornar

Presentation: a apresentação com o nome informado.

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

`getActivePresentation()`

Retorna a apresentação ativa no momento para a qual o script está vinculado ao contêiner ou null se não houver apresentação ativa. Interagir com uma apresentação para a qual o script não está vinculado a um contêiner, use openById(id).

// Get the current presentation to which this script is bound.
var presentation = SlidesApp.getActivePresentation();

Se a apresentação já estiver aberta, a mesma instância será retornada.

Retornar

Presentation

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

`getUi()`

Retorna uma instância do ambiente da interface do usuário da apresentação que permite ao script adicione recursos como menus, caixas de diálogo e barras laterais. Um script só pode interagir com a interface do instância atual de uma apresentação aberta e somente se o script estiver vinculado à apresentação. Para mais informações, consulte guias para menus e caixas de diálogo e barras laterais.

// Add a custom menu to the active presentation, including a separator and a sub-menu.
function onOpen(e) {
  SlidesApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(SlidesApp.getUi().createMenu('My sub-menu')
          .addItem('One sub-menu item', 'mySecondFunction')
          .addItem('Another sub-menu item', 'myThirdFunction'))
      .addToUi();
}

Retornar

Ui

`newAffineTransformBuilder()`

Retorna um novo AffineTransformBuilder para criar um AffineTransform. O builder é predefinida com a transformação de identidade afins.

Retornar

AffineTransformBuilder

`openById(id)`

Abre o Presentation com o ID fornecido.

// Open a presentation by ID.
var presentation = SlidesApp.openById('docId');

Se a apresentação já estiver aberta, a mesma instância será retornada.

Parâmetros

Nome	Tipo	Descrição
`id`	`String`

Retornar

Presentation: a apresentação com o ID fornecido.

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

`openByUrl(url)`

Abre o Presentation com o URL fornecido.

// Open a presentation by URL.
var presentation = SlidesApp.openByUrl('https://docs.google.com/presentation/d/docId/edit');

Se a apresentação já estiver aberta, a mesma instância será retornada.

Parâmetros

Nome	Tipo	Descrição
`url`	`String`

Retornar

Presentation: a apresentação com o URL fornecido.

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