本頁面由 Cloud Translation API 翻譯而成。

Class SlidesApp

建立並開啟可編輯的「Presentations」。

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

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

屬性

屬性	類型	說明
`AlignmentPosition`	`AlignmentPosition`	列舉對齊位置的類型。
`ArrowStyle`	`ArrowStyle`	列舉 `Line` 可包含的不同箭頭樣式。
`AutoTextType`	`AutoTextType`	列舉自動文字類型的列舉。
`AutofitType`	`AutofitType`	自動調整類型的列舉。
`CellMergeState`	`CellMergeState`	列舉表格儲存格的不同合併狀態。
`ColorType`	`ColorType`	顏色類型的列舉。
`ContentAlignment`	`ContentAlignment`	指定內容對齊方式的值列舉。
`DashStyle`	`DashStyle`	列舉 `Line` 可包含的不同破折號樣式。
`FillType`	`FillType`	填色類型的列舉。
`LineCategory`	`LineCategory`	`Line` 類別的列舉。
`LineFillType`	`LineFillType`	`LineFill` 類型的列舉。
`LineType`	`LineType`	`Line` 類型的列舉。
`LinkType`	`LinkType`	連結類型的列舉。
`ListPreset`	`ListPreset`	清單預設類型的列舉。
`PageBackgroundType`	`PageBackgroundType`	網頁背景類型的列舉。
`PageElementType`	`PageElementType`	網頁元素類型列舉。
`PageType`	`PageType`	網頁類型列舉。
`ParagraphAlignment`	`ParagraphAlignment`	列舉段落對齊類型。
`PlaceholderType`	`PlaceholderType`	列舉的預留位置類型。
`PredefinedLayout`	`PredefinedLayout`	預先定義版面配置的列舉。
`SelectionType`	`SelectionType`	選項類型的列舉。
`ShapeType`	`ShapeType`	列舉型別的列舉。
`SheetsChartEmbedType`	`SheetsChartEmbedType`	試算表圖表嵌入類型列舉。
`SlideLinkingMode`	`SlideLinkingMode`	列舉說明簡報的連結方式。
`SlidePosition`	`SlidePosition`	列舉投影片位置類型。
`SpacingMode`	`SpacingMode`	間距模式類型的列舉。
`TextBaselineOffset`	`TextBaselineOffset`	文字基準偏移類型的列舉。
`TextDirection`	`TextDirection`	列舉文字方向的類型。
`ThemeColorType`	`ThemeColorType`	主題顏色列舉。
`VideoSourceType`	`VideoSourceType`	影片來源類型列舉。

方法

方法	傳回類型	簡短說明
`create(name)`	`Presentation`	建立並開啟新的 `Presentation`。
`getActivePresentation()`	`Presentation`	傳回指令碼屬於 container-bound 的使用中呈現方式；如果沒有，則傳回 `null` 使用中的簡報。
`getUi()`	`Ui`	傳回簡報使用者介面環境的例項，這個環境可讓指令碼新增選單、對話方塊和側欄等功能。
`newAffineTransformBuilder()`	`AffineTransformBuilder`	傳回新的 `AffineTransformBuilder` 以建構 `AffineTransform`。
`openById(id)`	`Presentation`	開啟具有指定 ID 的 `Presentation`。
`openByUrl(url)`	`Presentation`	開啟具有指定網址的 `Presentation`。

內容詳盡的說明文件

`create(name)`

建立並開啟新的 Presentation。

參數

名稱	類型	說明
`name`	`String`	為建立的簡報指定的名稱。

回攻員

Presentation：具有指定名稱的簡報。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

`getActivePresentation()`

傳回指令碼屬於 container-bound 的使用中呈現方式；如果沒有，則傳回 null 使用中的簡報。如何與非指令碼的簡報互動容器繫結，請改用 openById(id)。

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

敬上如果簡報已開啟，系統會傳回相同的簡報例項。

回攻員

Presentation

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

`getUi()`

傳回簡報使用者介面環境的例項，這個環境可讓指令碼新增選單、對話方塊和側欄等功能。指令碼只能與以下項目的使用者介面互動：目前開啟的簡報例項，且僅限指令碼與簡報繫結的情況。若需更多資訊，請參閲選單和對話方塊和側欄的指南。

// 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();
}

回攻員

Ui

`newAffineTransformBuilder()`

傳回新的 AffineTransformBuilder 以建構 AffineTransform。建構工具具有身分識別 affine 轉換的預設設定。

回攻員

AffineTransformBuilder

`openById(id)`

開啟具有指定 ID 的 Presentation。

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

敬上如果簡報已開啟，系統會傳回相同的簡報例項。

參數

名稱	類型	說明
`id`	`String`

回攻員

Presentation：含有指定 ID 的簡報

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

`openByUrl(url)`

開啟具有指定網址的 Presentation。

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

敬上如果簡報已開啟，系統會傳回相同的簡報例項。

參數

名稱	類型	說明
`url`	`String`

回攻員

Presentation：具有指定網址的簡報

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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