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[]מחזירה את רשימת ה-ConnectionSites ברכיב הדף, או רשימה ריקה אם לרכיב הדף אין אתרי חיבור.
getContentUrl()Stringמחזירה כתובת URL לתמונה.
getDescription()Stringהפונקציה מחזירה את תיאור הטקסט החלופי של רכיב הדף.
getHeight()Number|nullמחזירה את גובה הרכיב בנקודות, שהוא הגובה של תיבת התוחמת של הרכיב אם הרכיב לא מסובב.
getInherentHeight()Number|nullהפונקציה מחזירה את הגובה המובנה של הרכיב בנקודות.
getInherentWidth()Number|nullהפונקציה מחזירה את הרוחב המובנה של הרכיב בנקודות.
getLeft()Numberהפונקציה מחזירה את המיקום האופקי של האלמנט בנקודות, שנמדד מהפינה הימנית העליונה של הדף כשהאלמנט לא מסובב.
getLink()Link|nullהפונקציה מחזירה את הערך Link או null אם אין קישור.
getObjectId()Stringהפונקציה מחזירה את המזהה הייחודי של האובייקט.
getPageElementType()PageElementTypeהפונקציה מחזירה את סוג רכיב הדף, שמיוצג כסוג enum‏ PageElementType.
getParentGroup()Group|nullהפונקציה מחזירה את הקבוצה שאליה שייך הרכיב הזה בדף, או null אם הרכיב לא נמצא בקבוצה.
getParentPage()Pageמחזירה את הדף שרכיב הדף הזה נמצא בו.
getParentPlaceholder()PageElement|nullהחזרת רכיב דף האב של ה-placeholder.
getPlaceholderIndex()Integer|nullהפונקציה מחזירה את האינדקס של תמונת ה-placeholder.
getPlaceholderType()PlaceholderTypeהפונקציה מחזירה את סוג הפלייסהולדר של התמונה, או PlaceholderType.NONE אם הצורה לא משמשת כפלייסהולדר.
getRotation()Numberמחזירה את זווית הסיבוב של הרכיב בכיוון השעון סביב המרכז שלו במעלות, כאשר אפס מעלות פירושו שאין סיבוב.
getSourceUrl()String|nullמחזירה את כתובת ה-URL של מקור התמונה, אם היא זמינה.
getTitle()Stringהפונקציה מחזירה את הכותרת של הטקסט החלופי של רכיב הדף.
getTop()Numberמחזירה את המיקום האנכי של האלמנט בנקודות, שנמדד מהפינה השמאלית העליונה של הדף כשהאלמנט לא מסובב.
getTransform()AffineTransformמחזירה את הטרנספורמציה של רכיב הדף.
getWidth()Number|nullהפונקציה מחזירה את רוחב הרכיב בנקודות, שהוא הרוחב של התיבה התוחמת של הרכיב כשהרכיב לא מסובב.
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)

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

פרמטרים

שםסוגתיאור
alignmentPositionAlignmentPositionהמיקום שבו רכיב הדף הזה ייושר בדף.

חזרה

‫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 יהיו כפופים באופן זמני למכסות מחמירות יותר.

פרמטרים

שםסוגתיאור
contentTypeStringסוג ה-MIME שאליו רוצים להמיר. ברוב ה-BLOB, ‏ '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 – הגובה המובנה של רכיב הדף בנקודות, או null אם לרכיב הדף אין גובה.

אישור

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

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

getInherentHeight()

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

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

חזרה

‫Number|null – הגובה המובנה של רכיב הדף בנקודות, או null אם לרכיב הדף אין גובה.

אישור

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

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

getInherentWidth()

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

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

חזרה

‫Number|null – הרוחב המובנה של רכיב הדף בנקודות, או 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

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

אישור

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

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

getPlaceholderIndex()

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

חזרה

‫Integer|null – האינדקס של הפלייסהולדר של התמונה, או null אם התמונה היא לא פלייסהולדר.

אישור

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

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

getPlaceholderType()

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

חזרה

‫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|null — כתובת ה-URL של התמונה או null אם לתמונה אין כתובת URL של מקור.

אישור

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

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

getTitle()

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

חזרה

‫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 – הרוחב המובנה של רכיב הדף בנקודות, או 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).

פרמטרים

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

חזרה

‫Image – רכיב הדף הזה, לשרשור.

אישור

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

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

remove()

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

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

אם מסירים placeholder‏ PageElement מתבנית ראשית או מפריסת שקפים, יוסרו גם placeholder-ים ריקים שמועברים בירושה.

אישור

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

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

הסרה של 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);

פרמטרים

שםסוגתיאור
blobSourceBlobSourceנתוני התמונה.

חזרה

‫Image — This 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);

פרמטרים

שםסוגתיאור
blobSourceBlobSourceנתוני התמונה.
cropBooleanאם בוחרים באפשרות true, התמונה נחתכת כך שתתאים לגודל של התמונה הקיימת. אחרת, התמונה תותאם ותמוקם במרכז.

חזרה

‫Image — This 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().

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

פרמטרים

שםסוגתיאור
imageUrlStringכתובת ה-URL שממנה אפשר להוריד את התמונה.

חזרה

‫Image — This Image אחרי ההחלפה.

אישור

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

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

replace(imageUrl, crop)

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

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

כתובת ה-URL שצוינה לא יכולה להיות גדולה מ-2KB.

פרמטרים

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

חזרה

‫Image — This Image אחרי ההחלפה.

אישור

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

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

scaleHeight(ratio)

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

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

פרמטרים

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

חזרה

‫Image – רכיב הדף הזה, לשרשור.

אישור

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

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

scaleWidth(ratio)

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

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

פרמטרים

שםסוגתיאור
ratioNumberהיחס שבו יוגדל או יוקטן הרוחב של הרכיב הזה בדף.

חזרה

‫Image – רכיב הדף הזה, לשרשור.

אישור

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

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

select()

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

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

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

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:

  1. תג ההורה Page של האובייקט PageElement חייב להיות current page selection.
  2. לא יכולים להיות כמה אובייקטים מסוג 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);
}

פרמטרים

שםסוגתיאור
replaceBooleanאם 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());

פרמטרים

שםסוגתיאור
descriptionStringהמחרוזת להגדרת התיאור של הטקסט החלופי.

חזרה

‫Image — רכיב הדף הזה.

אישור

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

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

setHeight(height)

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

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

פרמטרים

שםסוגתיאור
heightNumberהגובה החדש של הרכיב הזה בדף שצריך להגדיר, בנקודות.

חזרה

‫Image – רכיב הדף הזה, לשרשור.

אישור

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

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

setLeft(left)

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

פרמטרים

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

חזרה

‫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);

פרמטרים

שםסוגתיאור
slideIndexIntegerהאינדקס של השקף, כשהספירה מתחילה מ-0.

חזרה

‫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]);

פרמטרים

שםסוגתיאור
slideSlideה-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);

פרמטרים

שםסוגתיאור
slidePositionSlidePositionהערך היחסי 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');

פרמטרים

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

חזרה

‫Link – הערך Link שהוגדר.

אישור

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

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

setRotation(angle)

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

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

פרמטרים

שםסוגתיאור
angleNumberזווית הסיבוב החדשה בכיוון השעון שצריך להגדיר, במעלות.

חזרה

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

פרמטרים

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

חזרה

‫Image — רכיב הדף הזה.

אישור

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

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

setTop(top)

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

פרמטרים

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

חזרה

‫Image – רכיב הדף הזה, לשרשור.

אישור

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

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

setTransform(transform)

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

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

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

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

פרמטרים

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

חזרה

‫Image — האלמנט הזה, לשרשור.

אישור

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

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

setWidth(width)

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

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

פרמטרים

שםסוגתיאור
widthNumberהרוחב החדש של הרכיב הזה בדף שצריך להגדיר, בנקודות.

חזרה

‫Image – רכיב הדף הזה, לשרשור.

אישור

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

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