Class CellImageBuilder

Outil de création d'images de cellule

Compilateur pour CellImage. Ce compilateur crée la valeur d'image nécessaire pour ajouter une image à une cellule.

Propriétés

PropriétéTypeDescription
valueTypeValueTypeChamp défini sur ValueType.IMAGE, représentant le type de valeur de l'image.

Méthodes

MéthodeType renvoyéBrève description
build()CellImageCrée le type de valeur d'image requis pour ajouter une image à une cellule.
getAltTextDescription()StringRenvoie la description du texte alternatif de cette image.
getAltTextTitle()StringRenvoie le titre du 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. Renvoie null si l'URL n'est pas disponible.
setAltTextDescription(description)CellImageDéfinit la description du texte alternatif pour cette image.
setAltTextTitle(title)CellImageDéfinit le titre du texte alternatif de cette image.
setSourceUrl(url)CellImageBuilderDéfinit l'URL de la source d'image.
toBuilder()CellImageBuilderCrée un générateur qui transforme une image en type de valeur d'image afin que vous puissiez la placer dans une cellule.

Documentation détaillée

build()

Crée le type de valeur d'image requis pour ajouter une image à une cellule. La valeur de l'image est créée à partir des propriétés d'image ajoutées au compilateur, telles que l'URL source.

Renvois

CellImage : représentation de l'image à ajouter à une cellule.


getAltTextDescription()

Renvoie 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 avec 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 du texte alternatif de cette image.

Renvois

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 une URL hébergée par Google vers l'image. Cette URL est taguée avec le compte de la personne à l'origine de la demande. Par conséquent, toute personne disposant de l'URL accède à l'image en tant que personne à l'origine de la demande. 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 au bout d'un court laps de temps.

Renvois

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 par 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, le cas échéant. 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 avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setAltTextDescription(description)

Définit la description du texte alternatif pour cette image.

Paramètres

NomTypeDescription
descriptionStringNouvelle description du texte alternatif de l'image.

Renvois

CellImage : cette image, pour le chaînage.

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

setAltTextTitle(title)

Définit le titre du texte alternatif de cette image.

Paramètres

NomTypeDescription
titleStringNouveau titre du texte alternatif de l'image.

Renvois

CellImage : cette image, pour le chaînage.

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

setSourceUrl(url)

Définit l'URL de la source d'image.

Paramètres

NomTypeDescription
urlStringURL de l'image.

Renvois

CellImageBuilder : ce générateur, pour le chaînage.


toBuilder()

Crée un générateur qui transforme une image en type de valeur d'image afin que vous puissiez 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 à 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.