פריסה במצגת.
כל פריסה משמשת כתבנית לשקפים שיורשים ממנה את המצגת, והיא קובעת את אופן הסדר והסגנון של התוכן בשקפים האלה.
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
getBackground() | PageBackground | הפונקציה מקבלת את הרקע של הדף. |
getColorScheme() | ColorScheme | הפונקציה מקבלת את ה-ColorScheme שמשויך לדף. |
getGroups() | Group[] | מחזירה את הרשימה של Group אובייקטים בדף. |
getImages() | Image[] | מחזירה את הרשימה של Image אובייקטים בדף. |
getLayoutName() | String | הפונקציה מקבלת את שם הפריסה. |
getLines() | Line[] | מחזירה את הרשימה של Line אובייקטים בדף. |
getMaster() | Master | הפונקציה מקבלת את המאסטר שעליו מבוססת הפריסה. |
getObjectId() | String | הפונקציה מקבלת את המזהה הייחודי של הדף. |
getPageElementById(id) | PageElement | מחזירה את PageElement בדף עם המזהה הנתון, או null אם לא קיים. |
getPageElements() | PageElement[] | מחזירה את הרשימה של PageElement אובייקטים שעובדו בדף. |
getPageType() | PageType | הפונקציה מקבלת את סוג הדף. |
getPlaceholder(placeholderType) | PageElement | הפונקציה מחזירה את האובייקט PageElement של ה-placeholder עבור PlaceholderType או null שצוינו אם לא קיים placeholder תואם. |
getPlaceholder(placeholderType, placeholderIndex) | PageElement | הפונקציה מחזירה את האובייקט PageElement של ה-placeholder עבור PlaceholderType שצוין
ואינדקס של placeholder, או את הערך null אם ה-placeholder לא קיים. |
getPlaceholders() | PageElement[] | מחזירה את רשימת האובייקטים של ה-placeholder PageElement בדף. |
getShapes() | Shape[] | מחזירה את הרשימה של Shape אובייקטים בדף. |
getSheetsCharts() | SheetsChart[] | מחזירה את הרשימה של SheetsChart אובייקטים בדף. |
getTables() | Table[] | מחזירה את הרשימה של Table אובייקטים בדף. |
getVideos() | Video[] | מחזירה את הרשימה של Video אובייקטים בדף. |
getWordArts() | WordArt[] | מחזירה את הרשימה של WordArt אובייקטים בדף. |
group(pageElements) | Group | קיבוץ כל רכיבי הדף שצוינו. |
insertGroup(group) | Group | הוספת עותק של Group שסופק בדף. |
insertImage(blobSource) | Image | הוספת תמונה בפינה השמאלית העליונה של הדף, עם גודל ברירת מחדל מה-blob של התמונה שצוין. |
insertImage(blobSource, left, top, width, height) | Image | הוספת תמונה לדף במיקום ובגודל שצוינו ב-blob התמונה שצוין. |
insertImage(image) | Image | הוספת עותק של Image שסופק בדף. |
insertImage(imageUrl) | Image | מוסיף תמונה בפינה הימנית העליונה של הדף בגודל ברירת מחדל מכתובת האתר שסופקה. |
insertImage(imageUrl, left, top, width, height) | Image | הוספת תמונה לדף עם המיקום והגודל שצוינו מכתובת ה-URL שצוינה. |
insertLine(line) | Line | הוספת עותק של Line שסופק בדף. |
insertLine(lineCategory, startConnectionSite, endConnectionSite) | Line | הוספת שורה בדף המחברת בין שני ערכי connection sites . |
insertLine(lineCategory, startLeft, startTop, endLeft, endTop) | Line | הוספת שורה לדף. |
insertPageElement(pageElement) | PageElement | הוספת עותק של PageElement שסופק בדף. |
insertShape(shape) | Shape | הוספת עותק של Shape שסופק בדף. |
insertShape(shapeType) | Shape | הוספת צורה לדף. |
insertShape(shapeType, left, top, width, height) | Shape | הוספת צורה לדף. |
insertSheetsChart(sourceChart) | SheetsChart | הוספת תרשים של Google Sheets לדף. |
insertSheetsChart(sourceChart, left, top, width, height) | SheetsChart | הוספת תרשים של Google Sheets לדף עם המיקום והגודל שצוינו. |
insertSheetsChart(sheetsChart) | SheetsChart | הוספת עותק של SheetsChart שסופק בדף. |
insertSheetsChartAsImage(sourceChart) | Image | הוספת תרשים של Google Sheets כ-Image בדף. |
insertSheetsChartAsImage(sourceChart, left, top, width, height) | Image | הוספת תרשים של Google Sheets בפורמט Image בדף, עם המיקום והגודל שצוינו. |
insertTable(numRows, numColumns) | Table | הוספת טבלה לדף. |
insertTable(numRows, numColumns, left, top, width, height) | Table | הוספת טבלה בדף עם המיקום והגודל שצוינו. |
insertTable(table) | Table | הוספת עותק של Table שסופק בדף. |
insertTextBox(text) | Shape | מוסיף תיבת טקסט Shape שמכילה את המחרוזת הנתונה בדף. |
insertTextBox(text, left, top, width, height) | Shape | מוסיף תיבת טקסט Shape שמכילה את המחרוזת הנתונה בדף. |
insertVideo(videoUrl) | Video | מוסיף סרטון בפינה הימנית העליונה של הדף עם גודל ברירת מחדל. |
insertVideo(videoUrl, left, top, width, height) | Video | הוספת סרטון לדף עם המיקום והגודל שסופקו. |
insertVideo(video) | Video | הוספת עותק של Video שסופק בדף. |
insertWordArt(wordArt) | WordArt | הוספת עותק של WordArt שסופק בדף. |
remove() | void | הסרת הדף. |
replaceAllText(findText, replaceText) | Integer | מחליף את כל המופעים של טקסט התואם את הטקסט ל'החלפה'. |
replaceAllText(findText, replaceText, matchCase) | Integer | מחליף את כל המופעים של טקסט התואם את הטקסט ל'החלפה'. |
selectAsCurrentPage() | void | בוחר ב-Page במצגת הפעילה בתור current page selection ומסיר את כל הבחירה הקודמת. |
תיעוד מפורט
getBackground()
הפונקציה מקבלת את הרקע של הדף.
החזרות
PageBackground
- הרקע של הדף.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getColorScheme()
הפונקציה מקבלת את ה-ColorScheme
שמשויך לדף.
החזרות
ColorScheme
- ערכת הצבעים של הדף.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getGroups()
getImages()
getLayoutName()
הפונקציה מקבלת את שם הפריסה.
החזרות
String
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLines()
getMaster()
getObjectId()
הפונקציה מקבלת את המזהה הייחודי של הדף. מזהי אובייקטים שבהם נעשה שימוש בדפים וברכיבי הדפים חולקים אותו מרחב שמות.
החזרות
String
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementById(id)
מחזירה את PageElement
בדף עם המזהה הנתון, או null
אם לא קיים.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
id | String | המזהה של רכיב הדף שמאוחזר. |
החזרות
PageElement
- רכיב הדף עם המזהה הנתון.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElements()
מחזירה את הרשימה של PageElement
אובייקטים שעובדו בדף.
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageType()
getPlaceholder(placeholderType)
הפונקציה מחזירה את האובייקט PageElement
של ה-placeholder עבור PlaceholderType
או null
שצוינו אם לא קיים placeholder תואם.
אם יש placeholders מרובים מאותו סוג, הפונקציה מחזירה את ה-placeholder עם האינדקס המינימלי של ה-placeholder. אם יש מספר placeholders תואמים עם אותו אינדקס, הפונקציה הזו תחזיר את ה-placeholder הראשון מאוסף רכיבי הדף של הדף.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
placeholderType | PlaceholderType |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholder(placeholderType, placeholderIndex)
הפונקציה מחזירה את האובייקט PageElement
של ה-placeholder עבור PlaceholderType
שצוין
ואינדקס של placeholder, או את הערך null
אם ה-placeholder לא קיים.
אם יש מספר placeholders באותו סוג ובאותו אינדקס, הוא יחזיר את ה-placeholder הראשון מאוסף רכיבי הדף של הדף.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
placeholderType | PlaceholderType | |
placeholderIndex | Integer |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholders()
מחזירה את רשימת האובייקטים של ה-placeholder PageElement
בדף.
var master = SlidesApp.getActivePresentation().getMasters()[0]; Logger.log('Number of placeholders in the master: ' + master.getPlaceholders().length);
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getShapes()
getSheetsCharts()
מחזירה את הרשימה של SheetsChart
אובייקטים בדף.
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTables()
getVideos()
getWordArts()
group(pageElements)
קיבוץ כל רכיבי הדף שצוינו.
צריכים להיות לפחות שני אלמנטים בדף באותו דף שלא נמצאים עדיין בקבוצה אחרת. לא ניתן לקבץ חלק מרכיבי הדף כגון Videos
, Tables
ו-placeholder Shapes
.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
pageElements | PageElement[] | הרכיבים שיש לקבץ יחד. |
החזרות
Group
- הקבוצה החדשה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertGroup(group)
הוספת עותק של Group
שסופק בדף.
מיקום הרכיב שנוסף בדף הזה נקבע לפי המיקום של רכיב המקור בדף שלו.
אם הרכיב שסופק הוא placeholder שמועתק מתוך המצגת הנוכחית, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה יורשים גם מהרכיב שנוסף.
אם הרכיב שסופק הוא placeholder שמועתק ממצגת אחרת, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה מועתקים לרכיב ממצגת המקור.
// Copy a group between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var group = otherPresentationSlide.getGroups()[0]; currentPresentationSlide.insertGroup(group); // Also available for Layout, Master, and Page.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
group | Group | הקבוצה להעתקה ולהוספה. |
החזרות
Group
- הקבוצה שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(blobSource)
הוספת תמונה בפינה השמאלית העליונה של הדף, עם גודל ברירת מחדל מה-blob של התמונה שצוין.
הוספת התמונה תאחזר אותה מה-BlobSource
פעם אחת, ועותק מאוחסן לצורך הצגה במצגת. התמונות צריכות להיות בפורמט של פחות מ-50MB, לא יותר מ-25 מגה-פיקסלים בפורמט PNG, JPEG או GIF.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); slide.insertImage(image);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
blobSource | BlobSource | נתוני התמונה. |
החזרות
Image
– התמונה שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(blobSource, left, top, width, height)
הוספת תמונה לדף במיקום ובגודל שצוינו ב-blob התמונה שצוין.
התמונה נשלפת מה-BlobSource
שסופק פעם אחת בזמן ההוספה, ועותק מאוחסן במצגת. התמונות צריכות להיות בפורמט של פחות מ-50MB, לא לחרוג מ-25 מגה-פיקסלים בפורמט PNG, JPEG או GIF.
כדי לשמור על יחס הגובה-רוחב של התמונה, גודל התמונה משתנה וממורכז בהתאם לגודל שצוין.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); var position = {left: 0, top: 0}; var size = {width: 300, height: 100}; slide.insertImage(image, position.left, position.top, size.width, size.height);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
blobSource | BlobSource | נתוני התמונה. |
left | Number | המיקום האופקי של התמונה בנקודות, במדידה מהפינה השמאלית העליונה של הדף. |
top | Number | המיקום האנכי של התמונה בנקודות, במדידה מהפינה השמאלית העליונה של הדף. |
width | Number | רוחב התמונה בנקודות. |
height | Number | גובה התמונה בנקודות. |
החזרות
Image
– התמונה שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(image)
הוספת עותק של Image
שסופק בדף.
המיקום של התמונות שנוספו בדף הזה נקבע לפי המיקום של תמונת המקור בדף שלה.
אם התמונה שסופקה היא placeholder שמועתק מתוך המצגת הנוכחית, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה מקבלים גם בירושה את התמונה שנוספה.
אם התמונה שסופקה היא placeholder שמועתק ממצגת אחרת, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה מועתקים לתמונה ממצגת המקור. אם תמונת ה-placeholder שהועתקה ריקה, לא יוכנס שום דבר למצגת היעד.
// Copy an image between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var image = otherPresentationSlide.getImages[0]; currentPresentationSlide.insertImage(image);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
image | Image | התמונה להעתקה ולהוספה. |
החזרות
Image
– התמונה שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(imageUrl)
מוסיף תמונה בפינה הימנית העליונה של הדף בגודל ברירת מחדל מכתובת האתר שסופקה.
כשמוסיפים את התמונה, היא מאחזרת אותה מכתובת ה-URL פעם אחת, ועותק נשמר להצגה במצגת. התמונות צריכות להיות בגודל של פחות מ-50MB, לא יותר מ-25 מגה-פיקסלים ולהיות בפורמט PNG, JPEG או GIF.
כתובת ה-URL שצוינה חייבת להיות נגישה לכולם ובגודל של עד 2KB. כתובת ה-URL עצמה נשמרת עם התמונה ונחשפת באמצעות Image.getSourceUrl()
.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
imageUrl | String | כתובת ה-URL של התמונה. |
החזרות
Image
– התמונה שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(imageUrl, left, top, width, height)
הוספת תמונה לדף עם המיקום והגודל שצוינו מכתובת ה-URL שצוינה.
כשמוסיפים את התמונה, היא מאחזרת אותה מכתובת ה-URL פעם אחת, ועותק נשמר להצגה במצגת. התמונות צריכות להיות בגודל של פחות מ-50MB, לא יותר מ-25 מגה-פיקסלים ולהיות בפורמט PNG, JPEG או GIF.
כתובת ה-URL שצוינה חייבת להיות נגישה לכולם ובגודל של עד 2KB. כתובת ה-URL עצמה נשמרת עם התמונה ונחשפת באמצעות Image.getSourceUrl()
.
כדי לשמור על יחס הגובה-רוחב של התמונה, גודל התמונה משתנה וממורכז בהתאם לגודל שצוין.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
imageUrl | String | כתובת ה-URL של התמונה. |
left | Number | המיקום האופקי של התמונה בנקודות, במדידה מהפינה השמאלית העליונה של הדף. |
top | Number | המיקום האנכי של התמונה בנקודות, במדידה מהפינה השמאלית העליונה של הדף. |
width | Number | רוחב התמונה בנקודות. |
height | Number | גובה התמונה בנקודות. |
החזרות
Image
– התמונה שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(line)
הוספת עותק של Line
שסופק בדף.
מיקום הרכיב שנוסף בדף הזה נקבע לפי המיקום של רכיב המקור בדף שלו.
אם הרכיב שסופק הוא placeholder שמועתק מתוך המצגת הנוכחית, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה יורשים גם מהרכיב שנוסף.
אם הרכיב שסופק הוא placeholder שמועתק ממצגת אחרת, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה מועתקים לרכיב ממצגת המקור.
// Copy a line between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var line = otherPresentationSlide.getLines[0]; currentPresentationSlide.insertLine(line);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
line | Line | השורה להעתקה ולהוספה. |
החזרות
Line
- השורה שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(lineCategory, startConnectionSite, endConnectionSite)
הוספת שורה בדף המחברת בין שני ערכי connection sites
. שני אתרי החיבור חייבים להיות בדף הזה.
// Insert a line in the first slide of the presentation connecting two shapes. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE); var shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD); slide.insertLine( SlidesApp.LineCategory.BENT, shape1.getConnectionSites()[0], shape2.getConnectionSites()[1]);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
lineCategory | LineCategory | הקטגוריה של השורה שיש להוסיף. |
startConnectionSite | ConnectionSite | אתר החיבור שבו יש לחבר את תחילת הקו. |
endConnectionSite | ConnectionSite | אתר החיבור שבו יש לחבר את קצה הקו. |
החזרות
Line
- השורה שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)
הוספת שורה לדף.
// Insert a line in the first slide of the presentation. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var startPoint = {left: 10, top: 10}; var endPoint = {left: 40, top: 40}; slide.insertLine( SlidesApp.LineCategory.STRAIGHT, startPoint.left, startPoint.top, endPoint.left, endPoint.top);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
lineCategory | LineCategory | הקטגוריה של השורה שיש להוסיף. |
startLeft | Number | המיקום האופקי של נקודת ההתחלה של הקו, שנמדד בנקודות מהפינה השמאלית העליונה של הדף. |
startTop | Number | המיקום האנכי של נקודת ההתחלה של הקו, שנמדד בנקודות מהפינה השמאלית העליונה של הדף. |
endLeft | Number | המיקום האופקי של נקודת הקצה של הקו, שנמדד בנקודות מהפינה השמאלית העליונה של הדף. |
endTop | Number | המיקום האנכי של נקודת הסיום של הקו, שנמדד בנקודות מהפינה השמאלית העליונה של הדף. |
החזרות
Line
- השורה שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertPageElement(pageElement)
הוספת עותק של PageElement
שסופק בדף.
מיקום הרכיב שנוסף בדף הזה נקבע לפי המיקום של רכיב המקור בדף שלו.
אם הרכיב שסופק הוא placeholder שמועתק מתוך המצגת הנוכחית, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה יורשים גם מהרכיב שנוסף.
אם הרכיב שסופק הוא placeholder שמועתק ממצגת אחרת, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה מועתקים לרכיב ממצגת המקור.
// Copy a page element between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var pageElement = otherPresentationSlide.getPageElements()[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertPageElement(pageElement);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
pageElement | PageElement | רכיב הדף להעתקה ולהוספה. |
החזרות
PageElement
- רכיב הדף שנוסף.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shape)
הוספת עותק של Shape
שסופק בדף.
מיקום הרכיב שנוסף בדף הזה נקבע לפי המיקום של רכיב המקור בדף שלו.
אם הרכיב שסופק הוא placeholder שמועתק מתוך המצגת הנוכחית, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה יורשים גם מהרכיב שנוסף.
אם הרכיב שסופק הוא placeholder שמועתק ממצגת אחרת, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה מועתקים לרכיב ממצגת המקור.
// Copy a shape between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var shape = otherPresentationSlide.getShapes[0]; currentPresentationSlide.insertShape(shape); // Also available for Layout, Master, and Page.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
shape | Shape | הצורה להעתקה ולהוספה. |
החזרות
Shape
- הצורה שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shapeType)
הוספת צורה לדף.
לצורה מצורף גודל ברירת מחדל בפינה הימנית העליונה של הדף.
// Insert a shape in the first slide of the presentation. var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Also available for Layout, Master, and Page. slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
shapeType | ShapeType | סוג הצורה שיש להוסיף. |
החזרות
Shape
- הצורה שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shapeType, left, top, width, height)
הוספת צורה לדף.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
shapeType | ShapeType | סוג הצורה שיש להוסיף. |
left | Number | המיקום האופקי של הצורה, כפי שנמדד מהפינה השמאלית העליונה של הדף. |
top | Number | המיקום האנכי של הצורה, כפי שנמדד מהפינה השמאלית העליונה של הדף. |
width | Number | רוחב הצורה. |
height | Number | גובה הצורה. |
החזרות
Shape
- הצורה שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sourceChart)
הוספת תרשים של Google Sheets לדף.
התרשים מתווסף לגודל ברירת מחדל בפינה הימנית העליונה של הדף.
התרשים שנוסף מקושר לתרשים המקור ב-Google Sheets, כך שאפשר לעדכן אותו. שותפי עריכה אחרים יכולים לראות את הקישור לגיליון האלקטרוני המקורי.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChart(chart);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
sourceChart | EmbeddedChart | התרשים בגיליון האלקטרוני שיש להוסיף לדף. |
החזרות
SheetsChart
- התרשים שנוסף לדף.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sourceChart, left, top, width, height)
הוספת תרשים של Google Sheets לדף עם המיקום והגודל שצוינו.
כדי לשמור על יחס הגובה-רוחב של התרשים, גודל התרשים וממורכז בהתאם לגודל שצוין.
התרשים שנוסף מקושר לתרשים המקור ב-Google Sheets, כך שאפשר לעדכן אותו. שותפי עריכה אחרים יכולים לראות את הקישור לגיליון האלקטרוני המקורי.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var position = {left: 0, top: 0}; var size = {width: 200, height: 200}; // Also available for Layout, Master, and Page. slide.insertSheetsChart( chart, position.left, position.top, size.width, size.height);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
sourceChart | EmbeddedChart | התרשים בגיליון האלקטרוני שיש להוסיף לדף. |
left | Number | המיקום האופקי של התרשים בנקודות, שנמדד מהפינה הימנית העליונה של הדף. |
top | Number | המיקום האנכי של התרשים בנקודות, שנמדד מהפינה הימנית העליונה של הדף. |
width | Number | רוחב התרשים בנקודות. |
height | Number | גובה התרשים בנקודות. |
החזרות
SheetsChart
- התרשים שנוסף לדף.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sheetsChart)
הוספת עותק של SheetsChart
שסופק בדף.
מיקום הרכיב שנוסף בדף הזה נקבע לפי המיקום של רכיב המקור בדף שלו.
אם הרכיב שסופק הוא placeholder שמועתק מתוך המצגת הנוכחית, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה יורשים גם מהרכיב שנוסף.
אם הרכיב שסופק הוא placeholder שמועתק ממצגת אחרת, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה מועתקים לרכיב ממצגת המקור.
// Copy a sheets chart between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var sheetsChart = otherPresentationSlide.getSheetsCharts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertSheetsChart(sheetsChart);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
sheetsChart | SheetsChart | תרשים הגיליון להעתקה ולהוספה. |
החזרות
SheetsChart
– תרשים הגיליונות שנוספו.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChartAsImage(sourceChart)
הוספת תרשים של Google Sheets כ-Image
בדף.
תמונת התרשים מצורפת בגודל ברירת מחדל בפינה הימנית העליונה של הדף.
התמונה שהוכנסה של התרשים לא מקושרת לתרשים המקור ב-Google Sheets.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChartAsImage(chart); // Also available for Layout, Master, and Page.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
sourceChart | EmbeddedChart | התרשים בגיליון האלקטרוני שיש להוסיף לדף. |
החזרות
Image
- התמונה שהוכנסה של התרשים לדף.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChartAsImage(sourceChart, left, top, width, height)
הוספת תרשים של Google Sheets בפורמט Image
בדף, עם המיקום והגודל שצוינו.
כדי לשמור על יחס הגובה-רוחב של תמונת התרשים, גודל התמונה משתנה וממורכז בהתאם לגודל שצוין.
התמונה שהוכנסה של התרשים לא מקושרת לתרשים המקור ב-Google Sheets.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var position = {left: 0, top: 0}; var size = {width: 200, height: 200}; // Also available for Layout, Master, and Page. slide.insertSheetsChartAsImage( chart, position.left, position.right, size.width, size.height);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
sourceChart | EmbeddedChart | התרשים בגיליון האלקטרוני שיש להוסיף לדף. |
left | Number | המיקום האופקי של התרשים בנקודות, שנמדד מהפינה הימנית העליונה של הדף. |
top | Number | המיקום האנכי של התרשים בנקודות, שנמדד מהפינה הימנית העליונה של הדף. |
width | Number | רוחב התרשים בנקודות. |
height | Number | גובה התרשים בנקודות. |
החזרות
Image
- התמונה שהוכנסה של התרשים לדף.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns)
הוספת טבלה לדף.
הטבלה ממורכזת בדף, בגודל ברירת המחדל ובחלוקה שווה של שורות ועמודות.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
numRows | Integer | מספר השורות בטבלה. |
numColumns | Integer | מספר העמודות בטבלה. |
החזרות
Table
– הטבלה שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns, left, top, width, height)
הוספת טבלה בדף עם המיקום והגודל שצוינו.
השורות והעמודות מחולקות באופן שווה בטבלה שנוצרה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
numRows | Integer | מספר השורות בטבלה. |
numColumns | Integer | מספר העמודות בטבלה. |
left | Number | המיקום האופקי של הטבלה, שנמדד מהפינה הימנית העליונה של הדף. |
top | Number | המיקום האנכי של הטבלה, שנמדד מהפינה הימנית העליונה של הדף. |
width | Number | רוחב הטבלה. |
height | Number | הגובה המינימלי של הטבלה. הגובה בפועל של הטבלה שעברה רינדור תלוי בגורמים כמו גודל הגופן של הטקסט. |
החזרות
Table
– הטבלה שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(table)
הוספת עותק של Table
שסופק בדף.
מיקום הרכיב שנוסף בדף הזה נקבע לפי המיקום של רכיב המקור בדף שלו.
אם הרכיב שסופק הוא placeholder שמועתק מתוך המצגת הנוכחית, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה יורשים גם מהרכיב שנוסף.
אם הרכיב שסופק הוא placeholder שמועתק ממצגת אחרת, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה מועתקים לרכיב ממצגת המקור.
// Copy a table between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var table = otherPresentationSlide.getTables[0]; currentPresentationSlide.insertTable(table); // Also available for Layout, Master, and Page.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
table | Table | הטבלה להעתקה ולהוספה. |
החזרות
Table
– הטבלה שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTextBox(text)
מוסיף תיבת טקסט Shape
שמכילה את המחרוזת הנתונה בדף.
הצורה של תיבת הטקסט מוגדרת בגודל ברירת מחדל בפינה הימנית העליונה של הדף.
// Insert text box with "Hello" on the first slide of presentation. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
text | String | המחרוזת שהצורה של תיבת הטקסט צריכה להכיל. |
החזרות
Shape
- הצורה של תיבת הטקסט שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTextBox(text, left, top, width, height)
מוסיף תיבת טקסט Shape
שמכילה את המחרוזת הנתונה בדף.
// Insert text box with "Hello" on the first slide of presentation. This text box is a square // with a length of 10 points on each side. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
text | String | המחרוזת שהצורה של תיבת הטקסט צריכה להכיל. |
left | Number | המיקום האופקי של הצורה של תיבת הטקסט, שנמדד מהפינה השמאלית העליונה של הדף. |
top | Number | המיקום האנכי של הצורה של תיבת הטקסט, כפי שנמדד מהפינה השמאלית העליונה של הדף. |
width | Number | רוחב הצורה של תיבת הטקסט. |
height | Number | גובה הצורה של תיבת הטקסט. |
החזרות
Shape
- הצורה של תיבת הטקסט שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl)
מוסיף סרטון בפינה הימנית העליונה של הדף עם גודל ברירת מחדל.
כרגע יש תמיכה בסרטוני YouTube בלבד.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
videoUrl | String | כתובת ה-URL של הסרטון להוספה. |
החזרות
Video
– הסרטון שנוסף.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl, left, top, width, height)
הוספת סרטון לדף עם המיקום והגודל שסופקו.
כרגע יש תמיכה בסרטוני YouTube בלבד.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
videoUrl | String | כתובת ה-URL של הסרטון להוספה. |
left | Number | המיקום האופקי של הסרטון בנקודות, שנמדד מהפינה השמאלית העליונה של הדף. |
top | Number | המיקום האנכי של הסרטון בנקודות, במדידה מהפינה הימנית העליונה של הדף. |
width | Number | רוחב הסרטון בנקודות. |
height | Number | גובה הסרטון בנקודות. |
החזרות
Video
– הסרטון שנוסף.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(video)
הוספת עותק של Video
שסופק בדף.
מיקום הרכיב שנוסף בדף הזה נקבע לפי המיקום של רכיב המקור בדף שלו.
אם הרכיב שסופק הוא placeholder שמועתק מתוך המצגת הנוכחית, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה יורשים גם מהרכיב שנוסף.
אם הרכיב שסופק הוא placeholder שמועתק ממצגת אחרת, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה מועתקים לרכיב ממצגת המקור.
// Copy a video between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var video = otherPresentationSlide.getVideos[0]; currentPresentationSlide.insertVideo(video); // Also available for Layout, Master, and Page.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
video | Video | הסרטון להעתקה ולהוספה. |
החזרות
Video
– הסרטון שנוסף.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertWordArt(wordArt)
הוספת עותק של WordArt
שסופק בדף.
מיקום הרכיב שנוסף בדף הזה נקבע לפי המיקום של רכיב המקור בדף שלו.
אם הרכיב שסופק הוא placeholder שמועתק מתוך המצגת הנוכחית, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה יורשים גם מהרכיב שנוסף.
אם הרכיב שסופק הוא placeholder שמועתק ממצגת אחרת, מאפיינים שיורשים מדפי המאסטר או מדפי הפריסה מועתקים לרכיב ממצגת המקור.
// Copy a word art between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var wordArt = otherPresentationSlide.getWordArts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertWordArt(wordArt);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
wordArt | WordArt | הקבוצה להעתקה ולהוספה. |
החזרות
WordArt
- המילה המעוצבת שהוכנסה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
הסרת הדף.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText)
מחליף את כל המופעים של טקסט התואם את הטקסט ל'החלפה'. החיפוש לא תלוי רישיות.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
findText | String | הטקסט שיש לחפש. |
replaceText | String | הטקסט שיחליף את הטקסט התואם. |
החזרות
Integer
– מספר המופעים השתנה
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
מחליף את כל המופעים של טקסט התואם את הטקסט ל'החלפה'.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
findText | String | הטקסט שיש לחפש. |
replaceText | String | הטקסט שיחליף את הטקסט התואם. |
matchCase | Boolean | אם true , החיפוש הוא תלוי אותיות רישיות; אם false , החיפוש
לא תלוי אותיות רישיות. |
החזרות
Integer
– מספר המופעים השתנה
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
selectAsCurrentPage()
בוחר ב-Page
במצגת הפעילה בתור current page selection
ומסיר את כל הבחירה הקודמת.
סקריפט יכול לגשת רק לבחירת המשתמש שמפעיל את הסקריפט, ורק אם הסקריפט מקושר למצגת.
// Select the first slide as the current page selection and replace any previous selection. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.selectAsCurrentPage(); // Also available for Layout, Master, and Page.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations