Un elemento domanda, presentato come una griglia di colonne e righe, che consente all'intervistato di selezionare
più opzioni per riga da una sequenza di caselle di controllo. È possibile accedere o creare elementi da una
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']);
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
clearValidation() | CheckboxGridItem | Rimuove qualsiasi convalida dei dati per questo elemento della griglia. |
createResponse(responses) | ItemResponse | Crea un nuovo ItemResponse per questo elemento della griglia di caselle di controllo. |
duplicate() | CheckboxGridItem | Crea una copia di questo elemento e la aggiunge alla fine del modulo. |
getColumns() | String[] | Recupera i valori di ogni colonna della griglia. |
getHelpText() | String | Recupera il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems , PageBreakItems e SectionHeaderItems ). |
getId() | Integer | Restituisce l'identificatore univoco dell'elemento. |
getIndex() | Integer | Restituisce l'indice dell'elemento tra tutti gli elementi nel modulo. |
getRows() | String[] | Recupera i valori per ogni riga della griglia. |
getTitle() | String | Restituisce il titolo dell'elemento (a volte denominato testo dell'intestazione, nel caso di un SectionHeaderItem ). |
getType() | ItemType | Restituisce il tipo di elemento, rappresentato come ItemType . |
isRequired() | Boolean | Determina se l'intervistato deve rispondere alla domanda. |
setColumns(columns) | CheckboxGridItem | Imposta le colonne della griglia in base a un array di valori. |
setHelpText(text) | CheckboxGridItem | Imposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems , PageBreakItems e SectionHeaderItems ). |
setRequired(enabled) | CheckboxGridItem | Consente di impostare se l'intervistato deve rispondere alla domanda. |
setRows(rows) | CheckboxGridItem | Imposta le righe della griglia in base a un array di valori. |
setTitle(title) | CheckboxGridItem | Imposta il titolo dell'elemento (a volte denominato testo dell'intestazione, nel caso di un SectionHeaderItem ). |
setValidation(validation) | CheckboxGridItem | Imposta la convalida dei dati per questo elemento della griglia delle caselle di controllo. |
Documentazione dettagliata
clearValidation()
Rimuove qualsiasi convalida dei dati per questo elemento della griglia.
Invio
CheckboxGridItem
: questo elemento, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(responses)
Crea un nuovo ItemResponse
per questo elemento della griglia di caselle di controllo. L'argomento responses
deve essere un array String[][]
di array contenenti un numero di valori pari al numero di input
nella griglia delle caselle di controllo. Un elemento null
per una domanda nella griglia con casella di controllo non obbligatoria
indica nessuna risposta per quella riga. Genera un'eccezione se uno qualsiasi dei valori non corrisponde a
una scelta valida.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
responses | String[][] | un array di array di risposte valide per l'elemento della griglia di questa casella di controllo |
Invio
ItemResponse
: la risposta all'elemento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
Crea una copia di questo elemento e la aggiunge alla fine del modulo.
Invio
CheckboxGridItem
: un duplicato di questa CheckboxGridItem
, per il collegamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getColumns()
Recupera i valori di ogni colonna della griglia.
Invio
String[]
: un array di valori di colonna, che gli intervistati vedono come etichette quando visualizzano il modulo
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
Recupera il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems
, PageBreakItems
e SectionHeaderItems
).
Invio
String
: testo della guida o testo descrittivo dell'elemento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Restituisce l'identificatore univoco dell'elemento.
Invio
Integer
: l'ID dell'elemento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
Restituisce l'indice dell'elemento tra tutti gli elementi nel modulo.
Invio
Integer
: l'indice dell'elemento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getRows()
Recupera i valori per ogni riga della griglia.
Invio
String[]
: un array di valori di riga, che gli intervistati vedono come etichette quando visualizzano il modulo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Restituisce il titolo dell'elemento (a volte denominato testo dell'intestazione, nel caso di un SectionHeaderItem
).
Invio
String
: testo del titolo o dell'intestazione dell'elemento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
Restituisce il tipo di elemento, rappresentato come ItemType
.
Invio
ItemType
: il tipo di elemento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isRequired()
Determina se l'intervistato deve rispondere alla domanda.
Invio
Boolean
: se l'intervistato deve rispondere alla domanda
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setColumns(columns)
Imposta le colonne della griglia in base a un array di valori. Genera un'eccezione se specificato è vuoto.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columns | String[] | un array di valori di colonna, che gli intervistati vedono come etichette quando visualizzano il modulo |
Invio
CheckboxGridItem
: questo elemento, per il concatenamento
Lanci
Error
: se l'array specificato è null
o vuoto
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Imposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems
, PageBreakItems
e SectionHeaderItems
).
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | il nuovo testo della guida |
Invio
CheckboxGridItem
: CheckboxGridItem
, per concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
Consente di impostare se l'intervistato deve rispondere alla domanda.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
enabled | Boolean | se l'intervistato deve rispondere alla domanda |
Invio
CheckboxGridItem
: l'elemento corrente (per il concatenamento)
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRows(rows)
Imposta le righe della griglia in base a un array di valori. Genera un'eccezione se l'array specificato è vuoto.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rows | String[] | un array di valori di riga, che gli intervistati vedono come etichette quando visualizzano il modulo |
Invio
CheckboxGridItem
: questo elemento, per il concatenamento
Lanci
Error
: se l'array specificato è null
o vuoto
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Imposta il titolo dell'elemento (a volte denominato testo dell'intestazione, nel caso di un SectionHeaderItem
).
Parametri
Nome | Tipo | Descrizione |
---|---|---|
title | String | Il nuovo titolo o il nuovo testo dell'intestazione |
Invio
CheckboxGridItem
: CheckboxGridItem
, per concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
Imposta la convalida dei dati per questo elemento della griglia delle caselle di controllo. Il passaggio di un valore nullo o una convalida senza qualsiasi funzione di richiesta chiamata rimuoverà qualsiasi convalida precedente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
validation | CheckboxGridValidation | una casella di controlloGridValidation da applicare a questo elemento. |
Invio
CheckboxGridItem
: CheckboxGridItem
, per concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms