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

Class Line

‫PageElement שמייצג קו.

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
`alignOnPage(alignmentPosition)`	`Line`	מיישר את האלמנט למיקום היישור שצוין בדף.
`bringForward()`	`Line`	העברת רכיב הדף קדימה בדף ברמה אחת.
`bringToFront()`	`Line`	העברת רכיב הדף לחזית הדף.
`duplicate()`	`PageElement`	משכפל את רכיב הדף.
`getConnectionSites()`	`ConnectionSite[]`	מחזירה את רשימת ה-`ConnectionSite`s ברכיב הדף, או רשימה ריקה אם לרכיב הדף אין אתרי חיבור.
`getDashStyle()`	`DashStyle`	הפונקציה מחזירה את `DashStyle` של השורה.
`getDescription()`	`String`	הפונקציה מחזירה את תיאור הטקסט החלופי של רכיב הדף.
`getEnd()`	`Point`	הפונקציה מחזירה את נקודת הסיום של הקו, שנמדדת מהפינה הימנית העליונה של הדף.
`getEndArrow()`	`ArrowStyle`	הפונקציה מחזירה את `ArrowStyle` של החץ בסוף הקו.
`getEndConnection()`	`ConnectionSite\|null`	הפונקציה מחזירה את החיבור בסוף הקו, או `null` אם אין חיבור.
`getHeight()`	`Number\|null`	מחזירה את גובה הרכיב בנקודות, שהוא הגובה של תיבת התוחמת של הרכיב אם הרכיב לא מסובב.
`getInherentHeight()`	`Number\|null`	הפונקציה מחזירה את הגובה המובנה של הרכיב בנקודות.
`getInherentWidth()`	`Number\|null`	הפונקציה מחזירה את הרוחב המובנה של הרכיב בנקודות.
`getLeft()`	`Number`	הפונקציה מחזירה את המיקום האופקי של האלמנט בנקודות, שנמדד מהפינה הימנית העליונה של הדף כשהאלמנט לא מסובב.
`getLineCategory()`	`LineCategory`	הפונקציה מחזירה את `LineCategory` של השורה.
`getLineFill()`	`LineFill`	הפונקציה מחזירה את `LineFill` של השורה.
`getLineType()`	`LineType`	הפונקציה מחזירה את `LineType` של השורה.
`getLink()`	`Link\|null`	הפונקציה מחזירה את הערך `Link` או `null` אם אין קישור.
`getObjectId()`	`String`	הפונקציה מחזירה את המזהה הייחודי של האובייקט.
`getPageElementType()`	`PageElementType`	הפונקציה מחזירה את סוג רכיב הדף, שמיוצג כסוג enum‏ `PageElementType`.
`getParentGroup()`	`Group\|null`	הפונקציה מחזירה את הקבוצה שאליה שייך הרכיב הזה בדף, או `null` אם הרכיב לא נמצא בקבוצה.
`getParentPage()`	`Page`	מחזירה את הדף שרכיב הדף הזה נמצא בו.
`getRotation()`	`Number`	מחזירה את זווית הסיבוב של הרכיב בכיוון השעון סביב המרכז שלו במעלות, כאשר אפס מעלות פירושו שאין סיבוב.
`getStart()`	`Point`	הפונקציה מחזירה את נקודת ההתחלה של השורה, שנמדדת מהפינה הימנית העליונה של הדף.
`getStartArrow()`	`ArrowStyle`	הפונקציה מחזירה את `ArrowStyle` של החץ בתחילת השורה.
`getStartConnection()`	`ConnectionSite\|null`	הפונקציה מחזירה את החיבור בתחילת הקו, או `null` אם אין חיבור.
`getTitle()`	`String`	הפונקציה מחזירה את הכותרת של הטקסט החלופי של רכיב הדף.
`getTop()`	`Number`	מחזירה את המיקום האנכי של האלמנט בנקודות, שנמדד מהפינה השמאלית העליונה של הדף כשהאלמנט לא מסובב.
`getTransform()`	`AffineTransform`	מחזירה את הטרנספורמציה של רכיב הדף.
`getWeight()`	`Number`	הפונקציה מחזירה את עובי הקו בנקודות.
`getWidth()`	`Number\|null`	הפונקציה מחזירה את רוחב הרכיב בנקודות, שהוא הרוחב של התיבה התוחמת של הרכיב כשהרכיב לא מסובב.
`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()`

מחזירה את רשימת ה-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|null – החיבור בסוף השורה.

אישור

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

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

`getHeight()`

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

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

חזרה

‫Number|null – הגובה המובנה של רכיב הדף בנקודות, או null אם לרכיב הדף אין גובה.

אישור

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

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

`getInherentHeight()`

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

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

חזרה

‫Number|null – הגובה המובנה של רכיב הדף בנקודות, או null אם לרכיב הדף אין גובה.

אישור

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

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

`getInherentWidth()`

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

חזרה

‫Number|null – הרוחב המובנה של רכיב הדף בנקודות, או 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|null – הערך 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 – הקבוצה שאליה שייך רכיב הדף הזה, או 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|null — החיבור בתחילת השורה.

אישור

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

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 – הרוחב המובנה של רכיב הדף בנקודות, או 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 מתבנית ראשית או מפריסת שקפים, יוסרו גם placeholder-ים ריקים שמועברים בירושה.

אישור

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

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.

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

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

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:

תג ההורה Page של האובייקט PageElement חייב להיות current page selection.
לא יכולים להיות כמה אובייקטים מסוג 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`	האינדקס של השקף, כשהספירה מתחילה מ-0.

חזרה

‫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)`

מגדיר את עובי הקו בנקודות.

פרמטרים

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

Class Line קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

Methods

תיעוד מפורט

alignOnPage(alignmentPosition)

פרמטרים

חזרה

bringForward()

חזרה

אישור

bringToFront()

חזרה

אישור

duplicate()

חזרה

אישור

getConnectionSites()

חזרה

אישור

getDashStyle()

חזרה

אישור

getDescription()

חזרה

אישור

getEnd()

חזרה

אישור

getEndArrow()

חזרה

אישור

getEndConnection()

חזרה

אישור

getHeight()

חזרה

אישור

getInherentHeight()

חזרה

אישור

getInherentWidth()

חזרה

אישור

getLeft()

חזרה

אישור

getLineCategory()

חזרה

אישור

getLineFill()

חזרה

אישור

getLineType()

חזרה

אישור

getLink()

חזרה

אישור

getObjectId()

חזרה

אישור

getPageElementType()

חזרה

אישור

getParentGroup()

חזרה

אישור

getParentPage()

חזרה

אישור

getRotation()

חזרה

אישור

getStart()

חזרה

אישור

getStartArrow()

חזרה

אישור

getStartConnection()

חזרה

Class Line

`alignOnPage(alignmentPosition)`

`bringForward()`

`bringToFront()`

`duplicate()`

`getConnectionSites()`

`getDashStyle()`

`getDescription()`

`getEnd()`

`getEndArrow()`

`getEndConnection()`

`getHeight()`

`getInherentHeight()`

`getInherentWidth()`

`getLeft()`

`getLineCategory()`

`getLineFill()`

`getLineType()`

`getLink()`

`getObjectId()`

`getPageElementType()`

`getParentGroup()`

`getParentPage()`

`getRotation()`

`getStart()`

`getStartArrow()`

`getStartConnection()`

`getTitle()`

`getTop()`

`getTransform()`

`getWeight()`

`getWidth()`

`isConnector()`

`preconcatenateTransform(transform)`

`remove()`

`removeLink()`

`reroute()`

`scaleHeight(ratio)`

`scaleWidth(ratio)`

`select()`

`select(replace)`

`sendBackward()`

`sendToBack()`

`setDashStyle(style)`

`setDescription(description)`

`setEnd(left, top)`

`setEnd(point)`

`setEndArrow(style)`

`setEndConnection(connectionSite)`