Esta página foi traduzida pela API Cloud Translation.

Class CheckboxGridItem

Um item de pergunta, apresentado como uma grade de colunas e linhas, que permite ao entrevistado selecionar várias opções por linha em uma sequência de caixas de seleção. Os itens podem ser acessados ou criados com uma 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']);

Métodos

Método	Tipo de retorno	Breve descrição
`clearValidation()`	`CheckboxGridItem`	Remove qualquer validação de dados para este item de grade.
`createResponse(responses)`	`ItemResponse`	Cria um novo `ItemResponse` para esse item de grade da caixa de seleção.
`duplicate()`	`CheckboxGridItem`	Cria uma cópia desse item e a anexa ao final do formulário.
`getColumns()`	`String[]`	Recebe os valores de cada coluna da grade.
`getHelpText()`	`String`	Recebe o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como `ImageItems`, `PageBreakItems` e `SectionHeaderItems`).
`getId()`	`Integer`	Recebe o identificador exclusivo do item.
`getIndex()`	`Integer`	Recebe o índice do item entre todos os itens do formulário.
`getRows()`	`String[]`	Recebe os valores de cada linha da grade.
`getTitle()`	`String`	Recebe o título do item (às vezes chamado de texto do cabeçalho, no caso de um `SectionHeaderItem`).
`getType()`	`ItemType`	Recebe o tipo do item, representado como um `ItemType`.
`isRequired()`	`Boolean`	Determina se o entrevistado deve responder à pergunta.
`setColumns(columns)`	`CheckboxGridItem`	Define as colunas da grade com base em uma matriz de valores.
`setHelpText(text)`	`CheckboxGridItem`	Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como `ImageItems`, `PageBreakItems` e `SectionHeaderItems`).
`setRequired(enabled)`	`CheckboxGridItem`	Define se o respondente precisa responder à pergunta.
`setRows(rows)`	`CheckboxGridItem`	Define as linhas da grade com base em uma matriz de valores.
`setTitle(title)`	`CheckboxGridItem`	Define o título do item (às vezes chamado de texto do cabeçalho, no caso de um `SectionHeaderItem`).
`setValidation(validation)`	`CheckboxGridItem`	Define a validação de dados para este item de grade da caixa de seleção.

Documentação detalhada

`clearValidation()`

Remove qualquer validação de dados para este item de grade.

Retorno

CheckboxGridItem: este item para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`createResponse(responses)`

Cria um novo ItemResponse para esse item de grade da caixa de seleção. O argumento responses precisa ser uma matriz String[][] de matrizes contendo tantos valores quanto o número de entradas na grade da caixa de seleção. Um elemento null para uma pergunta de grade da caixa de seleção não obrigatória indica que não há resposta a essa linha. Uma exceção será gerada se algum dos valores não corresponder a uma escolha válida.

Parâmetros

Nome	Tipo	Descrição
`responses`	`String[][]`	uma matriz de matrizes de respostas válidas para este item de grade da caixa de seleção

Retorno

ItemResponse: a resposta do item

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`duplicate()`

Cria uma cópia desse item e a anexa ao final do formulário.

Retorno

CheckboxGridItem: uma cópia deste CheckboxGridItem, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getColumns()`

Recebe os valores de cada coluna da grade.

Retorno

String[]: uma matriz de valores de coluna, que os entrevistados veem como rótulos ao visualizar o formulário.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getHelpText()`

Recebe o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como ImageItems, PageBreakItems e SectionHeaderItems).

Retorno

String: o texto de ajuda ou de descrição do item

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getId()`

Recebe o identificador exclusivo do item.

Retorno

Integer: ID do item

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getIndex()`

Recebe o índice do item entre todos os itens do formulário.

Retorno

Integer: o índice do item

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getRows()`

Recebe os valores de cada linha da grade.

Retorno

String[]: uma matriz de valores de linha, que os entrevistados veem como rótulos ao visualizar o formulário.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getTitle()`

Recebe o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).

Retorno

String: título ou texto do cabeçalho do item.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getType()`

Recebe o tipo do item, representado como um ItemType.

Retorno

ItemType: o tipo do item

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`isRequired()`

Determina se o entrevistado deve responder à pergunta.

Retorno

Boolean: se o participante precisa responder à pergunta.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`setColumns(columns)`

Define as colunas da grade com base em uma matriz de valores. Lança uma exceção se a matriz fornecida estiver vazia.

Parâmetros

Nome	Tipo	Descrição
`columns`	`String[]`	Uma matriz de valores de coluna, que os entrevistados veem como rótulos ao visualizar o formulário

Retorno

CheckboxGridItem: este item para encadeamento.

Gera

Error: se a matriz fornecida for null ou estiver vazia.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`setHelpText(text)`

Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como ImageItems, PageBreakItems e SectionHeaderItems).

Parâmetros

Nome	Tipo	Descrição
`text`	`String`	o novo texto de ajuda

Retorno

CheckboxGridItem: este CheckboxGridItem, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`setRequired(enabled)`

Define se o respondente precisa responder à pergunta.

Parâmetros

Nome	Tipo	Descrição
`enabled`	`Boolean`	se o respondente deve responder à pergunta

Retorno

CheckboxGridItem: o item atual (para encadeamento).

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`setRows(rows)`

Define as linhas da grade com base em uma matriz de valores. Lança uma exceção se a matriz fornecida estiver vazia.

Parâmetros

Nome	Tipo	Descrição
`rows`	`String[]`	Uma matriz de valores de linha, que os entrevistados veem como rótulos ao visualizar o formulário

Retorno

CheckboxGridItem: este item para encadeamento.

Gera

Error: se a matriz fornecida for null ou estiver vazia.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`setTitle(title)`

Define o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).

Parâmetros

Nome	Tipo	Descrição
`title`	`String`	o novo título ou texto do cabeçalho

Retorno

CheckboxGridItem: este CheckboxGridItem, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`setValidation(validation)`

Define a validação de dados para este item de grade da caixa de seleção. Transmitir nulo ou uma validação sem qualquer função obrigatória chamada removerá qualquer validação anterior.

Parâmetros

Nome	Tipo	Descrição
`validation`	`CheckboxGridValidation`	uma CheckboxGridValidation para aplicar a este item.

Retorno

CheckboxGridItem: este CheckboxGridItem, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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