Class SlidesApp

簡報應用程式

建立並開啟可編輯的 Presentations。 

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

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

屬性

屬性類型說明
AlignmentPositionAlignmentPosition對齊位置類型的列舉。
ArrowStyleArrowStyle列舉 Line 可擁有的不同箭頭樣式。
AutoTextTypeAutoTextType自動文字類型的列舉。
AutofitTypeAutofitType自動調整類型列舉。
CellMergeStateCellMergeState列舉表格儲存格的不同合併狀態。
ColorTypeColorType顏色類型列舉。
ContentAlignmentContentAlignment用於指定內容對齊方式的值列舉。
DashStyleDashStyle列舉 Line 可採用的不同虛線樣式。
FillTypeFillType填入類型列舉。
LineCategoryLineCategoryLine 的類別列舉。
LineFillTypeLineFillTypeLineFill 類型的列舉。
LineTypeLineTypeLine 類型的列舉。
LinkTypeLinkType連結類型列舉。
ListPresetListPreset列舉清單預設集類型。
PageBackgroundTypePageBackgroundType列舉網頁背景類型。
PageElementTypePageElementType網頁元素類型的列舉。
PageTypePageType列舉頁面類型。
ParagraphAlignmentParagraphAlignment段落對齊方式的列舉。
PlaceholderTypePlaceholderType預留位置類型的列舉。
PredefinedLayoutPredefinedLayout預先定義的版面配置列舉。
SelectionTypeSelectionType選取項目類型的列舉。
ShapeTypeShapeType形狀類型的列舉。
SheetsChartEmbedTypeSheetsChartEmbedType試算表圖表嵌入類型的列舉。
SlideLinkingModeSlideLinkingMode列舉連結簡報的方式。
SlidePositionSlidePosition列舉投影片位置類型。
SpacingModeSpacingMode列舉間距模式類型。
TextBaselineOffsetTextBaselineOffset列舉文字基準線位移的類型。
TextDirectionTextDirection列舉文字方向的類型。
ThemeColorTypeThemeColorType主題顏色的列舉。
VideoSourceTypeVideoSourceType影片來源類型的列舉。

方法

方法傳回類型簡短說明
create(name)Presentation建立並開啟新的 Presentation。
getActivePresentation()Presentation|null傳回目前有效且指令碼繫結至容器的簡報，如果沒有有效簡報，則傳回 null。
getUi()Ui傳回簡報使用者介面環境的例項，允許指令碼新增選單、對話方塊和側欄等功能。
newAffineTransformBuilder()AffineTransformBuilder傳回新的 AffineTransformBuilder，用於建構 AffineTransform。
openById(id)Presentation開啟具有指定 ID 的 Presentation。
openByUrl(url)Presentation使用指定網址開啟 Presentation。

內容詳盡的說明文件

create(name)

建立並開啟新的 Presentation。

參數

名稱類型說明
nameString要為建立的簡報命名的名稱。

回攻員

Presentation：指定名稱的簡報。

授權

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

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

getActivePresentation()

傳回目前有效且指令碼繫結至容器的簡報，如果沒有有效簡報，則傳回 null。如要與指令碼未繫結的簡報互動，請改用 openById(id)。 

// Get the current presentation to which this script is bound.
const presentation = SlidesApp.getActivePresentation();
 如果簡報已開啟，系統會傳回相同的簡報執行個體。

回攻員

Presentation|null

授權

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

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

getUi()

傳回簡報使用者介面環境的例項，允許指令碼新增選單、對話方塊和側欄等功能。指令碼只能與目前開啟簡報執行個體的 UI 互動，且指令碼必須繫結至簡報。詳情請參閱選單和對話方塊與側欄指南。 

// 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。建構工具會預先設定身分仿射轉換。

回攻員

AffineTransformBuilder

openById(id)

開啟具有指定 ID 的 Presentation。 

// Open a presentation by ID.
const presentation = SlidesApp.openById('docId');
 如果簡報已開啟，系統會傳回相同的簡報執行個體。

參數

名稱類型說明
idString

回攻員

Presentation：具有指定 ID 的簡報

授權

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

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

openByUrl(url)

使用指定網址開啟 Presentation。 

// Open a presentation by URL.
const presentation = SlidesApp.openByUrl(
    'https://docs.google.com/presentation/d/docId/edit',
);
 如果簡報已開啟，系統會傳回相同的簡報執行個體。

參數

名稱類型說明
urlString

回攻員

Presentation：指定網址的簡報

授權

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

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