صورة ذات موضع ثابت مثبّتة في 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 | الوصف |
---|---|---|
contentType | String | نوع 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()
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 | الوصف |
---|---|---|
height | Integer | ارتفاع الصورة بالبكسل |
استرجاع الكرة
PositionedImage
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLayout(layout)
لتعيين تعريف كيفية تخطيط الصورة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
layout | PositionedLayout | تعداد يمثل وضع التخطيط |
استرجاع الكرة
PositionedImage
: هذا الكائن للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLeftOffset(offset)
لتعيين إزاحة الصورة، بالنقاط، من يسار الفقرة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
offset | Number | إزاحة من يسار الفقرة |
استرجاع الكرة
PositionedImage
: هذا الكائن للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setTopOffset(offset)
لتعيين إزاحة الصورة، بالنقاط، من أعلى الفقرة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
offset | Number | الإزاحة من أعلى الفقرة |
استرجاع الكرة
PositionedImage
: هذا الكائن للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setWidth(width)
لضبط عرض الصورة بالبكسل.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
width | Integer | عرض الصورة بالبكسل |
استرجاع الكرة
PositionedImage
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents