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

Class Line

(קו)

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

החזרות

Link

אישור

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

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

`getObjectId()`

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

החזרות

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

אישור

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

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

`getPageElementType()`

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

החזרות

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

אישור

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

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

`getParentGroup()`

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

החזרות

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

אישור

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

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

`getParentPage()`

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

החזרות

Page – הדף שבו נמצא הרכיב הזה.

אישור

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

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

`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 ממאסטר או מהפריסה, מסירים גם את כל ה-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)`

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

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

פרמטרים

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

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

אישור

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

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

`select(replace)`

בחירה ב-PageElement במצגת הפעילה.

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

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

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

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

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

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

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

פרמטרים

שם	סוג	תיאור
`replace`	`Boolean`	אם הערך שלו הוא `true`, הבחירה תחליף את הבחירה הקודמת. אחרת, הבחירה תתווסף לכל בחירה קודמת.

אישור

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

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

`sendBackward()`

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

רכיב הדף לא יכול להיות בקבוצה.

החזרות

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`	האינדקס מבוסס אפס לשקף.

החזרות

Link – ה-Link שהוגדר

אישור

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

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

`setLinkSlide(slide)`

מגדיר Link ל-Slide הנתון, הקישור מוגדר על ידי מזהה השקף הנתון.

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

פרמטרים

שם	סוג	תיאור
`slide`	`Slide`	`Slide` לקישור.

החזרות

Link – ה-Link שהוגדר

אישור

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

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

`setLinkSlide(slidePosition)`

הפונקציה מגדירה Link ל-Slide הנתון באמצעות המיקום היחסי של השקף.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

פרמטרים

שם	סוג	תיאור
`slidePosition`	`SlidePosition`	הערך היחסי של `SlidePosition`.

החזרות

Link – ה-Link שהוגדר

אישור

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

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

`setLinkUrl(url)`

מגדירה Link למחרוזת כתובת ה-URL הנתונה, שאינה ריקה.

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

פרמטרים

שם	סוג	תיאור
`url`	`String`	המחרוזת של כתובת ה-URL.

החזרות

Link – ה-Link שהוגדר

אישור

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

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

`setRotation(angle)`

מגדיר את זווית הסיבוב של הרכיב בכיוון השעון סביב מרכזו במעלות.

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

פרמטרים

שם	סוג	תיאור
`angle`	`Number`	הזווית החדשה להגדרת הסיבוב בכיוון השעון, במעלות.

החזרות

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