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

Class PositionedImage

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

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

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

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

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

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`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 שהומר לסוג התוכן שצוין. הזה method מוסיפה את הסיומת המתאימה לשם הקובץ, לדוגמה, "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