Class GridItem

GridItem

Un elemento domanda, presentato come una griglia di colonne e righe, che consente all'intervistato di selezionare una scelta per riga da una sequenza di pulsanti di opzione. È possibile accedere o creare elementi da una Form. 

// Open a form by ID and add a new grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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 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()IntegerRestituisce l'identificatore univoco dell'elemento.
getIndex()IntegerRestituisce l'indice dell'elemento tra tutti gli elementi nel modulo.
getRows()String[]Recupera i valori per ogni riga della griglia.
getTitle()StringRestituisce il titolo dell'elemento (a volte denominato testo dell'intestazione, nel caso di un SectionHeaderItem).
getType()ItemTypeRestituisce il tipo di elemento, rappresentato come ItemType.
isRequired()BooleanDetermina se l'intervistato deve rispondere alla domanda.
setColumns(columns)GridItemImposta le colonne della griglia in base a un array di valori.
setHelpText(text)GridItemImposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setRequired(enabled)GridItemConsente di impostare se l'intervistato 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 denominato 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.

Invio

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 un numero di valori uguale al numero di righe nella griglia. Un elemento null per una domanda a griglia non obbligatoria indica nessuna risposta per quella riga. Lancia un'eccezione se uno o più valori non corrispondono a una scelta valida.

Parametri

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

Invio

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.

Invio

GridItem: un duplicato di questa GridItem, per il collegamento

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

Invio

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

Restituisce l'identificatore univoco dell'elemento.

Invio

Integer: l'ID 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

getIndex()

Restituisce l'indice dell'elemento tra tutti gli elementi nel 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 per ogni riga della griglia.

Invio

String[]: un 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()

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

Invio

String: testo del titolo o 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 di elemento, rappresentato come ItemType.

Invio

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 l'intervistato deve rispondere alla domanda.

Invio

Boolean: se l'intervistato 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 specificato è vuoto.

Parametri

NomeTipoDescrizione
columnsString[]un array di valori di colonna, che gli intervistati vedono come etichette quando visualizzano il modulo

Invio

GridItem: questo elemento, per il concatenamento

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

Invio

GridItem: GridItem, per 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 impostare se l'intervistato deve rispondere alla domanda.

Parametri

NomeTipoDescrizione
enabledBooleanse l'intervistato deve rispondere alla domanda

Invio

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

Invio

GridItem: questo elemento, per il concatenamento

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

Parametri

NomeTipoDescrizione
titleStringIl nuovo titolo o il nuovo testo dell'intestazione

Invio

GridItem: GridItem, per 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 un valore nullo o una convalida senza alcun richiedono funzioni richiamate, rimuoverà qualsiasi convalida precedente.

Parametri

NomeTipoDescrizione
validationGridValidatione verrà applicata una GridValidation a questo elemento.

Invio

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