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 | Hiermit legen Sie die Farben der Linien im Diagramm fest. |
setDataSourceUrl(url) | ScatterChartBuilder | Legt die Datenquellen-URL fest, die zum Abrufen von Daten aus einer externen Quelle wie Google verwendet wird Google Tabellen. |
setDataTable(tableBuilder) | ScatterChartBuilder | Legt die für das Diagramm zu verwendende Datentabelle 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 Datenansichtsdefinition für das Diagramm fest. |
setDimensions(width, height) | ScatterChartBuilder | Legt die Dimensionen für das Diagramm 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 | Ändert die horizontale Achse in eine logarithmische Skala (alle Werte müssen 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 für den Titel der horizontalen Achse fest. |
setYAxisLogScale() | ScatterChartBuilder | Ändert die vertikale Achse in eine logarithmische Skala (alle Werte müssen 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 für den Titel der vertikalen Achse fest. |
Detaillierte Dokumentation
build()
Erstellt das Diagramm.
Rückflug
Chart
(Diagrammobjekt): Ein Diagrammobjekt, das in Dokumente und UI-Elemente eingebettet oder als statisches Objekt verwendet werden kann.
Bild.
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" . |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
setColors(cssValues)
Hiermit legen Sie die Farben der 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 mit CSS-Farbwerten, z. B. ["red", "#acf"] . Das n-te Element
im Array die Farbe der n-ten Linie im Diagramm darstellt. |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
setDataSourceUrl(url)
Legt die Datenquellen-URL fest, die zum Abrufen von Daten aus einer externen Quelle wie Google verwendet wird Google Tabellen. Wenn eine Datenquellen-URL und eine Datentabelle angegeben werden, wird die Datenquellen-URL ignoriert.
Weitere Informationen zum Abfragen von Datenquellen finden Sie in der Dokumentation zu Google Charts.
Parameter
Name | Typ | Beschreibung |
---|---|---|
url | String | Die URL der Datenquelle, einschließlich etwaiger Abfrageparameter. |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
setDataTable(tableBuilder)
Legt die für das Diagramm zu verwendende Datentabelle mithilfe eines DataTableBuilders fest. Dies ist eine unkomplizierte Methode,
zum Festlegen der Datentabelle, ohne build()
aufrufen zu müssen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
tableBuilder | DataTableBuilder | Tool zum Erstellen von Datentabellen Im Rahmen dieses Vorgangs wird sofort eine neue Datentabelle erstellt. , sodass weitere Aktualisierungen des Builders nicht im Diagramm berücksichtigt werden. |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
setDataTable(table)
Legt die Datentabelle fest, die die Linien für das Diagramm sowie die Beschriftungen der X-Achse enthält. Die sollte die erste Spalte ein String sein und die Beschriftungen der horizontalen Achse enthalten. Beliebige Anzahl von Spalten müssen alle numerisch sein. 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, der für Verkettungen nützlich ist.
setDataViewDefinition(dataViewDefinition)
Legt die Datenansichtsdefinition für das Diagramm fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
dataViewDefinition | DataViewDefinition | Ein Objekt zur Definition der Datenansicht, das die zu erfassende Ansicht definiert. die aus der angegebenen Datenquelle für die Diagrammzeichnung abgeleitet wird. |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
setDimensions(width, height)
Legt 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, der für Verkettungen nützlich ist.
setLegendPosition(position)
Legt die Position der Legende in Bezug auf das Diagramm fest. Standardmäßig gibt es keine Legende.
// 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. |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
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. |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
setOption(option, value)
Legt erweiterte Optionen für dieses Diagramm fest. Verfügbare Optionen für dieses Diagramms. 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. |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
setPointStyle(style)
Legt den Stil für Punkte in der Linie fest. Standardmäßig gibt es für Punkte keine speziellen Stile, die Linie sichtbar ist.
// 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 in der Linie verwendet werden soll. |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
Weitere Informationen
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. |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
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 für den Diagrammtitel. Sie können ein TextStyleBuilder -Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen. |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
setXAxisLogScale()
Ändert die horizontale Achse in eine logarithmische Skala (alle Werte müssen positiv sein).
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
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 Daten erweitert. Punkte.
// 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 der horizontalen Achse. |
end | Number | Der Wert für die höchste Rasterlinie der horizontalen Achse. |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
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 für den Titel der horizontalen Achse. Sie können ein TextStyleBuilder -Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen. |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
setXAxisTitle(title)
Fügt der horizontalen Achse einen Titel hinzu. Der Titel ist zentriert und wird unter dem Achsenwert angezeigt Labels.
// 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. |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
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. var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); var 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, der für Verkettungen nützlich ist.
setYAxisLogScale()
Ändert die vertikale Achse in eine logarithmische Skala (alle Werte müssen positiv sein).
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
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 der vertikalen Achse. |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
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 für den Titel der horizontalen Achse. Sie können ein TextStyleBuilder -Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen. |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
setYAxisTitle(title)
Fügt der vertikalen Achse einen Titel hinzu. Der Titel wird zentriert und links neben dem Wert angezeigt. Labels.
// 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. |
Rückflug
ScatterChartBuilder
: Dieser Builder, der für Verkettungen nützlich ist.
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. var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); var 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, der für Verkettungen nützlich ist.