Class ImageItem

ImageItem

A layout item that displays an image. Items can be accessed or created from a 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);
 

Methods

MethodReturn typeBrief description
duplicate()ImageItemCreates a copy of this item and appends it to the end of the form.
getAlignment()AlignmentGets the image's horizontal alignment.
getHelpText()StringGets the item's help text (sometimes called description text for layout items like ImageItems, PageBreakItems, and SectionHeaderItems).
getId()IntegerGets the item's unique identifier.
getImage()BlobGets the image that is currently assigned to the item.
getIndex()IntegerGets the index of the item among all the items in the form.
getTitle()StringGets the item's title (sometimes called header text, in the case of a SectionHeaderItem).
getType()ItemTypeGets the item's type, represented as an ItemType.
getWidth()IntegerGets the image's width in pixels.
setAlignment(alignment)ImageItemSets the image's horizontal alignment.
setHelpText(text)ImageItemSets the item's help text (sometimes called description text for layout items like ImageItems, PageBreakItems, and SectionHeaderItems).
setImage(image)ImageItemSets the image itself.
setTitle(title)ImageItemSets the item's title (sometimes called header text, in the case of a SectionHeaderItem).
setWidth(width)ImageItemSets the image's width in pixels.

Detailed documentation

duplicate()

Creates a copy of this item and appends it to the end of the form.

Return

ImageItem — a duplicate of this ImageItem, for chaining


getAlignment()

Gets the image's horizontal alignment.

Return

Alignment — the horizontal alignment


getHelpText()

Gets the item's help text (sometimes called description text for layout items like ImageItems, PageBreakItems, and SectionHeaderItems).

Return

String — the item's help text or description text


getId()

Gets the item's unique identifier.

Return

Integer — the item's ID


getImage()

Gets the image that is currently assigned to the item.

Return

Blob — the image data


getIndex()

Gets the index of the item among all the items in the form.

Return

Integer — the index of the item


getTitle()

Gets the item's title (sometimes called header text, in the case of a SectionHeaderItem).

Return

String — the item's title or header text


getType()

Gets the item's type, represented as an ItemType.

Return

ItemType — the item's type


getWidth()

Gets the image's width in pixels.

Return

Integer — the width in pixels


setAlignment(alignment)

Sets the image's horizontal alignment.

Parameters

NameTypeDescription
alignmentAlignmentthe horizontal alignment

Return

ImageItem — this ImageItem, for chaining


setHelpText(text)

Sets the item's help text (sometimes called description text for layout items like ImageItems, PageBreakItems, and SectionHeaderItems).

Parameters

NameTypeDescription
textStringthe new help text

Return

ImageItem — this ImageItem, for chaining


setImage(image)

Sets the image itself.

Parameters

NameTypeDescription
imageBlobSourcethe image data

Return

ImageItem — this ImageItem, for chaining


setTitle(title)

Sets the item's title (sometimes called header text, in the case of a SectionHeaderItem).

Parameters

NameTypeDescription
titleStringthe new title or header text

Return

ImageItem — this ImageItem, for chaining


setWidth(width)

Sets the image's width in pixels. Only the image's width can be set. Height is set automatically to maintain the image's proportions.

Parameters

NameTypeDescription
widthIntegerthe width in pixels

Return

ImageItem — this ImageItem, for chaining

发送以下问题的反馈:

此网页
Apps Script
Apps Script