Class 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عرض البيانات داخل هذا العنصر ككائن ثنائي كبير (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لضبط إزاحة الصورة على شكل نقاط في النقاط من الفقرة 39.
setTopOffset(offset)PositionedImageلضبط إزاحة الصورة على شكل نقاط في نقاط من أعلى الفقرة.
setWidth(width)PositionedImageلضبط عرض الصورة بالبكسل.

المستندات التفصيلية

getAs(contentType)

عرض البيانات داخل هذا العنصر ككائن ثنائي كبير (blob) تم تحويله إلى نوع المحتوى المحدد. تضيف هذه الطريقة الامتداد المناسب إلى اسم الملف، على سبيل المثال، "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' صالح أيضًا.

تذكرة ذهاب وعودة

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 — إزاحة الصورة من الفقرة اليسرى&#39؛المتبقية

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

لضبط إزاحة الصورة على شكل نقاط في النقاط من الفقرة 39.

المعلّمات

الاسمالنوعالوصف
offsetNumberإزاحة من الفقرة&#39؛ المتبقية

تذكرة ذهاب وعودة

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

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

setTopOffset(offset)

لضبط إزاحة الصورة على شكل نقاط في نقاط من أعلى الفقرة.

المعلّمات

الاسمالنوعالوصف
offsetNumberإزاحة من الفقرة \u39s من الأعلى

تذكرة ذهاب وعودة

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