É um item de layout que exibe uma imagem. Os itens podem ser acessados ou criados a partir de um Form
.
// Open a form by ID and add a new image item var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var img = UrlFetchApp.fetch('https://www.google.com/images/srpr/logo4w.png'); form.addImageItem() .setTitle('Google') .setHelpText('Google Logo') // The help text is the image description .setImage(img);
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
duplicate() | ImageItem | Cria uma cópia desse item e a anexa ao final do formulário. |
getAlignment() | Alignment | Recebe o alinhamento horizontal da imagem. |
getHelpText() | String | Recebe o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como ImageItems , PageBreakItems e SectionHeaderItems ). |
getId() | Integer | Recebe o identificador exclusivo do item. |
getImage() | Blob | Recebe a imagem que está atribuída ao item no momento. |
getIndex() | Integer | Acessa o índice do item entre todos os itens no formulário. |
getTitle() | String | Recebe o título do item (às vezes chamado de texto de cabeçalho, no caso de um SectionHeaderItem ). |
getType() | ItemType | Recebe o tipo do item, representado como ItemType . |
getWidth() | Integer | Recebe a largura da imagem em pixels. |
setAlignment(alignment) | ImageItem | Define o alinhamento horizontal da imagem. |
setHelpText(text) | ImageItem | Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como ImageItems , PageBreakItems e SectionHeaderItems ). |
setImage(image) | ImageItem | Define a própria imagem. |
setTitle(title) | ImageItem | Define o título do item (às vezes chamado de texto de cabeçalho, no caso de um SectionHeaderItem ). |
setWidth(width) | ImageItem | Define a largura da imagem em pixels. |
Documentação detalhada
duplicate()
Cria uma cópia desse item e a anexa ao final do formulário.
Retornar
ImageItem
: uma cópia deste ImageItem
, para encadeamento
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getAlignment()
getHelpText()
Recebe o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como ImageItems
, PageBreakItems
e SectionHeaderItems
).
Retornar
String
: o texto de ajuda ou descrição do item
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Recebe o identificador exclusivo do item.
Retornar
Integer
: o ID do item.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getImage()
getIndex()
Acessa o índice do item entre todos os itens no formulário.
Retornar
Integer
: o índice do item
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Recebe o título do item (às vezes chamado de texto de cabeçalho, no caso de um SectionHeaderItem
).
Retornar
String
: o título ou texto do cabeçalho do item
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
getWidth()
Recebe a largura da imagem em pixels.
Retornar
Integer
: a largura em pixels.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setAlignment(alignment)
Define o alinhamento horizontal da imagem.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
alignment | Alignment | o alinhamento horizontal |
Retornar
ImageItem
: este ImageItem
para encadeamento
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como ImageItems
, PageBreakItems
e SectionHeaderItems
).
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
text | String | o novo texto de ajuda |
Retornar
ImageItem
: este ImageItem
para encadeamento
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setImage(image)
Define a própria imagem.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
image | BlobSource | os dados da imagem |
Retornar
ImageItem
: este ImageItem
para encadeamento
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Define o título do item (às vezes chamado de texto de cabeçalho, no caso de um SectionHeaderItem
).
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
title | String | o novo título ou texto do cabeçalho |
Retornar
ImageItem
: este ImageItem
para encadeamento
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setWidth(width)
Define a largura da imagem em pixels. Somente a largura da imagem pode ser definida. A altura é definida automaticamente para manter as proporções de imagem.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
width | Integer | largura em pixels |
Retornar
ImageItem
: este ImageItem
para encadeamento
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms