Class PositionedImage

تصویر موقعیت یابی

تصویر موقعیت ثابت لنگر به یک Paragraph . برخلاف Inline Image ، Positioned Image یک Element نیست. این Element والد یا خواهر و برادر ندارد. در عوض، به یک Paragraph یا List Item متصل می‌شود و از طریق افست‌هایی از آن لنگر قرار می‌گیرد. یک Positioned Image دارای شناسه‌ای است که می‌توان از آن برای ارجاع به آن استفاده کرد. 

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);

روش ها

روش نوع برگشت شرح مختصر
get As(contentType) Blob داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید.
get Blob() Blob داده های داخل این شی را به صورت حباب برگردانید.
get Height() Integer ارتفاع تصویر را بر حسب پیکسل بازیابی می کند.
get Id() String شناسه تصویر را می گیرد.
get Layout() Positioned Layout یک مقدار enum دریافت می کند که نشان دهنده نحوه چیدمان تصویر است.
get Left Offset() Number انحراف تصویر را بر حسب نقطه از سمت چپ پاراگراف دریافت می کند.
get Paragraph() Paragraph Paragraph مورد نظر تصویر را دریافت می کند.
get Top Offset() Number انحراف تصویر را بر حسب نقطه از بالای پاراگراف دریافت می کند.
get Width() Integer عرض تصویر را بر حسب پیکسل بازیابی می کند.
set Height(height) Positioned Image ارتفاع تصویر را بر حسب پیکسل تنظیم می کند.
set Layout(layout) Positioned Image تعریف نحوه چیدمان تصویر را تنظیم می کند.
set Left Offset(offset) Positioned Image افست تصویر را بر حسب نقطه از سمت چپ پاراگراف تنظیم می کند.
set Top Offset(offset) Positioned Image افست تصویر را بر حسب نقطه از بالای پاراگراف تنظیم می کند.
set Width(width) Positioned Image عرض تصویر را بر حسب پیکسل تنظیم می کند.

مستندات دقیق

get As(contentType)

داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. این روش پسوند مناسب را به نام فایل اضافه می کند - به عنوان مثال، "myfile.pdf". با این حال، فرض می‌کند که بخشی از نام فایل که پس از آخرین نقطه (در صورت وجود) یک پسوند موجود است که باید جایگزین شود. در نتیجه، "ShoppingList.12.25.2014" به "ShoppingList.12.25.pdf" تبدیل می شود.

برای مشاهده سهمیه های روزانه برای تبدیل، به سهمیه خدمات Google مراجعه کنید. دامنه‌های جدید Google Workspace ممکن است به طور موقت مشمول سهمیه‌های سخت‌گیرانه‌تر شوند.

پارامترها

نام تایپ کنید توضیحات
content Type String نوع MIME برای تبدیل. برای اکثر حباب‌ها، 'application/pdf' تنها گزینه معتبر است. برای تصاویر با فرمت BMP، GIF، JPEG یا PNG، هر یک از 'image/bmp' ، 'image/gif' ، 'image/jpeg' یا 'image/png' نیز معتبر هستند. برای سند Google Docs، 'text/markdown' نیز معتبر است.

بازگشت

Blob - داده ها به عنوان یک لکه.

get Blob()

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

بازگشت

Blob - داده ها به عنوان یک لکه.

get Height()

ارتفاع تصویر را بر حسب پیکسل بازیابی می کند.

بازگشت

Integer - ارتفاع تصویر، بر حسب پیکسل

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Id()

شناسه تصویر را می گیرد.

بازگشت

String - شناسه تصویر

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Layout()

یک مقدار enum دریافت می کند که نشان دهنده نحوه چیدمان تصویر است.

بازگشت

Positioned Layout - طرح بندی تصویر

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Left Offset()

انحراف تصویر را بر حسب نقطه از سمت چپ پاراگراف دریافت می کند.

بازگشت

Number - تصویر از سمت چپ پاراگراف سمت چپ تغییر کرده است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Paragraph()

Paragraph مورد نظر تصویر را دریافت می کند.

بازگشت

Paragraph - پاراگراف والد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Top Offset()

انحراف تصویر را بر حسب نقطه از بالای پاراگراف دریافت می کند.

بازگشت

Number - تصویر از بالای پاراگراف سمت چپ فاصله دارد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Width()

عرض تصویر را بر حسب پیکسل بازیابی می کند.

بازگشت

Integer - عرض تصویر، بر حسب پیکسل

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Height(height)

ارتفاع تصویر را بر حسب پیکسل تنظیم می کند.

پارامترها

نام تایپ کنید توضیحات
height Integer ارتفاع تصویر بر حسب پیکسل

بازگشت

Positioned Image - شی فعلی

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Layout(layout)

تعریف نحوه چیدمان تصویر را تنظیم می کند.

پارامترها

نام تایپ کنید توضیحات
layout Positioned Layout یک عدد که حالت طرح بندی را نشان می دهد

بازگشت

Positioned Image - این شی برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Left Offset(offset)

افست تصویر را بر حسب نقطه از سمت چپ پاراگراف تنظیم می کند.

پارامترها

نام تایپ کنید توضیحات
offset Number از سمت چپ پاراگراف جابجا شده است

بازگشت

Positioned Image - این شی برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Top Offset(offset)

افست تصویر را بر حسب نقطه از بالای پاراگراف تنظیم می کند.

پارامترها

نام تایپ کنید توضیحات
offset Number از بالای پاراگراف جدا شود

بازگشت

Positioned Image - این شی برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Width(width)

عرض تصویر را بر حسب پیکسل تنظیم می کند.

پارامترها

نام تایپ کنید توضیحات
width Integer عرض تصویر بر حسب پیکسل

بازگشت

Positioned Image - شی فعلی

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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