PageElement
שמייצגת קו.
שיטות
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
alignOnPage(alignmentPosition) | Line | מיישר את הרכיב למיקום היישור שצוין בדף. |
bringForward() | Line | מעבירה את רכיב הדף קדימה ברכיב אחד. |
bringToFront() | Line | מעביר את רכיב הדף לחלק הקדמי של הדף. |
duplicate() | PageElement | שכפול של רכיב הדף. |
getConnectionSites() | ConnectionSite[] | הפונקציה מחזירה את הרשימה של ערכי ConnectionSite ברכיב הדף, או רשימה ריקה אם הדף
לרכיב אין אתרי חיבור. |
getDashStyle() | DashStyle | מקבל את DashStyle של הקו. |
getDescription() | String | הפונקציה מחזירה את תיאור הטקסט החלופי של רכיב הדף. |
getEnd() | Point | מחזירה את נקודת הסיום של הקו, שנמדדת מהפינה השמאלית העליונה של הדף. |
getEndArrow() | ArrowStyle | הפונקציה מקבלת את ה-ArrowStyle של החץ בסוף השורה. |
getEndConnection() | ConnectionSite | הפונקציה מחזירה את החיבור בסוף השורה, או null אם אין חיבור. |
getHeight() | Number | מקבל את גובה הרכיב בנקודות, שהוא גובה התיבה התוחמת של הרכיב כאשר אין סיבוב. |
getInherentHeight() | Number | מחזירה את הגובה המובנה של הרכיב בנקודות. |
getInherentWidth() | Number | מחזירה את הרוחב המובנה של הרכיב בנקודות. |
getLeft() | Number | מחזירה את המיקום האופקי של הרכיב בנקודות, שנמדד מהפינה השמאלית העליונה של כאשר לרכיב אין סיבוב. |
getLineCategory() | LineCategory | מקבל את LineCategory של הקו. |
getLineFill() | LineFill | מקבל את LineFill של הקו. |
getLineType() | LineType | מקבל את LineType של הקו. |
getLink() | Link | הפונקציה מחזירה את הערך Link או null אם אין קישור. |
getObjectId() | String | מחזירה את המזהה הייחודי של האובייקט הזה. |
getPageElementType() | PageElementType | מחזירה את הסוג של רכיב הדף, מיוצג כ-enum PageElementType . |
getParentGroup() | Group | הפונקציה מחזירה את הקבוצה שאליה שייך הרכיב בדף הזה, או null אם הרכיב לא נמצא
קבוצה. |
getParentPage() | Page | מחזיר את הדף שבו נמצא הרכיב של הדף הזה. |
getRotation() | Number | הפונקציה מחזירה את זווית הסיבוב של הרכיב בכיוון השעון סביב המרכז שלו, במעלות, כאשר אפס מעלות פירושו שלא יתבצע רוטציה. |
getStart() | Point | מחזירה את נקודת ההתחלה של הקו, במדידה מהפינה הימנית העליונה של הדף. |
getStartArrow() | ArrowStyle | הפונקציה מקבלת את ArrowStyle של החץ בתחילת השורה. |
getStartConnection() | ConnectionSite | הפונקציה מחזירה את החיבור בתחילת השורה, או null אם אין חיבור. |
getTitle() | String | הפונקציה מחזירה את כותרת הטקסט החלופי של רכיב הדף. |
getTop() | Number | מקבלת את המיקום האנכי של הרכיב בנקודות, שנמדדות מהפינה השמאלית העליונה של הדף כאשר לרכיב אין סיבוב. |
getTransform() | AffineTransform | מחזירה את הטרנספורמציה של רכיב הדף. |
getWeight() | Number | מחזירה את עובי הקו בנקודות. |
getWidth() | Number | הפונקציה מחזירה את רוחב הרכיב בנקודות, שהוא רוחב התיבה התוחמת של הרכיב כאשר לרכיב אין סיבוב. |
isConnector() | Boolean | הפונקציה מחזירה את הערך true אם הקו הוא מחבר, או false אם לא. |
preconcatenateTransform(transform) | Line | משרשרת מראש את הטרנספורמציה שסופקה לטרנספורמציה הקיימת של רכיב הדף. |
remove() | void | הסרת רכיב הדף. |
removeLink() | void | הסרה של Link . |
reroute() | Line | מנתב מחדש את נקודת ההתחלה והסיום של הקו לשני אתרי החיבור הקרובים ביותר ברשת המחוברת מרכיבי הדף. |
scaleHeight(ratio) | Line | שינוי גובה הרכיב לפי היחס שצוין. |
scaleWidth(ratio) | Line | שינוי רוחב הרכיב לפי היחס שצוין. |
select() | void | בוחר רק את ה-PageElement במצגת הפעילה ומסיר את כל התשובות הקודמות
בחירה. |
select(replace) | void | בחירה ב-PageElement במצגת הפעילה. |
sendBackward() | Line | הפונקציה שולחת את רכיב הדף אחורה בדף באמצעות רכיב אחד. |
sendToBack() | Line | שליחת רכיב הדף לחלק האחורי של הדף. |
setDashStyle(style) | Line | מגדיר את DashStyle של השורה. |
setDescription(description) | Line | מגדיר את תיאור הטקסט החלופי של רכיב הדף. |
setEnd(left, top) | Line | מגדיר את המיקום של נקודת הסיום של הקו. |
setEnd(point) | Line | מגדיר את המיקום של נקודת הסיום של הקו. |
setEndArrow(style) | Line | מגדיר את ArrowStyle של החץ בסוף השורה. |
setEndConnection(connectionSite) | Line | מגדיר את החיבור בסוף השורה. |
setHeight(height) | Line | מגדיר את גובה הרכיב בנקודות, שהוא גובה התיבה התוחמת של הרכיב כאשר אין סיבוב. |
setLeft(left) | Line | מגדיר את המיקום האופקי של הרכיב בנקודות, שנמדד מהפינה השמאלית העליונה של כאשר לרכיב אין סיבוב. |
setLineCategory(lineCategory) | Line | מגדיר את LineCategory של השורה. |
setLinkSlide(slideIndex) | Link | הפונקציה מגדירה Link ל-Slide הנתון באמצעות האינדקס מבוסס האפס של השקף. |
setLinkSlide(slide) | Link | מגדיר Link ל-Slide הנתון, הקישור מוגדר על ידי מזהה השקף הנתון. |
setLinkSlide(slidePosition) | Link | הפונקציה מגדירה Link ל-Slide הנתון באמצעות המיקום היחסי של השקף. |
setLinkUrl(url) | Link | מגדירה Link למחרוזת כתובת ה-URL הנתונה, שאינה ריקה. |
setRotation(angle) | Line | מגדיר את זווית הסיבוב של הרכיב בכיוון השעון סביב מרכזו, במעלות. |
setStart(left, top) | Line | מגדיר את המיקום של נקודת ההתחלה של הקו. |
setStart(point) | Line | מגדיר את המיקום של נקודת ההתחלה של הקו. |
setStartArrow(style) | Line | מגדיר את ArrowStyle של החץ בתחילת השורה. |
setStartConnection(connectionSite) | Line | מגדיר את החיבור בתחילת השורה. |
setTitle(title) | Line | מגדיר את כותרת הטקסט החלופי של רכיב הדף. |
setTop(top) | Line | מגדיר את המיקום האנכי של הרכיב בנקודות, שנמדד מהפינה השמאלית העליונה של הדף כאשר לרכיב אין סיבוב. |
setTransform(transform) | Line | מגדיר את הטרנספורמציה של רכיב הדף עם הטרנספורמציה שסופקה. |
setWeight(points) | Line | מגדיר את עובי הקו בנקודות. |
setWidth(width) | Line | מגדיר את רוחב הרכיב בנקודות, שהוא רוחב התיבה התוחמת של הרכיב כאשר אין סיבוב. |
מסמכי תיעוד מפורטים
alignOnPage(alignmentPosition)
מיישר את הרכיב למיקום היישור שצוין בדף.
פרמטרים
שם | סוג | תיאור |
---|---|---|
alignmentPosition | AlignmentPosition | המיקום שאליו יש ליישר את רכיב הדף בדף. |
חזרה
Line
– רכיב הדף הזה, לשרשור.
bringForward()
מעבירה את רכיב הדף קדימה ברכיב אחד.
רכיב הדף לא יכול להיות בקבוצה.
חזרה
Line
– רכיב הדף הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringToFront()
מעביר את רכיב הדף לחלק הקדמי של הדף.
רכיב הדף לא יכול להיות בקבוצה.
חזרה
Line
– רכיב הדף הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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
getConnectionSites()
הפונקציה מחזירה את הרשימה של ערכי ConnectionSite
ברכיב הדף, או רשימה ריקה אם הדף
לרכיב אין אתרי חיבור.
חזרה
ConnectionSite[]
— רשימת אתרי החיבור. יכולה להיות ריקה אם ברכיב הזה אין אתרי חיבור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDashStyle()
מקבל את DashStyle
של הקו.
חזרה
DashStyle
— סגנון המקף שבו נעשה שימוש בקו הזה.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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
getEnd()
מחזירה את נקודת הסיום של הקו, שנמדדת מהפינה השמאלית העליונה של הדף.
חזרה
Point
– נקודת הסיום של הקו.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getEndArrow()
הפונקציה מקבלת את ה-ArrowStyle
של החץ בסוף השורה.
חזרה
ArrowStyle
– סגנון החץ בסוף הקו הזה.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getEndConnection()
הפונקציה מחזירה את החיבור בסוף השורה, או null
אם אין חיבור.
חזרה
ConnectionSite
— החיבור בסוף השורה.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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
getLineCategory()
מקבל את LineCategory
של הקו.
חזרה
LineCategory
– קטגוריית הקו.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLineFill()
מקבל את LineFill
של הקו.
חזרה
LineFill
– הגדרת המילוי של השורה הזו.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLineType()
מקבל את LineType
של הקו.
חזרה
LineType
– סוג הקו הזה.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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
getRotation()
הפונקציה מחזירה את זווית הסיבוב של הרכיב בכיוון השעון סביב המרכז שלו, במעלות, כאשר אפס מעלות פירושו שלא יתבצע רוטציה.
חזרה
Number
— זווית הסיבוב במעלות בין 0 (כולל) ל-360 (לא כולל).
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getStart()
מחזירה את נקודת ההתחלה של הקו, במדידה מהפינה הימנית העליונה של הדף.
חזרה
Point
– נקודת ההתחלה של הקו.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getStartArrow()
הפונקציה מקבלת את ArrowStyle
של החץ בתחילת השורה.
חזרה
ArrowStyle
– סגנון החץ בתחילת השורה הזו.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getStartConnection()
הפונקציה מחזירה את החיבור בתחילת השורה, או null
אם אין חיבור.
חזרה
ConnectionSite
– החיבור בתחילת השורה.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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
getWeight()
מחזירה את עובי הקו בנקודות.
חזרה
Number
— עובי הקו בנקודות.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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
isConnector()
הפונקציה מחזירה את הערך true
אם הקו הוא מחבר, או false
אם לא.
מחבר הוא סוג של קו המשמש לחיבור אתרים בדף רלוונטי רכיבים. כל קצה של מחבר יכול להיות מחובר לאתר חיבור אחד לכל היותר.
חזרה
Boolean
— True
אם הקו הוא מחבר, או false
אם לא.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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 | הטרנספורמציה כדי לשרשר מראש את הטרנספורמציה של הרכיב הזה בדף. |
חזרה
Line
– רכיב הדף הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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();
reroute()
מנתב מחדש את נקודת ההתחלה והסיום של הקו לשני אתרי החיבור הקרובים ביותר ברשת המחוברת מרכיבי הדף. ההתחלה והסוף של השורה חייבים להיות מחוברים לרכיבי דף שונים.
חזרה
Line
– הקו.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleHeight(ratio)
שינוי גובה הרכיב לפי היחס שצוין. גובה הרכיב הוא הגובה שלו תיבה תוחמת (bounding box) כשלרכיב אין סיבוב.
השיטה הזו לא תואמת לכל רכיבי הדף. כדי לדעת אילו רכיבי דף לא שתואמים לשיטה הזו, קראו את מגבלות על קביעת גודל ומיקום.
פרמטרים
שם | סוג | תיאור |
---|---|---|
ratio | Number | היחס שבו יש לשנות את גודלו של הרכיב בדף הזה. |
חזרה
Line
– רכיב הדף הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
שינוי רוחב הרכיב לפי היחס שצוין. רוחב הרכיב הוא הרוחב של הרכיב תיבה תוחמת (bounding box) כשלרכיב אין סיבוב.
השיטה הזו לא תואמת לכל רכיבי הדף. כדי לדעת אילו רכיבי דף לא שתואמים לשיטה הזו, קראו את מגבלות על קביעת גודל ומיקום.
פרמטרים
שם | סוג | תיאור |
---|---|---|
ratio | Number | היחס שבו יש לשנות את גודל הרוחב של הרכיב הזה בדף. |
חזרה
Line
– רכיב הדף הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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()
הפונקציה שולחת את רכיב הדף אחורה בדף באמצעות רכיב אחד.
רכיב הדף לא יכול להיות בקבוצה.
חזרה
Line
– רכיב הדף הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendToBack()
שליחת רכיב הדף לחלק האחורי של הדף.
רכיב הדף לא יכול להיות בקבוצה.
חזרה
Line
– רכיב הדף הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setDashStyle(style)
מגדיר את DashStyle
של השורה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
style | DashStyle | סגנון המקף שיש להגדיר עבור הקו הזה. |
חזרה
Line
– הקו הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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 | המחרוזת שאליה יש להגדיר את התיאור של הטקסט החלופי. |
חזרה
Line
– רכיב הדף הזה.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEnd(left, top)
מגדיר את המיקום של נקודת הסיום של הקו.
יכול להיות שנתיב הקו ישתנה אחרי שהמיקום ישתנה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
left | Number | המיקום האופקי של נקודת הקצה של הקו, שנמדד בנקודות בפינה הימנית העליונה של הדף. |
top | Number | המיקום האנכי של נקודת הקצה של הקו, שנמדד בנקודות בפינה הימנית העליונה של הדף. |
חזרה
Line
– הקו הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEnd(point)
מגדיר את המיקום של נקודת הסיום של הקו.
יכול להיות שנתיב הקו ישתנה אחרי שהמיקום ישתנה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
point | Point | נקודת הקצה של הקו, שהמיקום שלו נמדד מהפינה השמאלית העליונה של הדף. |
חזרה
Line
– הקו הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEndArrow(style)
מגדיר את ArrowStyle
של החץ בסוף השורה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
style | ArrowStyle | הסגנון שצריך להגדיר. |
חזרה
Line
– הקו הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEndConnection(connectionSite)
מגדיר את החיבור בסוף השורה. מעביר את קצה הקו לערך שצוין בזמן שהצד השני נשאר ללא שינוי.
פרמטרים
שם | סוג | תיאור |
---|---|---|
connectionSite | ConnectionSite | אתר החיבור שבו מתעדכן החיבור הסופי, או null אם
מסירה את החיבור הסופי. |
חזרה
Line
– הקו.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
מגדיר את גובה הרכיב בנקודות, שהוא גובה התיבה התוחמת של הרכיב כאשר אין סיבוב.
השיטה הזו לא תואמת לכל רכיבי הדף. כדי לדעת אילו רכיבי דף לא שתואמים לשיטה הזו, קראו את מגבלות על קביעת גודל ומיקום.
פרמטרים
שם | סוג | תיאור |
---|---|---|
height | Number | הגובה החדש של רכיב הדף הזה שיש להגדיר, בנקודות. |
חזרה
Line
– רכיב הדף הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
מגדיר את המיקום האופקי של הרכיב בנקודות, שנמדד מהפינה השמאלית העליונה של כאשר לרכיב אין סיבוב.
פרמטרים
שם | סוג | תיאור |
---|---|---|
left | Number | המיקום האופקי החדש להגדרה, בנקודות. |
חזרה
Line
– רכיב הדף הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLineCategory(lineCategory)
מגדיר את LineCategory
של השורה.
אפשר להגדיר את הקטגוריה רק ב-connectors
. המחבר יכול להיות
נותב מחדש אחרי שינוי הקטגוריה שלו.
פרמטרים
שם | סוג | תיאור |
---|---|---|
lineCategory | LineCategory | קטגוריית השורות שיש להגדיר. |
חזרה
Line
– הקו.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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 | הזווית החדשה להגדרת הסיבוב בכיוון השעון, במעלות. |
חזרה
Line
– רכיב הדף הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStart(left, top)
מגדיר את המיקום של נקודת ההתחלה של הקו.
יכול להיות שנתיב הקו ישתנה אחרי שהמיקום ישתנה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
left | Number | המיקום האופקי של נקודת ההתחלה של הקו, שנמדד בנקודות בפינה הימנית העליונה של הדף. |
top | Number | המיקום האנכי של נקודת ההתחלה של הקו, שנמדד בנקודות בפינה הימנית העליונה של הדף. |
חזרה
Line
– הקו הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStart(point)
מגדיר את המיקום של נקודת ההתחלה של הקו.
יכול להיות שנתיב הקו ישתנה אחרי שהמיקום ישתנה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
point | Point | נקודת ההתחלה של הקו, שהמיקום שלו נמדד מהפינה השמאלית העליונה של הדף. |
חזרה
Line
– הקו הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStartArrow(style)
מגדיר את ArrowStyle
של החץ בתחילת השורה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
style | ArrowStyle | סגנון החץ החדש שיש להגדיר. |
חזרה
Line
– הקו הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStartConnection(connectionSite)
מגדיר את החיבור בתחילת השורה. היא מעבירה את תחילת השורה אתר החיבור שצוין, תוך שמירה על הקצה השני ללא שינוי.
פרמטרים
שם | סוג | תיאור |
---|---|---|
connectionSite | ConnectionSite | אתר החיבור שאליו מתעדכן החיבור ההתחלתי, או null
אם מסירים את החיבור ההתחלתי. |
חזרה
Line
– הקו.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
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 | המחרוזת שתשמש את הכותרת של הטקסט החלופי. |
חזרה
Line
– רכיב הדף הזה.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
מגדיר את המיקום האנכי של הרכיב בנקודות, שנמדד מהפינה השמאלית העליונה של הדף כאשר לרכיב אין סיבוב.
פרמטרים
שם | סוג | תיאור |
---|---|---|
top | Number | המיקום האנכי החדש להגדרה, בנקודות. |
חזרה
Line
– רכיב הדף הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTransform(transform)
מגדיר את הטרנספורמציה של רכיב הדף עם הטרנספורמציה שסופקה.
עדכון הטרנספורמציה של קבוצה משנה את השינוי המוחלט של רכיבי הדף של הקבוצה, שיכול לשנות את המראה החזותי שלהם.
עדכון הטרנספורמציה של רכיב דף שנמצא בקבוצה משנה רק את הטרנספורמציה של רכיב הדף הזה; הוא לא משפיע על השינויים בקבוצה או ברכיבי דף אחרים קבוצה.
כדי ללמוד איך טרנספורמציות משפיעות על המראה החזותי של רכיבי דף, ראו getTransform()
.
פרמטרים
שם | סוג | תיאור |
---|---|---|
transform | AffineTransform | הטרנספורמציה שהוגדרה לרכיב הדף הזה. |
חזרה
Line
– הרכיב הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWeight(points)
מגדיר את עובי הקו בנקודות.
פרמטרים
שם | סוג | תיאור |
---|---|---|
points | Number | העובי החדש של הקו בנקודות. |
חזרה
Line
– הקו הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
מגדיר את רוחב הרכיב בנקודות, שהוא רוחב התיבה התוחמת של הרכיב כאשר אין סיבוב.
השיטה הזו לא תואמת לכל רכיבי הדף. כדי לדעת אילו רכיבי דף לא שתואמים לשיטה הזו, קראו את מגבלות על קביעת גודל ומיקום.
פרמטרים
שם | סוג | תיאור |
---|---|---|
width | Number | הרוחב החדש של רכיב הדף הזה שיש להגדיר, בנקודות. |
חזרה
Line
– רכיב הדף הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations