Class SlidesApp

‫Slidesאפליקציה

יוצר ופותח את 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רשימה של סוגי מילוי.
LineCategoryLineCategoryרשימה של הקטגוריות של Line.
LineFillTypeLineFillTypeספירה של הסוגים של LineFill.
LineTypeLineTypeספירה של הסוגים של Line.
LinkTypeLinkTypeרשימה של סוגי הקישורים.
ListPresetListPresetרשימה של סוגי הגדרות קבועות מראש של רשימות.
PageBackgroundTypePageBackgroundTypeרשימה של סוגי רקעים לדפים.
PageElementTypePageElementTypeרשימה של סוגי רכיבי הדף.
PageTypePageTypeרשימה של סוגי הדפים.
ParagraphAlignmentParagraphAlignmentספירה של סוגי יישור הפסקה.
PlaceholderTypePlaceholderTypeספירה של סוגי הפלייסהולדרים.
PredefinedLayoutPredefinedLayoutרשימה של פריסות מוגדרות מראש.
SelectionTypeSelectionTypeרשימה של סוגי הבחירות.
ShapeTypeShapeTypeרשימה של סוגי הצורות.
SheetsChartEmbedTypeSheetsChartEmbedTypeרשימה של סוגי הטמעה של תרשימים ב-Sheets.
SlideLinkingModeSlideLinkingModeרשימה של הדרכים שבהן אפשר לקשר בין שקפים.
SlidePositionSlidePositionספירה של סוגי מיקומי השקפים.
SpacingModeSpacingModeרשימה של סוגי מצבי ריווח.
TextBaselineOffsetTextBaselineOffsetספירה של סוגי ההיסט של קו הבסיס של הטקסט.
TextDirectionTextDirectionרשימה של סוגי כיווני הטקסט.
ThemeColorTypeThemeColorTypeספירה של צבעי עיצוב.
VideoSourceTypeVideoSourceTypeרשימה של סוגי מקורות הווידאו.

Methods

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

תיעוד מפורט

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()

מחזירה מופע של סביבת ממשק המשתמש של המצגת שמאפשר לסקריפט להוסיף תכונות כמו תפריטים, תיבות דו-שיח וסרגלי צד. סקריפט יכול לבצע אינטראקציה עם ממשק המשתמש רק עבור המופע הנוכחי של מצגת פתוחה, ורק אם הסקריפט מקשר למצגת. מידע נוסף זמין במדריכים בנושא תפריטים ותיבות דו-שיח וסרגלי צד. 

// 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)

פותח את Presentation עם המזהה שצוין.

‫
// Open a presentation by ID.
const presentation = SlidesApp.openById('docId');
 אם המצגת כבר פתוחה, מוחזר אותו מופע של המצגת.

פרמטרים

שםסוגתיאור
idString

חזרה

‫Presentation – המצגת עם המזהה שצוין

אישור

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

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

openByUrl(url)

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

‫
// Open a presentation by URL.
const presentation = SlidesApp.openByUrl(
    'https://docs.google.com/presentation/d/docId/edit',
);
 אם המצגת כבר פתוחה, מוחזר אותו מופע של המצגת.

פרמטרים

שםסוגתיאור
urlString

חזרה

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

אישור

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

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