Class OverGridImage

OverGridImage

ייצוג של תמונה מעל הרשת בגיליון אלקטרוני.

Methods

שיטהסוג הערך שמוחזרתיאור קצר
assignScript(functionName)OverGridImageמשייכת את הפונקציה עם שם הפונקציה שצוין לאימג' הזה.
getAltTextDescription()Stringהפונקציה מחזירה את תיאור הטקסט החלופי של התמונה הזו.
getAltTextTitle()Stringמחזירה את הכותרת של הטקסט החלופי של התמונה.
getAnchorCell()Rangeהפונקציה מחזירה את התא שבו התמונה מעוגנת.
getAnchorCellXOffset()Integerמחזירה את ההיסט האופקי בפיקסלים מתא העוגן.
getAnchorCellYOffset()Integerהפונקציה מחזירה את ההיסט האנכי בפיקסלים מתא העוגן.
getHeight()Integerהפונקציה מחזירה את הגובה בפועל של התמונה הזו בפיקסלים.
getInherentHeight()Integerהפונקציה מחזירה את הגובה המובנה של התמונה הזו בפיקסלים.
getInherentWidth()Integerהפונקציה מחזירה את הגובה המובנה של התמונה הזו בפיקסלים.
getScript()Stringהפונקציה מחזירה את השם של הפונקציה שהוקצתה לתמונה הזו.
getSheet()Sheetמחזירה את הגיליון שבו התמונה מופיעה.
getWidth()Integerהפונקציה מחזירה את הרוחב בפועל של התמונה בפיקסלים.
remove()voidמחיקת התמונה מהגיליון האלקטרוני.
replace(blob)OverGridImageהתמונה הזו מוחלפת בתמונה שצוינה על ידי הערך BlobSource.
replace(url)OverGridImageהתמונה הזו מוחלפת בתמונה מכתובת ה-URL שצוינה.
resetSize()OverGridImageמאפס את התמונה למידות המקוריות שלה.
setAltTextDescription(description)OverGridImageהגדרת תיאור הטקסט החלופי לתמונה הזו.
setAltTextTitle(title)OverGridImageההגדרה הזו קובעת את הכותרת של הטקסט החלופי לתמונה.
setAnchorCell(cell)OverGridImageההגדרה הזו קובעת את התא שאליו מוצמדת התמונה.
setAnchorCellXOffset(offset)OverGridImageההגדרה הזו קובעת את ההיסט האופקי בפיקסלים מתא העוגן.
setAnchorCellYOffset(offset)OverGridImageההגדרה הזו קובעת את ההיסט האנכי של הפיקסלים מתא העוגן.
setHeight(height)OverGridImageהגדרת הגובה בפועל של התמונה בפיקסלים.
setWidth(width)OverGridImageההגדרה הזו קובעת את הרוחב בפועל של התמונה בפיקסלים.

תיעוד מפורט

assignScript(functionName)

משייכת את הפונקציה עם שם הפונקציה שצוין לאימג' הזה.

פרמטרים

שםסוגתיאור
functionNameStringשם הפונקציה שצוינה. זו חייבת להיות פונקציה ציבורית ברמה העליונה, ולא פונקציה שמסתיימת בקו תחתון, כמו privateFunction_.

חזרה

‫OverGridImage — התמונה הזו, לשרשור.

אישור

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

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

getAltTextDescription()

הפונקציה מחזירה את תיאור הטקסט החלופי של התמונה הזו.

חזרה

‫String — תיאור הטקסט החלופי.

אישור

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

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

getAltTextTitle()

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

חזרה

‫String — הכותרת של הטקסט החלופי.

אישור

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

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

getAnchorCell()

הפונקציה מחזירה את התא שבו התמונה מעוגנת.

חזרה

‫Range – תא העוגן.

אישור

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

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

getAnchorCellXOffset()

מחזירה את ההיסט האופקי בפיקסלים מתא העוגן.

חזרה

‫Integer – ההיסט האופקי של הפיקסלים.

אישור

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

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

getAnchorCellYOffset()

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

חזרה

‫Integer – ההיסט האנכי של הפיקסלים.

אישור

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

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

getHeight()

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

// Logs the height of all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  Logger.log(images[i].getHeight());
}

חזרה

‫Integer — גובה התמונה בפיקסלים.

אישור

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

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

getInherentHeight()

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

חזרה

‫Integer – הגובה המובנה בפיקסלים.

אישור

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

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

getInherentWidth()

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

חזרה

‫Integer – הרוחב המובנה בפיקסלים.

אישור

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

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

getScript()

הפונקציה מחזירה את השם של הפונקציה שהוקצתה לתמונה הזו.

חזרה

‫String — שם הפונקציה.

אישור

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

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

getSheet()

מחזירה את הגיליון שבו התמונה מופיעה. 

// Logs the parent sheet of all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  Logger.log(images[i].getSheet());
}

חזרה

‫Sheet — הגיליון שבו התמונה מופיעה.

אישור

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

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

getWidth()

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

// Logs the width of all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  Logger.log(images[i].getWidth());
}

חזרה

‫Integer — רוחב התמונה בפיקסלים.

אישור

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

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

remove()

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

// Deletes all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  images[i].remove();
}

אישור

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

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

replace(blob)

התמונה הזו מוחלפת בתמונה שצוינה על ידי הערך BlobSource. גודל ה-blob המקסימלי שנתמך הוא 2MB.

פרמטרים

שםסוגתיאור
blobBlobSourceהתמונה החדשה כ-Blob.

חזרה

‫OverGridImage — התמונה הזו, לשרשור.

אישור

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

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

replace(url)

התמונה הזו מוחלפת בתמונה מכתובת ה-URL שצוינה.

פרמטרים

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

חזרה

‫OverGridImage — התמונה הזו, לשרשור.

אישור

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

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

resetSize()

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

חזרה

‫OverGridImage — התמונה הזו, לשרשור.

אישור

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

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

setAltTextDescription(description)

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

פרמטרים

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

חזרה

‫OverGridImage — התמונה הזו, לשרשור.

אישור

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

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

setAltTextTitle(title)

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

פרמטרים

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

חזרה

‫OverGridImage — התמונה הזו, לשרשור.

אישור

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

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

setAnchorCell(cell)

ההגדרה הזו קובעת את התא שאליו מוצמדת התמונה.

פרמטרים

שםסוגתיאור
cellRangeתא העוגן החדש.

חזרה

‫OverGridImage — התמונה הזו, לשרשור.

אישור

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

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

setAnchorCellXOffset(offset)

ההגדרה הזו קובעת את ההיסט האופקי בפיקסלים מתא העוגן.

פרמטרים

שםסוגתיאור
offsetIntegerההיסט החדש של הפיקסלים בציר האופקי.

חזרה

‫OverGridImage — התמונה הזו, לשרשור.

אישור

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

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

setAnchorCellYOffset(offset)

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

פרמטרים

שםסוגתיאור
offsetIntegerההיסט האנכי החדש של הפיקסלים.

חזרה

‫OverGridImage — התמונה הזו, לשרשור.

אישור

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

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

setHeight(height)

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

פרמטרים

שםסוגתיאור
heightIntegerהגובה הרצוי בפיקסלים.

חזרה

‫OverGridImage – התמונה לשרשור.

אישור

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

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

setWidth(width)

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

פרמטרים

שםסוגתיאור
widthIntegerהרוחב הרצוי בפיקסלים.

חזרה

‫OverGridImage – התמונה לשרשור.

אישור

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

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

שיטות שהוצאו משימוש