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 اعتبارسنجی داده‌ها را برای این آیتم شبکه‌ایِ چک‌باکس تنظیم می‌کند.

مستندات دقیق

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 یا اعتبارسنجی بدون فراخوانی هیچ تابع require، هرگونه اعتبارسنجی قبلی را حذف می‌کند.

پارامترها

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

بازگشت

CheckboxGridItem — این CheckboxGridItem برای زنجیره‌سازی

مجوز

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

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