Class CheckboxGridItem

CheckboxGridItem

یک آیتم سوال که به صورت شبکه‌ای از ستون‌ها و ردیف‌ها ارائه می‌شود که به پاسخ‌دهنده اجازه می‌دهد چندین گزینه را در هر ردیف از یک دنباله چک باکس انتخاب کند. آیتم ها را می توان از یک 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()

نوع مورد را دریافت می کند که به صورت 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

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