Cette page a été traduite par l'API Cloud Translation.

Class ImageItem

Élément de mise en page qui affiche une image. Vous pouvez accéder aux éléments ou en créer depuis une 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);

Méthodes

Méthode	Type renvoyé	Brève description
`duplicate()`	`ImageItem`	Crée une copie de cet élément et l'ajoute à la fin du formulaire.
`getAlignment()`	`Alignment`	Récupère l'alignement horizontal de l'image.
`getHelpText()`	`String`	Récupère le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que `ImageItems`, `PageBreakItems` et `SectionHeaderItems`).
`getId()`	`Integer`	Récupère l'identifiant unique de l'article.
`getImage()`	`Blob`	Récupère l'image actuellement attribuée à l'élément.
`getIndex()`	`Integer`	Récupère l'index de l'élément parmi tous les éléments du formulaire.
`getTitle()`	`String`	Récupère le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'une `SectionHeaderItem`).
`getType()`	`ItemType`	Récupère le type de l'élément, représenté par `ItemType`.
`getWidth()`	`Integer`	Récupère la largeur de l'image en pixels.
`setAlignment(alignment)`	`ImageItem`	Définit l'alignement horizontal de l'image.
`setHelpText(text)`	`ImageItem`	Définit le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que `ImageItems`, `PageBreakItems` et `SectionHeaderItems`).
`setImage(image)`	`ImageItem`	Définit l'image elle-même.
`setTitle(title)`	`ImageItem`	Définit le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'une `SectionHeaderItem`).
`setWidth(width)`	`ImageItem`	Définit la largeur de l'image en pixels.

Documentation détaillée

`duplicate()`

Crée une copie de cet élément et l'ajoute à la fin du formulaire.

Renvois

ImageItem : doublon de ce ImageItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

`getAlignment()`

Récupère l'alignement horizontal de l'image.

Renvois

Alignment : alignement horizontal

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

`getHelpText()`

Récupère le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems, PageBreakItems et SectionHeaderItems).

Renvois

String : texte d'aide ou description de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

`getId()`

Récupère l'identifiant unique de l'article.

Renvois

Integer : ID de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

`getImage()`

Récupère l'image actuellement attribuée à l'élément.

Renvois

Blob : données d'image

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

`getIndex()`

Récupère l'index de l'élément parmi tous les éléments du formulaire.

Renvois

Integer : index de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

`getTitle()`

Récupère le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'une SectionHeaderItem).

Renvois

String : titre ou texte d'en-tête de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

`getType()`

Récupère le type de l'élément, représenté par ItemType.

Renvois

ItemType : type de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

`getWidth()`

Récupère la largeur de l'image en pixels.

Renvois

Integer : largeur en pixels

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

`setAlignment(alignment)`

Définit l'alignement horizontal de l'image.

Paramètres

Nom	Type	Description
`alignment`	`Alignment`	l'alignement horizontal

Renvois

ImageItem : cette ImageItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

`setHelpText(text)`

Définit le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems, PageBreakItems et SectionHeaderItems).

Paramètres

Nom	Type	Description
`text`	`String`	le nouveau texte d'aide

Renvois

ImageItem : cette ImageItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

`setImage(image)`

Définit l'image elle-même.

Paramètres

Nom	Type	Description
`image`	`BlobSource`	les données d'image

Renvois

ImageItem : cette ImageItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

`setTitle(title)`

Définit le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'une SectionHeaderItem).

Paramètres

Nom	Type	Description
`title`	`String`	le nouveau titre ou texte de l'en-tête

Renvois

ImageItem : cette ImageItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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

`setWidth(width)`

Définit la largeur de l'image en pixels. Seule la largeur de l'image peut être définie. La hauteur est définie automatiquement pour conserver les proportions de l'image.

Paramètres

Nom	Type	Description
`width`	`Integer`	la largeur en pixels

Renvois

ImageItem : cette ImageItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:

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