Cette page a été traduite par l'API Cloud Translation.

Class EmbeddedChart

Représente un graphique qui a été intégré dans une feuille de calcul.

Cet exemple montre comment modifier un graphique existant:

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A2:B8")
var chart = sheet.getCharts()[0];
chart = chart.modify()
    .addRange(range)
    .setOption('title', 'Updated!')
    .setOption('animation.duration', 500)
    .setPosition(2,2,0,0)
    .build();
sheet.updateChart(chart);

Cet exemple montre comment créer un graphique:

function newChart(range, sheet) {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chartBuilder = sheet.newChart();
  chartBuilder.addRange(range)
      .setChartType(Charts.ChartType.LINE)
      .setOption('title', 'My Line Chart!');
  sheet.insertChart(chartBuilder.build());
}

Méthodes

Méthode	Type renvoyé	Brève description
`asDataSourceChart()`	`DataSourceChart`	Caste vers une instance de graphique de source de données si le graphique est une source de données, ou `null` dans le cas contraire.
`getAs(contentType)`	`Blob`	Renvoyez les données de cet objet en tant qu'objet blob converti au type de contenu spécifié.
`getBlob()`	`Blob`	Renvoyez les données de cet objet en tant que blob.
`getChartId()`	`Integer`	Renvoie un identifiant stable pour le graphique, qui est unique dans la feuille de calcul contenant le graphique ou `null` si le graphique ne figure pas dans une feuille de calcul.
`getContainerInfo()`	`ContainerInfo`	Affiche des informations sur l'emplacement du graphique dans une feuille.
`getHiddenDimensionStrategy()`	`ChartHiddenDimensionStrategy`	Affiche la stratégie à utiliser pour gérer les lignes et les colonnes masquées.
`getMergeStrategy()`	`ChartMergeStrategy`	Affiche la stratégie de fusion utilisée lorsqu'il existe plusieurs plages.
`getNumHeaders()`	`Integer`	Renvoie le nombre de lignes ou de colonnes de la plage qui est traitée comme des en-têtes.
`getOptions()`	`ChartOptions`	Affiche les options de ce graphique, telles que la hauteur, les couleurs et les axes.
`getRanges()`	`Range[]`	Renvoie les plages que ce graphique utilise en tant que source de données.
`getTransposeRowsAndColumns()`	`Boolean`	Si la valeur est `true`, les lignes et les colonnes utilisées pour insérer le graphique sont interverties.
`modify()`	`EmbeddedChartBuilder`	Renvoie un `EmbeddedChartBuilder` qui peut être utilisé pour modifier ce graphique.

Documentation détaillée

`asDataSourceChart()`

Caste vers une instance de graphique de source de données si le graphique est une source de données, ou null dans le cas contraire.

Aller-retour

DataSourceChart : graphique de la source de données.

`getAs(contentType)`

Renvoyez les données de cet objet en tant qu'objet blob converti au type de contenu spécifié. Cette méthode ajoute l'extension appropriée au nom de fichier, par exemple "monfichier.pdf". Toutefois, nous partons du principe que la partie du nom de fichier qui suit la dernière période (le cas échéant) est une extension existante qui doit être remplacée. Par conséquent, "ShoppingList.12.25.2014" devient "ShoppingList.12.25.pdf".

Pour afficher les quotas quotidiens des conversions, consultez la page Quotas pour les services Google. Les domaines Google Workspace créés récemment peuvent être soumis à des quotas plus stricts.

Paramètres

Nom	Type	Description
`contentType`	`String`	Type MIME vers lequel effectuer la conversion. Pour la plupart des blobs, `'application/pdf'` est la seule option valide. Pour les images au format BMP, GIF, JPEG ou PNG, vous pouvez utiliser les formats `'image/bmp'`, `'image/gif'`, `'image/jpeg'` ou `'image/png'`.

Aller-retour

Blob : données en tant que blob.

`getBlob()`

Renvoyez les données de cet objet en tant que blob.

Aller-retour

Blob : données en tant que blob.

`getChartId()`

Renvoie un identifiant stable pour le graphique, qui est unique dans la feuille de calcul contenant le graphique ou null si le graphique ne figure pas dans une feuille de calcul.

Aller-retour

Integer : identifiant de graphique stable.

`getContainerInfo()`

Affiche des informations sur l'emplacement du graphique dans une feuille.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0)
    .build();

var containerInfo = chart.getContainerInfo();

// Logs the values we used in setPosition()
Logger.log("Anchor Column: %s\r\nAnchor Row %s\r\nOffset X %s\r\nOffset Y %s",
          containerInfo.getAnchorColumn(),
          containerInfo.getAnchorRow(),
          containerInfo.getOffsetX(),
          containerInfo.getOffsetY());

Aller-retour

ContainerInfo : objet contenant la position du conteneur de graphique

`getHiddenDimensionStrategy()`

Affiche la stratégie à utiliser pour gérer les lignes et les colonnes masquées. La valeur par défaut est IGNORE_ROWS.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setHiddenDimensionStrategy(Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs the strategy to use for hidden rows and columns which is
// Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS in this case.
Logger.log(chart.getHiddenDimensionStrategy());

Aller-retour

ChartHiddenDimensionStrategy : stratégie à utiliser pour les lignes et les colonnes masquées.

`getMergeStrategy()`

Affiche la stratégie de fusion utilisée lorsqu'il existe plusieurs plages. Si la valeur est MERGE_ROWS, la ligne est fusionnée. Si la valeur est MERGE_COLUMNS, les colonnes sont fusionnées. La valeur par défaut est MERGE_COLUMNS.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B10");
var range2 = sheet.getRange("C1:C10");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .addRange(range2)
    .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs whether rows of multiple ranges are merged, which is MERGE_ROWS in this case.
Logger.log(chart.getMergeStrategy());

Aller-retour

ChartMergeStrategy : MERGE_ROWS si les lignes sont fusionnées sur plusieurs plages ; MERGE_COLUMNS si les colonnes sont fusionnées sur plusieurs plages

`getNumHeaders()`

Renvoie le nombre de lignes ou de colonnes de la plage qui est traitée comme des en-têtes.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setNumHeaders(1)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs the number of rows or columns to use as headers, which is 1 in this case.
Logger.log(chart.getHeaders());

Aller-retour

Integer : nombre de lignes ou de colonnes traitées comme des en-têtes. Les valeurs négatives indiquent que les en-têtes sont détectés automatiquement.

`getOptions()`

Affiche les options de ce graphique, telles que la hauteur, les couleurs et les axes.

Les options renvoyées sont immuables.

Aller-retour

ChartOptions : options de ce graphique, telles que la hauteur, les couleurs et les axes

`getRanges()`

Renvoie les plages que ce graphique utilise en tant que source de données.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0)
    .build();

var ranges = chart.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (var i in ranges) {
  var range = ranges[i];
  Logger.log(range.getA1Notation());
}

Aller-retour

Range[] : tableau de plages servant de source de données à ce graphique

`getTransposeRowsAndColumns()`

Si la valeur est true, les lignes et les colonnes utilisées pour insérer le graphique sont interverties. La valeur par défaut est false.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .addRange(range)
    .setChartType(Charts.ChartType.BAR)
    .setTransposeRowsAndColumns(true)
    .setPosition(5, 5, 0, 0)
    .build()

// Logs whether rows and columns should be transposed, which is true in this case.
Logger.log(chart.getTransposeRowsAndColumns());

Aller-retour

Boolean : true si les lignes et les colonnes utilisées pour construire le graphique sont transposées.

`modify()`

Renvoie un EmbeddedChartBuilder qui peut être utilisé pour modifier ce graphique. Appelez sheet.updateChart(chart) pour enregistrer les modifications.

var sheet = SpreadsheetApp.getActiveSheet();
var chart = sheet.getCharts()[0];
chart = chart.modify()
    .setOption('width', 800)
    .setOption('height', 640)
    .setPosition(5, 5, 0, 0)
    .build();
sheet.updateChart(chart);

Aller-retour

EmbeddedChartBuilder : outil de création de graphiques intégrés