Class Line

Line

‫PageElement שמייצג קו.

Methods

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

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

פרמטרים

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

מחזירה את רשימת ה-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

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

פרמטרים

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

חזרה

‫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

הסרה של 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)

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

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

פרמטרים

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

חזרה

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

אישור

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

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

scaleWidth(ratio)

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

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

פרמטרים

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

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

אישור

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

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

select(replace)

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

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

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

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

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

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

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

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

פרמטרים

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

פרמטרים

שםסוגתיאור
slideIndexIntegerהאינדקס של השקף, כשהספירה מתחילה מ-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]);

פרמטרים

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

פרמטרים

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