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