Class Line

Line

PageElement שמייצג קו.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
alignOnPage(alignmentPosition)	Line	הרכיב מיושר למיקום היישור שצוין בדף.
bringForward()	Line	העברת רכיב הדף קדימה בדף ברכיב אחד.
bringToFront()	Line	העברת רכיב הדף לחזית הדף.
duplicate()	PageElement	שכפול של רכיב הדף.
getConnectionSites()	ConnectionSite[]	הפונקציה מחזירה את רשימת ה-ConnectionSites ברכיב הדף, או רשימה ריקה אם לרכיב הדף אין אתרי חיבור.
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	הגדרת עובי הקו בפונקציה point.
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()

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

חזרה

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 אם אין קישור.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

חזרה

Link – הערך של Link או null אם אין קישור.

אישור

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

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

---

getObjectId()

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

חזרה

String – המזהה הייחודי של האובייקט הזה.

אישור

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

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

---

getPageElementType()

הפונקציה מחזירה את הסוג של רכיב הדף, שמיוצג כ-enum מסוג PageElementType.

חזרה

PageElementType – הסוג של רכיב הדף.

אישור

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

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

---

getParentGroup()

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

חזרה

Group – הקבוצה שאליה שייך רכיב הדף הזה, או null.

אישור

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

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

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

חזרה

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 נקודות שמאלה:

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
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 ב-master או בפריסה, כל ה-placeholders הריקים שעברו בירושה יוסרו גם כן.

אישור

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

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

---

removeLink()

הסרה של Link.

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

---

reroute()

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

חזרה

Line — הקו.

אישור

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

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

---

scaleHeight(ratio)

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

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

פרמטרים

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

חזרה

Line – רכיב הדף הזה, לצורך קישור.

אישור

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

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

---

scaleWidth(ratio)

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

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

פרמטרים

שם	סוג	תיאור
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.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

אישור

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

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

---

select(replace)

בוחרים את PageElement במצגת הפעילה.

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

מעבירים את הערך true לשיטה הזו כדי לבחור רק את PageElement ולהסיר כל בחירה קודמת. הפעולה הזו גם מגדירה את ההורה Page של ה-PageElement בתור ה-current page selection.

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

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

1. ההורה Page של האובייקט PageElement חייב להיות current page selection.
2. אסור לבחור כמה אובייקטים מסוג Page.

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

פרמטרים

שם	סוג	תיאור
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".
const 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.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = 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.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

פרמטרים

שם	סוג	תיאור
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.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.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.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = 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	זווית הסיבוב החדשה בכיוון השעון להגדרה, במעלות.

חזרה

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".
const 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)

הגדרת עובי הקו בפונקציה point.

פרמטרים

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