Um item de layout que mostra uma imagem. Os itens podem ser acessados ou criados em um Form.
// Open a form by ID and add a new image item const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const 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() | Image | Cria uma cópia deste item e a adiciona ao final do formulário. |
get | Alignment | Recebe o alinhamento horizontal da imagem. |
get | String | Recebe o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout como Image, Page e Section). |
get | Integer | Recebe o identificador exclusivo do item. |
get | Blob | Recebe a imagem atribuída ao item no momento. |
get | Integer | Recebe o índice do item entre todos os itens do formulário. |
get | String | Recebe o título do item (às vezes chamado de texto do cabeçalho, no caso de um Section). |
get | Item | Recebe o tipo do item, representado como um Item. |
get | Integer | Recebe a largura da imagem em pixels. |
set | Image | Define o alinhamento horizontal da imagem. |
set | Image | Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout como Image, Page e Section). |
set | Image | Define a própria imagem. |
set | Image | Define o título do item (às vezes chamado de texto do cabeçalho, no caso de um Section). |
set | Image | Define a largura da imagem em pixels. |
Documentação detalhada
duplicate()
Cria uma cópia deste item e a adiciona ao final do formulário.
Retornar
ImageItem: uma duplicata de 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 a 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()
Recebe o índice do item entre todos os itens do 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 do cabeçalho, no caso de um SectionHeaderItem).
Retornar
String: o título do item ou o texto do cabeçalho
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: 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: 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 | Blob | os dados de imagem |
Retornar
ImageItem: 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 do 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: 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. Apenas a largura da imagem pode ser definida. A altura é definida automaticamente para manter as proporções da imagem.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
width | Integer | a largura em pixels |
Retornar
ImageItem: 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