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

Metodo	Tipo restituito	Breve descrizione
clearValidation()	GridItem	Rimuove qualsiasi convalida dei dati per questo elemento della griglia.
createResponse(responses)	ItemResponse	Crea un nuovo ItemResponse per questo elemento della griglia.
duplicate()	GridItem	Crea una copia di questo elemento e la aggiunge alla fine del modulo.
getColumns()	String[]	Recupera i valori per ogni colonna della griglia.
getHelpText()	String	Recupera il testo della guida dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
getId()	Integer	Recupera l'identificatore univoco dell'elemento.
getIndex()	Integer	Restituisce l'indice dell'elemento tra tutti gli elementi del modulo.
getRows()	String[]	Recupera i valori per ogni riga della griglia.
getTitle()	String	Recupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
getType()	ItemType	Restituisce il tipo dell'elemento, rappresentato come ItemType.
isRequired()	Boolean	Determina se il rispondente deve rispondere alla domanda.
setColumns(columns)	GridItem	Imposta le colonne della griglia in base a un array di valori.
setHelpText(text)	GridItem	Imposta il testo di assistenza dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setRequired(enabled)	GridItem	Imposta se il rispondente deve rispondere alla domanda.
setRows(rows)	GridItem	Imposta le righe della griglia in base a un array di valori.
setTitle(title)	GridItem	Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
setValidation(validation)	GridItem	Imposta 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

Nome	Tipo	Descrizione
responses	String[]	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

Nome	Tipo	Descrizione
columns	String[]	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

Nome	Tipo	Descrizione
text	String	il 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

Nome	Tipo	Descrizione
enabled	Boolean	se 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

Nome	Tipo	Descrizione
rows	String[]	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

Nome	Tipo	Descrizione
title	String	il 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

Nome	Tipo	Descrizione
validation	GridValidation	un 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