Class PositionedImage

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 داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید.
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' نیز معتبر هستند. برای سند Google Docs، 'text/markdown' نیز معتبر است.

بازگشت

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