Class CheckboxGridItem

CheckboxGridItem

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

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 con caselle di controllo.
duplicate()CheckboxGridItemCrea una copia di questo elemento e la aggiunge alla fine del modulo.
getColumns()String[]Restituisce i valori per ogni colonna della griglia.
getHelpText()StringRecupera il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
getId()IntegerConsente di acquisire l'identificatore univoco dell'elemento.
getIndex()IntegerRestituisce l'indice dell'elemento tra tutti gli elementi nel modulo.
getRows()String[]Restituisce i valori per ogni riga della griglia.
getTitle()StringConsente di acquisire il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem).
getType()ItemTypeRestituisce il tipo di elemento, rappresentato come ItemType.
isRequired()BooleanStabilisce se l'intervistato deve rispondere alla domanda.
setColumns(columns)CheckboxGridItemImposta le colonne della griglia in base a una matrice di valori.
setHelpText(text)CheckboxGridItemImposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setRequired(enabled)CheckboxGridItemConsente di stabilire se l'intervistato deve rispondere alla domanda.
setRows(rows)CheckboxGridItemImposta le righe della griglia in base a una matrice di valori.
setTitle(title)CheckboxGridItemImposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem).
setValidation(validation)CheckboxGridItemImposta 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

NomeTipoDescrizione
responsesString[][]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

NomeTipoDescrizione
columnsString[]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

NomeTipoDescrizione
textStringil 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

NomeTipoDescrizione
enabledBooleanse 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

NomeTipoDescrizione
rowsString[]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

NomeTipoDescrizione
titleStringil 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

NomeTipoDescrizione
validationCheckboxGridValidationuna 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