Class EmbeddedBarChartBuilder

Ajoute une plage au graphique que ce compilateur modifie. N'ajoute pas la plage si elle a déjà été ajoutée au graphique.

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();

sheet.insertChart(chart);

Paramètres

Aller-retour

EmbeddedChartBuilder : cet outil de création, pour le chaînage

Définit le type de graphique sur AreaChart et renvoie un EmbeddedAreaChartBuilder.

Aller-retour

EmbeddedAreaChartBuilder : outil de création d'un graphique en aires

Définit le type de graphique sur BarChart et renvoie un EmbeddedBarChartBuilder.

Aller-retour

EmbeddedBarChartBuilder : outil de création d'un graphique à barres

Définit le type de graphique sur ColumnChart et renvoie EmbeddedColumnChartBuilder.

Aller-retour

EmbeddedColumnChartBuilder : outil de création d'un graphique à colonnes

Définit le type de graphique sur ComboChart et renvoie EmbeddedComboChartBuilder.

Aller-retour

EmbeddedComboChartBuilder : outil de création d'un graphique combiné

Définit le type de graphique sur HistogramChart et renvoie EmbeddedHistogramChartBuilder.

Aller-retour

EmbeddedHistogramChartBuilder : outil de création d'un histogramme

Définit le type de graphique sur LineChart et renvoie un EmbeddedLineChartBuilder.

Aller-retour

EmbeddedLineChartBuilder : outil de création d'un graphique en courbes

Définit le type de graphique sur PieChart et renvoie un EmbeddedPieChartBuilder.

Aller-retour

EmbeddedPieChartBuilder : outil de création de graphique à secteurs

Définit le type de graphique sur "ScatterChart", puis renvoie un EmbeddedScatterChartBuilder.

Aller-retour

EmbeddedScatterChartBuilder : outil de création d'un graphique à nuage de points

Définit le type de graphique sur TableChart et renvoie EmbeddedTableChartBuilder.

Aller-retour

EmbeddedTableChartBuilder : outil de création d'un graphique de table

Il crée le graphique pour refléter toutes les modifications qui y ont été apportées.

Cette méthode ne dessine pas automatiquement le graphique au-dessus de la feuille de calcul. Vous devez insérer un nouveau graphique via sheet.insertChart(chart) et mettre à jour un graphique existant via sheet.updateChart(chart).

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)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Aller-retour

EmbeddedChart : graphique créé, qui doit encore être ajouté à la feuille de calcul

Supprime toutes les plages du graphique que ce compilateur modifie.

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

// This code updates the chart to use only the new ranges while preserving the existing
// formatting of the chart.
var chart = sheet.getCharts()[0];
var newChart = chart
    .modify()
    .clearRanges()
    .addRange(sheet.getRange("A1:A5"))
    .addRange(sheet.getRange("B1:B5"))
    .build();
sheet.updateChart(newChart);

Aller-retour

EmbeddedChartBuilder : cet outil de création, pour le chaînage

Affiche le type de graphique actuel.

Aller-retour

ChartType : type de graphique

Renvoyez le graphique ContainerInfo, qui encapsule l'emplacement du graphique sur la feuille.

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

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

// This method returns the exact same data as Chart#getContainerInfo()
var containerInfo = chartBuilder.getContainer();

// 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

Affiche une copie de la liste des plages contenant actuellement des données pour ce graphique. Utilisez addRange(range) et removeRange(range) pour modifier cette liste.

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

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

var ranges = chartBuilder.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 graphique pour la source de données à créer

Supprime la plage spécifiée du graphique que ce compilateur modifie. Ne génère pas d'erreur si la plage ne figure pas dans ce graphique.

La plage supprimée doit correspondre à une plage ajoutée via addRange(range). Sinon, aucune modification n'est apportée au graphique. Cette méthode ne peut pas être utilisée pour supprimer partiellement des valeurs d'une plage.

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

var firstRange = sheet.getRange("A1:B5");
var secondRange = sheet.getRange("A6:B8");

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(firstRange)
    // This range will render in a different color
    .addRange(secondRange)
    .setPosition(5, 5, 0, 0);

// Note that you can use either of these two formats, but the range
// MUST match up with a range that was added via addRange(), or it
// will not be removed, and will not throw an exception
chartBuilder.removeRange(firstRange);
chartBuilder.removeRange(sheet.getRange("A6:B8"));

var chart = chartBuilder.build();

sheet.insertChart(chart);

Paramètres

Aller-retour

EmbeddedChartBuilder : cet outil de création, pour le chaînage

Inverse le dessin d'une série sur l'axe du domaine. Pour les graphiques à plage verticale (tels que les graphiques en courbes, en aires ou à colonnes), cela signifie que l'axe horizontal est tracé de droite à gauche. Pour les graphiques à plage horizontale (comme les graphiques à barres), cela signifie que l'axe vertical est tracé de haut en bas. Pour les graphiques à secteurs, cela signifie que les segments sont tracés dans le sens inverse des aiguilles d'une montre.

// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner.
var builder = Charts.newPieChart();
builder.reverseCategories();

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage

Inverse la direction dans laquelle les barres se développent le long de l'axe horizontal. Par défaut, les valeurs s'étendent de gauche à droite. Si vous appelez cette méthode, elle va se développer de droite à gauche.

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage

Définit la couleur de l'arrière-plan du graphique.

// Creates a line chart builder and sets the background color to gray
var builder = Charts.newLineChart();
builder.setBackgroundColor("gray");

Paramètres

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage

Modifie le type de graphique. Tous les types de graphiques intégrés ne sont pas compatibles pour le moment. Consultez les ChartType.

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)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Paramètres

Aller-retour

EmbeddedChartBuilder : cet outil de création, pour le chaînage

Définit les couleurs des lignes du graphique.

// Creates a line chart builder and sets the first two lines to be drawn in green and red,
// respectively.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

Paramètres

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage

Définit la stratégie à utiliser pour 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();

sheet.insertChart(chart);

Paramètres

Aller-retour

EmbeddedChartBuilder : cet outil de création, pour le chaînage

Définit la position de la légende par rapport au graphique. Par défaut, il n'y a pas de légende.

// Creates a line chart builder and sets the legend position to right.
var builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

Paramètres

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage

Définit le style de texte de la légende du graphique.

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

Paramètres

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage

Définit la stratégie de fusion à utiliser lorsque plusieurs plages existent. Si la valeur est MERGE_ROWS, les lignes sont fusionnées. 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("C:C10");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .addRange(range2)
    .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Paramètres

Aller-retour

EmbeddedChartBuilder : cet outil de création, pour le chaînage

Définit le nombre de lignes ou de colonnes de la plage à traiter 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();

sheet.insertChart(chart);

Paramètres

Aller-retour

EmbeddedChartBuilder : cet outil de création, pour le chaînage

Définit les options avancées de ce graphique. Pour afficher la liste des options disponibles, consultez la page Options de configuration du graphique.

Cette méthode ne vérifie pas que l'option spécifiée est valide pour ce type de graphique, ni si la valeur est au format/structure approprié.

Cet exemple montre comment modifier le titre et définir une légende.

builder.setOption('title', 'Earnings projections');
builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});

Paramètres

Aller-retour

EmbeddedChartBuilder : cet outil de création, pour le chaînage

Définit la position, en changeant l'emplacement du graphique sur la feuille. anchorRowPos et anchorColPos sont indexés à 1.

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)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Paramètres

Aller-retour

EmbeddedChartBuilder : cet outil de création, pour le chaînage

Définit la plage du graphique.

Si des points de données se situent en dehors de la plage, celle-ci est étendue pour inclure ces points de données.

Paramètres

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage

Utilise des lignes empilées, ce qui signifie que les valeurs des lignes et des barres sont empilées (accumulées). Par défaut, il n'y a pas d'empilement.

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage

Définit le titre du graphique. Le titre est centré au-dessus du graphique.

// Creates a line chart builder and title to 'My Line Chart'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')

Paramètres

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage

Définit le style de texte du titre du graphique.

// Creates a line chart builder and sets it up for a  blue, 26-point title.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

Paramètres

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage

Indique si les lignes et les colonnes du graphique sont transposées. Si la valeur est true, les lignes et les colonnes 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()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setTransposeRowsAndColumns(true)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Paramètres

Aller-retour

EmbeddedChartBuilder : cet outil de création, pour le chaînage

Définit le style de texte de l'axe horizontal.

// Creates a line chart builder and sets the X-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

Paramètres

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage

Ajoute un titre à l'axe horizontal. Le titre est centré et apparaît sous les libellés de la valeur de l'axe.

// Creates a line chart builder and sets the X-axis title.
var builder = Charts.newLineChart();
builder.setTitle('X-axis Title')

Paramètres

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage

Définit le style du texte du titre de l'axe horizontal.

// Creates a line chart builder and sets the X-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

Paramètres

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage

Définit le style de texte de l'axe vertical.

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

Paramètres

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage

Ajoute un titre à l'axe vertical. Le titre est centré et apparaît à gauche des étiquettes de valeur.

// Creates a line chart builder and sets the Y-axis title.
var builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title')

Paramètres

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage

Définit le style du texte du titre de l'axe vertical.

// Creates a line chart builder and sets the Y-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

Paramètres

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage

Transforme l'axe de la plage en une échelle logarithmique (toutes les valeurs doivent être positives). L'axe des plages est l'axe vertical des graphiques verticaux (par exemple, une ligne, une zone ou une colonne) et l'axe horizontal des graphiques horizontaux (une barre, par exemple).

Aller-retour

EmbeddedBarChartBuilder : compilateur, utile pour le chaînage