דף זה תורגם על ידי Cloud Translation API.

Class TextItem

פריט שאלה שמאפשר למשיב להזין שורת טקסט אחת. ניתן לגשת לפריטים או ליצור אותם מForm. בזמן השימוש בבוחן, הפריטים האלה מדורגים.

// Open a form by ID and add a new text item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addTextItem();
item.setTitle('What is your name?');

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`clearValidation()`	`TextItem`	מסיר אימות נתונים עבור פריט הטקסט הזה.
`createResponse(response)`	`ItemResponse`	יצירה של `ItemResponse` חדש לפריט הטקסט הזה.
`duplicate()`	`TextItem`	יצירת עותק של הפריט הזה וצירוף שלו לסוף הטופס.
`getGeneralFeedback()`	`QuizFeedback`	החזרה של המשוב שמוצג למשיבים כשהם משיבים לשאלה שניתן לדרג.
`getHelpText()`	`String`	קבלת טקסט עזרה של הפריט (שנקרא לפעמים טקסט תיאור של פריטי פריסה כמו `ImageItems`, `PageBreakItems` ו`SectionHeaderItems`).
`getId()`	`Integer`	מקבל את המזהה הייחודי של הפריט.
`getIndex()`	`Integer`	קבלת האינדקס של הפריט בין כל הפריטים בטופס.
`getPoints()`	`Integer`	מחזירה את ערך הנקודות של פריט הניתן לדירוג.
`getTitle()`	`String`	מקבל את הפריט של הפריט (נקרא לפעמים טקסט כותרת, במקרה של `SectionHeaderItem`).
`getType()`	`ItemType`	מזהה את סוג הפריט, מיוצג כ-`ItemType`.
`isRequired()`	`Boolean`	קובעת אם המשיב צריך לענות על השאלה.
`setGeneralFeedback(feedback)`	`TextItem`	מגדיר את המשוב שיוצג למשיבים כשהם יענו על שאלה בעלת ציון או שאין לה תשובה נכונה או שגויה (למשל, שאלות שדורשות ציון ידני).
`setHelpText(text)`	`TextItem`	מגדיר את טקסט העזרה של הפריט (הנקרא לפעמים טקסט תיאור עבור פריטי פריסה כמו `ImageItems`, `PageBreakItems` ו`SectionHeaderItems`).
`setPoints(points)`	`TextItem`	מגדירה את מספר הנקודות שפריט הניתן לדירוג שווה לו.
`setRequired(enabled)`	`TextItem`	הגדרה אם המשיב חייב לענות על השאלה.
`setTitle(title)`	`TextItem`	מגדיר את הכותרת של הפריט (שנקראת לפעמים טקסט כותרת, במקרה של `SectionHeaderItem`).
`setValidation(validation)`	`TextItem`	מגדיר את אימות הנתונים של פריט הטקסט הזה.

תיעוד מפורט

`clearValidation()`

מסיר אימות נתונים עבור פריט הטקסט הזה.

הלוך ושוב

TextItem — TextItem זה, לשרשור

הרשאה

סקריפטים שמשתמשים בשיטה זו מחייבים הרשאה באמצעות אחד או יותר מההיקפים הבאים:

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

`createResponse(response)`

יצירה של ItemResponse חדש לפריט הטקסט הזה.

פרמטרים

שם	סוג	תיאור
`response`	`String`	תשובה לשאלה של הפריט

הלוך ושוב

ItemResponse — התגובה של הפריט

הרשאה

סקריפטים שמשתמשים בשיטה זו מחייבים הרשאה באמצעות אחד או יותר מההיקפים הבאים:

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

`duplicate()`

יצירת עותק של הפריט הזה וצירוף שלו לסוף הטופס.

הלוך ושוב

TextItem — עותק משוכפל של TextItem זה, לשרשור

הרשאה

סקריפטים שמשתמשים בשיטה זו מחייבים הרשאה באמצעות אחד או יותר מההיקפים הבאים:

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

`getGeneralFeedback()`

החזרה של המשוב שמוצג למשיבים כשהם משיבים לשאלה שניתן לדרג.

הלוך ושוב

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

`setGeneralFeedback(feedback)`

מגדיר את המשוב שיוצג למשיבים כשהם יענו על שאלה בעלת ציון או שאין לה תשובה נכונה או שגויה (למשל, שאלות שדורשות ציון ידני).

פרמטרים

שם	סוג	תיאור
`feedback`	`QuizFeedback`	המשוב החדש

הלוך ושוב

TextItem — TextItem זה, לשרשור

הרשאה

סקריפטים שמשתמשים בשיטה זו מחייבים הרשאה באמצעות אחד או יותר מההיקפים הבאים:

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

`setHelpText(text)`

מגדיר את טקסט העזרה של הפריט (הנקרא לפעמים טקסט תיאור עבור פריטי פריסה כמו ImageItems, PageBreakItems וSectionHeaderItems).

פרמטרים

שם	סוג	תיאור
`text`	`String`	טקסט העזרה החדש

הלוך ושוב

TextItem — TextItem זה, לשרשור

הרשאה

סקריפטים שמשתמשים בשיטה זו מחייבים הרשאה באמצעות אחד או יותר מההיקפים הבאים:

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

`setPoints(points)`

מגדירה את מספר הנקודות שפריט הניתן לדירוג שווה לו. ערך ברירת המחדל של פריטים חדשים הוא 0.

פרמטרים

שם	סוג	תיאור
`points`	`Integer`	מספר הנקודות שפריט מסוים שווה

הלוך ושוב

TextItem — TextItem זה, לשרשור

הרשאה

סקריפטים שמשתמשים בשיטה זו מחייבים הרשאה באמצעות אחד או יותר מההיקפים הבאים:

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

`setRequired(enabled)`

הגדרה אם המשיב חייב לענות על השאלה.

פרמטרים

שם	סוג	תיאור
`enabled`	`Boolean`	אם המשיב חייב לענות על השאלה

הלוך ושוב

TextItem — הפריט הנוכחי (לשרשור)

הרשאה

סקריפטים שמשתמשים בשיטה זו מחייבים הרשאה באמצעות אחד או יותר מההיקפים הבאים:

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

`setTitle(title)`

מגדיר את הכותרת של הפריט (שנקראת לפעמים טקסט כותרת, במקרה של SectionHeaderItem).

פרמטרים

שם	סוג	תיאור
`title`	`String`	הטקסט החדש של הכותרת או הכותרת

הלוך ושוב

TextItem — TextItem זה, לשרשור

הרשאה

סקריפטים שמשתמשים בשיטה זו מחייבים הרשאה באמצעות אחד או יותר מההיקפים הבאים:

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

`setValidation(validation)`

מגדיר את אימות הנתונים של פריט הטקסט הזה. הזנת ערך null או אימות ללא פונקציות דורשות קריאה תסיר כל אימות קודם.

פרמטרים

שם	סוג	תיאור
`validation`	`TextValidation`	אימות טקסט שחל על הפריט הזה.

הלוך ושוב

TextItem — TextItem זה, לשרשור

הרשאה

סקריפטים שמשתמשים בשיטה זו מחייבים הרשאה באמצעות אחד או יותר מההיקפים הבאים:

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