Représente une image à ajouter à une cellule. Pour ajouter une image à une cellule, vous devez créer une valeur d'image pour cette image en utilisant SpreadsheetApp.newCellImage() et CellImageBuilder. Vous pouvez ensuite utiliser Range.setValue(value) ou Range.setValues(values) pour ajouter la valeur de l'image à la cellule.
Propriétés
| Propriété | Type | Description |
|---|---|---|
valueType | ValueType | Champ défini sur ValueType.IMAGE, représentant le type de valeur d'image. |
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
getAltTextDescription() | String | Renvoie la description du texte alternatif pour cette image. |
getAltTextTitle() | String | Affiche le titre du texte alternatif pour cette image. |
getContentUrl() | String | Renvoie à l'image une URL hébergée par Google. |
getUrl() | String | Récupère l'URL source de l'image. Renvoie null si l'URL n'est pas disponible. |
toBuilder() | CellImageBuilder | Crée un compilateur qui transforme une image en type de valeur d'image afin de pouvoir la placer dans une cellule. |
Documentation détaillée
getAltTextDescription()
Renvoie la description du texte alternatif pour cette image.
Aller-retour
String : description du texte alternatif.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getAltTextTitle()
Affiche le titre du texte alternatif pour cette image.
Aller-retour
String : titre du texte alternatif.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getContentUrl()
Renvoie à l'image une URL hébergée par Google. Cette URL est taguée avec le compte du demandeur, de sorte que toute personne disposant de l'URL accède efficacement à l'image en tant que demandeur initial. L'accès à l'image peut être perdu si les paramètres de partage de la feuille de calcul changent. L'URL renvoyée expire dans un court laps de temps.
Aller-retour
String : URL de l'image, hébergée par Google.
getUrl()
Récupère l'URL source de l'image. Renvoie null si l'URL n'est pas disponible. Si l'image a été insérée via une API à l'aide d'une API, cette méthode renvoie l'URL fournie lors de l'insertion de l'image.
Aller-retour
String : URL de l'image si celle-ci est disponible. Renvoie null si l'image n'est pas disponible ou ne possède pas d'URL source.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
toBuilder()
Crée un compilateur qui transforme une image en type de valeur d'image afin de pouvoir la placer dans une cellule. Avant de placer une image dans une cellule, vous devez la créer en tant que type de valeur d'image.
Vous pouvez ensuite l'ajouter à une cellule en utilisant Range.setValue(value) ou Range.setValues(values).
Aller-retour
CellImageBuilder : compilateur qui crée un type de valeur d'image en fonction des propriétés d'image fournies.