تمت ترجمة هذه الصفحة بواسطة 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)`

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

المَعلمات

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

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

ImageItem — جهاز ImageItem هذا للسلاسل

التفويض

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

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

`setHelpText(text)`

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

المَعلمات

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

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

ImageItem — جهاز ImageItem هذا للسلاسل

التفويض

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

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

`setImage(image)`

لتعيين الصورة نفسها.

المَعلمات

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

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

ImageItem — جهاز ImageItem هذا للسلاسل

التفويض

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

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

`setTitle(title)`

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

المَعلمات

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

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

ImageItem — جهاز ImageItem هذا للسلاسل

التفويض

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

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

`setWidth(width)`

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

المَعلمات

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

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

ImageItem — جهاز ImageItem هذا للسلاسل

التفويض

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

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