Class Shape

צורה

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

שיטות

שיטהסוג הערך שמוחזרתיאור קצר
alignOnPage(alignmentPosition)Shapeיישור הרכיב למיקום היישור שצוין בדף.
bringForward()Shapeהצגת הרכיב בדף קדימה ברכיב אחד.
bringToFront()Shapeמעביר את רכיב הדף לחלק הקדמי של הדף.
duplicate()PageElementשכפול רכיב הדף.
getAutofit()Autofitהפונקציה מחזירה את Autofit של הטקסט בתוך הצורה הזו.
getBorder()Borderמחזירה את Border של הצורה.
getConnectionSites()ConnectionSite[]מחזירה את הרשימה של פריטי ה-ConnectionSite ברכיב הדף, או רשימה ריקה אם למרכיב הדף אין אתרי חיבור.
getContentAlignment()ContentAlignmentמחזירה את ContentAlignment של הטקסט בצורה.
getDescription()Stringמחזירה את תיאור הטקסט החלופי של רכיב הדף.
getFill()Fillמחזירה את Fill של הצורה.
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מחזירה את זווית הסיבוב של הרכיב בכיוון השעון סביב מרכזו, במעלות, כאשר אפס מעלות פירושו ללא סיבוב.
getShapeType()ShapeTypeמחזירה את סוג הצורה.
getText()TextRangeמחזירה את תוכן הטקסט של הצורה.
getTitle()Stringמחזירה את כותרת הטקסט החלופי של רכיב הדף.
getTop()Numberהפונקציה מקבלת את המיקום האנכי של הרכיב בנקודות, שנמדדות מהפינה השמאלית העליונה של הדף כשאין לרכיב סיבוב.
getTransform()AffineTransformמחזירה את הטרנספורמציה של רכיב הדף.
getWidth()Numberמחזירה את רוחב הרכיב בנקודות, שהוא רוחב התיבה התוחמת את הרכיב כשאין לרכיב סיבוב.
preconcatenateTransform(transform)Shapeמשרשר מראש את הטרנספורמציה שסופקה לטרנספורמציה הקיימת של רכיב הדף.
remove()voidמסיר את רכיב הדף.
removeLink()voidהסרה של Link.
replaceWithImage(blobSource)Imageמחליף את הצורה הזו בתמונה שסופקה על ידי BlobSource.
replaceWithImage(blobSource, crop)Imageמחליף את הצורה הזו בתמונה שסופקה על ידי BlobSource.
replaceWithImage(imageUrl)Imageמחליפה את הצורה הזו בתמונה.
replaceWithImage(imageUrl, crop)Imageמחליפה את הצורה הזו בתמונה.
replaceWithSheetsChart(sourceChart)SheetsChartמחליף את הצורה הזו בתרשים של Google Sheets.
replaceWithSheetsChartAsImage(sourceChart)Imageמחליפה את הצורה הזו בתמונה של תרשים ב-Google Sheets.
scaleHeight(ratio)Shapeמשנה את גובה הרכיב לפי היחס שצוין.
scaleWidth(ratio)Shapeמשנה את רוחב הרכיב לפי היחס שצוין.
select()voidהמערכת בוחרת רק את PageElement מהמצגת הפעילה, ומסירה את כל הבחירות הקודמות.
select(replace)voidלחיצה על PageElement במצגת הפעילה.
sendBackward()Shapeשולח את רכיב הדף אחורה בדף אחר רכיב אחד.
sendToBack()Shapeשליחת רכיב הדף לחלק האחורי של הדף.
setContentAlignment(contentAlignment)Shapeמגדיר את ContentAlignment של הטקסט בצורה.
setDescription(description)Shapeמגדיר את תיאור הטקסט החלופי של רכיב הדף.
setHeight(height)Shapeמגדירה את גובה הרכיב בנקודות, שהוא הגובה של התיבה התוחמת של הרכיב כאשר אין לרכיב סיבוב.
setLeft(left)Shapeמגדיר את המיקום האופקי של הרכיב בנקודות, שנמדד מהפינה השמאלית העליונה של הדף כאשר לרכיב אין סיבוב.
setLinkSlide(slideIndex)Linkמגדירה Link ל-Slide הנתון באמצעות האינדקס המבוסס על אפסים של השקף.
setLinkSlide(slide)Linkמגדירה Link ל-Slide הנתון, הקישור מוגדר על ידי מזהה השקף הנתון.
setLinkSlide(slidePosition)Linkמגדירה Link ל-Slide הנתון באמצעות המיקום היחסי של השקף.
setLinkUrl(url)Linkמגדיר Link למחרוזת הנתונה של כתובת אתר שאינה ריקה.
setRotation(angle)Shapeמגדיר את זווית הסיבוב של הרכיב בכיוון השעון סביב המרכז, במעלות.
setTitle(title)Shapeמגדיר את כותרת הטקסט החלופי של רכיב הדף.
setTop(top)Shapeקובע את המיקום האנכי של הרכיב בנקודות, שנמדד מהפינה השמאלית העליונה של הדף כשאין לרכיב סיבוב.
setTransform(transform)Shapeמגדיר את הטרנספורמציה של רכיב הדף עם הטרנספורמציה הנתונה.
setWidth(width)Shapeמגדיר את רוחב הרכיב בנקודות, שהוא רוחב התיבה התוחמת את הרכיב כאשר אין לרכיב סיבוב.

תיעוד מפורט

alignOnPage(alignmentPosition)

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

פרמטרים

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

החזרות

Shape - רכיב הדף הזה, לשרשור.

bringForward()

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

רכיב הדף לא יכול להיכלל בקבוצה.

החזרות

Shape - רכיב הדף הזה, לשרשור.

הרשאות

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

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

bringToFront()

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

רכיב הדף לא יכול להיכלל בקבוצה.

החזרות

Shape - רכיב הדף הזה, לשרשור.

הרשאות

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

  • 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

getAutofit()

הפונקציה מחזירה את Autofit של הטקסט בתוך הצורה הזו. הערך הוא null אם הצורה לא מאפשרת טקסט.

החזרות

Autofit – ההתאמה האוטומטית של הטקסט בצורה הזו.

הרשאות

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

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

getBorder()

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

החזרות

Border - הגדרת הגבול של הצורה הזו.

הרשאות

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

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

getConnectionSites()

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

החזרות

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

הרשאות

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

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

getContentAlignment()

מחזירה את ContentAlignment של הטקסט בצורה.

החזרות

ContentAlignment - היישור של הטקסט בצורה הזו.

הרשאות

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

  • 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

getFill()

מחזירה את Fill של הצורה.

החזרות

Fill – הגדרת המילוי של הצורה הזו.

הרשאות

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

  • 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

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

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

החזרות

Link

הרשאות

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

  • 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

getShapeType()

מחזירה את סוג הצורה.

החזרות

ShapeType - הסוג של הצורה הזו.

getText()

מחזירה את תוכן הטקסט של הצורה.

טקסט בתוך צורה מסתיים תמיד בתו בשורה חדשה.

החזרות

TextRange - תוכן הטקסט בצורה הזו.

הרשאות

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

  • 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 אם לרכיב הדף אין רוחב.

הרשאות

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

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

preconcatenateTransform(transform)

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

newTransform = argument * existingTransform

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

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

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

פרמטרים

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

החזרות

Shape - רכיב הדף הזה, לשרשור.

הרשאות

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

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

remove()

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

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

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

הרשאות

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

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

הסרה של Link. 

shape.removeLink();

replaceWithImage(blobSource)

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

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

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

var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
shape.replaceWithImage(driveImage);

פרמטרים

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

החזרות

Image - Image שהחליפה את הצורה.

הרשאות

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

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

replaceWithImage(blobSource, crop)

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

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

var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

פרמטרים

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

החזרות

Image - Image שהחליפה את הצורה.

הרשאות

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

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

replaceWithImage(imageUrl)

מחליפה את הצורה הזו בתמונה.

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

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

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

פרמטרים

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

החזרות

Image - Image שהחליפה את הצורה.

הרשאות

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

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

replaceWithImage(imageUrl, crop)

מחליפה את הצורה הזו בתמונה.

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

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

פרמטרים

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

החזרות

Image - Image שהחליפה את הצורה.

הרשאות

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

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

replaceWithSheetsChart(sourceChart)

מחליף את הצורה הזו בתרשים של Google Sheets.

התרשים מקושר לתרשים המקור ב-Google Sheets, כך שאפשר לעדכן אותו. שותפי עריכה אחרים יוכלו לראות את הקישור לגיליון האלקטרוני המקורי. 

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChart(chart);

פרמטרים

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

החזרות

SheetsChart – התרשים שהחליף את הצורה.

הרשאות

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

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

replaceWithSheetsChartAsImage(sourceChart)

מחליפה את הצורה הזו בתמונה של תרשים ב-Google Sheets.

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

התמונה של התרשים לא מקושרת לתרשים המקור ב-Google Sheets. 

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChartAsImage(chart);

פרמטרים

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

החזרות

Image - התמונה של התרשים שמחליף את הצורה.

הרשאות

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

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

scaleHeight(ratio)

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

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

פרמטרים

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

החזרות

Shape - רכיב הדף הזה, לשרשור.

הרשאות

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

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

scaleWidth(ratio)

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

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

פרמטרים

שםתיאורהתיאור
ratioNumberהיחס הנדרש לשינוי קנה המידה של רוחב רכיב הדף הזה.

החזרות

Shape - רכיב הדף הזה, לשרשור.

הרשאות

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

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

select()

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

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

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

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var 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.

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

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

  1. ההורה Page של האובייקט PageElement חייב להיות current page selection.
  2. לא צריך לבחור יותר מ-Page אובייקטים.

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

var 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.
var pageElements = slide.getPageElements();
for (var 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()

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

רכיב הדף לא יכול להיכלל בקבוצה.

החזרות

Shape - רכיב הדף הזה, לשרשור.

הרשאות

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

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

sendToBack()

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

רכיב הדף לא יכול להיכלל בקבוצה.

החזרות

Shape - רכיב הדף הזה, לשרשור.

הרשאות

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

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

setContentAlignment(contentAlignment)

מגדיר את ContentAlignment של הטקסט בצורה.

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

פרמטרים

שםתיאורהתיאור
contentAlignmentContentAlignmentההתאמה להגדרה.

החזרות

Shape – הצורה הזו לשרשור.

הרשאות

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

  • 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".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

פרמטרים

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

החזרות

Shape - רכיב הדף הזה.

הרשאות

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

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

setHeight(height)

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

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

פרמטרים

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

החזרות

Shape - רכיב הדף הזה, לשרשור.

הרשאות

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

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

setLeft(left)

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

פרמטרים

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

החזרות

Shape - רכיב הדף הזה, לשרשור.

הרשאות

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

  • 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.
shape.setLinkSlide(0);

פרמטרים

שםתיאורהתיאור
slideIndexIntegerהאינדקס מבוסס-אפס לשקף.

החזרות

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.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

פרמטרים

שםתיאורהתיאור
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.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

פרמטרים

שםתיאורהתיאור
slidePositionSlidePositionSlidePosition היחסי.

החזרות

Link – Link שהוגדר

הרשאות

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

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

setLinkUrl(url)

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

// Set a link to the URL.
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זווית הסיבוב החדשה בכיוון השעון שיש להגדיר, במעלות.

החזרות

Shape - רכיב הדף הזה, לשרשור.

הרשאות

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

  • 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".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

פרמטרים

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

החזרות

Shape - רכיב הדף הזה.

הרשאות

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

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

setTop(top)

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

פרמטרים

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

החזרות

Shape - רכיב הדף הזה, לשרשור.

הרשאות

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

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

setTransform(transform)

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

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

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

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

פרמטרים

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

החזרות

Shape – הרכיב הזה, לשרשור.

הרשאות

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

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

setWidth(width)

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

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

פרמטרים

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

החזרות

Shape - רכיב הדף הזה, לשרשור.

הרשאות

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

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