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