Class PositionedImage

صورة تمّ وضعها

صورة في موضع ثابت تم تثبيتها في Paragraph على عكس InlineImage، PositionedImage هو ليس Element. لا يتضمّن أحد الوالدَين أو الأشقاء Element. بدلاً من ذلك، يتم تثبيته على Paragraph أو ListItem، ويتم وضعه من خلال Offsets (الموضع النسبي) من هذا العنصر الثابت. يحتوي كل PositionedImage على معرّف يمكن استخدامه للإشارة إليه. 

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

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getAs(contentType)Blobعرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد
getBlob()Blobعرض البيانات داخل هذا الكائن ككتلة بيانات
getHeight()Integerتُستخدَم هذه السمة لاسترداد ارتفاع الصورة بالبكسل.
getId()Stringللحصول على معرّف الصورة
getLayout()PositionedLayoutتحصل على قيمة مصنّفة تمثّل كيفية عرض الصورة.
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 التي تم إنشاؤها حديثًا مؤقتًا لحدود برمجية أكثر صرامة.

المعلَمات

الاسمالنوعالوصف
contentTypeStringنوع MIME المطلوب التحويل إليه بالنسبة إلى معظم العناصر المصغّرة، يكون 'application/pdf' هو الخيار الوحيد الصالح. بالنسبة إلى الصور بتنسيق BMP أو GIF أو JPEG أو PNG، يمكن استخدام أي من 'image/bmp' أو 'image/gif' أو 'image/jpeg' أو 'image/png' أيضًا. بالنسبة إلى مستند "مستندات Google"، يكون '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()

تحصل على قيمة مصنّفة تمثّل كيفية عرض الصورة.

الإرجاع

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)

لضبط ارتفاع الصورة بالبكسل.

المعلَمات

الاسمالنوعالوصف
heightIntegerارتفاع الصورة بالبكسل

الإرجاع

PositionedImage - العنصر الحالي

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

setLayout(layout)

تُستخدَم لتحديد طريقة عرض الصورة.

المعلَمات

الاسمالنوعالوصف
layoutPositionedLayoutعنصر مصنّف يمثّل وضع التنسيق

الإرجاع

PositionedImage - هذا العنصر للتسلسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

setLeftOffset(offset)

لضبط مسافة الصورة من يمين الفقرة، بالنقاط

المعلَمات

الاسمالنوعالوصف
offsetNumberمُعدَّل الإزاحة من يمين الفقرة

الإرجاع

PositionedImage - هذا العنصر للتسلسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

setTopOffset(offset)

لضبط مسافة الصورة من أعلى الفقرة بالنقاط

المعلَمات

الاسمالنوعالوصف
offsetNumberمسافة من أعلى الفقرة

الإرجاع

PositionedImage - هذا العنصر للتسلسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

setWidth(width)

لضبط عرض الصورة بالبكسل.

المعلَمات

الاسمالنوعالوصف
widthIntegerعرض الصورة بالبكسل

الإرجاع

PositionedImage - العنصر الحالي

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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