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 التي تم إنشاؤها حديثًا أكثر صرامة مؤقتًا. حصصها.

المعلمات

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

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

المعلمات

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