Class GridItem

GridItem

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

// Open a form by ID and add a new grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addGridItem();
item.setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

روش ها

روش نوع برگشت شرح مختصر
clearValidation() GridItem هر گونه اعتبارسنجی داده را برای این مورد شبکه حذف می کند.
createResponse(responses) ItemResponse یک ItemResponse جدید برای این آیتم گرید ایجاد می کند.
duplicate() GridItem یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.
getColumns() String[] مقادیر هر ستون در شبکه را دریافت می کند.
getHelpText() String متن راهنمای مورد را دریافت می‌کند (گاهی اوقات متن توضیحات برای موارد طرح‌بندی مانند ImageItems ، PageBreakItems و SectionHeaderItems نامیده می‌شود).
getId() Integer شناسه منحصر به فرد مورد را دریافت می کند.
getIndex() Integer نمایه مورد را از بین تمام موارد موجود در فرم دریافت می کند.
getRows() String[] مقادیر هر سطر در شبکه را دریافت می کند.
getTitle() String عنوان مورد را دریافت می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد SectionHeaderItem ).
getType() ItemType نوع مورد را دریافت می کند که به صورت ItemType نمایش داده می شود.
isRequired() Boolean تعیین می کند که آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر.
setColumns(columns) GridItem ستون های شبکه را بر اساس آرایه ای از مقادیر تنظیم می کند.
setHelpText(text) GridItem متن راهنمای مورد را تنظیم می‌کند (گاهی اوقات متن توضیحات برای موارد طرح‌بندی مانند ImageItems ، PageBreakItems و SectionHeaderItems نامیده می‌شود).
setRequired(enabled) GridItem تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر.
setRows(rows) GridItem ردیف های شبکه را بر اساس آرایه ای از مقادیر تنظیم می کند.
setTitle(title) GridItem عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد SectionHeaderItem ).
setValidation(validation) GridItem اعتبار سنجی داده را برای این مورد شبکه تنظیم می کند.

مستندات دقیق

clearValidation()

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

بازگشت

GridItem - این مورد برای زنجیر کردن

مجوز

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

  • 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()

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

بازگشت

GridItem - تکراری از این GridItem ، برای زنجیر کردن

مجوز

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

  • 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[] آرایه ای از مقادیر ستون، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان برچسب می بینند

بازگشت

GridItem - این مورد برای زنجیر کردن

پرتاب می کند

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

مجوز

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

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

setHelpText(text)

متن راهنمای مورد را تنظیم می‌کند (گاهی اوقات متن توضیحات برای موارد طرح‌بندی مانند ImageItems ، PageBreakItems و SectionHeaderItems نامیده می‌شود).

پارامترها

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

بازگشت

GridItem - این GridItem ، برای زنجیر کردن

مجوز

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

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

setRequired(enabled)

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

پارامترها

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

بازگشت

GridItem - مورد فعلی (برای زنجیر کردن)

مجوز

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

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

setRows(rows)

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

پارامترها

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

بازگشت

GridItem - این مورد برای زنجیر کردن

پرتاب می کند

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

مجوز

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

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

setTitle(title)

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

پارامترها

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

بازگشت

GridItem - این GridItem ، برای زنجیر کردن

مجوز

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

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

setValidation(validation)

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

پارامترها

نام تایپ کنید توضیحات
validation GridValidation یک GridValidation برای اعمال به این مورد.

بازگشت

GridItem - این GridItem ، برای زنجیر کردن

مجوز

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

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