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

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

المَعلمات

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

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

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

التفويض

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

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

`createChoice(value, isCorrect)`

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

المَعلمات

الاسم	Type	الوصف
`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. لا يمكن دمج الخيارات التي تستخدم التنقّل في الصفحة في العنصر نفسه مع الخيارات التي لا تستخدم التنقّل في الصفحة.

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

المَعلمات

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

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

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

التفويض

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

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

`createChoice(value, navigationType)`

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

المَعلمات

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

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

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

التفويض

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

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

`createResponse(response)`

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

المَعلمات

الاسم	Type	الوصف
`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']);

المَعلمات

الاسم	Type	الوصف
`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')
]);

المَعلمات

الاسم	Type	الوصف
`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());

المَعلمات

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

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

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

التفويض

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

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

`setFeedbackForIncorrect(feedback)`

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

المَعلمات

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

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

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

التفويض

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

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

`setHelpText(text)`

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

المَعلمات

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

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

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

التفويض

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

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

`setPoints(points)`

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

المَعلمات

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

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

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

التفويض

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

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

`setRequired(enabled)`

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

المَعلمات

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

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

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

التفويض

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

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

`setTitle(title)`

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

المَعلمات

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

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

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

التفويض

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

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