Class GridItem

Elemento griglia

Un elemento domanda, presentato come una griglia di colonne e righe, che consente al rispondente di selezionare una scelta per riga da una sequenza di pulsanti di opzione. È possibile accedere agli elementi o crearli da un Form. 

// Open a form by ID and add a new grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addGridItem();
item.setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

Metodi

MetodoTipo restituitoBreve descrizione
clearValidation()GridItemRimuove qualsiasi convalida dei dati per questo elemento della griglia.
createResponse(responses)ItemResponseCrea un nuovo ItemResponse per questo elemento della griglia.
duplicate()GridItemCrea una copia di questo elemento e la aggiunge alla fine del modulo.
getColumns()String[]Recupera i valori per ogni colonna della griglia.
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.
getRows()String[]Recupera i valori per ogni riga della griglia.
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.
isRequired()BooleanDetermina se il rispondente deve rispondere alla domanda.
setColumns(columns)GridItemImposta le colonne della griglia in base a un array di valori.
setHelpText(text)GridItemImposta il testo di assistenza dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setRequired(enabled)GridItemImposta se il rispondente deve rispondere alla domanda.
setRows(rows)GridItemImposta le righe della griglia in base a un array di valori.
setTitle(title)GridItemImposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
setValidation(validation)GridItemImposta la convalida dei dati per questo elemento della griglia.

Documentazione dettagliata

clearValidation()

Rimuove qualsiasi convalida dei dati per questo elemento della griglia.

Indietro

GridItem: 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. L'argomento responses deve essere un array String[] contenente tanti valori quante sono le righe della griglia. Un elemento null per una domanda nella griglia non obbligatoria indica che non è stata data alcuna risposta a quella riga. Genera un'eccezione se uno dei valori non corrisponde a una scelta valida.

Parametri

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

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

GridItem: un duplicato di questo GridItem, 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()

Recupera i valori per ogni colonna della griglia.

Indietro

String[]: un array di valori delle colonne, che i rispondenti 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 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

getRows()

Recupera i valori per ogni riga della griglia.

Indietro

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

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

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

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 delle colonne, che gli utenti che rispondono al modulo vedono come etichette quando visualizzano il modulo

Indietro

GridItem: questo elemento, per il concatenamento

Genera

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

GridItem: questo GridItem, 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

GridItem: 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 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 vedono come etichette quando visualizzano il modulo

Indietro

GridItem: questo elemento, per il concatenamento

Genera

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 testo del titolo o dell'intestazione

Indietro

GridItem: questo GridItem, 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. Il passaggio di null o di un'istanza GridValidation su cui non sono state chiamate funzioni di richiesta rimuove qualsiasi convalida precedente.

Parametri

NomeTipoDescrizione
validationGridValidationun GridValidation da applicare a questo elemento.

Indietro

GridItem: questo GridItem, 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