Un elemento a domanda che consente al partecipante di selezionare una o più caselle di controllo, nonché un campo "altro" facoltativo. È possibile accedere agli elementi o crearli da un Form
. Quando vengono utilizzati in un quiz, gli elementi vengono valutati automaticamente.
// Open a form by ID and add a new checkbox item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxItem(); item.setTitle('What condiments would you like on your hot dog?') .setChoices([ item.createChoice('Ketchup'), item.createChoice('Mustard'), item.createChoice('Relish') ]) .showOtherOption(true);
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
clearValidation() | CheckboxItem | Rimuove qualsiasi convalida dei dati per questo elemento della casella di controllo. |
createChoice(value) | Choice | Crea una nuova scelta. |
createChoice(value, isCorrect) | Choice | Crea una nuova scelta. |
createResponse(responses) | ItemResponse | Crea un nuovo ItemResponse per questo elemento con casella di controllo. |
duplicate() | CheckboxItem | Crea una copia di questo elemento e la aggiunge alla fine del modulo. |
getChoices() | Choice[] | Recupera tutte le opzioni disponibili per un elemento. |
getFeedbackForCorrect() | QuizFeedback | Restituisce il feedback che viene mostrato agli intervistati quando rispondono correttamente a una domanda. |
getFeedbackForIncorrect() | QuizFeedback | Restituisce il feedback che viene mostrato agli intervistati quando rispondono in modo errato a una domanda. |
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. |
getPoints() | Integer | Restituisce il valore in punti di un elemento valutabile. |
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 . |
hasOtherOption() | Boolean | Determina se l'elemento dispone di un'opzione di tipo "altro". |
isRequired() | Boolean | Stabilisce se l'intervistato deve rispondere alla domanda. |
setChoiceValues(values) | CheckboxItem | Consente di impostare le scelte per un elemento da un array di stringhe. |
setChoices(choices) | CheckboxItem | Consente di impostare un array di opzioni per un elemento. |
setFeedbackForCorrect(feedback) | CheckboxItem | Imposta il feedback da mostrare agli intervistati quando rispondono correttamente a una domanda. |
setFeedbackForIncorrect(feedback) | CheckboxItem | Imposta il feedback da mostrare agli intervistati quando rispondono in modo errato a una domanda. |
setHelpText(text) | CheckboxItem | Imposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems , PageBreakItems e SectionHeaderItems ). |
setPoints(points) | CheckboxItem | Imposta il numero di punti per il valore di un elemento valutabile. |
setRequired(enabled) | CheckboxItem | Consente di stabilire se l'intervistato deve rispondere alla domanda. |
setTitle(title) | CheckboxItem | Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem ). |
setValidation(validation) | CheckboxItem | Imposta la convalida dei dati per questo elemento della casella di controllo. |
showOtherOption(enabled) | CheckboxItem | Consente di impostare se l'elemento ha un'opzione "altro". |
Documentazione dettagliata
clearValidation()
Rimuove qualsiasi convalida dei dati per questo elemento della casella di controllo.
Ritorni
CheckboxItem
: questo CheckboxItem
, 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
createChoice(value)
Crea una nuova scelta.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
value | String | il valore della scelta, che gli intervistati vedono come etichetta quando visualizzano il modulo |
Ritorni
Choice
: la nuova scelta
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
createChoice(value, isCorrect)
Crea una nuova scelta.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
value | String | il valore della scelta, che gli intervistati vedono come etichetta quando visualizzano il modulo |
isCorrect | Boolean | se la risposta è corretta |
Ritorni
Choice
: la nuova scelta
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 con casella di controllo. L'argomento responses
è un array String[]
contenente valori che devono essere controllati. Genera un'eccezione se un valore non corrisponde a una scelta valida per questo elemento, a meno che showOtherOption(enabled)
non sia impostato su true
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
responses | String[] | un array di risposte valide per questo articolo a scelta multipla |
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
CheckboxItem
: duplicato di questo CheckboxItem
, 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
getChoices()
getFeedbackForCorrect()
Restituisce il feedback che viene mostrato agli intervistati quando rispondono correttamente a una domanda.
Ritorni
QuizFeedback
: feedback, se disponibile.
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
getFeedbackForIncorrect()
Restituisce il feedback che viene mostrato agli intervistati quando rispondono in modo errato a una domanda.
Ritorni
QuizFeedback
: feedback, se disponibile.
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
getPoints()
Restituisce il valore in punti di un elemento valutabile.
Ritorni
Integer
: il numero di punti di una 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
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
hasOtherOption()
Determina se l'elemento dispone di un'opzione di tipo "altro".
Ritorni
Boolean
: true
se l'elemento ha un'opzione di tipo "other"; in caso contrario false
.
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
setChoiceValues(values)
Consente di impostare le scelte per un elemento da un array di stringhe. Genera un'eccezione se l'array specificato è vuoto.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); item.setChoiceValues(['Dogs', 'Cats']);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
values | String[] | l'array di valori di scelta, che gli intervistati vedono come etichette quando visualizzano il modulo |
Ritorni
CheckboxItem
: questo CheckboxItem
, 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
setChoices(choices)
Consente di impostare un array di opzioni per un elemento. Genera un'eccezione se l'array specificato è vuoto o contiene un elemento null
.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?') item.setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
choices | Choice[] | una serie di opzioni |
Ritorni
CheckboxItem
: questo CheckboxItem
, per il concatenamento
Tiri
Error
: se l'array specificato è null
, vuoto o contiene un elemento 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
setFeedbackForCorrect(feedback)
Imposta il feedback da mostrare agli intervistati quando rispondono correttamente a una domanda.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); // Set "Dogs" as the correct answer to this question. item.setChoices([ item.createChoice('Dogs', true), item.createChoice('Cats', false)]); // Add feedback which will be shown for correct responses; ie "Dogs". item.setFeedbackForCorrect( FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
feedback | QuizFeedback | il nuovo feedback. Se il valore è null, il feedback verrà cancellato. |
Ritorni
CheckboxItem
: questo CheckboxItem
, 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
setFeedbackForIncorrect(feedback)
Imposta il feedback da mostrare agli intervistati quando rispondono in modo errato a una domanda.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
feedback | QuizFeedback | il nuovo feedback |
Ritorni
CheckboxItem
: questo CheckboxItem
, 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
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
CheckboxItem
: questo CheckboxItem
, 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
setPoints(points)
Imposta il numero di punti per il valore di un elemento valutabile. Il valore predefinito per i nuovi elementi è 0.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
points | Integer | il numero di punti di un elemento di domanda |
Ritorni
CheckboxItem
: questo CheckboxItem
, 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
CheckboxItem
: 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
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
CheckboxItem
: questo CheckboxItem
, 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 casella di controllo. Se si supera una convalida o si esegue una convalida senza che vengano richiamate funzioni, qualsiasi convalida precedente viene rimossa.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
validation | CheckboxValidation | una casella di controllo Convalida da applicare a questo elemento. |
Ritorni
CheckboxItem
: questo CheckboxItem
, 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
showOtherOption(enabled)
Consente di impostare se l'elemento ha un'opzione "altro". Il valore predefinito per un nuovo CheckboxItem
o
MultipleChoiceItem
è false
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
enabled | Boolean | true se l'elemento ha un'opzione di tipo "altro"; false in caso contrario |
Ritorni
CheckboxItem
: questo CheckboxItem
, 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