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()); }
החזרות
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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 של הצורה. אם שני סוגים או יותר של placeholders נמצאים באותו דף, לכל אחד מהם יש ערך אינדקס ייחודי משלו. הפונקציה מחזירה את הערך 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()
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
ממאסטר או מהפריסה, מסירים גם את כל ה-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 פעם אחת ועותק יאוחסן לתצוגה בתוך המצגת. התמונות צריכות להיות בגודל של פחות מ-50MB, לא יותר מ-25 מגה-פיקסל. בנוסף, הן צריכות להיות בפורמט PNG , JPEG או GIF.
כתובת ה-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)
שינוי גובה הרכיב לפי היחס שצוין. גובה הרכיב הוא הגובה של התיבה התוחמת שלו כאשר לרכיב אין סיבוב.
השיטה הזו לא תואמת לכל רכיבי הדף. כאן תוכלו לקרוא על רכיבי הדף שלא תואמים לשיטה הזו.
פרמטרים
שם | סוג | תיאור |
---|---|---|
ratio | Number | היחס שבו יש לשנות את גודל הגובה של הרכיב בדף הזה. |
החזרות
Shape
– רכיב הדף הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
שינוי רוחב הרכיב לפי היחס שצוין. רוחב הרכיב הוא רוחב התיבה התוחמת שלו כאשר לרכיב אין סיבוב.
השיטה הזו לא תואמת לכל רכיבי הדף. כאן תוכלו לקרוא על רכיבי הדף שלא תואמים לשיטה הזו.
פרמטרים
שם | סוג | תיאור |
---|---|---|
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
ל-method הזה כדי לבחור רק את 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 | האינדקס מבוסס אפס לשקף. |
החזרות
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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 לקישור. |
החזרות
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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 . |
החזרות
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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. |
החזרות
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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