Class 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