Ein Layout-Element, das ein Bild anzeigt. Elemente können über ein Form
aufgerufen oder erstellt werden.
// 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);
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
duplicate() | ImageItem | Erstellt eine Kopie dieses Elements und hängt es an das Ende des Formulars an. |
getAlignment() | Alignment | Ruft die horizontale Ausrichtung des Bilds ab. |
getHelpText() | String | Ruft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems , PageBreakItems und SectionHeaderItems bezeichnet. |
getId() | Integer | Ruft die eindeutige Kennung des Elements ab. |
getImage() | Blob | Ruft das Bild ab, das dem Element derzeit zugewiesen ist. |
getIndex() | Integer | Ruft den Index des Elements aus allen Elementen im Formular ab. |
getTitle() | String | Ruft den Titel des Elements ab. Dieser wird manchmal als Headertext bezeichnet, falls SectionHeaderItem . |
getType() | ItemType | Ruft den Elementtyp ab, dargestellt als ItemType . |
getWidth() | Integer | Ruft die Bildbreite in Pixeln ab. |
setAlignment(alignment) | ImageItem | Legt die horizontale Ausrichtung des Bilds fest. |
setHelpText(text) | ImageItem | Legt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems , PageBreakItems und SectionHeaderItems ). |
setImage(image) | ImageItem | Legt das Bild selbst fest. |
setTitle(title) | ImageItem | Legt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem ) |
setWidth(width) | ImageItem | Legt die Bildbreite in Pixeln fest. |
Detaillierte Dokumentation
duplicate()
Erstellt eine Kopie dieses Elements und hängt es an das Ende des Formulars an.
Zurücksenden
ImageItem
: ein Duplikat dieses ImageItem
, für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getAlignment()
Ruft die horizontale Ausrichtung des Bilds ab.
Zurücksenden
Alignment
: horizontale Ausrichtung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
Ruft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems
, PageBreakItems
und SectionHeaderItems
bezeichnet.
Zurücksenden
String
: der Hilfe- oder Beschreibungstext des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Ruft die eindeutige Kennung des Elements ab.
Zurücksenden
Integer
: die ID des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getImage()
Ruft das Bild ab, das dem Element derzeit zugewiesen ist.
Zurücksenden
Blob
: Die Bilddaten
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
Ruft den Index des Elements aus allen Elementen im Formular ab.
Zurücksenden
Integer
: Der Index des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Ruft den Titel des Elements ab. Dieser wird manchmal als Headertext bezeichnet, falls SectionHeaderItem
.
Zurücksenden
String
: Titel oder Titel des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
Ruft den Elementtyp ab, dargestellt als ItemType
.
Zurücksenden
ItemType
: Typ des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getWidth()
Ruft die Bildbreite in Pixeln ab.
Zurücksenden
Integer
: Breite in Pixeln
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setAlignment(alignment)
Legt die horizontale Ausrichtung des Bilds fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
alignment | Alignment | die horizontale Ausrichtung |
Zurücksenden
ImageItem
– dieser ImageItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Legt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems
, PageBreakItems
und SectionHeaderItems
).
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | den neuen Hilfetext |
Zurücksenden
ImageItem
– dieser ImageItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setImage(image)
Legt das Bild selbst fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
image | BlobSource | Bilddaten |
Zurücksenden
ImageItem
– dieser ImageItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Legt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem
)
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | den neuen Titel oder Titel |
Zurücksenden
ImageItem
– dieser ImageItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setWidth(width)
Legt die Bildbreite in Pixeln fest. Nur die Bildbreite kann festgelegt werden. Die Höhe wird automatisch festgelegt, um die Proportionen des Bilds aufrechtzuerhalten.
Parameter
Name | Typ | Beschreibung |
---|---|---|
width | Integer | die Breite in Pixeln |
Zurücksenden
ImageItem
– dieser ImageItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms