דף זה תורגם על ידי Cloud Translation API.

Class Image

PageElement שמייצג תמונה.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
`alignOnPage(alignmentPosition)`	`Image`	הרכיב מיושר למיקום היישור שצוין בדף.
`bringForward()`	`Image`	העברת רכיב הדף קדימה בדף ברכיב אחד.
`bringToFront()`	`Image`	העברת רכיב הדף לחזית הדף.
`duplicate()`	`PageElement`	שכפול של רכיב הדף.
`getAs(contentType)`	`Blob`	החזרת הנתונים שבתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין.
`getBlob()`	`Blob`	החזרת הנתונים בתוך התמונה הזו כ-blob.
`getBorder()`	`Border`	הפונקציה מחזירה את `Border` של התמונה.
`getConnectionSites()`	`ConnectionSite[]`	הפונקציה מחזירה את רשימת ה-`ConnectionSite`s ברכיב הדף, או רשימה ריקה אם לרכיב הדף אין אתרי חיבור.
`getContentUrl()`	`String`	הפונקציה מקבלת כתובת URL של התמונה.
`getDescription()`	`String`	הפונקציה מחזירה את תיאור הטקסט החלופי של רכיב הדף.
`getHeight()`	`Number`	הפונקציה מקבלת את הגובה של האלמנט בנקודות, שהוא הגובה של תיבת הגבול של האלמנט כשאין לו סיבוב.
`getInherentHeight()`	`Number`	הפונקציה מחזירה את הגובה המובנה של הרכיב בנקודות.
`getInherentWidth()`	`Number`	הפונקציה מחזירה את רוחב הרכיב המובנה בפיקסלים.
`getLeft()`	`Number`	הפונקציה מחזירה את המיקום האופקי של האלמנט בנקודות, שנמדד מהפינה הימנית העליונה של הדף כשאין לאלמנט סיבוב.
`getLink()`	`Link`	הפונקציה מחזירה את הערך `Link` או `null` אם אין קישור.
`getObjectId()`	`String`	הפונקציה מחזירה את המזהה הייחודי של האובייקט הזה.
`getPageElementType()`	`PageElementType`	הפונקציה מחזירה את הסוג של רכיב הדף, שמיוצג כ-enum מסוג `PageElementType`.
`getParentGroup()`	`Group`	הפונקציה מחזירה את הקבוצה שאליה שייך רכיב הדף, או את הערך `null` אם הרכיב לא נמצא בקבוצה.
`getParentPage()`	`Page`	הפונקציה מחזירה את הדף שבו נמצא רכיב הדף הזה.
`getParentPlaceholder()`	`PageElement`	הפונקציה מחזירה את רכיב דף האב של ה-placeholder.
`getPlaceholderIndex()`	`Integer`	הפונקציה מחזירה את האינדקס של תמונת ה-placeholder.
`getPlaceholderType()`	`PlaceholderType`	הפונקציה מחזירה את סוג ה-placeholder של התמונה, או את הערך `PlaceholderType.NONE` אם הצורה היא לא placeholder.
`getRotation()`	`Number`	הפונקציה מחזירה את זווית הסיבוב של הרכיב בכיוון השעון סביב מרכזו במעלות, כאשר אפס מעלות מציין שאין סיבוב.
`getSourceUrl()`	`String`	הפונקציה מקבלת את כתובת ה-URL של מקור התמונה, אם היא זמינה.
`getTitle()`	`String`	הפונקציה מחזירה את שם הטקסט החלופי של רכיב הדף.
`getTop()`	`Number`	הפונקציה מקבלת את המיקום האנכי של הרכיב בנקודות, שנמדד מהפינה השמאלית העליונה של הדף כשאין רוטציה לרכיב.
`getTransform()`	`AffineTransform`	הפונקציה מחזירה את הטרנספורמציה של רכיב הדף.
`getWidth()`	`Number`	הפונקציה מחזירה את רוחב הרכיב בנקודות, שהוא רוחב תיבת הגבול של הרכיב כשהרכיב לא מסובב.
`preconcatenateTransform(transform)`	`Image`	שרשור מראש של הטרנספורמציה שסופקה לטרנספורמציה הקיימת של רכיב הדף.
`remove()`	`void`	הסרת רכיב הדף.
`removeLink()`	`void`	הסרה של `Link`.
`replace(blobSource)`	`Image`	החלפת התמונה הזו בתמונה שמתוארת על ידי אובייקט `BlobSource`.
`replace(blobSource, crop)`	`Image`	החלפת התמונה הזו בתמונה שמתוארת על ידי אובייקט `Image`, אפשר גם לחתוך את התמונה כך שתתאים.
`replace(imageUrl)`	`Image`	החלפת התמונה הזו בתמונה אחרת שהורדתם מכתובת ה-URL שסיפקתם.
`replace(imageUrl, crop)`	`Image`	החלפת התמונה הזו בתמונה אחרת שהורדתם מכתובת ה-URL שסיפקתם, עם אפשרות לחתוך את התמונה כך שתתאים.
`scaleHeight(ratio)`	`Image`	שינוי הגודל של גובה הרכיב לפי היחס שצוין.
`scaleWidth(ratio)`	`Image`	שינוי הגודל של רוחב הרכיב לפי היחס שצוין.
`select()`	`void`	המערכת בוחרת רק את `PageElement` במצגת הפעילה ומבטלת את הבחירה הקודמת.
`select(replace)`	`void`	בוחרים את `PageElement` במצגת הפעילה.
`sendBackward()`	`Image`	העברת רכיב הדף לאחור בדף ברכיב אחד.
`sendToBack()`	`Image`	שליחת רכיב הדף לחלק האחורי של הדף.
`setDescription(description)`	`Image`	הגדרת תיאור הטקסט החלופי של רכיב הדף.
`setHeight(height)`	`Image`	הגדרת הגובה של האלמנט בנקודות. הגובה הזה הוא הגובה של תיבת הגבול של האלמנט כשהאלמנט לא מסתובב.
`setLeft(left)`	`Image`	הגדרת המיקום האופקי של הרכיב בנקודות, שנמדדות מהפינה הימנית העליונה של הדף כשאין רכיב סיבוב.
`setLinkSlide(slideIndex)`	`Link`	הגדרת `Link` ל-`Slide` הנתון באמצעות האינדקס שמתחיל בספרה אפס של השקף.
`setLinkSlide(slide)`	`Link`	הגדרת `Link` ל-`Slide` הנתון. הקישור מוגדר לפי מזהה השקף הנתון.
`setLinkSlide(slidePosition)`	`Link`	הגדרת `Link` ל-`Slide` הנתון באמצעות המיקום היחסי של השקף.
`setLinkUrl(url)`	`Link`	הפונקציה מגדירה את `Link` למחרוזת כתובת ה-URL הנתונה שאינה ריקה.
`setRotation(angle)`	`Image`	הגדרת זווית הסיבוב של הרכיב בכיוון השעון סביב מרכזו, במעלות.
`setTitle(title)`	`Image`	הגדרת כותרת הטקסט החלופי של רכיב הדף.
`setTop(top)`	`Image`	הגדרת המיקום האנכי של האלמנט בנקודות, שנמדדות מהפינה הימנית העליונה של הדף כשאין רוטציה לאלמנט.
`setTransform(transform)`	`Image`	הגדרת הטרנספורמציה של רכיב הדף באמצעות הטרנספורמציה שצוינה.
`setWidth(width)`	`Image`	הגדרת רוחב הרכיב בפונטים. זהו רוחב תיבת הגבול של הרכיב כשהרכיב לא מסובב.

מסמכים מפורטים

`alignOnPage(alignmentPosition)`

הרכיב מיושר למיקום היישור שצוין בדף.

פרמטרים

שם	סוג	תיאור
`alignmentPosition`	`AlignmentPosition`	המיקום שאליו יש ליישר את רכיב הדף הזה בדף.

חזרה

Image – רכיב הדף הזה, לצורך קישור.

`bringForward()`

העברת רכיב הדף קדימה בדף ברכיב אחד.

אסור שמרכיב הדף יהיה בקבוצה.

חזרה

Image – רכיב הדף הזה, לצורך קישור.

אישור

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

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

`bringToFront()`

העברת רכיב הדף לחזית הדף.

אסור שמרכיב הדף יהיה בקבוצה.

חזרה

Image – רכיב הדף הזה, לצורך קישור.

אישור

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

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

`duplicate()`

שכפול של רכיב הדף.

רכיב הדף הכפול ממוקם באותו דף ובאותו מיקום כמו המקור.

חזרה

PageElement – העותק הכפול החדש של רכיב הדף הזה.

אישור

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

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

`getAs(contentType)`

החזרת הנתונים שבתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין. השיטה הזו מוסיפה את הסיומת המתאימה לשם הקובץ – לדוגמה, 'myfile.pdf'. עם זאת, ההנחה היא שחלק משם הקובץ שמופיע אחרי הנקודה האחרונה (אם יש כזו) הוא סיומת קיימת שצריך להחליף. כתוצאה מכך, הקובץ ShoppingList.12.25.2014 הופך לקובץ ShoppingList.12.25.pdf.

כדי לראות את המכסות היומיות להמרות, אפשר לעיין במאמר מכסות לשירותי Google. יכול להיות שדומיינים חדשים של Google Workspace יהיו כפופים באופן זמני למכסות מחמירות יותר.

פרמטרים

שם	סוג	תיאור
`contentType`	`String`	סוג ה-MIME שאליו רוצים להמיר. ברוב ה-blobs, `'application/pdf'` היא האפשרות היחידה התקפה. בתמונות בפורמט BMP,‏ GIF,‏ JPEG או PNG, אפשר להשתמש גם ב-`'image/bmp'`,‏ `'image/gif'`,‏ `'image/jpeg'` או `'image/png'`. במסמך ב-Google Docs, הערך `'text/markdown'` תקף גם כן.

חזרה

Blob – הנתונים כ-blob.

`getBlob()`

החזרת הנתונים בתוך התמונה הזו כ-blob.

חזרה

Blob – נתוני התמונה כ-blob.

`getBorder()`

הפונקציה מחזירה את Border של התמונה.

חזרה

Border — הגבול של התמונה.

אישור

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

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

`getConnectionSites()`

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

חזרה

ConnectionSite[] – רשימת אתרי החיבורים. הרשימה עשויה להיות ריקה אם לאתר הזה אין אתרי חיבורים.

אישור

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

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

`getContentUrl()`

הפונקציה מקבלת כתובת URL של התמונה.

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

חזרה

String

אישור

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

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

`getDescription()`

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

חזרה

String — תיאור הטקסט החלופי של רכיב הדף.

אישור

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

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

`getHeight()`

הפונקציה מקבלת את הגובה של האלמנט בנקודות, שהוא הגובה של תיבת הגבול של האלמנט כשאין לו סיבוב.

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

חזרה

Number – הגובה הטבעי של אלמנט הדף בנקודות, או null אם לאלמנט הדף אין גובה.

אישור

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

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

`getInherentHeight()`

הפונקציה מחזירה את הגובה המובנה של הרכיב בנקודות.

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

חזרה

Number – הגובה הטבעי של אלמנט הדף בנקודות, או null אם לאלמנט הדף אין גובה.

אישור

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

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

`getInherentWidth()`

הפונקציה מחזירה את רוחב הרכיב המובנה בפיקסלים.

חזרה

Number – רוחב המאפיין של הדף באופן מובנה, בנקודה, או null אם למאפיין של הדף אין רוחב.

אישור

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

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

`getLeft()`

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

חזרה

Number — המיקום האופקי של הרכיב הזה בנקודות, מהפינה הימנית העליונה של הדף.

אישור

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

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

`getLink()`

הפונקציה מחזירה את הערך Link או null אם אין קישור.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

חזרה

Link – הערך של Link או null אם אין קישור.

אישור

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

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

`getObjectId()`

הפונקציה מחזירה את המזהה הייחודי של האובייקט הזה. מזהים של אובייקטים שמשמשים דפים ורכיבי דפים משותפים לאותו מרחב שמות.

חזרה

String – המזהה הייחודי של האובייקט הזה.

אישור

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

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

`getPageElementType()`

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

חזרה

PageElementType – הסוג של רכיב הדף.

אישור

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

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

`getParentGroup()`

הפונקציה מחזירה את הקבוצה שאליה שייך רכיב הדף, או את הערך null אם הרכיב לא נמצא בקבוצה.

חזרה

Group – הקבוצה שאליה שייך רכיב הדף הזה, או null.

אישור

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

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

`getParentPage()`

הפונקציה מחזירה את הדף שבו נמצא רכיב הדף הזה.

חזרה

Page – הדף שבו נמצא הרכיב.

אישור

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

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

`getParentPlaceholder()`

הפונקציה מחזירה את רכיב דף האב של ה-placeholder. הפונקציה מחזירה את הערך null אם התמונה היא לא placeholder או שאין לה הורה.

חזרה

PageElement — רכיב הדף ההורה של placeholder התמונה הזה, או null אם התמונה הזו היא לא placeholder או שאין לה הורה.

אישור

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

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

`getPlaceholderIndex()`

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

חזרה

Integer – מדד ה-placeholder של התמונה הזו, או null אם התמונה היא לא placeholder.

אישור

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

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

`getPlaceholderType()`

הפונקציה מחזירה את סוג ה-placeholder של התמונה, או את הערך PlaceholderType.NONE אם הצורה היא לא placeholder.

חזרה

PlaceholderType – סוג ה-placeholder של התמונה הזו.

אישור

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

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

`getRotation()`

הפונקציה מחזירה את זווית הסיבוב של הרכיב בכיוון השעון סביב מרכזו במעלות, כאשר אפס מעלות מציין שאין סיבוב.

חזרה

Number – זווית הסיבוב במעלות, בין 0 (כולל) ל-360 (לא כולל).

אישור

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

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

`getSourceUrl()`

הפונקציה מקבלת את כתובת ה-URL של מקור התמונה, אם היא זמינה.

כשתמונה מוכנסת לפי כתובת URL, הפונקציה מחזירה את כתובת ה-URL שצוינה במהלך הוספת התמונה.

חזרה

String – כתובת ה-URL של התמונה, או null אם אין לתמונה כתובת URL של מקור.

אישור

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

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

`getTitle()`

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

חזרה

String – כותרת הטקסט החלופי של רכיב הדף.

אישור

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

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

`getTop()`

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

חזרה

Number — המיקום האנכי של הרכיב הזה בנקודות, מהפינה הימנית העליונה של הדף.

אישור

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

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

`getTransform()`

הפונקציה מחזירה את הטרנספורמציה של רכיב הדף.

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

חזרה

AffineTransform – הטרנספורמציה של רכיב הדף.

אישור

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

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

`getWidth()`

הפונקציה מחזירה את רוחב הרכיב בנקודות, שהוא רוחב תיבת הגבול של הרכיב כשהרכיב לא מסובב.

חזרה

Number – רוחב המאפיין של הדף באופן מובנה, בנקודה, או null אם למאפיין של הדף אין רוחב.

אישור

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

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

`preconcatenateTransform(transform)`

שרשור מראש של הטרנספורמציה שסופקה לטרנספורמציה הקיימת של רכיב הדף.

newTransform = argument * existingTransform;

לדוגמה, כדי להזיז רכיבים בדף 36 נקודות שמאלה:

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

אפשר גם להחליף את הטרנספורמציה של רכיב הדף ב-setTransform(transform).

פרמטרים

שם	סוג	תיאור
`transform`	`AffineTransform`	הטרנספורמציה שצריך לבצע תחילה כדי לצרף לטרנספורמציה של רכיב הדף הזה.

חזרה

Image – רכיב הדף הזה, לצורך קישור.

אישור

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

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

`remove()`

הסרת רכיב הדף.

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

אם מסירים placeholder‏ PageElement ב-master או בפריסה, כל ה-placeholders הריקים שעברו בירושה יוסרו גם כן.

אישור

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

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

`removeLink()`

הסרה של Link.

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

`replace(blobSource)`

החלפת התמונה הזו בתמונה שמתוארת על ידי אובייקט BlobSource.

כשמוסיפים את התמונה, היא מאוחזרת מ- BlobSource פעם אחת, ועותק שלה נשמר להצגה במצגת. התמונות צריכות להיות בגודל של עד 50MB, לא יכולות לחרוג מ-25 מגה-פיקסל וחייבות להיות בפורמט PNG,‏ JPEG או GIF.

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

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById("123abc");
image.replace(driveImage);

פרמטרים

שם	סוג	תיאור
`blobSource`	`BlobSource`	נתוני התמונה.

חזרה

Image — Image הזה אחרי ההחלפה.

אישור

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

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

`replace(blobSource, crop)`

החלפת התמונה הזו בתמונה שמתוארת באובייקט Image, עם אפשרות לחתוך את התמונה כך שתתאים.

כשאתם מוסיפים את התמונה, היא מאוחזרת מ- BlobSource פעם אחת, ועותק שלה נשמר כדי להציג אותה במצגת. התמונות צריכות להיות בגודל של עד 50MB, לא יכולות לחרוג מ-25 מגה-פיקסל וחייבות להיות בפורמט PNG,‏ JPEG או GIF.

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
// Replace and crop the drive image.
image.replace(driveImage, true);

פרמטרים

שם	סוג	תיאור
`blobSource`	`BlobSource`	נתוני התמונה.
`crop`	`Boolean`	אם הערך הוא `true`, התמונה תוחתוך כך שתתאים לגודל של התמונה הקיימת. אחרת, התמונה תתאים למסך ותוצג במרכז.

חזרה

Image — Image הזה אחרי ההחלפה.

אישור

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

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

`replace(imageUrl)`

החלפת התמונה הזו בתמונה אחרת שהורדתם מכתובת ה-URL שסיפקתם.

כשמוסיפים את התמונה, היא אוחזר מכתובת ה-URL פעם אחת ועתק שלה נשמר כדי להציג אותה במצגת. התמונות צריכות להיות בגודל של עד 50MB, לא יכולות לחרוג מ-25 מגה-פיקסל וחייבות להיות בפורמט PNG,‏ JPEG או GIF.

כתובת ה-URL שצוינה צריכה להיות גלויה לכולם ולא יכולה להיות גדולה מ-2KB. כתובת ה-URL עצמה נשמרת עם התמונה וחשופה דרך getSourceUrl().

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

פרמטרים

שם	סוג	תיאור
`imageUrl`	`String`	כתובת ה-URL שממנה מורידים את התמונה.

חזרה

Image — Image הזה אחרי ההחלפה.

אישור

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

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

`replace(imageUrl, crop)`

החלפת התמונה הזו בתמונה אחרת שהורדתם מכתובת ה-URL שסיפקתם, עם אפשרות לחתוך את התמונה כך שתתאים.

כתובת ה-URL שצריך לספק לא יכולה להיות גדולה מ-2KB.

פרמטרים

שם	סוג	תיאור
`imageUrl`	`String`	כתובת ה-URL שממנה מורידים את התמונה.
`crop`	`Boolean`	אם הערך הוא `true`, התמונה תוחתוך כך שתתאים לגודל של התמונה הקיימת. אחרת, התמונה תתאים למסך ותוצג במרכז.

חזרה

Image — Image הזה אחרי ההחלפה.

אישור

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

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

`scaleHeight(ratio)`

שינוי הגודל של גובה הרכיב לפי היחס שצוין. הגובה של הרכיב הוא הגובה של תיבת הגבול שלו כשאין רכיב סיבוב.

פרמטרים

שם	סוג	תיאור
`ratio`	`Number`	היחס שבו יש לשנות את הגובה של רכיב הדף הזה.

חזרה

Image – רכיב הדף הזה, לצורך קישור.

אישור

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

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

`scaleWidth(ratio)`

שינוי הגודל של רוחב הרכיב לפי היחס שצוין. רוחב הרכיב הוא רוחב תיבת הגבול שלו כשאין בו סיבוב.

פרמטרים

שם	סוג	תיאור
`ratio`	`Number`	היחס שבו רוחב הרכיב בדף ישתנה.

חזרה

Image – רכיב הדף הזה, לצורך קישור.

אישור

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

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

`select()`

המערכת בוחרת רק את PageElement במצגת הפעילה ומבטלת את הבחירה הקודמת. זהו קריאה ל-select(replace) עם true.

סקריפט יכול לגשת רק לבחירה של המשתמש שמפעיל אותו, ורק אם הסקריפט קשור למצגת.

הפעולה הזו מגדירה את ההורה Page של ה-PageElement בתור ה-current page selection.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

אישור

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

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

`select(replace)`

בוחרים את PageElement במצגת הפעילה.

סקריפט יכול לגשת רק לבחירה של המשתמש שמפעיל אותו, ורק אם הסקריפט קשור למצגת.

מעבירים את הערך true לשיטה הזו כדי לבחור רק את PageElement ולהסיר כל בחירה קודמת. הפעולה הזו גם מגדירה את ההורה Page של ה-PageElement בתור ה-current page selection.

מעבירים את false כדי לבחור כמה אובייקטים מסוג PageElement. אובייקטי PageElement חייבים להיות באותו Page.

כדי לבחור רכיב דף באמצעות הפרמטר false, צריך לעמוד בתנאים הבאים:

ההורה Page של האובייקט PageElement חייב להיות current page selection.
אסור לבחור כמה אובייקטים מסוג Page.

כדי לוודא שזה המצב, הגישה המועדפת היא לבחור קודם את ההורה Page באמצעות Page.selectAsCurrentPage() ואז לבחור את רכיבי הדף בדף הזה.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

פרמטרים

שם	סוג	תיאור
`replace`	`Boolean`	אם הערך הוא `true`, הבחירה מחליפה כל בחירה קודמת. אחרת, הבחירה מתווספת לכל בחירה קודמת.

אישור

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

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

`sendBackward()`

העברת רכיב הדף לאחור בדף ברכיב אחד.

אסור שמרכיב הדף יהיה בקבוצה.

חזרה

Image – רכיב הדף הזה, לצורך קישור.

אישור

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

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

`sendToBack()`

שליחת רכיב הדף לחלק האחורי של הדף.

אסור שמרכיב הדף יהיה בקבוצה.

חזרה

Image – רכיב הדף הזה, לצורך קישור.

אישור

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

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

`setDescription(description)`

הגדרת תיאור הטקסט החלופי של רכיב הדף.

אין תמיכה בשיטה עבור רכיבי Group.

// Set the first page element's alt text description to "new alt text
// description".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

פרמטרים

שם	סוג	תיאור
`description`	`String`	המחרוזת שבה רוצים להגדיר את תיאור הטקסט החלופי.

חזרה

Image – רכיב הדף הזה.

אישור

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

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

`setHeight(height)`

הגדרת הגובה של האלמנט בנקודות. הגובה הזה הוא הגובה של תיבת הגבול של האלמנט כשהאלמנט לא מסתובב.

פרמטרים

שם	סוג	תיאור
`height`	`Number`	הגובה החדש של רכיב הדף הזה להגדרה, בנקודות.

חזרה

Image – רכיב הדף הזה, לצורך קישור.

אישור

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

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

`setLeft(left)`

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

פרמטרים

שם	סוג	תיאור
`left`	`Number`	המיקום האופקי החדש להגדרה, בנקודות.

חזרה

Image – רכיב הדף הזה, לצורך קישור.

אישור

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

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

`setLinkSlide(slideIndex)`

הגדרת Link ל-Slide הנתון באמצעות האינדקס שמתחיל בספרה אפס של השקף.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

פרמטרים

שם	סוג	תיאור
`slideIndex`	`Integer`	האינדקס של השקף, שמתחיל בספרה אפס.

חזרה

Link – ה-Link שהוגדר.

אישור

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

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

`setLinkSlide(slide)`

הגדרת Link ל-Slide הנתון. הקישור מוגדר לפי מזהה השקף הנתון.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

פרמטרים

שם	סוג	תיאור
`slide`	`Slide`	ה-`Slide` שרוצים לקשר.

חזרה

Link – ה-Link שהוגדר.

אישור

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

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

`setLinkSlide(slidePosition)`

הגדרת Link ל-Slide הנתון באמצעות המיקום היחסי של השקף.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

פרמטרים

שם	סוג	תיאור
`slidePosition`	`SlidePosition`	הערך היחסי `SlidePosition`.

חזרה

Link – ה-Link שהוגדר.

אישור

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

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

`setLinkUrl(url)`

הפונקציה מגדירה את Link למחרוזת כתובת ה-URL הנתונה שאינה ריקה.

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

פרמטרים

שם	סוג	תיאור
`url`	`String`	מחרוזת כתובת ה-URL.

חזרה

Link – ה-Link שהוגדר.

אישור

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

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

`setRotation(angle)`

הגדרת זווית הסיבוב של הרכיב בכיוון השעון סביב מרכזו, במעלות.

פרמטרים

שם	סוג	תיאור
`angle`	`Number`	זווית הסיבוב החדשה בכיוון השעון להגדרה, במעלות.

חזרה

Image – רכיב הדף הזה, לצורך קישור.

אישור

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

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

`setTitle(title)`

הגדרת כותרת הטקסט החלופי של רכיב הדף.

אין תמיכה בשיטה עבור רכיבי Group.

// Set the first page element's alt text title to "new alt text title".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

פרמטרים

שם	סוג	תיאור
`title`	`String`	המחרוזת שבה רוצים להגדיר את כותרת הטקסט החלופי.

חזרה

Image – רכיב הדף הזה.

אישור

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

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

`setTop(top)`

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

פרמטרים

שם	סוג	תיאור
`top`	`Number`	המיקום האנכי החדש להגדרה, בנקודות.

חזרה

Image – רכיב הדף הזה, לצורך קישור.

אישור

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

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

`setTransform(transform)`

הגדרת הטרנספורמציה של רכיב הדף באמצעות הטרנספורמציה שצוינה.

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

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

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

פרמטרים

שם	סוג	תיאור
`transform`	`AffineTransform`	הטרנספורמציה שמוגדרת לרכיב הדף הזה.

חזרה

Image — הרכיב הזה, לשרשור.

אישור

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

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

`setWidth(width)`

הגדרת רוחב הרכיב בפונטים. זהו רוחב תיבת הגבול של הרכיב כשהרכיב לא מסובב.

פרמטרים

שם	סוג	תיאור
`width`	`Number`	רוחב הרכיב החדש בדף, בנקודות.

חזרה

Image – רכיב הדף הזה, לצורך קישור.

אישור

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

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