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

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` למחרוזת כתובת ה-URL הנתונה, שאינה ריקה.
`setRotation(angle)`	`Shape`	מגדיר את זווית הסיבוב של הרכיב בכיוון השעון סביב מרכזו, במעלות.
`setTitle(title)`	`Shape`	מגדיר את כותרת הטקסט החלופי של רכיב הדף.
`setTop(top)`	`Shape`	מגדיר את המיקום האנכי של הרכיב בנקודות, שנמדד מהפינה השמאלית העליונה של הדף כאשר לרכיב אין סיבוב.
`setTransform(transform)`	`Shape`	מגדיר את הטרנספורמציה של רכיב הדף עם הטרנספורמציה שסופקה.
`setWidth(width)`	`Shape`	מגדיר את רוחב הרכיב בנקודות, שהוא רוחב התיבה התוחמת של הרכיב כאשר אין סיבוב.

מסמכי תיעוד מפורטים

`alignOnPage(alignmentPosition)`

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

פרמטרים

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

חזרה

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

`getLink()`

הפונקציה מחזירה את הערך 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).

פרמטרים

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

חזרה

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

אישור

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

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

`remove()`

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

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

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

אישור

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

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

`removeLink()`

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

פרמטרים

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

חזרה

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

פרמטרים

שם	סוג	תיאור
`blobSource`	`BlobSource`	נתוני התמונה.
`crop`	`Boolean`	אם הערך שלו הוא `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().

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

פרמטרים

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

חזרה

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

אישור

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

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

`replaceWithImage(imageUrl, crop)`

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

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

פרמטרים

שם	סוג	תיאור
`imageUrl`	`String`	כתובת ה-URL של התמונה שממנה רוצים להוריד את התמונה.
`crop`	`Boolean`	אם הערך שלו הוא `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);

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

Image – התמונה של התרשים שהחליפה את הצורה.

אישור

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

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

`scaleHeight(ratio)`

שינוי גובה הרכיב לפי היחס שצוין. גובה הרכיב הוא הגובה שלו תיבה תוחמת (bounding box) כשלרכיב אין סיבוב.

פרמטרים

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

חזרה

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

אישור

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

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

`scaleWidth(ratio)`

שינוי רוחב הרכיב לפי היחס שצוין. רוחב הרכיב הוא הרוחב של הרכיב תיבה תוחמת (bounding box) כשלרכיב אין סיבוב.

פרמטרים

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

חזרה

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, התנאים הבאים חייבים להתקיים :

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

פרמטרים

שם	סוג	תיאור
`replace`	`Boolean`	אם הערך שלו הוא `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 של הטקסט בתוך הצורה.

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

פרמטרים

שם	סוג	תיאור
`contentAlignment`	`ContentAlignment`	היישור שיש להגדיר.

חזרה

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

פרמטרים

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

חזרה

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

אישור

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

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

`setHeight(height)`

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

פרמטרים

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

חזרה

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

אישור

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

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

`setLeft(left)`

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

פרמטרים

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

חזרה

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

פרמטרים

שם	סוג	תיאור
`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.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

פרמטרים

שם	סוג	תיאור
`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.
shape.setLinkSlide(SlideApp.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.
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`	הזווית החדשה להגדרת הסיבוב בכיוון השעון, במעלות.

חזרה

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

פרמטרים

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

חזרה

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

אישור

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

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

`setTop(top)`

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

פרמטרים

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

חזרה

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

אישור

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

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

`setTransform(transform)`

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

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

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

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

פרמטרים

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

חזרה

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

אישור

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

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

`setWidth(width)`

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

פרמטרים

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

חזרה

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

אישור

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

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