Class PieChartBuilder

PieChartBuilder

Ein Builder für Kreisdiagramme. Weitere Informationen finden Sie in der Google Charts-Dokumentation.

Hier ist ein Beispiel für die Erstellung eines Kreisdiagramms. Die Daten werden aus einer Google-Tabelle importiert. 

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

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

const chart = chartBuilder.build();

Methoden

MethodeRückgabetypKurzbeschreibung
build()ChartErstellt das Diagramm.
reverseCategories()PieChartBuilderKehrt die Darstellung von Reihen auf der Bereichsachse um.
set3D()PieChartBuilderLegt fest, dass das Diagramm dreidimensional dargestellt wird.
setBackgroundColor(cssValue)PieChartBuilderLegt die Hintergrundfarbe für das Diagramm fest.
setColors(cssValues)PieChartBuilderLegt die Farben für die Linien im Diagramm fest.
setDataSourceUrl(url)PieChartBuilderLegt die Datenquellen-URL fest, die verwendet wird, um Daten aus einer externen Quelle wie Google Sheets abzurufen.
setDataTable(tableBuilder)PieChartBuilderLegt die Datentabelle fest, die für das Diagramm verwendet werden soll. Dazu wird ein DataTableBuilder verwendet.
setDataTable(table)PieChartBuilderLegt die Datentabelle fest, die die Linien für das Diagramm sowie die X-Achsenbeschriftungen enthält.
setDataViewDefinition(dataViewDefinition)PieChartBuilderLegt die Definition der Datenansicht fest, die für das Diagramm verwendet werden soll.
setDimensions(width, height)PieChartBuilderLegt die Abmessungen für das Diagramm fest.
setLegendPosition(position)PieChartBuilderHiermit wird die Position der Legende im Verhältnis zum Diagramm festgelegt.
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.

Rückflug

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

reverseCategories()

Kehrt die Darstellung von Reihen auf der Bereichsachse um. Bei Diagrammen mit vertikalem Bereich (z. B. Linien-, Flächen- oder Säulendiagrammen) wird die horizontale Achse von rechts nach links gezeichnet. Bei Diagrammen mit horizontalem Bereich (z. B. Balkendiagrammen) wird die vertikale Achse von oben nach unten gezeichnet. Bei Kreisdiagrammen werden die Segmente gegen den Uhrzeigersinn gezeichnet. 

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

Rückflug

PieChartBuilder – Dieser Builder, nützlich für die Verkettung.

set3D()

Legt fest, dass das Diagramm dreidimensional dargestellt wird.

Rückflug

PieChartBuilder – Dieser Builder, nützlich für die Verkettung.

setBackgroundColor(cssValue)

Legt die Hintergrundfarbe für das Diagramm fest. 

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

Parameter

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

Rückflug

PieChartBuilder – Dieser Builder, nützlich für die Verkettung.

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

Parameter

NameTypBeschreibung
cssValuesString[]Ein Array von CSS-Farbwerten, z. B. ["red", "#acf"]. Das n-te Element im Array stellt die Farbe der n-ten Linie im Diagramm dar.

Rückflug

PieChartBuilder – Dieser Builder, nützlich für die Verkettung.

setDataSourceUrl(url)

Legt die Datenquellen-URL fest, die verwendet wird, um Daten aus einer externen Quelle wie Google Sheets abzurufen. 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 Charts-Dokumentation.

Parameter

NameTypBeschreibung
urlStringDie Datenquellen-URL, einschließlich aller Suchparameter.

Rückflug

PieChartBuilder – Dieser Builder, nützlich für die Verkettung.

setDataTable(tableBuilder)

Legt die Datentabelle fest, die für das Diagramm verwendet werden soll. Dazu wird ein DataTableBuilder verwendet. Dies ist eine praktische Methode zum Festlegen der Datentabelle, ohne dass build() aufgerufen werden muss.

Parameter

NameTypBeschreibung
tableBuilderDataTableBuilderEin Tool zum Erstellen von Datentabellen. Im Rahmen dieses Aufrufs wird sofort eine neue Datentabelle erstellt. Alle weiteren Aktualisierungen des Builders werden daher nicht im Diagramm berücksichtigt.

Rückflug

PieChartBuilder – Dieser Builder, nützlich für die Verkettung.

setDataTable(table)

Legt die Datentabelle fest, die die Linien für das Diagramm sowie die X-Achsenbeschriftungen enthält. Die erste Spalte muss ein String sein und die Labels für die horizontale Achse enthalten. Es können beliebig viele Spalten folgen, die alle numerisch sein müssen. Jede Spalte wird als separate Zeile dargestellt.

Parameter

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

Rückflug

PieChartBuilder – Dieser Builder, nützlich für die Verkettung.

setDataViewDefinition(dataViewDefinition)

Legt die Definition der Datenansicht fest, die für das Diagramm verwendet werden soll.

Parameter

NameTypBeschreibung
dataViewDefinitionDataViewDefinitionEin Objekt zur Definition der Datenansicht, das die Ansicht definiert, die für das Zeichnen des Diagramms aus der angegebenen Datenquelle abgeleitet werden soll.

Rückflug

PieChartBuilder – Dieser Builder, nützlich für die Verkettung.

setDimensions(width, height)

Legt die Abmessungen für das Diagramm fest.

Parameter

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

Rückflug

PieChartBuilder – Dieser Builder, nützlich 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

NameTypBeschreibung
positionPositionDie Position der Legende.

Rückflug

PieChartBuilder – Dieser Builder, nützlich für die Verkettung.

setLegendTextStyle(textStyle)

Legt den Textstil der Diagrammlegende fest. 

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

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

Rückflug

PieChartBuilder – Dieser Builder, nützlich für die Verkettung.

setOption(option, value)

Legt erweiterte Optionen für dieses Diagramm fest. Verfügbare 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.
const builder = Charts.newPieChart();
builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}});
const chart = builder.build();

Parameter

NameTypBeschreibung
optionStringDie festzulegende Option.
valueObjectDer festzulegende Wert.

Rückflug

PieChartBuilder – Dieser Builder, nützlich für die Verkettung.

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

Parameter

NameTypBeschreibung
chartTitleStringden Diagrammtitel.

Rückflug

PieChartBuilder – Dieser Builder, nützlich für die Verkettung.

setTitleTextStyle(textStyle)

Legt den Textstil des Diagrammtitels fest. 

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

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

Rückflug

PieChartBuilder – Dieser Builder, nützlich für die Verkettung.