تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class ImageItem

عنصر تصميم يعرض صورة يمكن الوصول إلى العناصر أو إنشاؤها من Form.

// Open a form by ID and add a new image item
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var img = UrlFetchApp.fetch('https://www.google.com/images/srpr/logo4w.png');
form.addImageItem()
    .setTitle('Google')
    .setHelpText('Google Logo') // The help text is the image description
    .setImage(img);

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`duplicate()`	`ImageItem`	إنشاء نسخة من هذا العنصر وإلحاقها بنهاية النموذج
`getAlignment()`	`Alignment`	الحصول على المحاذاة الأفقية للصورة
`getHelpText()`	`String`	يحصل على نص المساعدة الخاص بالعنصر (يُسمّى أحيانًا نص الوصف لعناصر التنسيق مثل `ImageItems` و`PageBreakItems` و`SectionHeaderItems`).
`getId()`	`Integer`	الحصول على المعرّف الفريد للعنصر
`getImage()`	`Blob`	الحصول على الصورة المعيّنة حاليًا للعنصر.
`getIndex()`	`Integer`	الحصول على فهرس العنصر بين جميع العناصر في النموذج.
`getTitle()`	`String`	يحصل على عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة استخدام `SectionHeaderItem`).
`getType()`	`ItemType`	تعرض هذه السمة نوع العنصر، ويتم تمثيله على أنّه `ItemType`.
`getWidth()`	`Integer`	للحصول على عرض الصورة بالبكسل.
`setAlignment(alignment)`	`ImageItem`	لضبط المحاذاة الأفقية للصورة.
`setHelpText(text)`	`ImageItem`	تحدِّد هذه السياسة نص المساعدة للعنصر (يُسمّى أحيانًا نص الوصف لعناصر التنسيق مثل `ImageItems` و`PageBreakItems` و`SectionHeaderItems`).
`setImage(image)`	`ImageItem`	لضبط الصورة نفسها.
`setTitle(title)`	`ImageItem`	تضبط عنوان العنصر (يُسمّى أحيانًا نص العنوان، في حال استخدام `SectionHeaderItem`).
`setWidth(width)`	`ImageItem`	لضبط عرض الصورة بالبكسل.

الوثائق التفصيلية

`duplicate()`

إنشاء نسخة من هذا العنصر وإلحاقها بنهاية النموذج

الإرجاع

ImageItem — نسخة طبق الأصل من ImageItem، للسلسلة

التفويض

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

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getAlignment()`

الحصول على المحاذاة الأفقية للصورة

الإرجاع

Alignment - المحاذاة الأفقية

التفويض

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

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getHelpText()`

يحصل على نص المساعدة الخاص بالعنصر (يُسمّى أحيانًا نص الوصف لعناصر التنسيق مثل ImageItems وPageBreakItems وSectionHeaderItems).

الإرجاع

String - نص مساعدة العنصر أو نص الوصف

التفويض

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

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getId()`

الحصول على المعرّف الفريد للعنصر

الإرجاع

Integer - معرّف العنصر

التفويض

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

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getImage()`

الحصول على الصورة المعيّنة حاليًا للعنصر.

الإرجاع

Blob: بيانات الصورة

التفويض

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

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getIndex()`

الحصول على فهرس العنصر بين جميع العناصر في النموذج.

الإرجاع

Integer — فهرس العنصر

التفويض

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

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getTitle()`

يحصل على عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة استخدام SectionHeaderItem).

الإرجاع

String - عنوان العنصر أو نص رأسه

التفويض

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

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getType()`

تعرض هذه السمة نوع العنصر، ويتم تمثيله على أنّه ItemType.

الإرجاع

ItemType — نوع العنصر

التفويض

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

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getWidth()`

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

الإرجاع

Integer - العرض بالبكسل

التفويض

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

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setAlignment(alignment)`

لضبط المحاذاة الأفقية للصورة.

المعلمات

الاسم	النوع	الوصف
`alignment`	`Alignment`	المحاذاة الأفقية

الإرجاع

ImageItem — ImageItem هذا، للسلسلة

التفويض

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

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setHelpText(text)`

تحدِّد هذه السياسة نص المساعدة للعنصر (يُسمّى أحيانًا نص الوصف لعناصر التنسيق مثل ImageItems وPageBreakItems وSectionHeaderItems).

المعلمات

الاسم	النوع	الوصف
`text`	`String`	نص المساعدة الجديد

الإرجاع

ImageItem — ImageItem هذا، للسلسلة

التفويض

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

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setImage(image)`

لضبط الصورة نفسها.

المعلمات

الاسم	النوع	الوصف
`image`	`BlobSource`	بيانات الصورة

الإرجاع

ImageItem — ImageItem هذا، للسلسلة

التفويض

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

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setTitle(title)`

تضبط عنوان العنصر (يُسمّى أحيانًا نص العنوان، في حال استخدام SectionHeaderItem).

المعلمات

الاسم	النوع	الوصف
`title`	`String`	العنوان أو نص العنوان الجديد

الإرجاع

ImageItem — ImageItem هذا، للسلسلة

التفويض

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

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setWidth(width)`

لضبط عرض الصورة بالبكسل. يمكن ضبط عرض الصورة فقط. تم ضبط الارتفاع تلقائيًا للحفاظ على تناسب الصورة.

المعلمات

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

الإرجاع

ImageItem — ImageItem هذا، للسلسلة

التفويض

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

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms