Class CellImageBuilder

CellImageBuilder

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

Propriétés

Propriété	Type	Description
valueType	ValueType	Type de valeur de l'image de la cellule, qui est ValueType.IMAGE.

Méthodes

Méthode	Type renvoyé	Brève description
build()	CellImage	Crée le type de valeur d'image nécessaire pour ajouter une image à une cellule.
getAltTextDescription()	String	Renvoie la description du texte alternatif de cette image.
getAltTextTitle()	String	Renvoie le titre du texte alternatif de cette image.
getContentUrl()	String	Renvoie une URL hébergée par Google vers l'image.
setAltTextDescription(description)	CellImage	Définit la description du texte alternatif de cette image.
setAltTextTitle(title)	CellImage	Définit le titre du texte alternatif de cette image.
setSourceUrl(url)	CellImageBuilder	Définit l'URL source de l'image.
toBuilder()	CellImageBuilder	Crée un compilateur d'images de cellules en fonction des propriétés d'image actuelles.

Méthodes obsolètes

Méthode	Type renvoyé	Brève description
getUrl()	String	Obtient l'URL source de l'image.

Documentation détaillée

build()

Crée le type de valeur d'image nécessaire 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 associée au compte du demandeur. Par conséquent, 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 sont modifiés. L'URL renvoyée expire après une courte période.

const range = SpreadsheetApp.getActiveSpreadsheet().getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  console.log(value.getContentUrl());
}

Renvois

String : URL de l'image hébergée par Google.

---

setAltTextDescription(description)

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

Paramètres

Nom	Type	Description
description	String	Nouvelle 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

Nom	Type	Description
title	String	Nouveau 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 source de l'image.

Paramètres

Nom	Type	Description
url	String	URL de l'image.

Renvois

CellImageBuilder : ce compilateur, pour le chaînage.

---

toBuilder()

Crée un compilateur d'images de cellules en fonction des propriétés d'image actuelles. Utilisez setSourceUrl(url) pour définir l'URL source de la nouvelle image. Vous pouvez ensuite l'ajouter à une cellule à l'aide de Range.setValue(value) ou Range.setValues(values).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const range = ss.getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  const newImage =
      value.toBuilder()
          .setSourceUrl(
              'https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png',
              )
          .build();
  const newRange = ss.getRange("Sheet1!A2");
  newRange.setValue(newImage);
}

Renvois

CellImageBuilder : compilateur qui crée un type de valeur d'image en fonction des propriétés d'image données.

Méthodes obsolètes

getUrl()

Obsolète. Pour la plupart des images récemment insérées, l'URL source n'est pas disponible.

Obtient l'URL source de l'image. Renvoie une chaîne vide si l'URL n'est pas disponible. Pour la plupart des images récemment insérées, l'URL source n'est pas disponible, quelle que soit la manière dont l'image est insérée.

Renvois

String : URL source de l'image si elle est disponible. Sinon, renvoie une chaîne vide.

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