本頁面由 Cloud Translation API 翻譯而成。

Class ImageItem

顯示圖片的版面配置項目。您可以透過 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);

方法

方法	傳回類型	簡短說明
`duplicate()`	`ImageItem`	建立此項目的副本，並附加至表單結尾。
`getAlignment()`	`Alignment`	取得圖片的水平對齊方式。
`getHelpText()`	`String`	取得項目的說明文字 (有時稱為版面配置項目的說明文字，例如 `ImageItems`、`PageBreakItems` 和 `SectionHeaderItems`)。
`getId()`	`Integer`	取得項目的專屬 ID。
`getImage()`	`Blob`	取得目前指派給項目的圖片。
`getIndex()`	`Integer`	取得表單中所有項目中的項目索引。
`getTitle()`	`String`	取得項目的標題 (在 `SectionHeaderItem` 的情況下，有時稱為標頭文字)。
`getType()`	`ItemType`	取得項目的類型，以 `ItemType` 表示。
`getWidth()`	`Integer`	取得圖片的寬度 (以像素為單位)。
`setAlignment(alignment)`	`ImageItem`	設定圖片的水平對齊方式。
`setHelpText(text)`	`ImageItem`	設定項目的說明文字 (對於 `ImageItems`、`PageBreakItems` 和 `SectionHeaderItems` 等版面配置項目，有時稱為說明文字)。
`setImage(image)`	`ImageItem`	設定圖片本身。
`setTitle(title)`	`ImageItem`	設定項目的標題 (在 `SectionHeaderItem` 的情況下，有時稱為標頭文字)。
`setWidth(width)`	`ImageItem`	設定圖片的寬度 (以像素為單位)。

內容詳盡的說明文件

`duplicate()`

建立此項目的副本，並附加至表單結尾。

回攻員

ImageItem：這個 ImageItem 的複本，用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getAlignment()`

取得圖片的水平對齊方式。

回攻員

Alignment - 水平對齊

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getHelpText()`

取得項目的說明文字 (有時稱為版面配置項目的說明文字，例如 ImageItems、PageBreakItems 和 SectionHeaderItems)。

回攻員

String：項目的說明文字或說明文字

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getId()`

取得項目的專屬 ID。

回攻員

Integer：商品 ID

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getImage()`

取得目前指派給項目的圖片。

回攻員

Blob：圖片資料

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getIndex()`

取得表單中所有項目中的項目索引。

回攻員

Integer：項目索引

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getTitle()`

取得項目的標題 (在 SectionHeaderItem 的情況下，有時稱為標頭文字)。

回攻員

String：項目的標題或標頭文字

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getType()`

取得項目的類型，以 ItemType 表示。

回攻員

ItemType：項目類型

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getWidth()`

取得圖片的寬度 (以像素為單位)。

回攻員

Integer：寬度 (以像素為單位)

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setAlignment(alignment)`

設定圖片的水平對齊方式。

參數

名稱	類型	說明
`alignment`	`Alignment`	水平對齊

回攻員

ImageItem — 這個 ImageItem，用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setHelpText(text)`

設定項目的說明文字 (對於 ImageItems、PageBreakItems 和 SectionHeaderItems 等版面配置項目，有時稱為說明文字)。

參數

名稱	類型	說明
`text`	`String`	新的說明文字

回攻員

ImageItem — 這個 ImageItem，用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setImage(image)`

設定圖片本身。

參數

名稱	類型	說明
`image`	`BlobSource`	圖片資料

回攻員

ImageItem — 這個 ImageItem，用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setTitle(title)`

設定項目的標題 (在 SectionHeaderItem 的情況下，有時稱為標頭文字)。

參數

名稱	類型	說明
`title`	`String`	新的標題或標頭文字

回攻員

ImageItem — 這個 ImageItem，用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setWidth(width)`

設定圖片的寬度 (以像素為單位)。只能設定圖片的寬度。系統會自動設定高度，以維持圖片的比例。

參數

名稱	類型	說明
`width`	`Integer`	寬度 (以像素為單位)

回攻員

ImageItem — 這個 ImageItem，用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms