Esta página foi traduzida pela API Cloud Translation.

Class ImageItem

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()`	`ImageItem`	Cria uma cópia do 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`	Consegue o índice do item entre todos os itens no formulário.
`getTitle()`	`String`	Extrai 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 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 do item e a anexa ao final do formulário.

Retornar

ImageItem: uma cópia desta 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()`

Recebe o alinhamento horizontal da imagem.

Retornar

Alignment: o alinhamento horizontal

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

`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 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.

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

Recebe a imagem atualmente atribuída ao item.

Retornar

Blob: os dados da imagem

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

`getIndex()`

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

Extrai o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).

Retornar

String: o título ou o 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()`

Recebe o tipo do item, representado como um ItemType.

Retornar

ItemType: o tipo 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

`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 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 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: 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. Só é possível definir a largura da imagem. 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: 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