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