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

Class ListItem

عنصر سؤال يسمح للمجيب بتحديد خيار واحد من القائمة المنسدلة. يمكن للعناصر يمكن الوصول إليها أو إنشاؤها من Form.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([
        item.createChoice('Cats'),
        item.createChoice('Dogs')
    ]);

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`createChoice(value)`	`Choice`	ينشئ خيارًا جديدًا.
`createChoice(value, isCorrect)`	`Choice`	ينشئ خيارًا جديدًا.
`createChoice(value, navigationItem)`	`Choice`	تنشئ خيارًا جديدًا يحتوي على خيار التنقّل في الصفحة الذي ينتقل إلى عنصر معيّن فاصل صفحات.
`createChoice(value, navigationType)`	`Choice`	ينشئ خيارًا جديدًا مع خيار التنقّل في الصفحة.
`createResponse(response)`	`ItemResponse`	تنشئ سمة `ItemResponse` جديدة لعنصر القائمة هذا.
`duplicate()`	`ListItem`	إنشاء نسخة من هذا العنصر وإلحاقها بنهاية النموذج
`getChoices()`	`Choice[]`	الحصول على جميع الخيارات لعنصر معيّن.
`getFeedbackForCorrect()`	`QuizFeedback`	تعرض الملاحظات التي تظهر للمستجيبين عند إجابتهم بشكل صحيح على سؤال.
`getFeedbackForIncorrect()`	`QuizFeedback`	إرجاع الملاحظات التي يتم عرضها للمستجيبين عندما أجابوا على سؤال بشكل غير صحيح.
`getHelpText()`	`String`	تحصل على نص المساعدة الخاص بالعنصر (يُسمّى أحيانًا نص الوصف لعناصر التنسيق مثل `ImageItems` و`PageBreakItems` و`SectionHeaderItems`).
`getId()`	`Integer`	الحصول على المعرّف الفريد للعنصر
`getIndex()`	`Integer`	الحصول على فهرس العنصر بين جميع العناصر في النموذج.
`getPoints()`	`Integer`	لعرض قيمة النقاط لعنصر قابل للدرجات.
`getTitle()`	`String`	يحصل على عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة استخدام `SectionHeaderItem`).
`getType()`	`ItemType`	تعرض هذه السمة نوع العنصر، ويتم تمثيله على أنّه `ItemType`.
`isRequired()`	`Boolean`	تحدد ما إذا كان يجب على المجيب الإجابة على السؤال.
`setChoiceValues(values)`	`ListItem`	تحدد الخيارات لعنصر من مصفوفة من السلاسل.
`setChoices(choices)`	`ListItem`	تحدّد هذه السمة مجموعة من الخيارات لعنصر معيّن.
`setFeedbackForCorrect(feedback)`	`ListItem`	لضبط الملاحظات التي يتم عرضها للمستجيبين عند إجابتهم بشكل صحيح على سؤال.
`setFeedbackForIncorrect(feedback)`	`ListItem`	لتعيين الملاحظات التي يتم عرضها للمستجيبين عندما يجيبون بشكل غير صحيح على سؤال.
`setHelpText(text)`	`ListItem`	تحدِّد هذه السياسة نص المساعدة للعنصر (يُسمّى أحيانًا نص الوصف لعناصر التنسيق مثل `ImageItems` و`PageBreakItems` و`SectionHeaderItems`).
`setPoints(points)`	`ListItem`	تحدد عدد النقاط التي يستحقها العنصر الذي يمكن وضع درجات له.
`setRequired(enabled)`	`ListItem`	تحدد ما إذا كان يجب على المجيب الإجابة على السؤال.
`setTitle(title)`	`ListItem`	تضبط عنوان العنصر (يُسمّى أحيانًا نص العنوان، في حال استخدام `SectionHeaderItem`).

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

`createChoice(value)`

ينشئ خيارًا جديدًا.

المعلمات

الاسم	النوع	الوصف
`value`	`String`	قيمة الخيار، والتي يراها المستجيبون كتصنيف عند عرض النموذج

الإرجاع

Choice: الخيار الجديد

التفويض

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

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

`createChoice(value, isCorrect)`

ينشئ خيارًا جديدًا.

المعلمات

الاسم	النوع	الوصف
`value`	`String`	قيمة الخيار، والتي يراها المستجيبون كتصنيف عند عرض النموذج
`isCorrect`	`Boolean`	ما إذا كان الخيار صحيحًا

الإرجاع

Choice: الخيار الجديد

التفويض

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

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

`createChoice(value, navigationItem)`

تنشئ خيارًا جديدًا يحتوي على خيار التنقّل في الصفحة الذي ينتقل إلى عنصر معيّن فاصل صفحات. هذا النمط تعادل createChoice(value, navigationType) مع ضبط navigationType على FormApp.PageNavigationType.GO_TO_PAGE. الخيارات التي تستخدم الصفحة لا يمكن دمج التنقل في العنصر نفسه مع الخيارات التي لا تستخدم التنقل في الصفحة.

يحدث التنقل في الصفحة بعد أن يكمل المشارك صفحة تحتوي على الخيار، وفقط إذا اختار المشارك هذا الخيار. إذا اختار المشارك خيارات متعددة باستخدام إرشادات التنقل في الصفحة في نفس الصفحة، يكون لخيار التنقل الأخير فقط أي تأثير. ولا يؤثر التنقّل في الصفحة أيضًا في الصفحة الأخيرة من النموذج.

المعلمات

الاسم	النوع	الوصف
`value`	`String`	قيمة الخيار، والتي يراها المستجيبون كتصنيف عند عرض النموذج
`navigationItem`	`PageBreakItem`	العنصر للانتقال إليه

الإرجاع

Choice: الخيار الجديد

التفويض

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

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

`createChoice(value, navigationType)`

ينشئ خيارًا جديدًا مع خيار التنقّل في الصفحة. لا يمكن تحديد الخيارات التي تستخدم التنقل عبر الصفحات يتم دمجها في العنصر نفسه مع الخيارات التي لا تستخدم التنقل في الصفحة.

المعلمات

الاسم	النوع	الوصف
`value`	`String`	قيمة الخيار، والتي يراها المستجيبون كتصنيف عند عرض النموذج
`navigationType`	`PageNavigationType`	نوع التنقّل الخاص بالاختيار

الإرجاع

Choice: الخيار الجديد

التفويض

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

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

`createResponse(response)`

تنشئ سمة ItemResponse جديدة لعنصر القائمة هذا. لعرض استثناء إذا لم تتطابق الوسيطة response مع اختيار صالح لهذا العنصر.

المعلمات

الاسم	النوع	الوصف
`response`	`String`	إجابة صالحة لعنصر القائمة هذا

الإرجاع

ItemResponse — الرد على العنصر

التفويض

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

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

`duplicate()`

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

الإرجاع

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

التفويض

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

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

`getChoices()`

الحصول على جميع الخيارات لعنصر معيّن.

الإرجاع

Choice[] — مجموعة من الخيارات

التفويض

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

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

`getFeedbackForCorrect()`

تعرض الملاحظات التي تظهر للمستجيبين عند إجابتهم بشكل صحيح على سؤال.

الإرجاع

QuizFeedback: الملاحظات، إن توفّرت

التفويض

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

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

`getFeedbackForIncorrect()`

إرجاع الملاحظات التي يتم عرضها للمستجيبين عندما أجابوا على سؤال بشكل غير صحيح.

الإرجاع

QuizFeedback: الملاحظات، إن توفّرت

التفويض

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

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

`getIndex()`

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

الإرجاع

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

التفويض

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

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

`getPoints()`

لعرض قيمة النقاط لعنصر قابل للدرجات.

الإرجاع

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

`isRequired()`

تحدد ما إذا كان يجب على المجيب الإجابة على السؤال.

الإرجاع

Boolean: ما إذا كان يجب على المجيب الإجابة عن السؤال

التفويض

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

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

`setChoiceValues(values)`

تحدد الخيارات لعنصر من مصفوفة من السلاسل. تعرض استثناء إذا كان الصفيف المحدد فارغ.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

المعلمات

الاسم	النوع	الوصف
`values`	`String[]`	مصفوفة قيم الاختيار، التي يراها المستجيبون كتصنيفات عند عرض النموذج

الإرجاع

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

التفويض

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

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

`setChoices(choices)`

تحدّد هذه السمة مجموعة من الخيارات لعنصر معيّن. لعرض استثناء إذا كان الصفيف المحدد فارغًا أو يحتوي على العنصر null.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?')
item.setChoices([
    item.createChoice('Cats'),
    item.createChoice('Dogs')
]);

المعلمات

الاسم	النوع	الوصف
`choices`	`Choice[]`	مصفوفة من الخيارات

الإرجاع

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

الرميات

Error: إذا كان الصفيف المحدَّد null أو فارغًا أو يحتوي على عنصر null

التفويض

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

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

`setFeedbackForCorrect(feedback)`

لضبط الملاحظات التي يتم عرضها للمستجيبين عند إجابتهم بشكل صحيح على سؤال.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false)]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());

المعلمات

الاسم	النوع	الوصف
`feedback`	`QuizFeedback`	الملاحظات الجديدة. وسيؤدي استخدام القيمة الفارغة إلى محو الملاحظات.

الإرجاع

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

التفويض

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

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

`setFeedbackForIncorrect(feedback)`

لتعيين الملاحظات التي يتم عرضها للمستجيبين عندما يجيبون بشكل غير صحيح على سؤال.

المعلمات

الاسم	النوع	الوصف
`feedback`	`QuizFeedback`	الملاحظات الجديدة

الإرجاع

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

التفويض

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

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

`setHelpText(text)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`setPoints(points)`

تحدد عدد النقاط التي يستحقها العنصر الذي يمكن وضع درجات له. القيمة التلقائية للعناصر الجديدة هي 0.

المعلمات

الاسم	النوع	الوصف
`points`	`Integer`	عدد النقاط التي يستحقها عنصر السؤال

الإرجاع

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

التفويض

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

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

`setRequired(enabled)`

تحدد ما إذا كان يجب على المجيب الإجابة على السؤال.

المعلمات

الاسم	النوع	الوصف
`enabled`	`Boolean`	لتحديد ما إذا كان يجب على المجيب الإجابة على السؤال

الإرجاع

ListItem — العنصر الحالي (للسلسلة)

التفويض

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

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

`setTitle(title)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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