Diese Seite wurde von der Cloud Translation API übersetzt.

Class ScatterChartBuilder

Builder für Streudiagramme. Weitere Informationen finden Sie in der Google Tabellen-Dokumentation.

Hier ist ein Beispiel für ein Streudiagramm. Die Daten werden aus einer Google-Tabelle importiert.

// Get sample data from a spreadsheet.
const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=C1%3AD' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';

const chartBuilder = Charts.newScatterChart()
                         .setTitle('Adjusted GDP & U.S. Population')
                         .setXAxisTitle('U.S. Population (millions)')
                         .setYAxisTitle('Adjusted GDP ($ billions)')
                         .setDimensions(600, 500)
                         .setLegendPosition(Charts.Position.NONE)
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`build()`	`Chart`	Das Diagramm wird erstellt.
`setBackgroundColor(cssValue)`	`ScatterChartBuilder`	Hier legen Sie die Hintergrundfarbe des Diagramms fest.
`setColors(cssValues)`	`ScatterChartBuilder`	Hiermit legen Sie die Farben für die Linien im Diagramm fest.
`setDataSourceUrl(url)`	`ScatterChartBuilder`	Hiermit wird die URL der Datenquelle festgelegt, über die Daten aus einer externen Quelle wie Google Tabellen abgerufen werden.
`setDataTable(tableBuilder)`	`ScatterChartBuilder`	Legt mithilfe eines DataTableBuilders die Datentabelle fest, die für das Diagramm verwendet werden soll.
`setDataTable(table)`	`ScatterChartBuilder`	Hier legen Sie die Datentabelle fest, die die Linien für das Diagramm sowie die Beschriftungen der X-Achse enthält.
`setDataViewDefinition(dataViewDefinition)`	`ScatterChartBuilder`	Hier legen Sie die Datenansichtsdefinition fest, die für das Diagramm verwendet werden soll.
`setDimensions(width, height)`	`ScatterChartBuilder`	Hier legen Sie die Dimensionen für das Diagramm fest.
`setLegendPosition(position)`	`ScatterChartBuilder`	Hiermit wird die Position der Legende im Verhältnis zum Diagramm festgelegt.
`setLegendTextStyle(textStyle)`	`ScatterChartBuilder`	Hiermit wird der Textstil der Diagrammlegende festgelegt.
`setOption(option, value)`	`ScatterChartBuilder`	Hier legen Sie erweiterte Optionen für dieses Diagramm fest.
`setPointStyle(style)`	`ScatterChartBuilder`	Legt den Stil für Punkte in der Linie fest.
`setTitle(chartTitle)`	`ScatterChartBuilder`	Hiermit wird der Titel des Diagramms festgelegt.
`setTitleTextStyle(textStyle)`	`ScatterChartBuilder`	Hiermit wird der Textstil des Diagrammtitels festgelegt.
`setXAxisLogScale()`	`ScatterChartBuilder`	Die horizontale Achse wird logarithmisch skaliert. Alle Werte müssen positiv sein.
`setXAxisRange(start, end)`	`ScatterChartBuilder`	Legt den Bereich für die horizontale Achse des Diagramms fest.
`setXAxisTextStyle(textStyle)`	`ScatterChartBuilder`	Hiermit wird der Textstil der horizontalen Achse festgelegt.
`setXAxisTitle(title)`	`ScatterChartBuilder`	Fügen Sie der horizontalen Achse einen Titel hinzu.
`setXAxisTitleTextStyle(textStyle)`	`ScatterChartBuilder`	Hiermit wird der Textstil für den Titel der horizontalen Achse festgelegt.
`setYAxisLogScale()`	`ScatterChartBuilder`	Die vertikale Achse wird logarithmisch skaliert. Alle Werte müssen positiv sein.
`setYAxisRange(start, end)`	`ScatterChartBuilder`	Legt den Bereich für die vertikale Achse des Diagramms fest.
`setYAxisTextStyle(textStyle)`	`ScatterChartBuilder`	Hiermit wird der Textstil der vertikalen Achse festgelegt.
`setYAxisTitle(title)`	`ScatterChartBuilder`	Fügen Sie der vertikalen Achse einen Titel hinzu.
`setYAxisTitleTextStyle(textStyle)`	`ScatterChartBuilder`	Hiermit wird der Textstil für den Titel der vertikalen Achse festgelegt.

Detaillierte Dokumentation

`build()`

Das Diagramm wird erstellt.

Rückflug

Chart – Ein Diagrammobjekt, das in Dokumente, UI-Elemente eingebettet oder als statisches Bild verwendet werden kann.

`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

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

Rückflug

ScatterChartBuilder – Dieser Builder eignet sich für die 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

Name	Typ	Beschreibung
`cssValues`	`String[]`	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

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

`setDataSourceUrl(url)`

Hiermit wird die URL der Datenquelle festgelegt, über die Daten aus einer externen Quelle wie Google Tabellen abgerufen werden. Wenn eine Datenquellen-URL und eine DataTable angegeben werden, wird die Datenquellen-URL ignoriert.

Weitere Informationen zum Abfragen von Datenquellen finden Sie in der Google Tabellen-Dokumentation.

Parameter

Name	Typ	Beschreibung
`url`	`String`	Die URL der Datenquelle, einschließlich aller Suchparameter.

Rückflug

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

`setDataTable(tableBuilder)`

Legt mithilfe eines DataTableBuilders die Datentabelle fest, die für das Diagramm verwendet werden soll. Dies ist eine praktische Methode, um die Datentabelle festzulegen, ohne build() aufrufen zu müssen.

Parameter

Name	Typ	Beschreibung
`tableBuilder`	`DataTableBuilder`	Ein Tool zum Erstellen von Datentabellen. Im Rahmen dieses Aufrufs wird sofort eine neue Datentabelle erstellt. Alle weiteren Änderungen am Builder werden daher nicht im Diagramm berücksichtigt.

Rückflug

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

`setDataTable(table)`

Hier legen Sie die Datentabelle fest, die die Linien für das Diagramm sowie die Beschriftungen der X-Achse enthält. Die erste Spalte sollte ein String sein und die Labels der horizontalen Achse enthalten. Es kann eine beliebige Anzahl von Spalten folgen, die alle numerisch sein müssen. Jede Spalte wird als separate Zeile angezeigt.

Parameter

Name	Typ	Beschreibung
`table`	`DataTableSource`	Die Datentabelle, die für das Diagramm verwendet werden soll.

Rückflug

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

`setDataViewDefinition(dataViewDefinition)`

Hier legen Sie die Datenansichtsdefinition fest, die für das Diagramm verwendet werden soll.

Parameter

Name	Typ	Beschreibung
`dataViewDefinition`	`DataViewDefinition`	Ein Datenansichtsdefinition-Objekt, das die Ansicht definiert, die aus der angegebenen Datenquelle für das Zeichnen des Diagramms abgeleitet werden soll.

Rückflug

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

`setDimensions(width, height)`

Hier legen Sie die Dimensionen für das Diagramm fest.

Parameter

Name	Typ	Beschreibung
`width`	`Integer`	Die Breite des Diagramms in Pixeln.
`height`	`Integer`	Die Höhe des Diagramms in Pixeln.

Rückflug

ScatterChartBuilder – Dieser Builder eignet sich für die 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

ScatterChartBuilder – 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

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

Rückflug

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

`setOption(option, value)`

Hier legen Sie erweiterte Optionen für dieses Diagramm fest. Hier finden Sie die verfügbaren Optionen für dieses Diagramm. Diese Methode hat keine Auswirkungen, wenn die angegebene Option ungültig ist.

// Build a scatter chart with a 1-second animation duration.
const builder = Charts.newScatterChart();
builder.setOption('animation.duration', 1000);
const chart = builder.build();

Parameter

Name	Typ	Beschreibung
`option`	`String`	Die Option, die festgelegt werden soll.
`value`	`Object`	Der festzulegende Wert.

Rückflug

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

`setPointStyle(style)`

Legt den Stil für Punkte in der Linie fest. Standardmäßig haben Punkte keinen bestimmten Stil und nur die Linie ist sichtbar.

// Creates a line chart builder and sets large point style.
const builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

Parameter

Name	Typ	Beschreibung
`style`	`PointStyle`	Der Stil, der für Punkte in der Linie verwendet werden soll.

Rückflug

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

Weitere Informationen

PointStyle

`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

Name	Typ	Beschreibung
`chartTitle`	`String`	den Diagrammtitel.

Rückflug

ScatterChartBuilder – 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

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

Rückflug

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

`setXAxisLogScale()`

Die horizontale Achse wird logarithmisch skaliert. Alle Werte müssen positiv sein.

Rückflug

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

`setXAxisRange(start, end)`

Legt den Bereich für die horizontale Achse des Diagramms fest.

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

// Creates a scatter chart builder and sets the X-axis range to be 0 to 100.
const builder = Charts.newTableChart();
builder.setXAxisRange(0, 100);

Parameter

Name	Typ	Beschreibung
`start`	`Number`	Der Wert für die unterste Rasterlinie der horizontalen Achse.
`end`	`Number`	Der Wert für die oberste Linie der horizontalen Achse.

Rückflug

ScatterChartBuilder – Dieser Builder eignet sich für die 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

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

Rückflug

ScatterChartBuilder – 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

Name	Typ	Beschreibung
`title`	`String`	Der Titel der X-Achse.

Rückflug

ScatterChartBuilder – 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

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

Rückflug

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

`setYAxisLogScale()`

Die vertikale Achse wird logarithmisch skaliert. Alle Werte müssen positiv sein.

Rückflug

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

`setYAxisRange(start, end)`

Legt den Bereich für die vertikale Achse des Diagramms fest. Wenn Datenpunkte außerhalb des Bereichs liegen, wird der Bereich erweitert, um diese Datenpunkte einzubeziehen.

// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100.
const builder = Charts.newTableChart();
builder.setYAxisRange(0, 100);

Parameter

Name	Typ	Beschreibung
`start`	`Number`	Der Wert für die unterste Rasterlinie der vertikalen Achse.
`end`	`Number`	Der Wert für die höchste Linie des Rasters der vertikalen Achse.

Rückflug

ScatterChartBuilder – 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

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

Rückflug

ScatterChartBuilder – 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

Name	Typ	Beschreibung
`title`	`String`	Der Titel der Y-Achse.

Rückflug

ScatterChartBuilder – 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

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

Rückflug

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