Class PositionedImage

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عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير يتم تحويله إلى نوع المحتوى المحدّد.
getBlob()Blobعرض البيانات داخل هذا الكائن على هيئة كائن ثنائي كبير (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 التي تم إنشاؤها حديثًا لحصص أكثر صرامة مؤقتًا.

المَعلمات

الاسمTypeالوصف
contentTypeStringنوع MIME المطلوب التحويل إليه. بالنسبة إلى معظم الكائنات الثنائية الكبيرة، يكون 'application/pdf' هو الخيار الصالح الوحيد. بالنسبة إلى الصور بتنسيق BMP أو GIF أو JPEG أو PNG، يكون أي من 'image/bmp' أو 'image/gif' أو 'image/jpeg' أو 'image/png' صالحًا أيضًا.

استرجاع الكرة

Blob — البيانات في صورة كائن ثنائي كبير (blob).


getBlob()

عرض البيانات داخل هذا الكائن على هيئة كائن ثنائي كبير (blob).

استرجاع الكرة

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)

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

setLayout(layout)

لتعيين تعريف كيفية تخطيط الصورة.

المَعلمات

الاسمTypeالوصف
layoutPositionedLayoutتعداد يمثل وضع التخطيط

استرجاع الكرة

PositionedImage: هذا الكائن للسلاسل

التفويض

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

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

setLeftOffset(offset)

لتعيين إزاحة الصورة، بالنقاط، من يسار الفقرة.

المَعلمات

الاسمTypeالوصف
offsetNumberإزاحة من يسار الفقرة

استرجاع الكرة

PositionedImage: هذا الكائن للسلاسل

التفويض

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

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

setTopOffset(offset)

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

المَعلمات

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

استرجاع الكرة

PositionedImage: هذا الكائن للسلاسل

التفويض

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

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

setWidth(width)

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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