דף זה תורגם על ידי 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`	ספירה של סוגי ה-placeholders.
`PredefinedLayout`	`PredefinedLayout`	ספירה של הפריסות המוגדרות מראש.
`SelectionType`	`SelectionType`	מספר של סוגי הבחירות.
`ShapeType`	`ShapeType`	ספירה של סוגי הצורות.
`SheetsChartEmbedType`	`SheetsChartEmbedType`	ספירה של סוגי ההטמעה לתרשים של Sheets.
`SlideLinkingMode`	`SlideLinkingMode`	ספירה של הדרכים שבהן אפשר לקשר את Slides.
`SlidePosition`	`SlidePosition`	ספירה של סוגי מיקומי השקפים.
`SpacingMode`	`SpacingMode`	ספירה של הסוגים של מצבי הריווח.
`TextBaselineOffset`	`TextBaselineOffset`	ספירה של סוגי ההיסט הבסיסי של הטקסט.
`TextDirection`	`TextDirection`	מספור של סוגי הנחיות הטקסט.
`ThemeColorType`	`ThemeColorType`	ספירה של צבעי עיצוב.
`VideoSourceType`	`VideoSourceType`	מספור של סוגי מקורות הווידאו.

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`create(name)`	`Presentation`	יצירה ופתיחה של `Presentation` חדש.
`getActivePresentation()`	`Presentation`	הפונקציה מחזירה את המצגת הפעילה הנוכחית שאליה הסקריפט כפוף לקונטיינר, או `null` אם אין מצגת פעילה.
`getUi()`	`Ui`	הפונקציה מחזירה מופע של סביבת ממשק המשתמש של המצגת, שמאפשר לסקריפט להוסיף תכונות כמו תפריטים, תיבות דו-שיח וסרגלי צד.
`newAffineTransformBuilder()`	`AffineTransformBuilder`	הפונקציה מחזירה `AffineTransformBuilder` חדש כדי לבנות `AffineTransform`.
`openById(id)`	`Presentation`	תיפתח השדה `Presentation` עם המזהה הנתון.
`openByUrl(url)`	`Presentation`	פותח את `Presentation` עם כתובת ה-URL הנתונה.

מסמכי תיעוד מפורטים

`create(name)`

יצירה ופתיחה של Presentation חדש.

פרמטרים

שם	סוג	תיאור
`name`	`String`	השם שניתן למצגת שנוצרה.

חזרה

Presentation – המצגת עם השם הנתון.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getActivePresentation()`

הפונקציה מחזירה את המצגת הפעילה הנוכחית שאליה הסקריפט כפוף לקונטיינר, או 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. ה-builder מוגדרת מראש עם טרנספורמציה של אפיון הזהות.

חזרה

AffineTransformBuilder

`openById(id)`

תיפתח השדה Presentation עם המזהה הנתון.

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

אם המצגת כבר פתוחה, מוחזר אותו מופע של המצגת.

פרמטרים

שם	סוג	תיאור
`id`	`String`

חזרה

Presentation – המצגת עם המזהה הנתון

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`openByUrl(url)`

פותח את Presentation עם כתובת ה-URL הנתונה.

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

אם המצגת כבר פתוחה, מוחזר אותו מופע של המצגת.

פרמטרים

שם	סוג	תיאור
`url`	`String`

חזרה

Presentation – המצגת עם כתובת ה-URL הנתונה

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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