דף זה תורגם על ידי Cloud Translation API.

Class PositionedImage

תמונה במיקום קבוע שמקובעת ל-Paragraph. בניגוד ל-InlineImage, PositionedImage הוא לא Element. אין לה הורה או אח/ה Element. במקום זאת, הוא עוגן ל-Paragraph או ל-ListItem וממוקם באמצעות סטיות מהעוגן הזה. ל-PositionedImage יש מזהה שאפשר להשתמש בו כדי להפנות אליו.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Append a new paragraph.
const paragraph = body.appendParagraph('New paragraph to anchor the image to.');

// Get an image in Drive from its ID.
const image = DriveApp.getFileById('ENTER_IMAGE_FILE_ID_HERE').getBlob();

// Add the PositionedImage with offsets (in points).
const posImage =
    paragraph.addPositionedImage(image).setTopOffset(60).setLeftOffset(40);

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
`getAs(contentType)`	`Blob`	החזרת הנתונים שבתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין.
`getBlob()`	`Blob`	החזרת הנתונים שבתוך האובייקט הזה כ-blob.
`getHeight()`	`Integer`	אחזור הגובה של התמונה, בפיקסלים.
`getId()`	`String`	הפונקציה מקבלת את מזהה התמונה.
`getLayout()`	`PositionedLayout`	הפונקציה מקבלת ערך enum שמייצג את אופן הפריסה של התמונה.
`getLeftOffset()`	`Number`	הפונקציה מקבלת את ההיסט של התמונה, בנקודות, מצד ימין של הפסקה.
`getParagraph()`	`Paragraph`	הפונקציה מקבלת את ה-`Paragraph` שאליו התמונה מעוגנת.
`getTopOffset()`	`Number`	הפונקציה מקבלת את ההיסט של התמונה, בנקודות, מהחלק העליון של הפסקה.
`getWidth()`	`Integer`	אחזור הרוחב של התמונה, בפיקסלים.
`setHeight(height)`	`PositionedImage`	הגדרת הגובה של התמונה, בפיקסלים.
`setLayout(layout)`	`PositionedImage`	הגדרת הגדרת הפריסה של התמונה.
`setLeftOffset(offset)`	`PositionedImage`	הגדרת ההזזה של התמונה, בנקודות, מצד ימין של הפסקה.
`setTopOffset(offset)`	`PositionedImage`	הגדרת ההזזה של התמונה, בנקודות, מהחלק העליון של הפסקה.
`setWidth(width)`	`PositionedImage`	הגדרת רוחב התמונה, בפיקסלים.

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

`getAs(contentType)`

החזרת הנתונים שבתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין. השיטה הזו מוסיפה את הסיומת המתאימה לשם הקובץ – לדוגמה, 'myfile.pdf'. עם זאת, ההנחה היא שחלק משם הקובץ שמופיע אחרי הנקודה האחרונה (אם יש כזו) הוא סיומת קיימת שצריך להחליף. כתוצאה מכך, הקובץ ShoppingList.12.25.2014 הופך לקובץ ShoppingList.12.25.pdf.

כדי לראות את המכסות היומיות להמרות, אפשר לעיין במאמר מכסות לשירותי Google. יכול להיות שדומיינים חדשים של Google Workspace יהיו כפופים באופן זמני למכסות מחמירות יותר.

פרמטרים

שם	סוג	תיאור
`contentType`	`String`	סוג ה-MIME שאליו רוצים להמיר. ברוב ה-blobs, `'application/pdf'` היא האפשרות היחידה התקפה. בתמונות בפורמט BMP,‏ GIF,‏ JPEG או PNG, אפשר להשתמש גם ב-`'image/bmp'`,‏ `'image/gif'`,‏ `'image/jpeg'` או `'image/png'`. במסמך ב-Google Docs, הערך `'text/markdown'` תקף גם כן.

חזרה

Blob – הנתונים כ-blob.

`getBlob()`

החזרת הנתונים שבתוך האובייקט הזה כ-blob.

חזרה

Blob – הנתונים כ-blob.

`getHeight()`

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

חזרה

Integer – הגובה של התמונה, בפיקסלים

אישור

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getId()`

הפונקציה מקבלת את מזהה התמונה.

חזרה

String – מזהה התמונה

אישור

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getLayout()`

הפונקציה מקבלת ערך enum שמייצג את אופן הפריסה של התמונה.

חזרה

PositionedLayout – פריסת התמונה

אישור

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getLeftOffset()`

הפונקציה מקבלת את ההיסט של התמונה, בנקודות, מצד ימין של הפסקה.

חזרה

Number — ההזזה של התמונה מצד ימין של הפסקה השמאלית

אישור

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getParagraph()`

הפונקציה מקבלת את ה-Paragraph שאליו התמונה מעוגנת.

חזרה

Paragraph – הפיסקה ההורה

אישור

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getTopOffset()`

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

חזרה

Number – ההזזה של התמונה מלמעלה של הפסקה השמאלית

אישור

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getWidth()`

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

חזרה

Integer – רוחב התמונה, בפיקסלים

אישור

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setHeight(height)`

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

פרמטרים

שם	סוג	תיאור
`height`	`Integer`	הגובה של התמונה, בפיקסלים

חזרה

PositionedImage – האובייקט הנוכחי

אישור

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setLayout(layout)`

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

פרמטרים

שם	סוג	תיאור
`layout`	`PositionedLayout`	enum שמייצג את מצב הפריסה

חזרה

PositionedImage – האובייקט הזה לשרשור

אישור

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setLeftOffset(offset)`

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

פרמטרים

שם	סוג	תיאור
`offset`	`Number`	סטייה מימין לפסקה

חזרה

PositionedImage – האובייקט הזה לשרשור

אישור

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setTopOffset(offset)`

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

פרמטרים

שם	סוג	תיאור
`offset`	`Number`	סטייה מחלק העליון של הפסקה

חזרה

PositionedImage – האובייקט הזה לשרשור

אישור

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setWidth(width)`

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

פרמטרים

שם	סוג	תיאור
`width`	`Integer`	רוחב התמונה, בפיקסלים

חזרה

PositionedImage – האובייקט הנוכחי

אישור

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents