Compilateur pour Cell
. Ce compilateur crée la valeur d'image nécessaire pour ajouter une image à une cellule.
Propriétés
Propriété | Type | Description |
---|---|---|
value | Value | Type de valeur de l'image de la cellule, qui est Value . |
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
build() | Cell | Crée le type de valeur d'image requis pour ajouter une image à une cellule. |
get | String | Renvoie la description du texte alternatif de cette image. |
get | String | Renvoie le titre du texte alternatif de cette image. |
get | String | Renvoie une URL hébergée par Google vers l'image. |
set | Cell | Définit la description du texte alternatif pour cette image. |
set | Cell | Définit le titre du texte alternatif de cette image. |
set | Cell | Définit l'URL de la source d'image. |
to | Cell | Crée un outil de création d'images de cellule en fonction des propriétés d'image actuelles. |
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
Cell
: représentation de l'image à ajouter à une cellule.
get Alt Text Description()
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
get Alt Text Title()
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
get Content Url()
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 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 au bout d'un court laps de temps.
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.
set Alt Text Description(description)
Définit la description du texte alternatif pour cette image.
Paramètres
Nom | Type | Description |
---|---|---|
description | String | Nouvelle description du texte alternatif de l'image. |
Renvois
Cell
: 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
set Alt Text Title(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
Cell
: 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
set Source Url(url)
Définit l'URL de la source d'image.
Paramètres
Nom | Type | Description |
---|---|---|
url | String | URL de l'image. |
Renvois
Cell
: ce générateur, pour le chaînage.
to Builder()
Crée un outil de création d'images de cellule en fonction des propriétés d'image actuelles. Utilisez set
pour définir l'URL source de la nouvelle image. Vous pouvez ensuite l'ajouter à une cellule à l'aide de Range.setValue(value)
ou de 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
Cell
: compilateur qui crée un type de valeur d'image en fonction des propriétés d'image données.