Class CellImage

CellImage

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éTypeDescription
valueTypeValueTypeChamp défini sur ValueType.IMAGE, qui représente le type de valeur de l'image.

Méthodes

MéthodeType renvoyéBrève description
getAltTextDescription()StringAffiche la description du texte alternatif de cette image.
getAltTextTitle()StringRenvoie le titre en texte alternatif de cette image.
getContentUrl()StringRenvoie une URL hébergée par Google vers l'image.
getUrl()StringRécupère l'URL source de l'image et renvoie null si l'URL n'est pas disponible.
toBuilder()CellImageBuilderCré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.