Questa pagina è stata tradotta dall'API Cloud Translation.

Class CheckboxItem

Un elemento di domanda che consente all'intervistato di selezionare una o più caselle di controllo, nonché un campo facoltativo "Altro". È 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

Metodo	Tipo restituito	Breve descrizione
`clearValidation()`	`CheckboxItem`	Rimuove qualsiasi convalida dei dati per questo elemento di 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 di casella di controllo.
`duplicate()`	`CheckboxItem`	Crea una copia di questo elemento e la aggiunge alla fine del modulo.
`getChoices()`	`Choice[]`	Recupera tutte le opzioni per un elemento.
`getFeedbackForCorrect()`	`QuizFeedback`	Restituisce il feedback mostrato ai partecipanti quando rispondono correttamente a una domanda.
`getFeedbackForIncorrect()`	`QuizFeedback`	Restituisce il feedback mostrato ai partecipanti quando rispondono erroneamente a una domanda.
`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`	Recupera l'identificatore univoco dell'elemento.
`getIndex()`	`Integer`	Recupera l'indice dell'elemento tra tutti gli elementi del modulo.
`getPoints()`	`Integer`	Restituisce il valore in punti di un elemento valutabile.
`getTitle()`	`String`	Recupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un `SectionHeaderItem`).
`getType()`	`ItemType`	Recupera il tipo di elemento, rappresentato come `ItemType`.
`hasOtherOption()`	`Boolean`	Determina se l'elemento ha un'opzione "Altro".
`isRequired()`	`Boolean`	Determina se il rispondente deve rispondere alla domanda.
`setChoiceValues(values)`	`CheckboxItem`	Imposta le opzioni per un elemento da un array di stringhe.
`setChoices(choices)`	`CheckboxItem`	Imposta un array di opzioni per un elemento.
`setFeedbackForCorrect(feedback)`	`CheckboxItem`	Imposta il feedback da mostrare ai partecipanti quando rispondono correttamente a una domanda.
`setFeedbackForIncorrect(feedback)`	`CheckboxItem`	Imposta il feedback da mostrare ai partecipanti quando rispondono in modo errato a una domanda.
`setHelpText(text)`	`CheckboxItem`	Imposta il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come `ImageItems`, `PageBreakItems` e `SectionHeaderItems`).
`setPoints(points)`	`CheckboxItem`	Imposta il numero di punti attribuiti a un elemento valutabile.
`setRequired(enabled)`	`CheckboxItem`	Imposta se il rispondente deve rispondere alla domanda.
`setTitle(title)`	`CheckboxItem`	Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un `SectionHeaderItem`).
`setValidation(validation)`	`CheckboxItem`	Imposta la convalida dei dati per questo elemento di casella di controllo.
`showOtherOption(enabled)`	`CheckboxItem`	Imposta se l'elemento ha un'opzione "Altro".

Documentazione dettagliata

`clearValidation()`

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

Invio

CheckboxItem - questo CheckboxItem, per l'accodamento

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 i rispondenti vedono come etichetta quando visualizzano il modulo

Invio

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 i rispondenti vedono come etichetta quando visualizzano il modulo
`isCorrect`	`Boolean`	se la scelta è una risposta corretta

Invio

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 di casella di controllo. L'argomento responses è un array String[] contenente i valori da controllare. Viene lanciata 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 elemento a scelta multipla

Invio

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.

Invio

CheckboxItem: un duplicato di questo CheckboxItem, per l'accodamento

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 opzioni per un elemento.

Invio

Choice[]: un array di opzioni

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.

Invio

QuizFeedback: 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 partecipanti quando rispondono erroneamente a una domanda.

Invio

QuizFeedback: 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 di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).

Invio

String: il testo della guida o della 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.

Invio

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

Recupera l'indice dell'elemento tra tutti gli elementi del 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

`getPoints()`

Restituisce il valore in punti di un elemento valutabile.

Invio

Integer: il numero di punti assegnati a 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).

Invio

String: il titolo o il testo dell'intestazione 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

`getType()`

Recupera il tipo di elemento, rappresentato come ItemType.

Invio

ItemType: il tipo di 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

`hasOtherOption()`

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

Invio

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.

Invio

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 opzioni 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

Nome	Tipo	Descrizione
`values`	`String[]`	l'array di valori di scelta, che gli utenti che rispondono al modulo vedono come etichette quando visualizzano il modulo

Invio

CheckboxItem - questo CheckboxItem, per l'accodamento

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 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.
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

Nome	Tipo	Descrizione
`choices`	`Choice[]`	un array di opzioni

Invio

CheckboxItem - questo CheckboxItem, per l'accodamento

Lanci

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

Nome	Tipo	Descrizione
`feedback`	`QuizFeedback`	il nuovo feedback. Un valore nullo cancella il feedback.

Invio

CheckboxItem - questo CheckboxItem, per l'accodamento

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

Parametri

Nome	Tipo	Descrizione
`feedback`	`QuizFeedback`	il nuovo feedback

Invio

CheckboxItem - questo CheckboxItem, per l'accodamento

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 aiuto 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

CheckboxItem - questo CheckboxItem, per l'accodamento

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

Parametri

Nome	Tipo	Descrizione
`points`	`Integer`	il numero di punti che vale un elemento della domanda

Invio

CheckboxItem - questo CheckboxItem, per l'accodamento

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

Nome	Tipo	Descrizione
`enabled`	`Boolean`	se il rispondente deve rispondere alla domanda

Invio

CheckboxItem: l'elemento corrente (per l'accodamento)

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

Nome	Tipo	Descrizione
`title`	`String`	il nuovo titolo o il nuovo testo dell'intestazione

Invio

CheckboxItem - questo CheckboxItem, per l'accodamento

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 di casella di controllo. Se passi un valore null o una convalida senza chiamare funzioni require, verrà rimossa qualsiasi convalida precedente.

Parametri

Nome	Tipo	Descrizione
`validation`	`CheckboxValidation`	un'espressione CheckboxValidation da applicare a questo elemento.

Invio

CheckboxItem - questo CheckboxItem, per l'accodamento

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

Nome	Tipo	Descrizione
`enabled`	`Boolean`	`true` se l'elemento ha un'opzione "Altro"; `false` in caso contrario

Invio

CheckboxItem - questo CheckboxItem, per l'accodamento

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