Représente une image à ajouter à une cellule. Pour ajouter une image à une cellule, vous devez créer une valeur d'image pour l'image à l'aide de SpreadsheetApp.newCellImage() et de 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, qui représente le type de valeur de l'image. |
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
getAltTextDescription() | String | Affiche la description du texte alternatif de cette image. |
getAltTextTitle() | String | Renvoie le titre en texte alternatif de cette image. |
getContentUrl() | String | Renvoie une URL hébergée par Google vers l'image. |
getUrl() | String | Récupère l'URL source de l'image et renvoie null si l'URL n'est pas disponible. |
toBuilder() | CellImageBuilder | Crée un compilateur qui transforme une image en un type de valeur d'image afin que vous puissiez la placer dans une cellule. |
Documentation détaillée
getAltTextDescription()
Affiche la description du texte alternatif de cette image.
Renvois
String : description du texte alternatif.
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/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getAltTextTitle()
Renvoie le titre en texte alternatif de cette image.
Renvois
String : titre du texte alternatif.
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/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getContentUrl()
Renvoie une URL hébergée par Google vers l'image. Cette URL est taguée avec le compte du demandeur, de sorte que toute personne disposant de l'URL accède à l'image en tant que demandeur d'origine. 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 après une courte période.
Renvois
String : URL de l'image hébergée par Google.
getUrl()
Récupère l'URL source de l'image et renvoie null si l'URL n'est pas disponible. Si l'image a été insérée via une URL à l'aide d'une API, cette méthode renvoie l'URL fournie lors de l'insertion de l'image.
Renvois
String : URL de l'image si disponible. Renvoie null si l'image n'est pas disponible ou si elle n'a pas d'URL source.
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/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
toBuilder()
Crée un compilateur qui transforme une image en un type de valeur d'image afin que vous puissiez la placer dans une cellule. Avant de pouvoir insérer 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 à l'aide de Range.setValue(value) ou de Range.setValues(values).
Renvois
CellImageBuilder : compilateur qui crée un type de valeur d'image en fonction des propriétés d'image données.