Questa pagina è stata tradotta dall'API Cloud Translation.

Class 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

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 di ogni colonna della griglia.
`getHelpText()`	`String`	Recupera il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come `ImageItems`, `PageBreakItems` e `SectionHeaderItems`).
`getId()`	`Integer`	Restituisce l'identificatore univoco dell'elemento.
`getIndex()`	`Integer`	Restituisce l'indice dell'elemento tra tutti gli elementi nel modulo.
`getRows()`	`String[]`	Recupera i valori per ogni riga della griglia.
`getTitle()`	`String`	Restituisce il titolo dell'elemento (a volte denominato testo dell'intestazione, nel caso di un `SectionHeaderItem`).
`getType()`	`ItemType`	Restituisce il tipo di elemento, rappresentato come `ItemType`.
`isRequired()`	`Boolean`	Determina se l'intervistato 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 della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come `ImageItems`, `PageBreakItems` e `SectionHeaderItems`).
`setRequired(enabled)`	`GridItem`	Consente di impostare se l'intervistato 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 denominato 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.

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

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

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

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

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

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

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

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