Class ImageItem

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アイテムのヘルプ テキストを取得します(ImageItemsPageBreakItemsSectionHeaderItems などのレイアウト アイテムの説明テキストと呼ばれることもあります)。
getId()Integerアイテムの固有識別子を取得します。
getImage()Blob現在アイテムに割り当てられている画像を取得します。
getIndex()Integerフォーム内のすべてのアイテムの中で、アイテムのインデックスを取得します。
getTitle()Stringアイテムのタイトルを取得します(SectionHeaderItem の場合はヘッダー テキストと呼ばれることもあります)。
getType()ItemTypeItemType として表されるアイテムのタイプを取得します。
getWidth()Integer画像の幅をピクセル単位で取得します。
setAlignment(alignment)ImageItem画像の水平方向の配置を設定します。
setHelpText(text)ImageItemアイテムのヘルプテキスト(ImageItemsPageBreakItemsSectionHeaderItems などのレイアウト アイテムの説明テキストとも呼ばれます)を設定します。
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()

アイテムのヘルプ テキストを取得します(ImageItemsPageBreakItemsSectionHeaderItems などのレイアウト アイテムの説明テキストと呼ばれることもあります)。

戻る

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 - チェーン用の ImageItem

承認

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

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

setHelpText(text)

アイテムのヘルプテキスト(ImageItemsPageBreakItemsSectionHeaderItems などのレイアウト アイテムの説明テキストとも呼ばれます)を設定します。

パラメータ

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

戻る

ImageItem - チェーン用の ImageItem

承認

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

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

setImage(image)

画像自体を設定します。

パラメータ

名前タイプ説明
imageBlobSource画像データ

戻る

ImageItem - チェーン用の ImageItem

承認

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

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

setTitle(title)

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

パラメータ

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

戻る

ImageItem - チェーン用の ImageItem

承認

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

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

setWidth(width)

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

パラメータ

名前タイプ説明
widthInteger幅(ピクセル単位)

戻る

ImageItem - チェーン用の ImageItem

承認

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

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