Эта страница переведена с помощью Cloud Translation API.

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