Class BarChartBuilder

BarChartBuilder

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

Das folgende Beispiel zeigt, wie ein Balkendiagramm erstellt wird. Die Daten werden aus einer Google-Tabelle.

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

 var chartBuilder = Charts.newBarChart()
     .setTitle('Top Grossing Films in US and Canada')
     .setXAxisTitle('USD')
     .setYAxisTitle('Film')
     .setDimensions(600, 500)
     .setLegendPosition(Charts.Position.BOTTOM)
     .setDataSourceUrl(dataSourceUrl);

 var chart = chartBuilder.build();

Methoden

MethodeRückgabetypKurzbeschreibung
build()ChartErstellt das Diagramm.
reverseCategories()BarChartBuilderKehrt die Zeichnung von Reihen auf der Domänenachse um.
reverseDirection()BarChartBuilderKehrt die Richtung um, in die die Balken entlang der horizontalen Achse wachsen.
setBackgroundColor(cssValue)BarChartBuilderLegt die Hintergrundfarbe des Diagramms fest.
setColors(cssValues)BarChartBuilderHiermit legen Sie die Farben der Linien im Diagramm fest.
setDataSourceUrl(url)BarChartBuilderLegt die Datenquellen-URL fest, die zum Abrufen von Daten aus einer externen Quelle wie Google verwendet wird Google Tabellen.
setDataTable(tableBuilder)BarChartBuilderLegt die für das Diagramm zu verwendende Datentabelle mithilfe eines DataTableBuilders fest.
setDataTable(table)BarChartBuilderLegt die Datentabelle fest, die die Linien für das Diagramm sowie die Beschriftungen der X-Achse enthält.
setDataViewDefinition(dataViewDefinition)BarChartBuilderLegt die Datenansichtsdefinition für das Diagramm fest.
setDimensions(width, height)BarChartBuilderLegt die Dimensionen für das Diagramm fest.
setLegendPosition(position)BarChartBuilderLegt die Position der Legende in Bezug auf das Diagramm fest.
setLegendTextStyle(textStyle)BarChartBuilderLegt den Textstil der Diagrammlegende fest.
setOption(option, value)BarChartBuilderLegt erweiterte Optionen für dieses Diagramm fest.
setRange(start, end)BarChartBuilderLegt den Bereich für das Diagramm fest.
setStacked()BarChartBuilderVerwendet gestapelte Linien, d. h. Linien- und Balkenwerte werden gestapelt (akkumuliert).
setTitle(chartTitle)BarChartBuilderLegt den Titel des Diagramms fest.
setTitleTextStyle(textStyle)BarChartBuilderLegt den Textstil des Diagrammtitels fest.
setXAxisTextStyle(textStyle)BarChartBuilderLegt den Textstil der horizontalen Achse fest.
setXAxisTitle(title)BarChartBuilderFügt der horizontalen Achse einen Titel hinzu.
setXAxisTitleTextStyle(textStyle)BarChartBuilderLegt den Textstil für den Titel der horizontalen Achse fest.
setYAxisTextStyle(textStyle)BarChartBuilderLegt den Textstil der vertikalen Achse fest.
setYAxisTitle(title)BarChartBuilderFügt der vertikalen Achse einen Titel hinzu.
setYAxisTitleTextStyle(textStyle)BarChartBuilderLegt den Textstil für den Titel der vertikalen Achse fest.
useLogScale()BarChartBuilderÄndert die Bereichsachse in eine logarithmische Skala (alle Werte müssen positiv sein).

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.


reverseCategories()

Kehrt die Zeichnung von Reihen auf der Domänenachse um. Für vertikale Diagramme (z. B. Linien-, Flächen- oder Säulendiagrammen), bedeutet dies, dass die horizontale Achse von rechts nach links gezeichnet wird. Für Horizontale Diagramme (wie Balkendiagramme) bedeutet, dass die vertikale Achse von oben bis unten. Bei Kreisdiagrammen bedeutet dies, dass die Segmente gegen den Uhrzeigersinn gezeichnet werden.

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

Rückflug

BarChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.


reverseDirection()

Kehrt die Richtung um, in die die Balken entlang der horizontalen Achse wachsen. Standardmäßig werden Werte von links nach rechts wachsen. Durch den Aufruf dieser Methode wachsen sie von rechts nach links.

Rückflug

BarChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.


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

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

Rückflug

BarChartBuilder: 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

NameTypBeschreibung
cssValuesString[]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

BarChartBuilder: 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

NameTypBeschreibung
urlStringDie URL der Datenquelle, einschließlich etwaiger Abfrageparameter.

Rückflug

BarChartBuilder: 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

NameTypBeschreibung
tableBuilderDataTableBuilderTool 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

BarChartBuilder: 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

NameTypBeschreibung
tableDataTableSourceDie Datentabelle, die für das Diagramm verwendet werden soll.

Rückflug

BarChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.


setDataViewDefinition(dataViewDefinition)

Legt die Datenansichtsdefinition für das Diagramm fest.

Parameter

NameTypBeschreibung
dataViewDefinitionDataViewDefinitionEin Objekt zur Definition der Datenansicht, das die zu erfassende Ansicht definiert. die aus der angegebenen Datenquelle für die Diagrammzeichnung abgeleitet wird.

Rückflug

BarChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.


setDimensions(width, height)

Legt die Dimensionen für das Diagramm fest.

Parameter

NameTypBeschreibung
widthIntegerDie Breite des Diagramms in Pixeln.
heightIntegerDie Höhe des Diagramms in Pixeln.

Rückflug

BarChartBuilder: 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

NameTypBeschreibung
positionPositionDie Position der Legende.

Rückflug

BarChartBuilder: 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

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

Rückflug

BarChartBuilder: 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 bar chart with a 1-second animation duration.
var builder = Charts.newBarChart();
builder.setOption('animation.duration', 1000);
var chart = builder.build();

Parameter

NameTypBeschreibung
optionStringDie festzulegende Option.
valueObjectDer festzulegende Wert.

Rückflug

BarChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.


setRange(start, end)

Legt den Bereich für das Diagramm fest.

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

Parameter

NameTypBeschreibung
startNumberDer Wert für die unterste Rasterlinie der Bereichsachse.
endNumberDer Wert für die höchste Rasterlinie der Bereichsachse.

Rückflug

BarChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.


setStacked()

Verwendet gestapelte Linien, d. h. Linien- und Balkenwerte werden gestapelt (akkumuliert). Standardmäßig aber es gibt kein Stapel.

Rückflug

BarChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.


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

NameTypBeschreibung
chartTitleStringDiagrammtitel.

Rückflug

BarChartBuilder: 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

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

Rückflug

BarChartBuilder: 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

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

Rückflug

BarChartBuilder: 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

NameTypBeschreibung
titleStringDer Titel für die X-Achse.

Rückflug

BarChartBuilder: 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

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

Rückflug

BarChartBuilder: 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

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

Rückflug

BarChartBuilder: 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

NameTypBeschreibung
titleStringDer Titel für die Y-Achse.

Rückflug

BarChartBuilder: 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

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

Rückflug

BarChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.


useLogScale()

Ändert die Bereichsachse in eine logarithmische Skala (alle Werte müssen positiv sein). Der Bereich ist die vertikale Achse für vertikale Diagramme (wie Linien, Flächen oder Säulen) und der Horizontale Achse für horizontale Diagramme (z. B. Balken)

Rückflug

BarChartBuilder: Dieser Builder, der für Verkettungen nützlich ist.