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للحصول على قيمة تعداد تمثّل كيفية عرض الصورة.
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 — البيانات ككائنات ثنائية كبيرة (blob).

getBlob()

عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير.

الإرجاع

Blob — البيانات ككائنات ثنائية كبيرة (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