Um item de layout que exibe uma imagem. Os itens podem ser acessados ou criados em 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 atualmente atribuída ao item. |
getIndex() | Integer | Recebe o índice do item entre todos os itens do formulário. |
getTitle() | String | Recebe o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem). |
getType() | ItemType | Recebe o tipo do item, representado como um 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 do 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.
Retorno
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).
Retorno
String: o texto de ajuda ou de 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.
Retorno
Integer: 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.
Retorno
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).
Retorno
String: 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.
Retorno
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 |
Retorno
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 |
Retorno
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 |
Retorno
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 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 |
Retorno
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 da imagem.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
width | Integer | a largura em pixels |
Retorno
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