Class CheckboxGridItem

ElementoGrigliacon caselle di controllo

Un elemento della domanda, presentato come una griglia di colonne e righe, che consente al rispondente di selezionare più opzioni 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 checkbox grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addCheckboxGridItem();
item.setTitle('Where did you celebrate New Years?')
    .setRows(['New York', 'San Francisco', 'London'])
    .setColumns(['2014', '2015', '2016', '2017']);

Metodi

MetodoTipo restituitoBreve descrizione
clearValidation()CheckboxGridItemRimuove qualsiasi convalida dei dati per questo elemento della griglia.
createResponse(responses)ItemResponseCrea un nuovo ItemResponse per questo elemento della griglia di caselle di controllo.
duplicate()CheckboxGridItemCrea una copia di questo elemento e la aggiunge alla fine del modulo.
getColumns()String[]Recupera i valori di ogni colonna della griglia.
getHelpText()StringRecupera il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
getId()IntegerRecupera l'identificatore univoco dell'elemento.
getIndex()IntegerRecupera l'indice dell'elemento tra tutti gli elementi del modulo.
getRows()String[]Recupera i valori di ogni riga della griglia.
getTitle()StringRecupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
getType()ItemTypeRecupera il tipo di elemento, rappresentato come ItemType.
isRequired()BooleanDetermina se il rispondente deve rispondere alla domanda.
setColumns(columns)CheckboxGridItemImposta le colonne della griglia in base a un array di valori.
setHelpText(text)CheckboxGridItemImposta il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setRequired(enabled)CheckboxGridItemImposta se il rispondente deve rispondere alla domanda.
setRows(rows)CheckboxGridItemImposta le righe della griglia in base a un array di valori.
setTitle(title)CheckboxGridItemImposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
setValidation(validation)CheckboxGridItemImposta la convalida dei dati per questo elemento della griglia di caselle di controllo.

Documentazione dettagliata

clearValidation()

Rimuove qualsiasi convalida dei dati per questo elemento della griglia.

Invio

CheckboxGridItem: questo elemento, 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

createResponse(responses)

Crea un nuovo ItemResponse per questo elemento della griglia di caselle di controllo. L'argomento responses deve essere un array di array String[][] contenente tanti valori quanti sono gli input nella griglia di caselle di controllo. Un elemento null per una domanda con griglia di caselle di controllo facoltativa indica che non è stata fornita alcuna risposta per quella riga. Genera un'eccezione se uno dei valori non corrisponde a una scelta valida.

Parametri

NomeTipoDescrizione
responsesString[][]un array di array di risposte valide per questo elemento della griglia di caselle di controllo

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

CheckboxGridItem: un duplicato di questo CheckboxGridItem, 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

getColumns()

Recupera i valori di ogni colonna della griglia.

Invio

String[]: un array di valori di colonna, che i partecipanti al sondaggio visualizzano 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: 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

getRows()

Recupera i valori di ogni riga della griglia.

Invio

String[]: un array di valori di riga, che i partecipanti 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()

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

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

setColumns(columns)

Imposta le colonne della griglia in base a un array di valori. Genera un'eccezione se l'array specificato è vuoto.

Parametri

NomeTipoDescrizione
columnsString[]un array di valori di colonna, che gli utenti che rispondono al modulo visualizzano come etichette

Invio

CheckboxGridItem: questo elemento, per l'accodamento

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

Parametri

NomeTipoDescrizione
textStringil nuovo testo della guida

Invio

CheckboxGridItem - questo CheckboxGridItem, 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

NomeTipoDescrizione
enabledBooleanse il rispondente deve rispondere alla domanda

Invio

CheckboxGridItem: 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

setRows(rows)

Imposta le righe della griglia in base a un array di valori. Genera un'eccezione se l'array specificato è vuoto.

Parametri

NomeTipoDescrizione
rowsString[]un array di valori di riga, che gli utenti che rispondono al modulo visualizzano come etichette quando visualizzano il modulo

Invio

CheckboxGridItem: questo elemento, per l'accodamento

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 chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).

Parametri

NomeTipoDescrizione
titleStringil nuovo titolo o il nuovo testo dell'intestazione

Invio

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

Parametri

NomeTipoDescrizione
validationCheckboxGridValidationun controllo di convalida della griglia di caselle di controllo da applicare a questo elemento.

Invio

CheckboxGridItem - questo CheckboxGridItem, 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