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アイテムの一意の識別子を取得します。
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 の複製

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

getAlignment()

画像の水平方向の配置を取得します。

戻る

Alignment - 水平方向の配置

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

getHelpText()

アイテムのヘルプテキストを取得します（ImageItems、PageBreakItems、SectionHeaderItems などのレイアウト アイテムの説明テキストとも呼ばれます）。

戻る

String - アイテムのヘルプテキストまたは説明文

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

getId()

アイテムの一意の識別子を取得します。

戻る

Integer - アイテムの ID

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

getImage()

現在アイテムに割り当てられている画像を取得します。

戻る

Blob - 画像データ

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

getIndex()

フォーム内のすべてのアイテムの中で、アイテムのインデックスを取得します。

戻る

Integer - アイテムのインデックス

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

getTitle()

アイテムのタイトルを取得します（SectionHeaderItem の場合はヘッダー テキストと呼ばれることもあります）。

戻る

String - アイテムのタイトルまたはヘッダー テキスト

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

getType()

アイテムのタイプ（ItemType として表されます）を取得します。

戻る

ItemType - アイテムのタイプ

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

getWidth()

画像の幅（ピクセル単位）を取得します。

戻る

Integer - 幅（ピクセル単位）

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

setAlignment(alignment)

画像の水平方向の配置を設定します。

パラメータ

名前型説明
alignmentAlignment水平方向の配置

戻る

ImageItem - チェーン用の this ImageItem

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

setHelpText(text)

アイテムのヘルプテキスト（ImageItems、PageBreakItems、SectionHeaderItems などのレイアウト アイテムの説明テキスト）を設定します。

パラメータ

名前型説明
textString新しいヘルプテキスト

戻る

ImageItem - チェーン用の this ImageItem

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

setImage(image)

画像自体を設定します。

パラメータ

名前型説明
imageBlobSource画像データ

戻る

ImageItem - チェーン用の this ImageItem

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

setTitle(title)

アイテムのタイトル（SectionHeaderItem の場合はヘッダー テキスト）を設定します。

パラメータ

名前型説明
titleString新しいタイトルまたはヘッダー テキスト

戻る

ImageItem - チェーン用の this ImageItem

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

setWidth(width)

画像の幅をピクセル単位で設定します。設定できるのは画像の幅のみです。高さは、画像のアスペクト比を維持するように自動的に設定されます。

パラメータ

名前型説明
widthInteger幅（ピクセル）

戻る

ImageItem - チェーン用の this ImageItem

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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