PageElement
שמייצג קו.
Methods
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
alignOnPage(alignmentPosition) | Line | הרכיב מיושר למיקום היישור שצוין בדף. |
bringForward() | Line | העברת רכיב הדף קדימה בדף ברכיב אחד. |
bringToFront() | Line | העברת רכיב הדף לחזית הדף. |
duplicate() | PageElement | שכפול של רכיב הדף. |
getConnectionSites() | ConnectionSite[] | הפונקציה מחזירה את רשימת ה-ConnectionSite s ברכיב הדף, או רשימה ריקה אם לרכיב הדף אין אתרי חיבור. |
getDashStyle() | DashStyle | הפונקציה מקבלת את DashStyle של השורה. |
getDescription() | String | הפונקציה מחזירה את תיאור הטקסט החלופי של רכיב הדף. |
getEnd() | Point | הפונקציה מחזירה את נקודת הסיום של הקו, שנמדדת מהפינה הימנית העליונה של הדף. |
getEndArrow() | ArrowStyle | הפונקציה מקבלת את הערך של ArrowStyle של החץ בסוף השורה. |
getEndConnection() | ConnectionSite | הפונקציה מחזירה את החיבור בסוף השורה, או את הערך null אם אין חיבור. |
getHeight() | Number | הפונקציה מקבלת את הגובה של האלמנט בנקודות, שהוא הגובה של תיבת הגבול של האלמנט כשאין לו סיבוב. |
getInherentHeight() | Number | הפונקציה מחזירה את הגובה המובנה של הרכיב בנקודות. |
getInherentWidth() | Number | הפונקציה מחזירה את רוחב הרכיב המובנה בפיקסלים. |
getLeft() | Number | הפונקציה מחזירה את המיקום האופקי של האלמנט בנקודות, שנמדד מהפינה הימנית העליונה של הדף כשאין לאלמנט סיבוב. |
getLineCategory() | LineCategory | הפונקציה מקבלת את LineCategory של השורה. |
getLineFill() | LineFill | הפונקציה מקבלת את LineFill של השורה. |
getLineType() | LineType | הפונקציה מקבלת את LineType של השורה. |
getLink() | Link | הפונקציה מחזירה את הערך Link או null אם אין קישור. |
getObjectId() | String | הפונקציה מחזירה את המזהה הייחודי של האובייקט הזה. |
getPageElementType() | PageElementType | הפונקציה מחזירה את הסוג של רכיב הדף, שמיוצג כ-enum מסוג PageElementType . |
getParentGroup() | Group | הפונקציה מחזירה את הקבוצה שאליה שייך רכיב הדף, או את הערך null אם הרכיב לא נמצא בקבוצה. |
getParentPage() | Page | הפונקציה מחזירה את הדף שבו נמצא רכיב הדף הזה. |
getRotation() | Number | הפונקציה מחזירה את זווית הסיבוב של הרכיב בכיוון השעון סביב מרכזו במעלות, כאשר אפס מעלות מציין שאין סיבוב. |
getStart() | Point | הפונקציה מחזירה את נקודת ההתחלה של השורה, שנמדדת מהפינה הימנית העליונה של הדף. |
getStartArrow() | ArrowStyle | הפונקציה מקבלת את הערך של ArrowStyle של החץ בתחילת השורה. |
getStartConnection() | ConnectionSite | הפונקציה מחזירה את החיבור בתחילת השורה, או את הערך null אם אין חיבור. |
getTitle() | String | הפונקציה מחזירה את שם הטקסט החלופי של רכיב הדף. |
getTop() | Number | הפונקציה מקבלת את המיקום האנכי של הרכיב בנקודות, שנמדד מהפינה השמאלית העליונה של הדף כשאין רוטציה לרכיב. |
getTransform() | AffineTransform | הפונקציה מחזירה את הטרנספורמציה של רכיב הדף. |
getWeight() | Number | הפונקציה מחזירה את עובי הקו בפונקציה. |
getWidth() | Number | הפונקציה מחזירה את רוחב הרכיב בנקודות, שהוא רוחב תיבת הגבול של הרכיב כשהרכיב לא מסובב. |
isConnector() | Boolean | הפונקציה מחזירה את הערך true אם הקו הוא מחבר, או את הערך false אם לא. |
preconcatenateTransform(transform) | Line | שרשור מראש של הטרנספורמציה שסופקה לטרנספורמציה הקיימת של רכיב הדף. |
remove() | void | הסרת רכיב הדף. |
removeLink() | void | הסרה של Link . |
reroute() | Line | המערכת מנתבת מחדש את נקודות ההתחלה והסיום של הקו לשני מיקומי החיבור הקרובים ביותר ברכיבי הדף המקושרים. |
scaleHeight(ratio) | Line | שינוי הגודל של גובה הרכיב לפי היחס שצוין. |
scaleWidth(ratio) | Line | שינוי הגודל של רוחב הרכיב לפי היחס שצוין. |
select() | void | המערכת בוחרת רק את PageElement במצגת הפעילה ומבטלת את הבחירה הקודמת. |
select(replace) | void | בוחרים את PageElement במצגת הפעילה. |
sendBackward() | Line | העברת רכיב הדף לאחור בדף ברכיב אחד. |
sendToBack() | Line | שליחת רכיב הדף לחלק האחורי של הדף. |
setDashStyle(style) | Line | הגדרת DashStyle של הקו. |
setDescription(description) | Line | הגדרת תיאור הטקסט החלופי של רכיב הדף. |
setEnd(left, top) | Line | הגדרת המיקום של נקודת הסיום של הקו. |
setEnd(point) | Line | הגדרת המיקום של נקודת הסיום של הקו. |
setEndArrow(style) | Line | הגדרת ArrowStyle של החץ בסוף השורה. |
setEndConnection(connectionSite) | Line | מגדיר את החיבור בסוף השורה. |
setHeight(height) | Line | הגדרת הגובה של האלמנט בנקודות. הגובה הזה הוא הגובה של תיבת הגבול של האלמנט כשהאלמנט לא מסתובב. |
setLeft(left) | Line | הגדרת המיקום האופקי של הרכיב בנקודות, שנמדדות מהפינה הימנית העליונה של הדף כשאין רכיב סיבוב. |
setLineCategory(lineCategory) | Line | הגדרת LineCategory של הקו. |
setLinkSlide(slideIndex) | Link | הגדרת Link ל-Slide הנתון באמצעות האינדקס שמתחיל בספרה אפס של השקף. |
setLinkSlide(slide) | Link | הגדרת Link ל-Slide הנתון. הקישור מוגדר לפי מזהה השקף הנתון. |
setLinkSlide(slidePosition) | Link | הגדרת Link ל-Slide הנתון באמצעות המיקום היחסי של השקף. |
setLinkUrl(url) | Link | הפונקציה מגדירה את Link למחרוזת כתובת ה-URL שצוינה, שהיא לא ריקה. |
setRotation(angle) | Line | הגדרת זווית הסיבוב של הרכיב בכיוון השעון סביב מרכזו, במעלות. |
setStart(left, top) | Line | הגדרת המיקום של נקודת ההתחלה של הקו. |
setStart(point) | Line | הגדרת המיקום של נקודת ההתחלה של הקו. |
setStartArrow(style) | Line | הגדרת ArrowStyle של החץ בתחילת השורה. |
setStartConnection(connectionSite) | Line | הגדרת החיבור בתחילת השורה. |
setTitle(title) | Line | הגדרת כותרת הטקסט החלופי של רכיב הדף. |
setTop(top) | Line | הגדרת המיקום האנכי של האלמנט בנקודות, שנמדדות מהפינה הימנית העליונה של הדף כשאין לאלמנט רוטציה. |
setTransform(transform) | Line | הגדרת הטרנספורמציה של רכיב הדף באמצעות הטרנספורמציה שצוינה. |
setWeight(points) | Line | הגדרת עובי הקו בפונקציה point. |
setWidth(width) | Line | הגדרת רוחב הרכיב בפונטים. זהו רוחב תיבת הגבול של הרכיב כשהרכיב לא מסובב. |
מסמכים מפורטים
alignOnPage(alignmentPosition)
הרכיב מיושר למיקום היישור שצוין בדף.
פרמטרים
שם | סוג | תיאור |
---|---|---|
alignmentPosition | AlignmentPosition | המיקום שאליו יש ליישר את רכיב הדף הזה בדף. |
חזרה
Line
– רכיב הדף הזה, לצורך קישור.
bringForward()
העברת רכיב הדף קדימה בדף ברכיב אחד.
אסור שמרכיב הדף יהיה בקבוצה.
חזרה
Line
– רכיב הדף הזה, לצורך קישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringToFront()
העברת רכיב הדף לחזית הדף.
אסור שמרכיב הדף יהיה בקבוצה.
חזרה
Line
– רכיב הדף הזה, לצורך קישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
duplicate()
שכפול של רכיב הדף.
רכיב הדף הכפול ממוקם באותו דף ובאותו מיקום כמו המקור.
חזרה
PageElement
– העותק הכפול החדש של רכיב הדף הזה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getConnectionSites()
הפונקציה מחזירה את רשימת ה-ConnectionSite
s ברכיב הדף, או רשימה ריקה אם לרכיב הדף אין אתרי חיבור.
חזרה
ConnectionSite[]
– רשימת אתרי החיבורים. הרשימה עשויה להיות ריקה אם לאתר הזה אין אתרי חיבורים.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDashStyle()
הפונקציה מקבלת את DashStyle
של השורה.
חזרה
DashStyle
— הסגנון של הקווים המקבילים שמופיעים בקו הזה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDescription()
הפונקציה מחזירה את תיאור הטקסט החלופי של רכיב הדף. התיאור משולב עם הכותרת כדי להציג ולקרוא טקסט חלופי.
חזרה
String
— תיאור הטקסט החלופי של רכיב הדף.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getEnd()
הפונקציה מחזירה את נקודת הסיום של הקו, שנמדדת מהפינה הימנית העליונה של הדף.
חזרה
Point
— נקודת הסיום של הקו.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getEndArrow()
הפונקציה מקבלת את הערך של ArrowStyle
של החץ בסוף השורה.
חזרה
ArrowStyle
— הסגנון של החץ בסוף השורה הזו.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getEndConnection()
הפונקציה מחזירה את החיבור בסוף השורה, או את הערך null
אם אין חיבור.
חזרה
ConnectionSite
– החיבור בסוף השורה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getHeight()
הפונקציה מקבלת את הגובה של האלמנט בנקודות, שהוא הגובה של תיבת הגבול של האלמנט כשאין לו סיבוב.
השיטה הזו לא תואמת לכל רכיבי הדף. כדי לבדוק אילו אלמנטים בדף לא תואמים לשיטה הזו, אפשר לעיין ב מגבלות לגבי הגודל והמיקום.
חזרה
Number
– הגובה הטבעי של אלמנט הדף בנקודות, או null
אם לאלמנט הדף אין גובה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentHeight()
הפונקציה מחזירה את הגובה המובנה של הרכיב בנקודות.
הטרנספורמציה של רכיב הדף היא ביחס לגודל המובנה שלו. משתמשים בגודל המובנה בשילוב עם הטרנספורמציה של הרכיב כדי לקבוע את המראה החזותי הסופי של הרכיב.
חזרה
Number
– הגובה הטבעי של אלמנט הדף בנקודות, או null
אם לאלמנט הדף אין גובה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentWidth()
הפונקציה מחזירה את רוחב הרכיב המובנה בפיקסלים.
הטרנספורמציה של רכיב הדף היא ביחס לגודל המובנה שלו. משתמשים בגודל המובנה בשילוב עם הטרנספורמציה של הרכיב כדי לקבוע את המראה החזותי הסופי של הרכיב.
חזרה
Number
– רוחב המאפיין של הדף באופן מובנה, בנקודה, או null
אם למאפיין של הדף אין רוחב.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLeft()
הפונקציה מחזירה את המיקום האופקי של האלמנט בנקודות, שנמדד מהפינה הימנית העליונה של הדף כשאין לאלמנט סיבוב.
חזרה
Number
— המיקום האופקי של הרכיב הזה בנקודות, מהפינה הימנית העליונה של הדף.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLineCategory()
הפונקציה מקבלת את LineCategory
של השורה.
חזרה
LineCategory
– קטגוריית השורה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLineFill()
הפונקציה מקבלת את LineFill
של השורה.
חזרה
LineFill
— הגדרת המילוי של השורה הזו.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLineType()
הפונקציה מקבלת את LineType
של השורה.
חזרה
LineType
– הסוג של הקו.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLink()
הפונקציה מחזירה את הערך Link
או null
אם אין קישור.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; const link = shape.getLink(); if (link != null) { Logger.log(`Shape has a link of type: ${link.getLinkType()}`); }
חזרה
Link
– הערך של Link
או null
אם אין קישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getObjectId()
הפונקציה מחזירה את המזהה הייחודי של האובייקט הזה. מזהים של אובייקטים שמשמשים דפים ורכיבי דפים משותפים לאותו מרחב שמות.
חזרה
String
– המזהה הייחודי של האובייקט הזה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementType()
הפונקציה מחזירה את הסוג של רכיב הדף, שמיוצג כ-enum מסוג PageElementType
.
חזרה
PageElementType
– הסוג של רכיב הדף.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentGroup()
הפונקציה מחזירה את הקבוצה שאליה שייך רכיב הדף, או את הערך null
אם הרכיב לא נמצא בקבוצה.
חזרה
Group
– הקבוצה שאליה שייך רכיב הדף הזה, או null
.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentPage()
הפונקציה מחזירה את הדף שבו נמצא רכיב הדף הזה.
חזרה
Page
– הדף שבו נמצא הרכיב.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRotation()
הפונקציה מחזירה את זווית הסיבוב של הרכיב בכיוון השעון סביב מרכזו במעלות, כאשר אפס מעלות מציין שאין סיבוב.
חזרה
Number
– זווית הסיבוב במעלות, בין 0 (כולל) ל-360 (לא כולל).
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getStart()
הפונקציה מחזירה את נקודת ההתחלה של השורה, שנמדדת מהפינה הימנית העליונה של הדף.
חזרה
Point
— נקודת ההתחלה של השורה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getStartArrow()
הפונקציה מקבלת את הערך של ArrowStyle
של החץ בתחילת השורה.
חזרה
ArrowStyle
— הסגנון של החץ בתחילת השורה הזו.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getStartConnection()
הפונקציה מחזירה את החיבור בתחילת השורה, או את הערך null
אם אין חיבור.
חזרה
ConnectionSite
— החיבור בתחילת השורה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTitle()
הפונקציה מחזירה את שם הטקסט החלופי של רכיב הדף. הכותרת משולבת עם התיאור כדי להציג ולקרוא את טקסט ה-alt.
חזרה
String
– כותרת הטקסט החלופי של רכיב הדף.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTop()
הפונקציה מקבלת את המיקום האנכי של הרכיב בנקודות, שנמדד מהפינה השמאלית העליונה של הדף כשאין רוטציה לרכיב.
חזרה
Number
— המיקום האנכי של הרכיב הזה בנקודות, מהפינה הימנית העליונה של הדף.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTransform()
הפונקציה מחזירה את הטרנספורמציה של רכיב הדף.
המראה החזותי של רכיב הדף נקבע לפי הטרנספורמציה המוחלטת שלו. כדי לחשב את הטרנספורמציה המוחלטת, צריך לשרשר מראש את הטרנספורמציה של רכיב הדף עם הטרנספורמציות של כל הקבוצות ההורה שלו. אם רכיב הדף לא נמצא בקבוצה, הטרנספורמציה המוחלטת שלו זהה לערך בשדה הזה.
חזרה
AffineTransform
– הטרנספורמציה של רכיב הדף.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWeight()
הפונקציה מחזירה את עובי הקו בפונקציה.
חזרה
Number
— עובי הקו בנקודות.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWidth()
הפונקציה מחזירה את רוחב הרכיב בנקודות, שהוא רוחב תיבת הגבול של הרכיב כשאין לו סיבוב.
השיטה הזו לא תואמת לכל רכיבי הדף. כדי לבדוק אילו אלמנטים בדף לא תואמים לשיטה הזו, אפשר לעיין ב מגבלות לגבי הגודל והמיקום.
חזרה
Number
– רוחב המאפיין של הדף באופן מובנה, בנקודה, או null
אם למאפיין של הדף אין רוחב.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isConnector()
הפונקציה מחזירה את הערך true
אם הקו הוא מחבר, או את הערך false
אם לא.
מחבר הוא סוג של קו שמשמש לחיבור בין אתרים מחוברים ברכיבי דף רלוונטיים. אפשר לחבר כל קצה של המחבר למקום חיבור אחד לכל היותר.
חזרה
Boolean
— True
אם השורה היא מחבר, או false
אם לא.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
preconcatenateTransform(transform)
שרשור מראש של הטרנספורמציה שסופקה לטרנספורמציה הקיימת של רכיב הדף.
newTransform = argument * existingTransform;
לדוגמה, כדי להזיז רכיבים בדף 36 נקודות שמאלה:
const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; element.preconcatenateTransform( SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(), );
אפשר גם להחליף את הטרנספורמציה של רכיב הדף ב-setTransform(transform)
.
פרמטרים
שם | סוג | תיאור |
---|---|---|
transform | AffineTransform | הטרנספורמציה שצריך לבצע תחילה כדי לצרף לטרנספורמציה של רכיב הדף הזה. |
חזרה
Line
– רכיב הדף הזה, לצורך קישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
הסרת רכיב הדף.
אם אחרי פעולת הסרה, ה-Group
מכיל רק רכיב דף אחד או לא מכיל אף רכיב דף, הקבוצה עצמה תוסר גם כן.
אם מסירים placeholder PageElement
ב-master או בפריסה, כל ה-placeholders הריקים שעברו בירושה יוסרו גם כן.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeLink()
הסרה של Link
.
const slides = SlidesApp.getActivePresentation().getSlides(); slides[1].getShapes()[0].removeLink();
reroute()
המערכת מנתבת מחדש את נקודות ההתחלה והסיום של הקו לשני מיקומי החיבור הקרובים ביותר ברכיבי הדף המקושרים. ההתחלה והסיום של הקו חייבים להיות מחוברים לאלמנטי דף שונים.
חזרה
Line
— הקו.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleHeight(ratio)
שינוי הגודל של גובה הרכיב לפי היחס שצוין. הגובה של הרכיב הוא הגובה של תיבת הגבול שלו כשאין רכיב סיבוב.
השיטה הזו לא תואמת לכל רכיבי הדף. כדי לבדוק אילו אלמנטים בדף לא תואמים לשיטה הזו, אפשר לעיין ב מגבלות לגבי הגודל והמיקום.
פרמטרים
שם | סוג | תיאור |
---|---|---|
ratio | Number | היחס שבו יש לשנות את הגובה של רכיב הדף הזה. |
חזרה
Line
– רכיב הדף הזה, לצורך קישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
שינוי הגודל של רוחב הרכיב לפי היחס שצוין. רוחב הרכיב הוא רוחב תיבת הגבול שלו כשאין בו סיבוב.
השיטה הזו לא תואמת לכל רכיבי הדף. כדי לבדוק אילו אלמנטים בדף לא תואמים לשיטה הזו, אפשר לעיין ב מגבלות לגבי הגודל והמיקום.
פרמטרים
שם | סוג | תיאור |
---|---|---|
ratio | Number | היחס שבו רוחב הרכיב בדף ישתנה. |
חזרה
Line
– רכיב הדף הזה, לצורך קישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
המערכת בוחרת רק את PageElement
במצגת הפעילה ומבטלת את הבחירה הקודמת. זהו קריאה ל-select(replace)
עם true
.
סקריפט יכול לגשת רק לבחירה של המשתמש שמפעיל אותו, ורק אם הסקריפט קשור למצגת.
הפעולה הזו מגדירה את ההורה Page
של ה-PageElement
בתור ה-current page selection
.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = slide.getPageElements()[0]; // Only select this page element and replace any previous selection. pageElement.select();
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select(replace)
בוחרים את PageElement
במצגת הפעילה.
סקריפט יכול לגשת רק לבחירה של המשתמש שמפעיל אותו, ורק אם הסקריפט קשור למצגת.
מעבירים את הערך true
לשיטה הזו כדי לבחור רק את PageElement
ולהסיר כל בחירה קודמת. הפעולה הזו גם מגדירה את ההורה Page
של ה-PageElement
בתור ה-current page selection
.
מעבירים את false
כדי לבחור כמה אובייקטים מסוג PageElement
. אובייקטי PageElement
חייבים להיות באותו Page
.
כדי לבחור רכיב דף באמצעות הפרמטר false
, צריך לעמוד בתנאים הבאים:
- ההורה
Page
של האובייקטPageElement
חייב להיותcurrent page selection
. - אסור לבחור כמה אובייקטים מסוג
Page
.
כדי לוודא שזה המצב, הגישה המועדפת היא לבחור קודם את ההורה Page
באמצעות Page.selectAsCurrentPage()
ואז לבחור את רכיבי הדף בדף הזה.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // First select the slide page, as the current page selection. slide.selectAsCurrentPage(); // Then select all the page elements in the selected slide page. const pageElements = slide.getPageElements(); for (let i = 0; i < pageElements.length; i++) { pageElements[i].select(false); }
פרמטרים
שם | סוג | תיאור |
---|---|---|
replace | Boolean | אם הערך הוא true , הבחירה מחליפה כל בחירה קודמת. אחרת, הבחירה מתווספת לכל בחירה קודמת. |
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendBackward()
העברת רכיב הדף לאחור בדף ברכיב אחד.
אסור שמרכיב הדף יהיה בקבוצה.
חזרה
Line
– רכיב הדף הזה, לצורך קישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendToBack()
שליחת רכיב הדף לחלק האחורי של הדף.
אסור שמרכיב הדף יהיה בקבוצה.
חזרה
Line
– רכיב הדף הזה, לצורך קישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setDashStyle(style)
הגדרת DashStyle
של הקו.
פרמטרים
שם | סוג | תיאור |
---|---|---|
style | DashStyle | הסגנון של הקווים המקבילים להפרדה שרוצים להגדיר לקו הזה. |
חזרה
Line
— הקו הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setDescription(description)
הגדרת תיאור הטקסט החלופי של רכיב הדף.
אין תמיכה בשיטה עבור רכיבי Group
.
// Set the first page element's alt text description to "new alt text // description". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setDescription('new alt text description'); Logger.log(pageElement.getDescription());
פרמטרים
שם | סוג | תיאור |
---|---|---|
description | String | המחרוזת שבה רוצים להגדיר את תיאור הטקסט החלופי. |
חזרה
Line
– רכיב הדף הזה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEnd(left, top)
הגדרת המיקום של נקודת הסיום של הקו.
ייתכן שנתיב הקו ישתנה אחרי שמשנים את המיקום.
פרמטרים
שם | סוג | תיאור |
---|---|---|
left | Number | המיקום האופק של נקודת הסיום של הקו, שנמדד בנקודות מהפינה הימנית העליונה של הדף. |
top | Number | המיקום האנכי של נקודת הסיום של הקו, שנמדד בנקודות מהפינה הימנית העליונה של הדף. |
חזרה
Line
— הקו הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEnd(point)
הגדרת המיקום של נקודת הסיום של הקו.
ייתכן שנתיב הקו ישתנה אחרי שמשנים את המיקום.
פרמטרים
שם | סוג | תיאור |
---|---|---|
point | Point | נקודת הסיום של הקו, שהמיקום שלה נמדד מהפינה הימנית העליונה של הדף. |
חזרה
Line
— הקו הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEndArrow(style)
מגדיר את ArrowStyle
של החץ בסוף השורה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
style | ArrowStyle | הסגנון שרוצים להגדיר. |
חזרה
Line
— הקו הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEndConnection(connectionSite)
מגדיר את החיבור בסוף השורה. הוא מעביר את קצה השורה לאתר החיבור שצוין, תוך שמירה על הקצה השני.
פרמטרים
שם | סוג | תיאור |
---|---|---|
connectionSite | ConnectionSite | אתר החיבור שאליו מתבצע העדכון של החיבור הקצה, או null אם מסירים את החיבור הקצה. |
חזרה
Line
— הקו.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
הגדרת הגובה של האלמנט בנקודות. הגובה הזה הוא הגובה של תיבת הגבול של האלמנט כשהאלמנט לא מסתובב.
השיטה הזו לא תואמת לכל רכיבי הדף. כדי לבדוק אילו אלמנטים בדף לא תואמים לשיטה הזו, אפשר לעיין ב מגבלות לגבי הגודל והמיקום.
פרמטרים
שם | סוג | תיאור |
---|---|---|
height | Number | הגובה החדש של רכיב הדף הזה להגדרה, בנקודות. |
חזרה
Line
– רכיב הדף הזה, לצורך קישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
הגדרת המיקום האופקי של הרכיב בנקודות, שנמדדות מהפינה הימנית העליונה של הדף כשאין רכיב סיבוב.
פרמטרים
שם | סוג | תיאור |
---|---|---|
left | Number | המיקום האופקי החדש להגדרה, בנקודות. |
חזרה
Line
– רכיב הדף הזה, לצורך קישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLineCategory(lineCategory)
הגדרת LineCategory
של הקו.
אפשר להגדיר את הקטגוריה רק ב-connectors
. יכול להיות שהמסנן יועבר לנתיב אחר אחרי שינוי הקטגוריה שלו.
פרמטרים
שם | סוג | תיאור |
---|---|---|
lineCategory | LineCategory | קטגוריית השורה להגדרה. |
חזרה
Line
— הקו.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slideIndex)
הגדרת Link
ל-Slide
הנתון באמצעות האינדקס שמתחיל בספרה אפס של השקף.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(0);
פרמטרים
שם | סוג | תיאור |
---|---|---|
slideIndex | Integer | האינדקס של השקף, שמתחיל בספרה אפס. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slide)
הגדרת Link
ל-Slide
הנתון. הקישור מוגדר לפי מזהה השקף הנתון.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(slides[0]);
פרמטרים
שם | סוג | תיאור |
---|---|---|
slide | Slide | ה-Slide שרוצים לקשר. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slidePosition)
הגדרת Link
ל-Slide
הנתון באמצעות המיקום היחסי של השקף.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
פרמטרים
שם | סוג | תיאור |
---|---|---|
slidePosition | SlidePosition | הערך היחסי SlidePosition . |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkUrl(url)
הפונקציה מגדירה את Link
למחרוזת כתובת ה-URL הנתונה שאינה ריקה.
// Set a link to the URL. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkUrl('https://slides.google.com');
פרמטרים
שם | סוג | תיאור |
---|---|---|
url | String | מחרוזת כתובת ה-URL. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setRotation(angle)
הגדרת זווית הסיבוב של הרכיב בכיוון השעון סביב מרכזו, במעלות.
השיטה הזו לא תואמת לכל רכיבי הדף. כדי לבדוק אילו אלמנטים בדף לא תואמים לשיטה הזו, אפשר לעיין ב מגבלות לגבי הגודל והמיקום.
פרמטרים
שם | סוג | תיאור |
---|---|---|
angle | Number | זווית הסיבוב החדשה בכיוון השעון להגדרה, במעלות. |
חזרה
Line
– רכיב הדף הזה, לצורך קישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStart(left, top)
הגדרת המיקום של נקודת ההתחלה של הקו.
ייתכן שנתיב הקו ישתנה אחרי שמשנים את המיקום.
פרמטרים
שם | סוג | תיאור |
---|---|---|
left | Number | המיקום האופקית של נקודת ההתחלה של הקו, שנמדד בנקודות מהפינה הימנית העליונה של הדף. |
top | Number | המיקום האנכי של נקודת ההתחלה של הקו, שנמדד בנקודות מהפינה הימנית העליונה של הדף. |
חזרה
Line
— הקו הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStart(point)
הגדרת המיקום של נקודת ההתחלה של הקו.
ייתכן שנתיב הקו ישתנה אחרי שמשנים את המיקום.
פרמטרים
שם | סוג | תיאור |
---|---|---|
point | Point | נקודת ההתחלה של הקו, שהמיקום שלה נמדד מהפינה הימנית העליונה של הדף. |
חזרה
Line
— הקו הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStartArrow(style)
הגדרת ArrowStyle
של החץ בתחילת השורה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
style | ArrowStyle | סגנון החץ החדש שרוצים להגדיר. |
חזרה
Line
— הקו הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStartConnection(connectionSite)
הגדרת החיבור בתחילת השורה. הוא מעביר את תחילת השורה לאתר החיבור שצוין, תוך שמירה על הקצה השני.
פרמטרים
שם | סוג | תיאור |
---|---|---|
connectionSite | ConnectionSite | אתר החיבור שאליו מתעדכן החיבור ההתחלתי, או null
אם מסירים את החיבור ההתחלתי. |
חזרה
Line
— הקו.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTitle(title)
הגדרת כותרת הטקסט החלופי של רכיב הדף.
אין תמיכה בשיטה עבור רכיבי Group
.
// Set the first page element's alt text title to "new alt text title". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setTitle('new alt text title'); Logger.log(pageElement.getTitle());
פרמטרים
שם | סוג | תיאור |
---|---|---|
title | String | המחרוזת שבה רוצים להגדיר את כותרת הטקסט החלופי. |
חזרה
Line
– רכיב הדף הזה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
הגדרת המיקום האנכי של האלמנט בנקודות, שנמדדות מהפינה הימנית העליונה של הדף כשאין רוטציה לאלמנט.
פרמטרים
שם | סוג | תיאור |
---|---|---|
top | Number | המיקום האנכי החדש להגדרה, בנקודות. |
חזרה
Line
– רכיב הדף הזה, לצורך קישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTransform(transform)
הגדרת הטרנספורמציה של רכיב הדף באמצעות הטרנספורמציה שצוינה.
עדכון הטרנספורמציה של קבוצה משנה את הטרנספורמציה המוחלטת של רכיבי הדף בקבוצה הזו, וכך יכול לשנות את המראה החזותי שלהם.
עדכון הטרנספורמציה של רכיב דף שנמצא בקבוצה משנה רק את הטרנספורמציה של אותו רכיב דף, ולא משפיע על הטרנספורמציות של הקבוצה או על רכיבי דף אחרים בקבוצה.
פרטים על האופן שבו טרנספורמציות משפיעות על המראה החזותי של רכיבי הדף מופיעים בקטע getTransform()
.
פרמטרים
שם | סוג | תיאור |
---|---|---|
transform | AffineTransform | הטרנספורמציה שמוגדרת לרכיב הדף הזה. |
חזרה
Line
— הרכיב הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWeight(points)
הגדרת עובי הקו בפונקציה point.
פרמטרים
שם | סוג | תיאור |
---|---|---|
points | Number | עובי הקו החדש בנקודות. |
חזרה
Line
— הקו הזה, לשרשור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
הגדרת רוחב הרכיב בפונטים. זהו רוחב תיבת הגבול של הרכיב כשהרכיב לא מסובב.
השיטה הזו לא תואמת לכל רכיבי הדף. כדי לבדוק אילו אלמנטים בדף לא תואמים לשיטה הזו, אפשר לעיין ב מגבלות לגבי הגודל והמיקום.
פרמטרים
שם | סוג | תיאור |
---|---|---|
width | Number | רוחב הרכיב החדש בדף, בנקודות. |
חזרה
Line
– רכיב הדף הזה, לצורך קישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations