یک آیتم سوال که به صورت شبکهای از ستونها و ردیفها ارائه میشود که به پاسخدهنده اجازه میدهد چندین گزینه را در هر ردیف از یک دنباله چک باکس انتخاب کند. آیتم ها را می توان از یک Form
مشاهده کرد یا ایجاد کرد.
// Open a form by ID and add a new checkgox grid item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxGridItem(); item.setTitle('Where did you celebrate New Years?') .setRows(['New York', 'San Francisco', 'London']) .setColumns(['2014', '2015', '2016', '2017']);
مواد و روش ها
روش | نوع برگشت | توضیح مختصر |
---|---|---|
clearValidation() | CheckboxGridItem | هر گونه اعتبارسنجی داده را برای این مورد شبکه حذف می کند. |
createResponse(responses) | ItemResponse | یک ItemResponse جدید برای این آیتم شبکه چک باکس ایجاد می کند. |
duplicate() | CheckboxGridItem | یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند. |
getColumns() | String[] | مقادیر هر ستون در شبکه را دریافت می کند. |
getHelpText() | String | متن راهنمای مورد را دریافت میکند (گاهی اوقات متن توضیحات برای موارد طرحبندی مانند ImageItems ، PageBreakItems و SectionHeaderItems نامیده میشود). |
getId() | Integer | شناسه منحصر به فرد مورد را دریافت می کند. |
getIndex() | Integer | نمایه مورد را از بین تمام موارد موجود در فرم دریافت می کند. |
getRows() | String[] | مقادیر هر سطر در شبکه را دریافت می کند. |
getTitle() | String | عنوان مورد را دریافت می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد SectionHeaderItem ). |
getType() | ItemType | نوع مورد را دریافت می کند که به صورت ItemType نمایش داده می شود. |
isRequired() | Boolean | تعیین می کند که آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر. |
setColumns(columns) | CheckboxGridItem | ستون های شبکه را بر اساس آرایه ای از مقادیر تنظیم می کند. |
setHelpText(text) | CheckboxGridItem | متن راهنمای مورد را تنظیم میکند (گاهی اوقات متن توضیحات برای موارد طرحبندی مانند ImageItems ، PageBreakItems و SectionHeaderItems نامیده میشود). |
setRequired(enabled) | CheckboxGridItem | تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر. |
setRows(rows) | CheckboxGridItem | ردیف های شبکه را بر اساس آرایه ای از مقادیر تنظیم می کند. |
setTitle(title) | CheckboxGridItem | عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد SectionHeaderItem ). |
setValidation(validation) | CheckboxGridItem | اعتبار سنجی داده را برای این مورد شبکه چک باکس تنظیم می کند. |
مستندات دقیق
clearValidation()
هر گونه اعتبارسنجی داده را برای این مورد شبکه حذف می کند.
برگشت
CheckboxGridItem
- این مورد، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(responses)
یک ItemResponse
جدید برای این آیتم شبکه چک باکس ایجاد می کند. responses
آرگومان باید یک آرایه String[][]
از آرایهها باشد که به اندازه تعداد ورودیهای شبکه چک باکس حاوی مقادیر باشد. یک عنصر null
برای یک سوال شبکه چک باکس غیر ضروری نشان دهنده عدم پاسخ به آن سطر است. در صورتی که هر یک از مقادیر با یک انتخاب معتبر مطابقت نداشته باشد، یک استثنا ایجاد می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
responses | String[][] | آرایهای از آرایههای پاسخهای معتبر برای این آیتم شبکه چک باکس |
برگشت
ItemResponse
- پاسخ مورد
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.
برگشت
CheckboxGridItem
- تکراری از این CheckboxGridItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getColumns()
مقادیر هر ستون در شبکه را دریافت می کند.
برگشت
String[]
- آرایه ای از مقادیر ستون، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان برچسب می بینند
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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
getRows()
مقادیر هر سطر در شبکه را دریافت می کند.
برگشت
String[]
- آرایه ای از مقادیر ردیف، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان برچسب می بینند.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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()
isRequired()
تعیین می کند که آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر.
برگشت
Boolean
- آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setColumns(columns)
ستون های شبکه را بر اساس آرایه ای از مقادیر تنظیم می کند. اگر آرایه داده شده خالی باشد، یک استثنا می اندازد.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
columns | String[] | آرایه ای از مقادیر ستون، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان برچسب می بینند |
برگشت
CheckboxGridItem
- این مورد، برای زنجیر کردن
پرتاب می کند
Error
- اگر آرایه داده شده null
یا خالی باشد
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
متن راهنمای مورد را تنظیم میکند (گاهی اوقات متن توضیحات برای موارد طرحبندی مانند ImageItems
، PageBreakItems
و SectionHeaderItems
نامیده میشود).
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
text | String | متن راهنما جدید |
برگشت
CheckboxGridItem
- این CheckboxGridItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
enabled | Boolean | آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر |
برگشت
CheckboxGridItem
- مورد فعلی (برای زنجیره زدن)
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRows(rows)
ردیف های شبکه را بر اساس آرایه ای از مقادیر تنظیم می کند. اگر آرایه داده شده خالی باشد، یک استثنا می اندازد.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
rows | String[] | آرایه ای از مقادیر ردیف، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان برچسب می بینند |
برگشت
CheckboxGridItem
- این مورد، برای زنجیر کردن
پرتاب می کند
Error
- اگر آرایه داده شده null
یا خالی باشد
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد SectionHeaderItem
).
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
title | String | عنوان یا متن سرصفحه جدید |
برگشت
CheckboxGridItem
- این CheckboxGridItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
اعتبار سنجی داده را برای این مورد شبکه چک باکس تنظیم می کند. ارسال null یا اعتبارسنجی بدون نیاز به توابع فراخوانی شده، هرگونه اعتبارسنجی قبلی را حذف می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
validation | CheckboxGridValidation | یک CheckboxGridValidation برای اعمال به این مورد. |
برگشت
CheckboxGridItem
- این CheckboxGridItem
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms