تصویر موقعیت ثابت لنگر به یک Paragraph
. برخلاف InlineImage
، PositionedImage
یک Element
نیست. این Element
والد یا خواهر و برادر ندارد. در عوض، به یک Paragraph
یا ListItem
متصل میشود و از طریق افستهایی از آن لنگر قرار میگیرد. یک PositionedImage
یک شناسه دارد که می توان از آن برای ارجاع به آن استفاده کرد.
var body = DocumentApp.getActiveDocument().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 | داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. |
getBlob() | 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)
داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. این روش پسوند مناسب را به نام فایل اضافه می کند - به عنوان مثال، "myfile.pdf". با این حال، فرض میکند که بخشی از نام فایل که پس از آخرین نقطه (در صورت وجود) یک پسوند موجود است که باید جایگزین شود. در نتیجه، "ShoppingList.12.25.2014" به "ShoppingList.12.25.pdf" تبدیل می شود.
برای مشاهده سهمیه های روزانه برای تبدیل، به سهمیه خدمات Google مراجعه کنید. دامنههای جدید Google Workspace ممکن است به طور موقت مشمول سهمیههای سختگیرانهتر شوند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
contentType | String | نوع MIME برای تبدیل. برای اکثر حبابها، 'application/pdf' تنها گزینه معتبر است. برای تصاویر با فرمت BMP، GIF، JPEG یا PNG، هر یک از 'image/bmp' ، 'image/gif' ، 'image/jpeg' یا 'image/png' نیز معتبر هستند. |
برگشت
Blob
- داده ها به عنوان یک لکه.
getBlob()
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()
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 | یک عدد که حالت طرح بندی را نشان می دهد |
برگشت
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