Class EmbeddedBarChartBuilder

EmbeddedBarChartBuilder

Builder für Balkendiagramme. Weitere Informationen finden Sie in der Gviz-Dokumentation.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
addRange(range)	EmbeddedChartBuilder	Fügt dem Diagramm, das von diesem Builder geändert wird, einen Bereich hinzu.
asAreaChart()	EmbeddedAreaChartBuilder	Legt den Diagrammtyp auf „AreaChart“ fest und gibt ein EmbeddedAreaChartBuilder zurück.
asBarChart()	EmbeddedBarChartBuilder	Legt den Diagrammtyp auf „BarChart“ fest und gibt ein EmbeddedBarChartBuilder zurück.
asColumnChart()	EmbeddedColumnChartBuilder	Legt den Diagrammtyp auf „ColumnChart“ fest und gibt ein EmbeddedColumnChartBuilder zurück.
asComboChart()	EmbeddedComboChartBuilder	Legt den Diagrammtyp auf „ComboChart“ fest und gibt ein EmbeddedComboChartBuilder zurück.
asHistogramChart()	EmbeddedHistogramChartBuilder	Legt den Diagrammtyp auf HistogramChart fest und gibt ein EmbeddedHistogramChartBuilder zurück.
asLineChart()	EmbeddedLineChartBuilder	Legt den Diagrammtyp auf LineChart fest und gibt ein EmbeddedLineChartBuilder zurück.
asPieChart()	EmbeddedPieChartBuilder	Legt den Diagrammtyp auf „PieChart“ fest und gibt ein EmbeddedPieChartBuilder zurück.
asScatterChart()	EmbeddedScatterChartBuilder	Legt den Diagrammtyp auf „ScatterChart“ fest und gibt ein EmbeddedScatterChartBuilder zurück.
asTableChart()	EmbeddedTableChartBuilder	Legt den Diagrammtyp auf „TableChart“ fest und gibt ein EmbeddedTableChartBuilder zurück.
build()	EmbeddedChart	Erstellt das Diagramm neu, um alle Änderungen zu berücksichtigen.
clearRanges()	EmbeddedChartBuilder	Entfernt alle Bereiche aus dem Diagramm, das mit diesem Builder geändert wird.
getChartType()	ChartType	Gibt den aktuellen Diagrammtyp zurück.
getContainer()	ContainerInfo	Gibt das Diagramm ContainerInfo zurück, das die Position des Diagramms im Tabellenblatt angibt.
getRanges()	Range[]	Gibt eine Kopie der Liste der Bereiche zurück, die derzeit Daten für dieses Diagramm liefern.
removeRange(range)	EmbeddedChartBuilder	Entfernt den angegebenen Bereich aus dem Diagramm, das von diesem Builder geändert wird.
reverseCategories()	EmbeddedBarChartBuilder	Kehrt die Darstellung von Reihen auf der Bereichsachse um.
reverseDirection()	EmbeddedBarChartBuilder	Kehrt die Richtung um, in der die Balken entlang der horizontalen Achse wachsen.
setBackgroundColor(cssValue)	EmbeddedBarChartBuilder	Legt die Hintergrundfarbe für das Diagramm fest.
setChartType(type)	EmbeddedChartBuilder	Ändert den Diagrammtyp.
setColors(cssValues)	EmbeddedBarChartBuilder	Legt die Farben für die Linien im Diagramm fest.
setHiddenDimensionStrategy(strategy)	EmbeddedChartBuilder	Legt die Strategie für ausgeblendete Zeilen und Spalten fest.
setLegendPosition(position)	EmbeddedBarChartBuilder	Hiermit wird die Position der Legende im Verhältnis zum Diagramm festgelegt.
setLegendTextStyle(textStyle)	EmbeddedBarChartBuilder	Legt den Textstil der Diagrammlegende fest.
setMergeStrategy(mergeStrategy)	EmbeddedChartBuilder	Legt die Zusammenführungsstrategie fest, die verwendet werden soll, wenn mehrere Bereiche vorhanden sind.
setNumHeaders(headers)	EmbeddedChartBuilder	Legt die Anzahl der Zeilen oder Spalten des Bereichs fest, die als Überschriften behandelt werden sollen.
setOption(option, value)	EmbeddedChartBuilder	Legt erweiterte Optionen für dieses Diagramm fest.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)	EmbeddedChartBuilder	Legt die Position fest und ändert so, wo das Diagramm auf dem Tabellenblatt angezeigt wird.
setRange(start, end)	EmbeddedBarChartBuilder	Legt den Bereich für das Diagramm fest.
setStacked()	EmbeddedBarChartBuilder	Verwendet gestapelte Linien. Das bedeutet, dass Linien- und Balkenwerte gestapelt (kumuliert) werden.
setTitle(chartTitle)	EmbeddedBarChartBuilder	Legt den Titel des Diagramms fest.
setTitleTextStyle(textStyle)	EmbeddedBarChartBuilder	Legt den Textstil des Diagrammtitels fest.
setTransposeRowsAndColumns(transpose)	EmbeddedChartBuilder	Legt fest, ob die Zeilen und Spalten des Diagramms transponiert werden.
setXAxisTextStyle(textStyle)	EmbeddedBarChartBuilder	Legt den Textstil der horizontalen Achse fest.
setXAxisTitle(title)	EmbeddedBarChartBuilder	Fügt der horizontalen Achse einen Titel hinzu.
setXAxisTitleTextStyle(textStyle)	EmbeddedBarChartBuilder	Legt den Textstil für den Titel der horizontalen Achse fest.
setYAxisTextStyle(textStyle)	EmbeddedBarChartBuilder	Legt den Textstil der vertikalen Achse fest.
setYAxisTitle(title)	EmbeddedBarChartBuilder	Fügt der vertikalen Achse einen Titel hinzu.
setYAxisTitleTextStyle(textStyle)	EmbeddedBarChartBuilder	Legt den Textstil für den Titel der vertikalen Achse fest.
useLogScale()	EmbeddedBarChartBuilder	Legt fest, dass die Bereichsachse logarithmisch skaliert wird. Dazu müssen alle Werte positiv sein.

Detaillierte Dokumentation

addRange(range)

Fügt dem Diagramm, das von diesem Builder geändert wird, 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

Name	Typ	Beschreibung
range	Range	Der hinzuzufügende Bereich.

Rückflug

EmbeddedChartBuilder – Dieser Builder zur Verkettung.

---

asAreaChart()

Legt den Diagrammtyp auf „AreaChart“ fest und gibt ein EmbeddedAreaChartBuilder zurück.

Rückflug

EmbeddedAreaChartBuilder – Ein Builder für ein Flächendiagramm.

---

asBarChart()

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

Rückflug

EmbeddedBarChartBuilder – Ein Builder für ein Balkendiagramm.

---

asColumnChart()

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

Rückflug

EmbeddedColumnChartBuilder: Ein Builder für ein Säulendiagramm.

---

asComboChart()

Legt den Diagrammtyp auf „ComboChart“ fest und gibt ein EmbeddedComboChartBuilder zurück.

Rückflug

EmbeddedComboChartBuilder – Ein Builder für ein Kombinationsdiagramm.

---

asHistogramChart()

Legt den Diagrammtyp auf HistogramChart fest und gibt ein EmbeddedHistogramChartBuilder zurück.

Rückflug

EmbeddedHistogramChartBuilder – Ein Builder für ein Histogramm.

---

asLineChart()

Legt den Diagrammtyp auf LineChart fest und gibt ein EmbeddedLineChartBuilder zurück.

Rückflug

EmbeddedLineChartBuilder: Ein Builder für ein Liniendiagramm.

---

asPieChart()

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

Rückflug

EmbeddedPieChartBuilder: Ein Builder für ein Kreisdiagramm.

---

asScatterChart()

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

Rückflug

EmbeddedScatterChartBuilder: Ein Builder für ein Streudiagramm.

---

asTableChart()

Legt den Diagrammtyp auf „TableChart“ fest und gibt ein EmbeddedTableChartBuilder zurück.

Rückflug

EmbeddedTableChartBuilder: Ein Builder für ein Tabellendiagramm.

---

build()

Erstellt das Diagramm neu, um alle Änderungen zu berücksichtigen.

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 noch der Tabelle hinzugefügt werden muss.

---

clearRanges()

Entfernt alle Bereiche aus dem Diagramm, das mit diesem Builder 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 die Position des Diagramms im Tabellenblatt angibt.

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 von 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 Werte nicht 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 renders 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
// is not removed, and does not throw an exception
chartBuilder.removeRange(firstRange);
chartBuilder.removeRange(sheet.getRange('A6:B8'));

const chart = chartBuilder.build();

sheet.insertChart(chart);

Parameter

Name	Typ	Beschreibung
range	Range	Der zu entfernende Bereich.

Rückflug

EmbeddedChartBuilder – Dieser Builder zur Verkettung.

---

reverseCategories()

Kehrt die Darstellung von Reihen auf der Bereichsachse um. Bei Diagrammen mit vertikalem Bereich (z. B. Linien-, Flächen- oder Säulendiagrammen) wird die horizontale Achse von rechts nach links gezeichnet. Bei Diagrammen mit horizontalem Bereich (z. B. Balkendiagrammen) wird die vertikale Achse von oben nach unten gezeichnet. Bei Kreisdiagrammen werden die Segmente gegen den Uhrzeigersinn gezeichnet.

// 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, nützlich für die Verkettung.

---

reverseDirection()

Kehrt die Richtung um, in der die Balken entlang der horizontalen Achse wachsen. Standardmäßig werden Werte von links nach rechts größer. Wenn Sie diese Methode aufrufen, werden sie von rechts nach links erweitert.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setBackgroundColor(cssValue)

Legt die Hintergrundfarbe für das Diagramm fest.

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

Parameter

Name	Typ	Beschreibung
cssValue	String	Der CSS-Wert für die Farbe, z. B. "blue" oder "#00f".

Rückflug

EmbeddedBarChartBuilder – Dieser Builder, nützlich 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

Name	Typ	Beschreibung
type	ChartType	Der Typ, in den dieses Diagramm geändert werden soll.

Rückflug

EmbeddedChartBuilder – Dieser Builder zur Verkettung.

---

setColors(cssValues)

Legt 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

Name	Typ	Beschreibung
cssValues	String[]	Ein Array von CSS-Farbwerten, z. B. ["red", "#acf"]. Das n-te Element im Array stellt die Farbe der n-ten Linie im Diagramm dar.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setHiddenDimensionStrategy(strategy)

Legt die Strategie für ausgeblendete Zeilen und Spalten fest. 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

Name	Typ	Beschreibung
strategy	ChartHiddenDimensionStrategy	Die 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

Name	Typ	Beschreibung
position	Position	Die Position der Legende.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setLegendTextStyle(textStyle)

Legt den Textstil der Diagrammlegende fest.

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

Name	Typ	Beschreibung
textStyle	TextStyle	Der Textstil, der für die Diagrammlegende verwendet werden soll.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder, nützlich 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

Name	Typ	Beschreibung
mergeStrategy	ChartMergeStrategy	Die 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

Name	Typ	Beschreibung
headers	Integer	Die Anzahl der Zeilen oder Spalten, die als Header behandelt werden sollen. Bei negativen Werten werden Header automatisch erkannt.

Rückflug

EmbeddedChartBuilder – Dieser Builder zur Verkettung.

---

setOption(option, value)

Legt erweiterte Optionen für dieses Diagramm fest. Eine Liste der verfügbaren Optionen finden Sie unter Konfigurationsoptionen für Diagramme.

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

Name	Typ	Beschreibung
option	String	Der Name der Option.
value	Object	Der Wert der Option.

Rückflug

EmbeddedChartBuilder – Dieser Builder zur Verkettung.

---

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Legt die Position fest und ändert so, wo das Diagramm auf dem Tabellenblatt angezeigt wird. anchorRowPos und anchorColPos sind 1-basiert.

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

Name	Typ	Beschreibung
anchorRowPos	Integer	Die Oberseite des Diagramms wird in dieser Zeile verankert.
anchorColPos	Integer	Die linke Seite des Diagramms ist in dieser Spalte verankert.
offsetX	Integer	Die rechte obere Ecke des Diagramms wird um diese Anzahl von Pixeln versetzt.
offsetY	Integer	Die linke untere Ecke des Diagramms wird um diese Anzahl von Pixeln versetzt.

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 einzuschließen.

Parameter

Name	Typ	Beschreibung
start	Number	Der Wert für die unterste Rasterlinie der Bereichsachse.
end	Number	Der Wert für die oberste Rasterlinie der Bereichsachse.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setStacked()

Verwendet gestapelte Linien. Das bedeutet, dass Linien- und Balkenwerte gestapelt (kumuliert) werden. Standardmäßig werden keine Stapel erstellt.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setTitle(chartTitle)

Legt den Titel des Diagramms fest. 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

Name	Typ	Beschreibung
chartTitle	String	den Diagrammtitel.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setTitleTextStyle(textStyle)

Legt den Textstil des Diagrammtitels fest.

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

Name	Typ	Beschreibung
textStyle	TextStyle	Der Textstil, der für den Diagrammtitel verwendet werden soll. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setTransposeRowsAndColumns(transpose)

Legt fest, ob die Zeilen und Spalten des Diagramms transponiert werden. Wenn diese Option auf true gesetzt 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

Name	Typ	Beschreibung
transpose	Boolean	Bei true werden die Zeilen und Spalten, die zum Erstellen des Diagramms verwendet werden, transponiert.

Rückflug

EmbeddedChartBuilder – Dieser Builder zur Verkettung.

---

setXAxisTextStyle(textStyle)

Legt den Textstil der horizontalen Achse fest.

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

Name	Typ	Beschreibung
textStyle	TextStyle	Der für den Titel der horizontalen Achse zu verwendende Textstil. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setXAxisTitle(title)

Fügt 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

Name	Typ	Beschreibung
title	String	Der Titel für die X-Achse.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setXAxisTitleTextStyle(textStyle)

Legt den Textstil für den Titel der horizontalen Achse fest.

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

Name	Typ	Beschreibung
textStyle	TextStyle	Der für den Titel der horizontalen Achse zu verwendende Textstil. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setYAxisTextStyle(textStyle)

Legt den Textstil der vertikalen Achse fest.

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

Name	Typ	Beschreibung
textStyle	TextStyle	Der für den Titel der horizontalen Achse zu verwendende Textstil. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setYAxisTitle(title)

Fügt der vertikalen Achse einen Titel hinzu. Der Titel ist zentriert und wird links neben den Wertlabels angezeigt.

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

Parameter

Name	Typ	Beschreibung
title	String	Der Titel für die Y-Achse.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

setYAxisTitleTextStyle(textStyle)

Legt den Textstil für den Titel der vertikalen Achse fest.

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

Name	Typ	Beschreibung
textStyle	TextStyle	Der für den Titel der horizontalen Achse zu verwendende Textstil. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

EmbeddedBarChartBuilder – Dieser Builder, nützlich für die Verkettung.

---

useLogScale()

Legt fest, dass die Bereichsachse logarithmisch skaliert wird. Dazu müssen alle Werte 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, nützlich für die Verkettung.