Class CheckboxItem

Elemento Casella di controllo

Un elemento della domanda che consente al rispondente di selezionare una o più caselle di controllo, nonché un campo "altro" facoltativo. È possibile accedere agli elementi o crearli da un Form. Se utilizzati in un quiz, questi elementi vengono valutati automaticamente. 

// Open a form by ID and add a new checkbox item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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

MetodoTipo restituitoBreve descrizione
clearValidation()CheckboxItemRimuove qualsiasi convalida dei dati per questo elemento della casella di controllo.
createChoice(value)ChoiceCrea una nuova scelta.
createChoice(value, isCorrect)ChoiceCrea una nuova scelta.
createResponse(responses)ItemResponseCrea un nuovo ItemResponse per questa casella di controllo.
duplicate()CheckboxItemCrea una copia di questo elemento e la aggiunge alla fine del modulo.
getChoices()Choice[]Recupera tutte le scelte per un elemento.
getFeedbackForCorrect()QuizFeedback|nullRestituisce il feedback mostrato ai partecipanti quando rispondono correttamente a una domanda.
getFeedbackForIncorrect()QuizFeedback|nullRestituisce il feedback mostrato ai rispondenti quando rispondono in modo errato a una domanda.
getHelpText()StringRecupera il testo della guida dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
getId()IntegerRecupera l'identificatore univoco dell'elemento.
getIndex()IntegerRestituisce l'indice dell'elemento tra tutti gli elementi del modulo.
getPoints()IntegerRestituisce il valore in punti di un elemento valutabile.
getTitle()StringRecupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
getType()ItemTypeRestituisce il tipo dell'elemento, rappresentato come ItemType.
hasOtherOption()BooleanDetermina se l'elemento ha un'opzione "Altro".
isRequired()BooleanDetermina se il rispondente deve rispondere alla domanda.
setChoiceValues(values)CheckboxItemImposta le scelte per un elemento da un array di stringhe.
setChoices(choices)CheckboxItemImposta un array di scelte per un elemento.
setFeedbackForCorrect(feedback)CheckboxItemImposta il feedback da mostrare ai partecipanti quando rispondono correttamente a una domanda.
setFeedbackForIncorrect(feedback)CheckboxItemImposta il feedback da mostrare ai rispondenti quando rispondono in modo errato a una domanda.
setHelpText(text)CheckboxItemImposta il testo di assistenza dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setPoints(points)CheckboxItemImposta il numero di punti che vale un elemento valutabile.
setRequired(enabled)CheckboxItemImposta se il rispondente deve rispondere alla domanda.
setTitle(title)CheckboxItemImposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
setValidation(validation)CheckboxItemImposta la convalida dei dati per questa casella di controllo.
showOtherOption(enabled)CheckboxItemImposta se l'elemento ha un'opzione "altro".

Documentazione dettagliata

clearValidation()

Rimuove qualsiasi convalida dei dati per questo elemento della casella di controllo.

Indietro

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

NomeTipoDescrizione
valueStringIl valore della scelta, che i rispondenti vedono come etichetta quando visualizzano il modulo.

Indietro

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

NomeTipoDescrizione
valueStringIl valore della scelta, che i rispondenti vedono come etichetta quando visualizzano il modulo.
isCorrectBooleanse la scelta è una risposta corretta

Indietro

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 questa casella di controllo. L'argomento responses è un array String[] contenente i valori da controllare. 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

NomeTipoDescrizione
responsesString[]un array di risposte valide per questa domanda a scelta multipla

Indietro

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.

Indietro

CheckboxItem: un 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()

Recupera tutte le scelte per un elemento.

Indietro

Choice[]: una gamma di scelte

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

getFeedbackForCorrect()

Restituisce il feedback mostrato ai partecipanti quando rispondono correttamente a una domanda.

Indietro

QuizFeedback|null: il feedback, se presente.

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 mostrato ai rispondenti quando rispondono in modo errato a una domanda.

Indietro

QuizFeedback|null: il feedback, se presente.

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 della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).

Indietro

String: il testo della guida o la descrizione 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()

Recupera l'identificatore univoco dell'elemento.

Indietro

Integer: l'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 del modulo.

Indietro

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.

Indietro

Integer: il numero di punti che vale 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()

Recupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).

Indietro

String: il titolo o il testo 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 dell'elemento, rappresentato come ItemType.

Indietro

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

hasOtherOption()

Determina se l'elemento ha un'opzione "Altro".

Indietro

Boolean - true se l'elemento ha un'opzione "altro"; false in caso contrario

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 il rispondente deve rispondere alla domanda.

Indietro

Boolean: indica se il rispondente 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)

Imposta 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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

Parametri

NomeTipoDescrizione
valuesString[]l'array di valori di scelta, che gli utenti che rispondono vedono come etichette quando visualizzano il modulo

Indietro

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)

Imposta un array di scelte 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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoices([item.createChoice('Cats'), item.createChoice('Dogs')]);

Parametri

NomeTipoDescrizione
choicesChoice[]una serie di scelte

Indietro

CheckboxItem: questo CheckboxItem, per il concatenamento

Genera

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 ai partecipanti quando rispondono correttamente a una domanda. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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

NomeTipoDescrizione
feedbackQuizFeedbackil nuovo feedback. Un valore nullo cancellerà il feedback.

Indietro

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 ai rispondenti quando rispondono in modo errato a una domanda.

Parametri

NomeTipoDescrizione
feedbackQuizFeedbackil nuovo feedback

Indietro

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 di assistenza dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).

Parametri

NomeTipoDescrizione
textStringil nuovo testo della guida

Indietro

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 che vale un elemento valutabile. Il valore predefinito per i nuovi elementi è 0.

Parametri

NomeTipoDescrizione
pointsIntegeril numero di punti che vale una domanda

Indietro

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)

Imposta se il rispondente deve rispondere alla domanda.

Parametri

NomeTipoDescrizione
enabledBooleanse il rispondente deve rispondere alla domanda

Indietro

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 un SectionHeaderItem).

Parametri

NomeTipoDescrizione
titleStringil nuovo testo del titolo o dell'intestazione

Indietro

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 questa casella di controllo. Il passaggio di null o di una convalida senza chiamare funzioni di convalida precedenti.

Parametri

NomeTipoDescrizione
validationCheckboxValidationun oggetto CheckboxValidation da applicare a questo elemento.

Indietro

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)

Imposta se l'elemento ha un'opzione "altro". Il valore predefinito per un nuovo CheckboxItem o MultipleChoiceItem è false.

Parametri

NomeTipoDescrizione
enabledBooleantrue se l'elemento ha un'opzione "altro"; false in caso contrario

Indietro

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