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