Diese Seite wurde von der Cloud Translation API übersetzt.

Class ScatterChartBuilder

Builder für Streudiagramme. Weitere Informationen finden Sie in der Dokumentation zu Google Charts.

Das folgende Beispiel zeigt, wie Sie ein Streudiagramm erstellen. Die Daten werden aus einer Google-Tabelle importiert.

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

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

var chart = chartBuilder.build();

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`build()`	`Chart`	Erstellt das Diagramm.
`setBackgroundColor(cssValue)`	`ScatterChartBuilder`	Legt die Hintergrundfarbe des Diagramms fest.
`setColors(cssValues)`	`ScatterChartBuilder`	Legt die Farben für die Linien im Diagramm fest.
`setDataSourceUrl(url)`	`ScatterChartBuilder`	Legt die URL der Datenquelle fest, über die Daten aus einer externen Quelle wie Google Tabellen abgerufen werden.
`setDataTable(tableBuilder)`	`ScatterChartBuilder`	Legt die Datentabelle für das Diagramm mithilfe eines DataTableBuilders fest.
`setDataTable(table)`	`ScatterChartBuilder`	Legt die Datentabelle fest, die die Linien für das Diagramm sowie die Beschriftungen der X-Achse enthält.
`setDataViewDefinition(dataViewDefinition)`	`ScatterChartBuilder`	Legt die Definition der Datenansicht für das Diagramm fest.
`setDimensions(width, height)`	`ScatterChartBuilder`	Legt die Abmessungen des Diagramms fest.
`setLegendPosition(position)`	`ScatterChartBuilder`	Legt die Position der Legende in Bezug auf das Diagramm fest.
`setLegendTextStyle(textStyle)`	`ScatterChartBuilder`	Legt den Textstil der Diagrammlegende fest.
`setOption(option, value)`	`ScatterChartBuilder`	Legt erweiterte Optionen für dieses Diagramm fest.
`setPointStyle(style)`	`ScatterChartBuilder`	Legt den Stil für Punkte in der Linie fest.
`setTitle(chartTitle)`	`ScatterChartBuilder`	Legt den Titel des Diagramms fest.
`setTitleTextStyle(textStyle)`	`ScatterChartBuilder`	Legt den Textstil des Diagrammtitels fest.
`setXAxisLogScale()`	`ScatterChartBuilder`	Wandelt die horizontale Achse in eine logarithmische Skala um (es müssen alle Werte positiv sein).
`setXAxisRange(start, end)`	`ScatterChartBuilder`	Legt den Bereich für die horizontale Achse des Diagramms fest.
`setXAxisTextStyle(textStyle)`	`ScatterChartBuilder`	Legt den Textstil der horizontalen Achse fest.
`setXAxisTitle(title)`	`ScatterChartBuilder`	Fügt der horizontalen Achse einen Titel hinzu.
`setXAxisTitleTextStyle(textStyle)`	`ScatterChartBuilder`	Legt den Textstil des Titels der horizontalen Achse fest.
`setYAxisLogScale()`	`ScatterChartBuilder`	Wandelt die vertikale Achse in eine logarithmische Skala um (es müssen alle Werte positiv sein).
`setYAxisRange(start, end)`	`ScatterChartBuilder`	Legt den Bereich für die vertikale Achse des Diagramms fest.
`setYAxisTextStyle(textStyle)`	`ScatterChartBuilder`	Legt den Textstil der vertikalen Achse fest.
`setYAxisTitle(title)`	`ScatterChartBuilder`	Fügt der vertikalen Achse einen Titel hinzu.
`setYAxisTitleTextStyle(textStyle)`	`ScatterChartBuilder`	Legt den Textstil des Titels der vertikalen Achse fest.

Detaillierte Dokumentation

`build()`

Erstellt das Diagramm.

Return

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

`setBackgroundColor(cssValue)`

Legt die Hintergrundfarbe des Diagramms fest.

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

Parameter

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

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`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.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

Parameter

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

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setDataSourceUrl(url)`

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

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

Parameter

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

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setDataTable(tableBuilder)`

Legt die Datentabelle für das Diagramm mithilfe eines DataTableBuilders fest. Dies ist eine praktische Methode zum Festlegen der Datentabelle, ohne build() aufrufen zu müssen.

Parameter

Name	Typ	Beschreibung
`tableBuilder`	`DataTableBuilder`	Ein Datentabellen-Builder. Im Rahmen dieses Aufrufs wird sofort eine neue Datentabelle erstellt, sodass weitere Aktualisierungen des Builders nicht im Diagramm widergespiegelt werden.

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setDataTable(table)`

Legt 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 Beschriftungen der horizontalen Achsen enthalten. Es kann eine beliebige Anzahl von Spalten folgen, alle müssen numerisch sein. Jede Spalte wird als separate Zeile angezeigt.

Parameter

Name	Typ	Beschreibung
`table`	`DataTableSource`	Die Datentabelle für das Diagramm.

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setDataViewDefinition(dataViewDefinition)`

Legt die Definition der Datenansicht für das Diagramm fest.

Parameter

Name	Typ	Beschreibung
`dataViewDefinition`	`DataViewDefinition`	Ein Datenansichtsdefinitionsobjekt, das die Ansicht definiert, die aus der angegebenen Datenquelle für die Diagrammzeichnung abgeleitet werden soll.

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setDimensions(width, height)`

Legt die Abmessungen des Diagramms fest.

Parameter

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

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setLegendPosition(position)`

Legt die Position der Legende in Bezug auf das Diagramm fest. Standardmäßig ist keine Legende vorhanden.

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

Parameter

Name	Typ	Beschreibung
`position`	`Position`	Die Position der Legende.

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setLegendTextStyle(textStyle)`

Legt den Textstil der Diagrammlegende fest.

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

Parameter

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

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setOption(option, value)`

Legt 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.
var builder = Charts.newScatterChart();
builder.setOption('animation.duration', 1000);
var chart = builder.build();

Parameter

Name	Typ	Beschreibung
`option`	`String`	Die festzulegende Option.
`value`	`Object`	Der festzulegende Wert.

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setPointStyle(style)`

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

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

Parameter

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

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

Weitere Informationen

PointStyle

`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'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')

Parameter

Name	Typ	Beschreibung
`chartTitle`	`String`	Diagrammtitel.

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setTitleTextStyle(textStyle)`

Legt den Textstil des Diagrammtitels fest.

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

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.

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setXAxisLogScale()`

Wandelt die horizontale Achse in eine logarithmische Skala um (es müssen alle Werte positiv sein).

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setXAxisRange(start, end)`

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

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

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

Parameter

Name	Typ	Beschreibung
`start`	`Number`	Der Wert für die unterste Rasterlinie auf der horizontalen Achse.
`end`	`Number`	Der Wert für die höchste Rasterlinie auf der horizontalen Achse.

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`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.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

Parameter

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

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setXAxisTitle(title)`

Fügt der horizontalen Achse einen Titel hinzu. Der Titel ist zentriert und erscheint unterhalb der Wertelabels der Achse.

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

Parameter

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

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setXAxisTitleTextStyle(textStyle)`

Legt den Textstil des Titels der horizontalen Achse fest.

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

Parameter

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

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setYAxisLogScale()`

Wandelt die vertikale Achse in eine logarithmische Skala um (es müssen alle Werte positiv sein).

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setYAxisRange(start, end)`

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

// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100.
var 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 Rasterlinie auf der vertikalen Achse.

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`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.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

Parameter

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

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setYAxisTitle(title)`

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

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

Parameter

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

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.

`setYAxisTitleTextStyle(textStyle)`

Legt den Textstil des Titels der vertikalen Achse fest.

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

Parameter

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

Return

ScatterChartBuilder: Dieser Builder wird für Verkettungen verwendet.