Class ParagraphTextItem

ParagrafoElementodi testo

Un elemento di domanda che consente al rispondente di inserire un blocco di testo. È possibile accedere agli elementi o crearli da un Form. Se utilizzati in un quiz, questi elementi vengono valutati.

// Open a form by ID and add a new paragraph text item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addParagraphTextItem();
item.setTitle('What is your address?');

Metodi

Metodo	Tipo restituito	Breve descrizione
clearValidation()	ParagraphTextItem	Rimuove qualsiasi convalida dei dati per questo elemento di testo del paragrafo.
createResponse(response)	ItemResponse	Crea un nuovo ItemResponse per questo elemento di testo del paragrafo.
duplicate()	ParagraphTextItem	Crea una copia di questo elemento e la aggiunge alla fine del modulo.
getGeneralFeedback()	QuizFeedback	Restituisce il feedback mostrato ai partecipanti quando rispondono a una domanda con voto.
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	Recupera l'identificatore univoco dell'elemento.
getIndex()	Integer	Recupera l'indice dell'elemento tra tutti gli elementi del modulo.
getPoints()	Integer	Restituisce il valore in punti di un elemento valutabile.
getTitle()	String	Recupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
getType()	ItemType	Recupera il tipo di elemento, rappresentato come ItemType.
isRequired()	Boolean	Determina se il rispondente deve rispondere alla domanda.
setGeneralFeedback(feedback)	ParagraphTextItem	Imposta il feedback da mostrare ai partecipanti quando rispondono a una domanda valutabile che non ha una risposta corretta o sbagliata (ad es. domande che richiedono la valutazione manuale).
setHelpText(text)	ParagraphTextItem	Imposta il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setPoints(points)	ParagraphTextItem	Imposta il numero di punti attribuiti a un elemento valutabile.
setRequired(enabled)	ParagraphTextItem	Imposta se il rispondente deve rispondere alla domanda.
setTitle(title)	ParagraphTextItem	Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
setValidation(validation)	ParagraphTextItem	Imposta la convalida dei dati per questo elemento di testo del paragrafo.

Documentazione dettagliata

clearValidation()

Rimuove qualsiasi convalida dei dati per questo elemento di testo del paragrafo.

Invio

ParagraphTextItem - questo ParagraphTextItem, per l'accodamento

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

Crea un nuovo ItemResponse per questo elemento di testo del paragrafo.

Parametri

Nome	Tipo	Descrizione
response	String	una risposta alla domanda posta dall'elemento

Invio

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.

Invio

ParagraphTextItem: un duplicato di questo ParagraphTextItem, per l'accodamento

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

---

getGeneralFeedback()

Restituisce il feedback mostrato ai partecipanti quando rispondono a una domanda con voto.

Invio

QuizFeedback: il feedback, se presente.

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: il testo della guida o della descrizione 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()

Recupera l'identificatore univoco dell'elemento.

Invio

Integer: l'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()

Recupera l'indice dell'elemento tra tutti gli elementi del 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

---

getPoints()

Restituisce il valore in punti di un elemento valutabile.

Invio

Integer: il numero di punti assegnati a una 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

---

getTitle()

Recupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).

Invio

String: il titolo o il testo dell'intestazione 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

---

getType()

Recupera il tipo di elemento, rappresentato come ItemType.

Invio

ItemType: il tipo di 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

---

isRequired()

Determina se il rispondente deve rispondere alla domanda.

Invio

Boolean: indica se il rispondente 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

---

setGeneralFeedback(feedback)

Imposta il feedback da mostrare ai partecipanti quando rispondono a una domanda valutabile che non ha una risposta corretta o sbagliata (ad es. domande che richiedono la valutazione manuale).

Parametri

Nome	Tipo	Descrizione
feedback	QuizFeedback	il nuovo feedback

Invio

ParagraphTextItem - questo ParagraphTextItem, per l'accodamento

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 di aiuto 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

ParagraphTextItem - questo ParagraphTextItem, per l'accodamento

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

---

setPoints(points)

Imposta il numero di punti attribuiti a un elemento valutabile. Il valore predefinito per i nuovi elementi è 0.

Parametri

Nome	Tipo	Descrizione
points	Integer	il numero di punti che vale un elemento della domanda

Invio

ParagraphTextItem - questo ParagraphTextItem, per l'accodamento

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)

Imposta se il rispondente deve rispondere alla domanda.

Parametri

Nome	Tipo	Descrizione
enabled	Boolean	se il rispondente deve rispondere alla domanda

Invio

ParagraphTextItem: l'elemento corrente (per l'accodamento)

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 un SectionHeaderItem).

Parametri

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

Invio

ParagraphTextItem - questo ParagraphTextItem, per l'accodamento

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 di testo del paragrafo. Se passi un valore null o una convalida senza chiamare funzioni require, verrà rimossa qualsiasi convalida precedente.

Parametri

Nome	Tipo	Descrizione
validation	ParagraphTextValidation	un'espressione ParagraphTextValidation da applicare a questo elemento.

Invio

ParagraphTextItem - questo ParagraphTextItem, per l'accodamento

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