Questa pagina è stata tradotta dall'API Cloud Translation.

Interface Item

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

Per operare su proprietà specifiche per tipo, usa getType() per controllare il valore ItemType dell'elemento, poi trasmetti l'elemento alla classe appropriata usando 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);
}

Implementare le classi

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 di una casella di controllo.
`asDateItem()`	`DateItem`	Restituisce l'elemento come un elemento di data.
`asDateTimeItem()`	`DateTimeItem`	Restituisce l'elemento come elemento di data e ora.
`asDurationItem()`	`DurationItem`	Restituisce l'elemento come elemento di 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 di paragrafo.
`asScaleItem()`	`ScaleItem`	Restituisce l'elemento come un elemento della 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 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.
`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`.
`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 chiamato testo dell'intestazione, nel caso di `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.

Ritorni

CheckboxGridItem: la casella di controllo dell'elemento della griglia

Tiri

Error: se l'elemento non è una griglia con 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

`asCheckboxItem()`

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

Ritorni

CheckboxItem: l'elemento della casella di controllo

Tiri

Error: se l'elemento non è un elemento con 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 un elemento di data. Genera un'eccezione di scripting se ItemType non era già DATE.

Ritorni

DateItem: l'elemento della data

Tiri

Error: se l'elemento non è un elemento di 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 di data e ora. Genera un'eccezione di scripting se ItemType non era già DATETIME.

Ritorni

DateTimeItem: la voce relativa alla data e all'ora

Tiri

Error: se l'elemento non è di tipo 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 di durata. Genera un'eccezione di scripting se ItemType non era già DURATION.

Ritorni

DurationItem: l'elemento relativo alla durata

Tiri

Error: se l'elemento non è un elemento di 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.

Ritorni

GridItem: l'elemento della griglia

Tiri

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.

Ritorni

ImageItem: l'elemento immagine

Tiri

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.

Ritorni

ListItem: la voce dell'elenco

Tiri

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.

Ritorni

MultipleChoiceItem: l'articolo a scelta multipla

Tiri

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.

Ritorni

PageBreakItem: l'elemento di interruzione di pagina

Tiri

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 di paragrafo. Genera un'eccezione di scripting se ItemType non era già PARAGRAPH_TEXT.

Ritorni

ParagraphTextItem: l'elemento di testo paragrafo

Tiri

Error: se l'elemento non è un paragrafo 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

`asScaleItem()`

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

Ritorni

ScaleItem: l'elemento della bilancia

Tiri

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.

Ritorni

SectionHeaderItem: l'elemento intestazione della sezione

Tiri

Error: se l'elemento non è un elemento di intestazione di 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.

Ritorni

TextItem: l'elemento di testo

Tiri

Error: se l'elemento non è 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.

Ritorni

TimeItem: l'elemento dell'ora

Tiri

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.

Ritorni

VideoItem: l'elemento video

Tiri

Error: se l'elemento non è un elemento video.

`duplicate()`

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

Ritorni

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

`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

`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

`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

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

`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

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