Class PieChartBuilder

PieChartBuilder

Ein Generator für Kreisdiagramme Weitere Informationen finden Sie in der Dokumentation zu Google Charts.

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

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

  var chartBuilder = Charts.newPieChart()
      .setTitle('World Population by Continent')
      .setDimensions(600, 500)
      .set3D()
      .setDataSourceUrl(dataSourceUrl);

  var chart = chartBuilder.build();

Methoden

MethodeRückgabetypKurzbeschreibung
build()ChartErstellt das Diagramm.
reverseCategories()PieChartBuilderKehrt die Zeichnung einer Reihe auf der Domainachse um.
set3D()PieChartBuilderLegt fest, dass das Diagramm dreidimensional ist.
setBackgroundColor(cssValue)PieChartBuilderLegt die Hintergrundfarbe des Diagramms fest.
setColors(cssValues)PieChartBuilderLegt die Farben für die Linien im Diagramm fest.
setDataSourceUrl(url)PieChartBuilderLegt die URL der Datenquelle fest, über die Daten aus einer externen Quelle wie Google Tabellen abgerufen werden.
setDataTable(tableBuilder)PieChartBuilderLegt die Datentabelle für das Diagramm mithilfe eines DataTableBuilders fest.
setDataTable(table)PieChartBuilderLegt die Datentabelle fest, die die Linien für das Diagramm sowie die Beschriftungen der X-Achse enthält.
setDataViewDefinition(dataViewDefinition)PieChartBuilderLegt die Definition der Datenansicht für das Diagramm fest.
setDimensions(width, height)PieChartBuilderLegt die Abmessungen des Diagramms fest.
setLegendPosition(position)PieChartBuilderLegt die Position der Legende in Bezug auf das Diagramm fest.
setLegendTextStyle(textStyle)PieChartBuilderLegt den Textstil der Diagrammlegende fest.
setOption(option, value)PieChartBuilderLegt erweiterte Optionen für dieses Diagramm fest.
setTitle(chartTitle)PieChartBuilderLegt den Titel des Diagramms fest.
setTitleTextStyle(textStyle)PieChartBuilderLegt den Textstil des Diagrammtitels 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.


reverseCategories()

Kehrt die Zeichnung einer Reihe auf der Domainachse um. Bei vertikalen Diagrammen wie Linien-, Flächen- oder Säulendiagrammen bedeutet dies, dass die horizontale Achse von rechts nach links gezeichnet wird. Bei horizontalen Diagrammen wie Balkendiagrammen bedeutet dies, dass die vertikale Achse von oben nach unten gezeichnet wird. 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();

Return

PieChartBuilder: Dieser Builder wird für Verkettungen verwendet.


set3D()

Legt fest, dass das Diagramm dreidimensional ist.

Return

PieChartBuilder: Dieser Builder wird für Verkettungen verwendet.


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").

Return

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

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

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

NameTypBeschreibung
urlStringDie URL der Datenquelle, einschließlich aller Suchparameter.

Return

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

NameTypBeschreibung
tableBuilderDataTableBuilderEin Datentabellen-Builder. Im Rahmen dieses Aufrufs wird sofort eine neue Datentabelle erstellt, sodass weitere Aktualisierungen des Builders nicht im Diagramm widergespiegelt werden.

Return

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

NameTypBeschreibung
tableDataTableSourceDie Datentabelle für das Diagramm.

Return

PieChartBuilder: Dieser Builder wird für Verkettungen verwendet.


setDataViewDefinition(dataViewDefinition)

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

Parameter

NameTypBeschreibung
dataViewDefinitionDataViewDefinitionEin Datenansichtsdefinitionsobjekt, das die Ansicht definiert, die aus der angegebenen Datenquelle für die Diagrammzeichnung abgeleitet werden soll.

Return

PieChartBuilder: Dieser Builder wird für Verkettungen verwendet.


setDimensions(width, height)

Legt die Abmessungen des Diagramms fest.

Parameter

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

Return

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

NameTypBeschreibung
positionPositionDie Position der Legende.

Return

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

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

Return

PieChartBuilder: 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 pie chart with a pretty legend.
var builder = Charts.newPieChart();
builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}});
var chart = builder.build();

Parameter

NameTypBeschreibung
optionStringDie festzulegende Option.
valueObjectDer festzulegende Wert.

Return

PieChartBuilder: Dieser Builder wird für Verkettungen verwendet.


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.

Return

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

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

Return

PieChartBuilder: Dieser Builder wird für Verkettungen verwendet.