Questa pagina è stata tradotta dall'API Cloud Translation.

Interface Item

Un elemento modulo generico che contiene proprietà comuni a tutti gli elementi, come titolo e testo della guida. È possibile accedere o creare elementi da un Form.

Per intervenire su proprietà specifiche del tipo, usa getType() per controllare il valore ItemType dell'elemento, quindi trasmetti l'elemento al la classe appropriata con un metodo come asCheckboxItem().

// Create a new form and add a text item.
var form = FormApp.create('Form Name');
form.addTextItem();

// Access the text item as a generic item.
var items = form.getItems();
var item = items[0];

// Cast the generic item to the text-item class.
if (item.getType() == 'TEXT') {
  var textItem = item.asTextItem();
  textItem.setRequired(false);
}

Classi di implementazione

Nome	Breve descrizione

Metodi

Metodo	Tipo restituito	Breve descrizione
`asCheckboxGridItem()`	`CheckboxGridItem`	Restituisce l'elemento come elemento della griglia di caselle di controllo.
`asCheckboxItem()`	`CheckboxItem`	Restituisce l'elemento come elemento della casella di controllo.
`asDateItem()`	`DateItem`	Restituisce l'elemento come elemento di data.
`asDateTimeItem()`	`DateTimeItem`	Restituisce l'elemento come elemento con data e ora.
`asDurationItem()`	`DurationItem`	Restituisce l'elemento come elemento relativo alla durata.
`asGridItem()`	`GridItem`	Restituisce l'elemento come elemento della griglia.
`asImageItem()`	`ImageItem`	Restituisce l'elemento come elemento immagine.
`asListItem()`	`ListItem`	Restituisce l'elemento come elemento dell'elenco.
`asMultipleChoiceItem()`	`MultipleChoiceItem`	Restituisce l'elemento come elemento a scelta multipla.
`asPageBreakItem()`	`PageBreakItem`	Restituisce l'elemento come un'interruzione di pagina.
`asParagraphTextItem()`	`ParagraphTextItem`	Restituisce l'elemento come elemento di testo del paragrafo.
`asScaleItem()`	`ScaleItem`	Restituisce l'elemento come elemento di scala.
`asSectionHeaderItem()`	`SectionHeaderItem`	Restituisce l'elemento come elemento di intestazione della sezione.
`asTextItem()`	`TextItem`	Restituisce l'elemento come elemento di testo.
`asTimeItem()`	`TimeItem`	Restituisce l'elemento come elemento temporale.
`asVideoItem()`	`VideoItem`	Restituisce l'elemento come elemento video.
`duplicate()`	`Item`	Crea una copia di questo elemento e la aggiunge alla fine del modulo.
`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.
`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`.
`setHelpText(text)`	`Item`	Imposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come `ImageItems`, `PageBreakItems` e `SectionHeaderItems`).
`setTitle(title)`	`Item`	Imposta il titolo dell'elemento (a volte denominato testo dell'intestazione, nel caso di un `SectionHeaderItem`).

Documentazione dettagliata

`asCheckboxGridItem()`

Restituisce l'elemento come elemento della griglia di caselle di controllo. Genera un'eccezione di scripting se ItemType non era già CHECKBOX_GRID.

Invio

CheckboxGridItem: la voce della griglia della casella di controllo

Lanci

Error: se l'elemento non è una griglia con caselle di controllo

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

`asCheckboxItem()`

Restituisce l'elemento come elemento della casella di controllo. Genera un'eccezione di scripting se ItemType non era già CHECKBOX.

Invio

CheckboxItem: la voce della casella di controllo.

Lanci

Error: se l'elemento non è una casella di controllo

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

`asDateItem()`

Restituisce l'elemento come elemento di data. Genera un'eccezione di scripting se ItemType non era già DATE.

Invio

DateItem: la data

Lanci

Error: se l'elemento non è un elemento con data

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

`asDateTimeItem()`

Restituisce l'elemento come elemento con data e ora. Genera un'eccezione di scripting se ItemType non era già DATETIME.

Invio

DateTimeItem: la voce con data e ora.

Lanci

Error: se l'elemento non è un elemento con data e ora.

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

`asDurationItem()`

Restituisce l'elemento come elemento relativo alla durata. Genera un'eccezione di scripting se ItemType non era già DURATION.

Invio

DurationItem: l'elemento relativo alla durata

Lanci

Error: se l'elemento non è un elemento relativo alla durata

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

`asGridItem()`

Restituisce l'elemento come elemento della griglia. Genera un'eccezione di scripting se ItemType non era già GRID.

Invio

GridItem: l'elemento della griglia

Lanci

Error: se l'elemento non è un elemento della griglia

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

`asImageItem()`

Restituisce l'elemento come elemento immagine. Genera un'eccezione di scripting se ItemType non era già IMAGE.

Invio

ImageItem: l'elemento dell'immagine

Lanci

Error: se l'elemento non è un elemento immagine

`asListItem()`

Restituisce l'elemento come elemento dell'elenco. Genera un'eccezione di scripting se ItemType non era già LIST.

Invio

ListItem: la voce dell'elenco.

Lanci

Error: se l'elemento non è un elemento dell'elenco

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

`asMultipleChoiceItem()`

Restituisce l'elemento come elemento a scelta multipla. Genera un'eccezione di scripting se ItemType non era già MULTIPLE_CHOICE.

Invio

MultipleChoiceItem: l'elemento a scelta multipla

Lanci

Error: se l'elemento non è a scelta multipla

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

`asPageBreakItem()`

Restituisce l'elemento come un'interruzione di pagina. Genera un'eccezione di scripting se ItemType non era già PAGE_BREAK.

Invio

PageBreakItem: l'elemento dell'interruzione di pagina

Lanci

Error: se l'elemento non è un'interruzione di pagina.

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

`asParagraphTextItem()`

Restituisce l'elemento come elemento di testo del paragrafo. Genera un'eccezione di scripting se ItemType non era già PARAGRAPH_TEXT.

Invio

ParagraphTextItem: l'elemento di testo del paragrafo.

Lanci

Error: se l'elemento non è un elemento di testo del paragrafo.

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

`asScaleItem()`

Restituisce l'elemento come elemento di scala. Genera un'eccezione di scripting se ItemType non era già SCALE.

Invio

ScaleItem: l'elemento della bilancia

Lanci

Error: se l'elemento non è un elemento della bilancia

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

`asSectionHeaderItem()`

Restituisce l'elemento come elemento di intestazione della sezione. Genera un'eccezione di scripting se ItemType non era già SECTION_HEADER.

Invio

SectionHeaderItem: l'elemento dell'intestazione della sezione

Lanci

Error: se l'elemento non è un elemento di intestazione della sezione.

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

`asTextItem()`

Restituisce l'elemento come elemento di testo. Genera un'eccezione di scripting se ItemType non era già TEXT.

Invio

TextItem: l'elemento di testo

Lanci

Error: se l'elemento non è un elemento di testo.

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

`asTimeItem()`

Restituisce l'elemento come elemento temporale. Genera un'eccezione di scripting se ItemType non era già TIME.

Invio

TimeItem: l'elemento temporale

Lanci

Error: se l'elemento non è un elemento temporale

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

`asVideoItem()`

Restituisce l'elemento come elemento video. Genera un'eccezione di scripting se ItemType non era già VIDEO.

Invio

VideoItem: l'elemento video

Lanci

Error: se l'elemento non è un elemento video

`duplicate()`

Crea una copia di questo elemento e la aggiunge alla fine del modulo.

Invio

Item: un duplicato di questa Item, 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

`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

`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

`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

Item: Item, 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

`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

Item: Item, 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