Class EmbeddedBarChartBuilder

EingebettetesBalkenDiagramm-Tool

Tool zum Erstellen von Balkendiagrammen. Weitere Informationen finden Sie in der Dokumentation zu Gviz.

Methoden

MethodeRückgabetypKurzbeschreibung
addRange(range)EmbeddedChartBuilderFügt dem Diagramm, das dieser Builder ändert, einen Bereich hinzu.
asAreaChart()EmbeddedAreaChartBuilderLegt den Diagrammtyp auf „Flächendiagramm“ fest und gibt eine EmbeddedAreaChartBuilder zurück.
asBarChart()EmbeddedBarChartBuilderLegt den Diagrammtyp auf „BarChart“ fest und gibt eine EmbeddedBarChartBuilder zurück.
asColumnChart()EmbeddedColumnChartBuilderLegt den Diagrammtyp auf „ColumnChart“ fest und gibt eine EmbeddedColumnChartBuilder zurück.
asComboChart()EmbeddedComboChartBuilderLegt den Diagrammtyp auf „Kombinationsdiagramm“ fest und gibt eine EmbeddedComboChartBuilder zurück.
asHistogramChart()EmbeddedHistogramChartBuilderLegt den Diagrammtyp auf „Histogrammdiagramm“ fest und gibt eine EmbeddedHistogramChartBuilder zurück.
asLineChart()EmbeddedLineChartBuilderLegt den Diagrammtyp auf „LineChart“ fest und gibt eine EmbeddedLineChartBuilder zurück.
asPieChart()EmbeddedPieChartBuilderLegt den Diagrammtyp auf „PieChart“ fest und gibt eine EmbeddedPieChartBuilder zurück.
asScatterChart()EmbeddedScatterChartBuilderLegt den Diagrammtyp auf „ScatterChart“ fest und gibt eine EmbeddedScatterChartBuilder zurück.
asTableChart()EmbeddedTableChartBuilderLegt den Diagrammtyp auf „Tabellendiagramm“ fest und gibt eine EmbeddedTableChartBuilder zurück.
build()EmbeddedChartDas Diagramm wird so erstellt, dass alle an ihm vorgenommenen Änderungen berücksichtigt werden.
clearRanges()EmbeddedChartBuilderEntfernt alle Bereiche aus dem Diagramm, das mit diesem Tool geändert wird.
getChartType()ChartTypeGibt den aktuellen Diagrammtyp zurück.
getContainer()ContainerInfoGibt das Diagramm ContainerInfo zurück, das angibt, wo das Diagramm auf dem Tabellenblatt angezeigt wird.
getRanges()Range[]Gibt eine Kopie der Liste der Bereiche zurück, die derzeit Daten für dieses Diagramm liefern.
removeRange(range)EmbeddedChartBuilderEntfernt den angegebenen Bereich aus dem Diagramm, das mit diesem Builder geändert wird.
reverseCategories()EmbeddedBarChartBuilderDie Reihen werden auf der Ordinatenachse in umgekehrter Reihenfolge dargestellt.
reverseDirection()EmbeddedBarChartBuilderDie Richtung, in der die Balken entlang der horizontalen Achse wachsen, wird umgekehrt.
setBackgroundColor(cssValue)EmbeddedBarChartBuilderHier legen Sie die Hintergrundfarbe des Diagramms fest.
setChartType(type)EmbeddedChartBuilderÄndert den Diagrammtyp.
setColors(cssValues)EmbeddedBarChartBuilderHiermit legen Sie die Farben für die Linien im Diagramm fest.
setHiddenDimensionStrategy(strategy)EmbeddedChartBuilderLegt die Strategie fest, die für ausgeblendete Zeilen und Spalten verwendet werden soll.
setLegendPosition(position)EmbeddedBarChartBuilderHiermit wird die Position der Legende im Verhältnis zum Diagramm festgelegt.
setLegendTextStyle(textStyle)EmbeddedBarChartBuilderHiermit wird der Textstil der Diagrammlegende festgelegt.
setMergeStrategy(mergeStrategy)EmbeddedChartBuilderLegt die Zusammenführungsstrategie fest, die verwendet werden soll, wenn mehrere Bereiche vorhanden sind.
setNumHeaders(headers)EmbeddedChartBuilderLegt die Anzahl der Zeilen oder Spalten des Bereichs fest, die als Überschriften behandelt werden sollen.
setOption(option, value)EmbeddedChartBuilderHier legen Sie erweiterte Optionen für dieses Diagramm fest.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)EmbeddedChartBuilderHiermit wird die Position festgelegt, an der das Diagramm auf dem Tabellenblatt angezeigt wird.
setRange(start, end)EmbeddedBarChartBuilderLegt den Bereich für das Diagramm fest.
setStacked()EmbeddedBarChartBuilderEs werden gestapelte Linien verwendet, d. h., Linien- und Balkenwerte werden gestapelt (aufsummiert).
setTitle(chartTitle)EmbeddedBarChartBuilderHiermit wird der Titel des Diagramms festgelegt.
setTitleTextStyle(textStyle)EmbeddedBarChartBuilderHiermit wird der Textstil des Diagrammtitels festgelegt.
setTransposeRowsAndColumns(transpose)EmbeddedChartBuilderHiermit wird festgelegt, ob die Zeilen und Spalten des Diagramms transponiert werden.
setXAxisTextStyle(textStyle)EmbeddedBarChartBuilderHiermit wird der Textstil der horizontalen Achse festgelegt.
setXAxisTitle(title)EmbeddedBarChartBuilderFügen Sie der horizontalen Achse einen Titel hinzu.
setXAxisTitleTextStyle(textStyle)EmbeddedBarChartBuilderHiermit wird der Textstil für den Titel der horizontalen Achse festgelegt.
setYAxisTextStyle(textStyle)EmbeddedBarChartBuilderHiermit wird der Textstil der vertikalen Achse festgelegt.
setYAxisTitle(title)EmbeddedBarChartBuilderFügen Sie der vertikalen Achse einen Titel hinzu.
setYAxisTitleTextStyle(textStyle)EmbeddedBarChartBuilderHiermit wird der Textstil für den Titel der vertikalen Achse festgelegt.
useLogScale()EmbeddedBarChartBuilderDie Bereichsachse wird logarithmisch skaliert. Alle Werte müssen positiv sein.

Detaillierte Dokumentation

addRange(range)

Fügt dem Diagramm, das dieser Builder ändert, einen Bereich hinzu. Der Bereich wird nicht hinzugefügt, wenn er dem Diagramm bereits hinzugefügt wurde.

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

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

sheet.insertChart(chart);

Parameter

NameTypBeschreibung
rangeRangeDer Bereich, der hinzugefügt werden soll.

Rückflug

EmbeddedChartBuilder – dieser Builder, zur Verkettung


asAreaChart()

Legt den Diagrammtyp auf „Flächendiagramm“ fest und gibt eine EmbeddedAreaChartBuilder zurück.

Rückflug

EmbeddedAreaChartBuilder – ein Builder für ein Flächendiagramm


asBarChart()

Legt den Diagrammtyp auf „BarChart“ fest und gibt eine EmbeddedBarChartBuilder zurück.

Rückflug

EmbeddedBarChartBuilder – ein Builder für ein Balkendiagramm


asColumnChart()

Legt den Diagrammtyp auf „ColumnChart“ fest und gibt eine EmbeddedColumnChartBuilder zurück.

Rückflug

EmbeddedColumnChartBuilder – ein Builder für ein Säulendiagramm


asComboChart()

Legt den Diagrammtyp auf „Kombinationsdiagramm“ fest und gibt eine EmbeddedComboChartBuilder zurück.

Rückflug

EmbeddedComboChartBuilder – ein Builder für ein Kombinationsdiagramm


asHistogramChart()

Legt den Diagrammtyp auf „Histogrammdiagramm“ fest und gibt eine EmbeddedHistogramChartBuilder zurück.

Rückflug

EmbeddedHistogramChartBuilder – ein Builder für ein Histogrammdiagramm


asLineChart()

Legt den Diagrammtyp auf „LineChart“ fest und gibt eine EmbeddedLineChartBuilder zurück.

Rückflug

EmbeddedLineChartBuilder – ein Builder für ein Liniendiagramm


asPieChart()

Legt den Diagrammtyp auf „PieChart“ fest und gibt eine EmbeddedPieChartBuilder zurück.

Rückflug

EmbeddedPieChartBuilder – ein Builder für ein Kreisdiagramm


asScatterChart()

Legt den Diagrammtyp auf „ScatterChart“ fest und gibt eine EmbeddedScatterChartBuilder zurück.

Rückflug

EmbeddedScatterChartBuilder – ein Builder für ein Streudiagramm


asTableChart()

Legt den Diagrammtyp auf „Tabellendiagramm“ fest und gibt eine EmbeddedTableChartBuilder zurück.

Rückflug

EmbeddedTableChartBuilder – ein Builder für ein Tabellendiagramm


build()

Das Diagramm wird so erstellt, dass alle an ihm vorgenommenen Änderungen berücksichtigt werden.

Bei dieser Methode wird das Diagramm nicht automatisch über der Tabelle gezeichnet. Ein neues Diagramm muss über sheet.insertChart(chart) eingefügt und ein vorhandenes Diagramm über sheet.updateChart(chart) aktualisiert werden.

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

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

Rückflug

EmbeddedChart – das erstellte Diagramm, das der Tabelle noch hinzugefügt werden muss


clearRanges()

Entfernt alle Bereiche aus dem Diagramm, das mit diesem Tool geändert wird.

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

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

Rückflug

EmbeddedChartBuilder – dieser Builder, zur Verkettung


getChartType()

Gibt den aktuellen Diagrammtyp zurück.

Rückflug

ChartType – der Diagrammtyp


getContainer()

Gibt das Diagramm ContainerInfo zurück, das angibt, wo das Diagramm auf dem Tabellenblatt angezeigt wird.

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

const 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()
const containerInfo = chartBuilder.getContainer();

// Logs the values 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(),
);

Rückflug

ContainerInfo: ein Objekt mit der Position des Diagrammcontainers


getRanges()

Gibt eine Kopie der Liste der Bereiche zurück, die derzeit Daten für dieses Diagramm liefern. Verwenden Sie addRange(range) und removeRange(range), um diese Liste zu ändern.

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

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

const ranges = chartBuilder.getRanges();

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

Rückflug

Range[]: ein Array von Bereichen, die als Datenquelle für das zu erstellende Diagramm dienen


removeRange(range)

Entfernt den angegebenen Bereich aus dem Diagramm, das mit diesem Builder geändert wird. Es wird kein Fehler ausgegeben, wenn der Bereich nicht in diesem Diagramm enthalten ist.

Der entfernte Bereich muss mit einem Bereich übereinstimmen, der über addRange(range) hinzugefügt wurde. Andernfalls wird das Diagramm nicht geändert. Mit dieser Methode können keine Werte teilweise aus einem Bereich entfernt werden.

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

const firstRange = sheet.getRange('A1:B5');
const secondRange = sheet.getRange('A6:B8');

const 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'));

const chart = chartBuilder.build();

sheet.insertChart(chart);

Parameter

NameTypBeschreibung
rangeRangeDer Bereich, der entfernt werden soll.

Rückflug

EmbeddedChartBuilder – dieser Builder, zur Verkettung


reverseCategories()

Die Reihen werden auf der Ordinatenachse in umgekehrter Reihenfolge dargestellt. Bei Diagrammen mit vertikalem Bereich (z. B. Linien-, Flächen- oder Säulendiagramme) bedeutet das, dass die horizontale Achse von rechts nach links gezeichnet wird. Bei Diagrammen mit horizontalem Bereich (z. B. Balkendiagramme) wird die vertikale Achse also von oben nach unten gezeichnet. Bei Kreisdiagrammen bedeutet das, dass die Segmente gegen den Uhrzeigersinn gezeichnet werden.

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

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.


reverseDirection()

Die Richtung, in der die Balken entlang der horizontalen Achse wachsen, wird umgekehrt. Standardmäßig steigen die Werte von links nach rechts an. Wenn Sie diese Methode aufrufen, werden sie von rechts nach links größer.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.


setBackgroundColor(cssValue)

Hier legen Sie die Hintergrundfarbe des Diagramms fest.

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

Parameter

NameTypBeschreibung
cssValueStringDer CSS-Wert für die Farbe (z. B. "blue" oder "#00f").

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.


setChartType(type)

Ändert den Diagrammtyp. Derzeit werden nicht alle eingebetteten Diagrammtypen unterstützt. ChartType ansehen.

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

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

Parameter

NameTypBeschreibung
typeChartTypeDer Typ, in den dieses Diagramm umgewandelt werden soll.

Rückflug

EmbeddedChartBuilder – dieser Builder, zur Verkettung


setColors(cssValues)

Hiermit legen Sie die Farben für die Linien im Diagramm fest.

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

Parameter

NameTypBeschreibung
cssValuesString[]Ein Array von CSS-Farbwerten, z. B. ["red", "#acf"]. Das n-te Element im Array steht für die Farbe der n-ten Linie im Diagramm.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.


setHiddenDimensionStrategy(strategy)

Legt die Strategie fest, die für ausgeblendete Zeilen und Spalten verwendet werden soll. Die Standardeinstellung ist IGNORE_ROWS.

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

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

sheet.insertChart(chart);

Parameter

NameTypBeschreibung
strategyChartHiddenDimensionStrategyDie Strategie, die für ausgeblendete Zeilen und Spalten verwendet werden soll.

Rückflug

EmbeddedChartBuilder – dieser Builder, zur Verkettung


setLegendPosition(position)

Hiermit wird die Position der Legende im Verhältnis zum Diagramm festgelegt. Standardmäßig ist keine Legende vorhanden.

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

Parameter

NameTypBeschreibung
positionPositionDie Position der Legende.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.


setLegendTextStyle(textStyle)

Hiermit wird der Textstil der Diagrammlegende festgelegt.

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

Parameter

NameTypBeschreibung
textStyleTextStyleDer Textstil, der für die Diagrammlegende verwendet werden soll.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.


setMergeStrategy(mergeStrategy)

Legt die Zusammenführungsstrategie fest, die verwendet werden soll, wenn mehrere Bereiche vorhanden sind. Bei MERGE_ROWS werden Zeilen zusammengeführt, bei MERGE_COLUMNS Spalten. Die Standardeinstellung ist MERGE_COLUMNS.

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

const range = sheet.getRange('A1:B10');
const range2 = sheet.getRange('C:C10');
const 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);

Parameter

NameTypBeschreibung
mergeStrategyChartMergeStrategyDie zu verwendende Zusammenführungsstrategie.

Rückflug

EmbeddedChartBuilder – dieser Builder, zur Verkettung


setNumHeaders(headers)

Legt die Anzahl der Zeilen oder Spalten des Bereichs fest, die als Überschriften behandelt werden sollen.

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

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

sheet.insertChart(chart);

Parameter

NameTypBeschreibung
headersIntegerDie Anzahl der Zeilen oder Spalten, die als Überschriften behandelt werden sollen. Bei negativen Werten werden Überschriften automatisch erkannt.

Rückflug

EmbeddedChartBuilder – dieser Builder, zur Verkettung


setOption(option, value)

Hier legen Sie erweiterte Optionen für dieses Diagramm fest. Eine Liste der verfügbaren Optionen finden Sie unter Diagrammkonfigurationsoptionen.

Bei dieser Methode wird nicht geprüft, ob die angegebene Option für diesen Diagrammtyp gültig ist oder ob der Wert das richtige Format bzw. die richtige Struktur hat.

In diesem Beispiel wird gezeigt, wie Sie den Titel ändern und eine Legende festlegen.

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const sheet = spreadsheet.getSheets()[0];
const chart = sheet.newChart()
 .setOption('title', 'Earnings projections')
 .setOption('legend', {
   position: 'top',
   textStyle: { color: 'blue', fontSize: 16 },
 }).build();

Parameter

NameTypBeschreibung
optionStringDer Name der Option.
valueObjectDer Wert der Option.

Rückflug

EmbeddedChartBuilder – Dieser Builder zur Verkettung.


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Hiermit wird die Position festgelegt, an der das Diagramm auf dem Tabellenblatt angezeigt wird. anchorRowPos und anchorColPos beginnen mit 1.

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

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setPosition(5, 5, 0, 0)
                  .build();

sheet.insertChart(chart);

Parameter

NameTypBeschreibung
anchorRowPosIntegerDie Oberseite des Diagramms ist in dieser Zeile verankert.
anchorColPosIntegerDie linke Seite des Diagramms ist in dieser Spalte verankert.
offsetXIntegerDie rechte obere Ecke des Diagramms wird um diese Anzahl von Pixeln verschoben.
offsetYIntegerDie linke untere Ecke des Diagramms wird um diese Anzahl von Pixeln verschoben.

Rückflug

EmbeddedChartBuilder – dieser Builder, zur Verkettung


setRange(start, end)

Legt den Bereich für das Diagramm fest.

Wenn Datenpunkte außerhalb des Bereichs liegen, wird der Bereich erweitert, um diese Datenpunkte einzubeziehen.

Parameter

NameTypBeschreibung
startNumberDer Wert für die unterste Rasterlinie der Bereichsachse.
endNumberDer Wert für die oberste Rasterlinie der Bereichsachse.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.


setStacked()

Es werden gestapelte Linien verwendet, d. h., Linien- und Balkenwerte werden gestapelt (aufsummiert). Standardmäßig wird kein Stapeln verwendet.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.


setTitle(chartTitle)

Hiermit wird der Titel des Diagramms festgelegt. Der Titel wird zentriert über dem Diagramm angezeigt.

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

Parameter

NameTypBeschreibung
chartTitleStringden Diagrammtitel.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.


setTitleTextStyle(textStyle)

Hiermit wird der Textstil des Diagrammtitels festgelegt.

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

Parameter

NameTypBeschreibung
textStyleTextStyleDer Textstil für den Diagrammtitel. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.


setTransposeRowsAndColumns(transpose)

Hiermit wird festgelegt, ob die Zeilen und Spalten des Diagramms transponiert werden. Wenn true festgelegt ist, werden die Zeilen und Spalten vertauscht. Die Standardeinstellung ist false.

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

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

sheet.insertChart(chart);

Parameter

NameTypBeschreibung
transposeBooleanBei true werden die Zeilen und Spalten, die zum Erstellen des Diagramms verwendet werden, transponiert.

Rückflug

EmbeddedChartBuilder – dieser Builder, zur Verkettung


setXAxisTextStyle(textStyle)

Hiermit wird der Textstil der horizontalen Achse festgelegt.

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

Parameter

NameTypBeschreibung
textStyleTextStyleDer Textstil für den Titel der horizontalen Achse. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.


setXAxisTitle(title)

Fügen Sie der horizontalen Achse einen Titel hinzu. Der Titel ist zentriert und wird unter den Achsenwertlabels angezeigt.

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

Parameter

NameTypBeschreibung
titleStringDer Titel der X-Achse.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.


setXAxisTitleTextStyle(textStyle)

Hiermit wird der Textstil für den Titel der horizontalen Achse festgelegt.

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

Parameter

NameTypBeschreibung
textStyleTextStyleDer Textstil für den Titel der horizontalen Achse. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.


setYAxisTextStyle(textStyle)

Hiermit wird der Textstil der vertikalen Achse festgelegt.

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

Parameter

NameTypBeschreibung
textStyleTextStyleDer Textstil für den Titel der horizontalen Achse. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.


setYAxisTitle(title)

Fügen Sie der vertikalen Achse einen Titel hinzu. Der Titel ist zentriert und wird links neben den Wertelabels angezeigt.

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

Parameter

NameTypBeschreibung
titleStringDer Titel der Y-Achse.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.


setYAxisTitleTextStyle(textStyle)

Hiermit wird der Textstil für den Titel der vertikalen Achse festgelegt.

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

Parameter

NameTypBeschreibung
textStyleTextStyleDer Textstil für den Titel der horizontalen Achse. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.


useLogScale()

Die Bereichsachse wird logarithmisch skaliert. Alle Werte müssen positiv sein. Die Bereichsachse ist die vertikale Achse für vertikale Diagramme (z. B. Linien-, Flächen- oder Säulendiagramme) und die horizontale Achse für horizontale Diagramme (z. B. Balkendiagramme).

Rückflug

EmbeddedBarChartBuilder – Dieser Builder eignet sich für die Verkettung.