Class PositionedImage

PositionedImage

تصویر موقعیت ثابت لنگر به یک 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()

داده های داخل این شی را به صورت حباب برگردانید.

برگشت

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 یک عدد که حالت طرح بندی را نشان می دهد

برگشت

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