Un elemento di domanda, presentato come griglia di colonne e righe, che consente al partecipante di selezionare più scelte per riga da una sequenza di caselle di controllo. È possibile accedere agli elementi o crearli da un
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 con caselle di controllo. |
duplicate() | CheckboxGridItem | Crea una copia di questo elemento e la aggiunge alla fine del modulo. |
getColumns() | String[] | Restituisce i valori per ogni colonna della griglia. |
getHelpText() | String | Recupera il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems , PageBreakItems e SectionHeaderItems ). |
getId() | Integer | Consente di acquisire l'identificatore univoco dell'elemento. |
getIndex() | Integer | Restituisce l'indice dell'elemento tra tutti gli elementi nel modulo. |
getRows() | String[] | Restituisce i valori per ogni riga della griglia. |
getTitle() | String | Consente di acquisire il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem ). |
getType() | ItemType | Restituisce il tipo di elemento, rappresentato come ItemType . |
isRequired() | Boolean | Stabilisce se l'intervistato deve rispondere alla domanda. |
setColumns(columns) | CheckboxGridItem | Imposta le colonne della griglia in base a una matrice 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 stabilire se l'intervistato deve rispondere alla domanda. |
setRows(rows) | CheckboxGridItem | Imposta le righe della griglia in base a una matrice di valori. |
setTitle(title) | CheckboxGridItem | Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem ). |
setValidation(validation) | CheckboxGridItem | Imposta la convalida dei dati per questo elemento della griglia della casella di controllo. |
Documentazione dettagliata
clearValidation()
Rimuove qualsiasi convalida dei dati per questo elemento della griglia.
Ritorni
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 con 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 sulla griglia con casella di controllo non obbligatoria
indica che non è stata data alcuna risposta alla riga. Genera un'eccezione se uno o più valori non corrisponde a una scelta valida.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
responses | String[][] | un array di array di risposte valide per questo elemento della griglia con caselle di controllo |
Ritorni
ItemResponse
: la risposta 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
duplicate()
Crea una copia di questo elemento e la aggiunge alla fine del modulo.
Ritorni
CheckboxGridItem
: duplicato di questo CheckboxGridItem
, 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
getColumns()
Restituisce i valori per ogni colonna della griglia.
Ritorni
String[]
: 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 della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems
, PageBreakItems
e SectionHeaderItems
).
Ritorni
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()
Consente di acquisire l'identificatore univoco dell'elemento.
Ritorni
Integer
: ID dell'articolo
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.
Ritorni
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()
Restituisce i valori per ogni riga della griglia.
Ritorni
String[]
: 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()
Consente di acquisire il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem
).
Ritorni
String
: testo dell'intestazione o del titolo 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
.
Ritorni
ItemType
: 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()
Stabilisce se l'intervistato deve rispondere alla domanda.
Ritorni
Boolean
: indica se la persona intervistata 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 una matrice di valori. Genera un'eccezione se l'array specificato è vuoto.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columns | String[] | un array di valori di colonna, che gli intervistati vedono come etichette quando visualizzano il modulo |
Ritorni
CheckboxGridItem
: questo elemento, per il concatenamento
Tiri
Error
: se l'array specificato è vuoto o null
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 |
Ritorni
CheckboxGridItem
: questo CheckboxGridItem
, 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
setRequired(enabled)
Consente di stabilire se l'intervistato deve rispondere alla domanda.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
enabled | Boolean | se l'intervistato deve rispondere alla domanda |
Ritorni
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 una matrice 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 |
Ritorni
CheckboxGridItem
: questo elemento, per il concatenamento
Tiri
Error
: se l'array specificato è vuoto o null
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 chiamato testo dell'intestazione, nel caso di SectionHeaderItem
).
Parametri
Nome | Tipo | Descrizione |
---|---|---|
title | String | il nuovo testo dell'intestazione o del titolo |
Ritorni
CheckboxGridItem
: questo CheckboxGridItem
, 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
setValidation(validation)
Imposta la convalida dei dati per questo elemento della griglia della casella di controllo. Se passi un valore null o una convalida senza funzioni richieste richiamate, qualsiasi convalida precedente viene rimossa.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
validation | CheckboxGridValidation | una casella di controlloGridValidation da applicare a questo elemento. |
Ritorni
CheckboxGridItem
: questo CheckboxGridItem
, 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