Class SpeakerSpotlight

זרקור על הדובר

הסמל PageElement שמייצג זרקור על הדובר. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const speakerSpotlight = slide.getPageElements()[0];
console.log(
    `Page element is of type: ${
        speakerSpotlight.getPageElementType().toString()}`,
);

Methods

שיטהסוג הערך המוחזרתיאור קצר
alignOnPage(alignmentPosition)SpeakerSpotlightהרכיב מיושר למיקום היישור שצוין בדף.
bringForward()SpeakerSpotlightהעברת רכיב הדף קדימה בדף ברכיב אחד.
bringToFront()SpeakerSpotlightהעברת רכיב הדף לחזית הדף.
duplicate()PageElementשכפול של רכיב הדף.
getBorder()Borderהפונקציה מחזירה את הערך של Border של הזרקור על הדובר.
getConnectionSites()ConnectionSite[]הפונקציה מחזירה את רשימת ה-ConnectionSites ברכיב הדף, או רשימה ריקה אם לרכיב הדף אין אתרי חיבור.
getDescription()Stringהפונקציה מחזירה את תיאור הטקסט החלופי של רכיב הדף.
getHeight()Numberהפונקציה מקבלת את הגובה של האלמנט בנקודות, שהוא הגובה של תיבת הגבול של האלמנט כשאין לו סיבוב.
getInherentHeight()Numberהפונקציה מחזירה את הגובה המובנה של הרכיב בנקודות.
getInherentWidth()Numberהפונקציה מחזירה את רוחב הרכיב המובנה בפיקסלים.
getLeft()Numberהפונקציה מחזירה את המיקום האופקי של האלמנט בנקודות, שנמדד מהפינה הימנית העליונה של הדף כשאין לאלמנט סיבוב.
getMaskShapeType()ShapeTypeהפונקציה מחזירה את הערך ShapeType של המסכה שהוחלו על הזרקור על הדובר, או את הערך null אם אין מסכה.
getObjectId()Stringהפונקציה מחזירה את המזהה הייחודי של האובייקט הזה.
getPageElementType()PageElementTypeהפונקציה מחזירה את הסוג של רכיב הדף, שמיוצג כ-enum מסוג PageElementType.
getParentGroup()Groupהפונקציה מחזירה את הקבוצה שאליה שייך רכיב הדף, או את הערך null אם הרכיב לא נמצא בקבוצה.
getParentPage()Pageהפונקציה מחזירה את הדף שבו נמצא רכיב הדף הזה.
getRotation()Numberהפונקציה מחזירה את זווית הסיבוב של הרכיב בכיוון השעון סביב מרכזו במעלות, כאשר אפס מעלות מציין שאין סיבוב.
getTitle()Stringהפונקציה מחזירה את שם הטקסט החלופי של רכיב הדף.
getTop()Numberהפונקציה מקבלת את המיקום האנכי של הרכיב בנקודות, שנמדד מהפינה השמאלית העליונה של הדף כשאין רוטציה לרכיב.
getTransform()AffineTransformהפונקציה מחזירה את הטרנספורמציה של רכיב הדף.
getWidth()Numberהפונקציה מחזירה את רוחב הרכיב בנקודות, שהוא רוחב תיבת הגבול של הרכיב כשהרכיב לא מסובב.
preconcatenateTransform(transform)SpeakerSpotlightשרשור מראש של הטרנספורמציה שסופקה לטרנספורמציה הקיימת של רכיב הדף.
remove()voidהסרת רכיב הדף.
scaleHeight(ratio)SpeakerSpotlightשינוי הגודל של גובה הרכיב לפי היחס שצוין.
scaleWidth(ratio)SpeakerSpotlightשינוי הרוחב של הרכיב לפי היחס שצוין.
select()voidהמערכת בוחרת רק את PageElement במצגת הפעילה ומבטלת את הבחירה הקודמת.
select(replace)voidבוחרים את PageElement במצגת הפעילה.
sendBackward()SpeakerSpotlightהעברת רכיב הדף לאחור בדף ברכיב אחד.
sendToBack()SpeakerSpotlightשליחת רכיב הדף לחלק האחורי של הדף.
setDescription(description)SpeakerSpotlightהגדרת תיאור הטקסט החלופי של רכיב הדף.
setHeight(height)SpeakerSpotlightהגדרת הגובה של האלמנט בנקודות. זהו הגובה של תיבת הגבול של האלמנט כשהאלמנט לא מסתובב.
setLeft(left)SpeakerSpotlightהגדרת המיקום האופקי של הרכיב בנקודות, שנמדדות מהפינה הימנית העליונה של הדף כשאין רכיב סיבוב.
setRotation(angle)SpeakerSpotlightהגדרת זווית הסיבוב של הרכיב בכיוון השעון סביב מרכזו, במעלות.
setTitle(title)SpeakerSpotlightהגדרת כותרת הטקסט החלופי של רכיב הדף.
setTop(top)SpeakerSpotlightהגדרת המיקום האנכי של האלמנט בנקודות, שנמדדות מהפינה הימנית העליונה של הדף כשאין רוטציה לאלמנט.
setTransform(transform)SpeakerSpotlightהגדרת הטרנספורמציה של רכיב הדף באמצעות הטרנספורמציה שצוינה.
setWidth(width)SpeakerSpotlightהגדרת רוחב הרכיב בפונטים. זהו רוחב תיבת הגבול של הרכיב כשהרכיב לא מסובב.

מסמכים מפורטים

alignOnPage(alignmentPosition)

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

פרמטרים

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

חזרה

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

bringForward()

העברת רכיב הדף קדימה בדף ברכיב אחד.

אסור שמרכיב הדף יהיה בקבוצה.

חזרה

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

אישור

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

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

bringToFront()

העברת רכיב הדף לחזית הדף.

אסור שמרכיב הדף יהיה בקבוצה.

חזרה

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

אישור

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

  • 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

getBorder()

הפונקציה מחזירה את הערך של Border של הזרקור על הדובר. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Gets the first element on the page, which in
// this example is of type speaker spotlight.
const speakerSpotlight = slide.getPageElements()[0];
// Gets the border of the speaker spotlight.
const border = speakerSpotlight.getBorder();

חזרה

Border — הגבול של הזרקור על הדובר.

אישור

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

  • 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

getDescription()

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

חזרה

String — תיאור הטקסט החלופי של רכיב הדף.

אישור

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

  • 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

getMaskShapeType()

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Gets the first element on the page, which in
// this example is of type speaker spotlight.
const speakerSpotlight = slide.getPageElements()[0];
// Gets the shape type of the mask on the speaker spotlight.
const maskShapeType = speakerSpotlight.getMaskShapeType();

חזרה

ShapeType — סוג הצורה של המסכה של הזרקור על הדובר.

אישור

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

  • 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

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

getWidth()

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

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

חזרה

Number – רוחב המאפיין של הדף במילימטרים, או null אם למאפיין של הדף אין רוחב.

אישור

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

  • 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הטרנספורמציה שצריך לבצע תחילה כדי לצרף לטרנספורמציה של רכיב הדף הזה.

חזרה

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

אישור

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

  • 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

scaleHeight(ratio)

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

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

פרמטרים

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

חזרה

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

אישור

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

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

scaleWidth(ratio)

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

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

פרמטרים

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

חזרה

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

אישור

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

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

העברת רכיב הדף לאחור בדף ברכיב אחד.

אסור שמרכיב הדף יהיה בקבוצה.

חזרה

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

אישור

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

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

sendToBack()

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

אסור שמרכיב הדף יהיה בקבוצה.

חזרה

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

אישור

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

  • 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המחרוזת שבה רוצים להגדיר את תיאור הטקסט החלופי.

חזרה

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

אישור

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

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

setHeight(height)

הגדרת הגובה של האלמנט בנקודות. זהו הגובה של תיבת הגבול של האלמנט כשהאלמנט לא מסתובב.

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

פרמטרים

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

חזרה

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

אישור

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

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

setLeft(left)

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

פרמטרים

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

חזרה

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

אישור

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

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

setRotation(angle)

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

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

פרמטרים

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

חזרה

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

אישור

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

  • 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המחרוזת שבה רוצים להגדיר את כותרת הטקסט החלופי.

חזרה

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

אישור

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

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

setTop(top)

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

פרמטרים

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

חזרה

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

אישור

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

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

setTransform(transform)

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

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

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

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

פרמטרים

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

חזרה

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

אישור

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

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

setWidth(width)

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

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

פרמטרים

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

חזרה

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

אישור

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

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