Class Line

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)

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

פרמטרים

שםסוגתיאור
alignmentPositionAlignmentPositionהמיקום שאליו יש ליישר את רכיב הדף בדף.

חזרה

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

הפונקציה מחזירה את הערך 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).

פרמטרים

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

חזרה

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

אישור

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

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

remove()

הסרת רכיב הדף.

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

אם מסירים placeholder PageElement ממאסטר או מפריסה, אם מסירים את ה-placeholder ריק המערכת מסירה גם את ה-placeholders.

אישור

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

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

הסרה של Link. 

shape.removeLink();

reroute()

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

חזרה

Line – הקו.

אישור

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

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

scaleHeight(ratio)

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

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

פרמטרים

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

חזרה

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

אישור

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

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

scaleWidth(ratio)

שינוי רוחב הרכיב לפי היחס שצוין. רוחב הרכיב הוא הרוחב של הרכיב תיבה תוחמת (bounding box) כשלרכיב אין סיבוב.

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

פרמטרים

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

חזרה

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

אישור

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

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

select()

בוחר רק את ה-PageElement במצגת הפעילה ומסיר את כל התשובות הקודמות בחירה. המספר הזה זהה להתקשרות אל select(replace) באמצעות true.

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

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

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

אישור

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

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

select(replace)

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

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

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

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

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

  1. ההורה Page של האובייקט PageElement חייב להיות current page selection.
  2. אסור לבחור יותר מ-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);
}

פרמטרים

שםסוגתיאור
replaceBooleanאם הערך שלו הוא 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 של השורה.

פרמטרים

שםסוגתיאור
styleDashStyleסגנון המקף שיש להגדיר עבור הקו הזה.

חזרה

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

פרמטרים

שםסוגתיאור
descriptionStringהמחרוזת שאליה יש להגדיר את התיאור של הטקסט החלופי.

חזרה

Line – רכיב הדף הזה.

אישור

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

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

setEnd(left, top)

מגדיר את המיקום של נקודת הסיום של הקו.

יכול להיות שנתיב הקו ישתנה אחרי שהמיקום ישתנה.

פרמטרים

שםסוגתיאור
leftNumberהמיקום האופקי של נקודת הקצה של הקו, שנמדד בנקודות בפינה הימנית העליונה של הדף.
topNumberהמיקום האנכי של נקודת הקצה של הקו, שנמדד בנקודות בפינה הימנית העליונה של הדף.

חזרה

Line – הקו הזה, לשרשור.

אישור

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

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

setEnd(point)

מגדיר את המיקום של נקודת הסיום של הקו.

יכול להיות שנתיב הקו ישתנה אחרי שהמיקום ישתנה.

פרמטרים

שםסוגתיאור
pointPointנקודת הקצה של הקו, שהמיקום שלו נמדד מהפינה השמאלית העליונה של הדף.

חזרה

Line – הקו הזה, לשרשור.

אישור

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

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

setEndArrow(style)

מגדיר את ArrowStyle של החץ בסוף השורה.

פרמטרים

שםסוגתיאור
styleArrowStyleהסגנון שצריך להגדיר.

חזרה

Line – הקו הזה, לשרשור.

אישור

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

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

setEndConnection(connectionSite)

מגדיר את החיבור בסוף השורה. מעביר את קצה הקו לערך שצוין בזמן שהצד השני נשאר ללא שינוי.

פרמטרים

שםסוגתיאור
connectionSiteConnectionSiteאתר החיבור שבו מתעדכן החיבור הסופי, או null אם מסירה את החיבור הסופי.

חזרה

Line – הקו.

אישור

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

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

setHeight(height)

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

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

פרמטרים

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

חזרה

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

אישור

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

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

setLeft(left)

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

פרמטרים

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

חזרה

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

אישור

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

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

setLineCategory(lineCategory)

מגדיר את LineCategory של השורה.

אפשר להגדיר את הקטגוריה רק ב-connectors. המחבר יכול להיות נותב מחדש אחרי שינוי הקטגוריה שלו.

פרמטרים

שםסוגתיאור
lineCategoryLineCategoryקטגוריית השורות שיש להגדיר.

חזרה

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

פרמטרים

שםסוגתיאור
slideIndexIntegerהאינדקס מבוסס אפס לשקף.

חזרה

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

פרמטרים

שםסוגתיאור
slideSlideSlide לקישור.

חזרה

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

פרמטרים

שםסוגתיאור
slidePositionSlidePositionהערך היחסי של 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");

פרמטרים

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

חזרה

Link – ה-Link שהוגדר

אישור

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

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

setRotation(angle)

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

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

פרמטרים

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

חזרה

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

אישור

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

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

setStart(left, top)

מגדיר את המיקום של נקודת ההתחלה של הקו.

יכול להיות שנתיב הקו ישתנה אחרי שהמיקום ישתנה.

פרמטרים

שםסוגתיאור
leftNumberהמיקום האופקי של נקודת ההתחלה של הקו, שנמדד בנקודות בפינה הימנית העליונה של הדף.
topNumberהמיקום האנכי של נקודת ההתחלה של הקו, שנמדד בנקודות בפינה הימנית העליונה של הדף.

חזרה

Line – הקו הזה, לשרשור.

אישור

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

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

setStart(point)

מגדיר את המיקום של נקודת ההתחלה של הקו.

יכול להיות שנתיב הקו ישתנה אחרי שהמיקום ישתנה.

פרמטרים

שםסוגתיאור
pointPointנקודת ההתחלה של הקו, שהמיקום שלו נמדד מהפינה השמאלית העליונה של הדף.

חזרה

Line – הקו הזה, לשרשור.

אישור

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

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

setStartArrow(style)

מגדיר את ArrowStyle של החץ בתחילת השורה.

פרמטרים

שםסוגתיאור
styleArrowStyleסגנון החץ החדש שיש להגדיר.

חזרה

Line – הקו הזה, לשרשור.

אישור

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

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

setStartConnection(connectionSite)

מגדיר את החיבור בתחילת השורה. היא מעבירה את תחילת השורה אתר החיבור שצוין, תוך שמירה על הקצה השני ללא שינוי.

פרמטרים

שםסוגתיאור
connectionSiteConnectionSiteאתר החיבור שאליו מתעדכן החיבור ההתחלתי, או 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());

פרמטרים

שםסוגתיאור
titleStringהמחרוזת שתשמש את הכותרת של הטקסט החלופי.

חזרה

Line – רכיב הדף הזה.

אישור

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

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

setTop(top)

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

פרמטרים

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

חזרה

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

אישור

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

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

setTransform(transform)

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

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

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

כדי ללמוד איך טרנספורמציות משפיעות על המראה החזותי של רכיבי דף, ראו getTransform().

פרמטרים

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

חזרה

Line – הרכיב הזה, לשרשור.

אישור

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

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

setWeight(points)

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

פרמטרים

שםסוגתיאור
pointsNumberהעובי החדש של הקו בנקודות.

חזרה

Line – הקו הזה, לשרשור.

אישור

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

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

setWidth(width)

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

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

פרמטרים

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

חזרה

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

אישור

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

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