Class CheckboxGridItem

آیتم گرید باکس

یک آیتم سوال که به صورت شبکه‌ای از ستون‌ها و ردیف‌ها ارائه می‌شود که به پاسخ‌دهنده اجازه می‌دهد چندین گزینه را در هر ردیف از یک دنباله چک باکس انتخاب کند. آیتم ها را می توان از یک Form مشاهده کرد یا ایجاد کرد. 

// Open a form by ID and add a new checkbox grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addCheckboxGridItem();
item.setTitle('Where did you celebrate New Years?')
    .setRows(['New York', 'San Francisco', 'London'])
    .setColumns(['2014', '2015', '2016', '2017']);

روش ها

روش نوع برگشت شرح مختصر
clear Validation() Checkbox Grid Item هر گونه اعتبارسنجی داده را برای این مورد شبکه حذف می کند.
create Response(responses) Item Response یک Item Response جدید برای این آیتم شبکه چک باکس ایجاد می کند.
duplicate() Checkbox Grid Item یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.
get Columns() String[] مقادیر هر ستون در شبکه را دریافت می کند.
get Help Text() String متن راهنمای مورد را دریافت می‌کند (گاهی اوقات متن توضیحات برای موارد طرح‌بندی مانند Image Items ، Page Break Items و Section Header Items نامیده می‌شود).
get Id() Integer شناسه منحصر به فرد مورد را دریافت می کند.
get Index() Integer نمایه مورد را از بین تمام موارد موجود در فرم دریافت می کند.
get Rows() String[] مقادیر هر سطر در شبکه را دریافت می کند.
get Title() String عنوان مورد را دریافت می کند (گاهی اوقات متن سرصفحه نامیده می شود، در مورد Section Header Item ).
get Type() Item Type نوع مورد را دریافت می کند که به عنوان یک Item Type نشان داده می شود.
is Required() Boolean تعیین می کند که آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر.
set Columns(columns) Checkbox Grid Item ستون های شبکه را بر اساس آرایه ای از مقادیر تنظیم می کند.
set Help Text(text) Checkbox Grid Item متن راهنمای مورد را تنظیم می‌کند (گاهی اوقات به آن متن توضیحات برای موارد طرح‌بندی مانند Image Items ، Page Break Items و Section Header Items گفته می‌شود).
set Required(enabled) Checkbox Grid Item تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر.
set Rows(rows) Checkbox Grid Item ردیف های شبکه را بر اساس آرایه ای از مقادیر تنظیم می کند.
set Title(title) Checkbox Grid Item عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد Section Header Item ).
set Validation(validation) Checkbox Grid Item اعتبار سنجی داده را برای این مورد شبکه چک باکس تنظیم می کند.

مستندات دقیق

clear Validation()

هر گونه اعتبارسنجی داده را برای این مورد شبکه حذف می کند.

بازگشت

Checkbox Grid Item - این مورد، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

create Response(responses)

یک Item Response جدید برای این آیتم شبکه چک باکس ایجاد می کند. responses آرگومان باید یک آرایه String[][] از آرایه‌ها باشد که به اندازه تعداد ورودی‌های شبکه چک باکس حاوی مقادیر باشد. یک عنصر null برای یک سوال شبکه چک باکس غیر ضروری نشان دهنده عدم پاسخ به آن سطر است. در صورتی که هر یک از مقادیر با یک انتخاب معتبر مطابقت نداشته باشد، یک استثنا ایجاد می کند.

پارامترها

نام تایپ کنید توضیحات
responses String[][] آرایه‌ای از آرایه‌هایی از پاسخ‌های معتبر برای این آیتم شبکه چک باکس

بازگشت

Item Response - پاسخ مورد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

duplicate()

یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.

بازگشت

Checkbox Grid Item - تکراری از این Checkbox Grid Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Columns()

مقادیر هر ستون در شبکه را دریافت می کند.

بازگشت

String[] - آرایه ای از مقادیر ستون، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان برچسب می بینند

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Help Text()

متن راهنمای مورد را دریافت می‌کند (گاهی اوقات متن توضیحات برای موارد طرح‌بندی مانند Image Items ، Page Break Items و Section Header Items نامیده می‌شود).

بازگشت

String - متن راهنمای مورد یا متن توضیحات

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Id()

شناسه منحصر به فرد مورد را دریافت می کند.

بازگشت

Integer - شناسه مورد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Index()

نمایه مورد را از بین تمام موارد موجود در فرم دریافت می کند.

بازگشت

Integer - شاخص مورد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Rows()

مقادیر هر سطر در شبکه را دریافت می کند.

بازگشت

String[] - آرایه ای از مقادیر ردیف، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان برچسب می بینند.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Title()

عنوان مورد را دریافت می کند (گاهی اوقات متن سرصفحه نامیده می شود، در مورد Section Header Item ).

بازگشت

String - عنوان یا متن سرصفحه مورد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Type()

نوع مورد را دریافت می کند که به عنوان یک Item Type نشان داده می شود.

بازگشت

Item Type - نوع مورد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

is Required()

تعیین می کند که آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر.

بازگشت

Boolean - آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Columns(columns)

ستون های شبکه را بر اساس آرایه ای از مقادیر تنظیم می کند. اگر آرایه داده شده خالی باشد، یک استثنا می اندازد.

پارامترها

نام تایپ کنید توضیحات
columns String[] آرایه ای از مقادیر ستون، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان برچسب می بینند

بازگشت

Checkbox Grid Item - این مورد، برای زنجیر کردن

پرتاب می کند

Error - اگر آرایه داده شده null یا خالی باشد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Help Text(text)

متن راهنمای مورد را تنظیم می‌کند (گاهی اوقات به آن متن توضیحات برای موارد طرح‌بندی مانند Image Items ، Page Break Items و Section Header Items گفته می‌شود).

پارامترها

نام تایپ کنید توضیحات
text String متن راهنما جدید

بازگشت

Checkbox Grid Item - این Checkbox Grid Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Required(enabled)

تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر.

پارامترها

نام تایپ کنید توضیحات
enabled Boolean آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر

بازگشت

Checkbox Grid Item - آیتم فعلی (برای زنجیره زدن)

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Rows(rows)

ردیف های شبکه را بر اساس آرایه ای از مقادیر تنظیم می کند. اگر آرایه داده شده خالی باشد، یک استثنا می اندازد.

پارامترها

نام تایپ کنید توضیحات
rows String[] آرایه ای از مقادیر ردیف، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان برچسب می بینند

بازگشت

Checkbox Grid Item - این مورد، برای زنجیر کردن

پرتاب می کند

Error - اگر آرایه داده شده null یا خالی باشد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Title(title)

عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد Section Header Item ).

پارامترها

نام تایپ کنید توضیحات
title String عنوان یا متن سرصفحه جدید

بازگشت

Checkbox Grid Item - این Checkbox Grid Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Validation(validation)

اعتبار سنجی داده را برای این مورد شبکه چک باکس تنظیم می کند. ارسال null یا اعتبارسنجی بدون نیاز به توابع فراخوانی شده، هرگونه اعتبارسنجی قبلی را حذف می کند.

پارامترها

نام تایپ کنید توضیحات
validation Checkbox Grid Validation یک CheckboxGridValidation برای اعمال به این مورد.

بازگشت

Checkbox Grid Item - این Checkbox Grid Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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