Class PositionedImage

PositionedImage

صورة ذات موضع ثابت مثبّتة في Paragraph على عكس InlineImage، فإنّ PositionedImage ليس Element. لا يحتوي على عنصر رئيسي أو عنصر مجاور Element. بدلاً من ذلك، يتم تثبيته على Paragraph أو ListItem، ويتم وضعه من خلال إزاحات من نقطة التثبيت هذه. يحتوي 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 التي تم إنشاؤها حديثًا لحصص أكثر صرامة بشكل مؤقت.

المَعلمات

الاسم	النوع	الوصف
contentType	String	نوع 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)

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

المَعلمات

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

الإرجاع

‫PositionedImage: العنصر الحالي

التفويض

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

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

---

setLayout(layout)

تحدّد هذه السمة طريقة عرض الصورة.

المَعلمات

الاسم	النوع	الوصف
layout	PositionedLayout	تعداد يمثّل وضع التنسيق

الإرجاع

‫PositionedImage: هذا العنصر للتسلسل

التفويض

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

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

---

setLeftOffset(offset)

تضبط هذه السمة موضع الصورة، بالنقاط، من يمين الفقرة.

المَعلمات

الاسم	النوع	الوصف
offset	Number	الإزاحة من يسار الفقرة

الإرجاع

‫PositionedImage: هذا العنصر للتسلسل

التفويض

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

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

---

setTopOffset(offset)

تضبط هذه السمة إزاحة الصورة بالنقاط من أعلى الفقرة.

المَعلمات

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

الإرجاع

‫PositionedImage: هذا العنصر للتسلسل

التفويض

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

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

---

setWidth(width)

تضبط هذه السمة عرض الصورة بالبكسل.

المَعلمات

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

الإرجاع

‫PositionedImage: العنصر الحالي

التفويض

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

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