Questa pagina è stata tradotta dall'API Cloud Translation.

Class GridItem

Un elemento di domanda, presentato come griglia di colonne e righe, che consente al partecipante 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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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[]`	Restituisce i valori per ogni colonna della griglia.
`getHelpText()`	`String`	Recupera il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come `ImageItems`, `PageBreakItems` e `SectionHeaderItems`).
`getId()`	`Integer`	Consente di acquisire l'identificatore univoco dell'elemento.
`getIndex()`	`Integer`	Restituisce l'indice dell'elemento tra tutti gli elementi nel modulo.
`getRows()`	`String[]`	Restituisce i valori per ogni riga della griglia.
`getTitle()`	`String`	Consente di acquisire il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di `SectionHeaderItem`).
`getType()`	`ItemType`	Restituisce il tipo di elemento, rappresentato come `ItemType`.
`isRequired()`	`Boolean`	Stabilisce se l'intervistato deve rispondere alla domanda.
`setColumns(columns)`	`GridItem`	Imposta le colonne della griglia in base a una matrice di valori.
`setHelpText(text)`	`GridItem`	Imposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come `ImageItems`, `PageBreakItems` e `SectionHeaderItems`).
`setRequired(enabled)`	`GridItem`	Consente di stabilire se l'intervistato deve rispondere alla domanda.
`setRows(rows)`	`GridItem`	Imposta le righe della griglia in base a una matrice di valori.
`setTitle(title)`	`GridItem`	Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di `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.

Ritorni

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 pari al numero di righe nella griglia. Un elemento null per una domanda sulla griglia 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

Nome	Tipo	Descrizione
`responses`	`String[]`	un array di risposte valide per questo elemento della griglia

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

GridItem: 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()`

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

Nome	Tipo	Descrizione
`columns`	`String[]`	un array di valori di colonna, che gli intervistati vedono come etichette quando visualizzano il modulo

Ritorni

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

Nome	Tipo	Descrizione
`text`	`String`	il nuovo testo della guida

Ritorni

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

Consente di stabilire se l'intervistato deve rispondere alla domanda.

Parametri

Nome	Tipo	Descrizione
`enabled`	`Boolean`	se l'intervistato deve rispondere alla domanda

Ritorni

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 una matrice di valori. Genera un'eccezione se l'array specificato è vuoto.

Parametri

Nome	Tipo	Descrizione
`rows`	`String[]`	un array di valori di riga, che gli intervistati vedono come etichette quando visualizzano il modulo

Ritorni

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

Nome	Tipo	Descrizione
`title`	`String`	il nuovo testo dell'intestazione o del titolo

Ritorni

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. Se si supera una convalida o si esegue una convalida senza che vengano richiamate funzioni, qualsiasi convalida precedente viene rimossa.

Parametri

Nome	Tipo	Descrizione
`validation`	`GridValidation`	un valore GridValidation da applicare a questo elemento.

Ritorni

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