Class TableChartBuilder

TableChartBuilder

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

Das folgende Beispiel zeigt, wie ein Tabellendiagramm 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%3AF' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';

var chartBuilder = Charts.newTableChart()
    .setDimensions(600, 500)
    .enablePaging(20)
    .setDataSourceUrl(dataSourceUrl);

var chart = chartBuilder.build();

Methoden

MethodeRückgabetypKurzbeschreibung
build()ChartErstellt das Diagramm.
enablePaging(enablePaging)TableChartBuilderLegt fest, ob das Durchblättern der Daten aktiviert werden soll.
enablePaging(pageSize)TableChartBuilderAktiviert Paginierung und legt die Anzahl der Zeilen pro Seite fest.
enablePaging(pageSize, startPage)TableChartBuilderAktiviert Paginierung und legt die Anzahl der Zeilen auf jeder Seite und der ersten Tabellenseite fest, die angezeigt werden soll (Seitennummern basieren auf null).
enableRtlTable(rtlEnabled)TableChartBuilderGrundlegende Unterstützung für linksläufige Sprachen (wie Arabisch oder Hebräisch) durch Umkehren der Spaltenreihenfolge der Tabelle, sodass Spalte 0 die Spalte ganz rechts und die letzte Spalte die Spalte ganz links ist.
enableSorting(enableSorting)TableChartBuilderLegt fest, ob Spalten sortiert werden sollen, wenn der Nutzer auf eine Spaltenüberschrift klickt.
setDataSourceUrl(url)TableChartBuilderLegt die URL der Datenquelle fest, über die Daten aus einer externen Quelle wie Google Tabellen abgerufen werden.
setDataTable(tableBuilder)TableChartBuilderLegt die Datentabelle für das Diagramm mithilfe eines DataTableBuilders fest.
setDataTable(table)TableChartBuilderLegt die Datentabelle fest, die die Linien für das Diagramm sowie die Beschriftungen der X-Achse enthält.
setDataViewDefinition(dataViewDefinition)TableChartBuilderLegt die Definition der Datenansicht für das Diagramm fest.
setDimensions(width, height)TableChartBuilderLegt die Abmessungen des Diagramms fest.
setFirstRowNumber(number)TableChartBuilderLegt die Zeilennummer für die erste Zeile in der Datentabelle fest.
setInitialSortingAscending(column)TableChartBuilderLegt den Index der Spalte fest, nach der die Tabelle anfänglich (aufsteigend) sortiert werden soll.
setInitialSortingDescending(column)TableChartBuilderLegt den Index der Spalte fest, nach der die Tabelle anfänglich sortiert (absteigend) sein soll.
setOption(option, value)TableChartBuilderLegt erweiterte Optionen für dieses Diagramm fest.
showRowNumberColumn(showRowNumber)TableChartBuilderLegt fest, ob die Zeilennummer als erste Spalte der Tabelle angezeigt werden soll.
useAlternatingRowStyle(alternate)TableChartBuilderLegt fest, ob ungeraden und geraden Zeilen in einem Tabellendiagramm ein abwechselnder Farbstil zugewiesen wird.

Detaillierte Dokumentation

build()

Erstellt das Diagramm.

Return

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


enablePaging(enablePaging)

Legt fest, ob das Durchblättern der Daten aktiviert werden soll.

Die Paginierung ist standardmäßig deaktiviert. Wenn Paging aktiviert ist, beträgt die Standardseitengröße 10.

Parameter

NameTypBeschreibung
enablePagingBooleantrue, wenn das Paging aktiviert werden soll, andernfalls false.

Return

TableChartBuilder: Dieser Builder wird für Verkettungen verwendet.


enablePaging(pageSize)

Aktiviert Paginierung und legt die Anzahl der Zeilen pro Seite fest.

Die Standardseitengröße ist 10.

// Creates a table chart builder and enables paging with page size of 5.
var builder = Charts.newTableChart();
builder.enablePaging(5);

Parameter

NameTypBeschreibung
pageSizeIntegerDie Anzahl der Zeilen auf jeder Seite der Tabelle.

Return

TableChartBuilder: Dieser Builder wird für Verkettungen verwendet.


enablePaging(pageSize, startPage)

Aktiviert Paginierung und legt die Anzahl der Zeilen auf jeder Seite und der ersten Tabellenseite fest, die angezeigt werden soll (Seitennummern basieren auf null).

Die Standardseitengröße ist 10 und die Standardstartseite 0.

// Creates a table chart builder and enables paging with page size of 5 and displays page 2
// first.
var builder = Charts.newTableChart();
builder.enablePaging(5, 2);

Parameter

NameTypBeschreibung
pageSizeIntegerDie Anzahl der Zeilen auf jeder Seite der Tabelle.
startPageIntegerDie erste anzuzeigende Tabellenseite (Seitennummern basieren auf null)

Return

TableChartBuilder: Dieser Builder wird für Verkettungen verwendet.


enableRtlTable(rtlEnabled)

Grundlegende Unterstützung für linksläufige Sprachen (wie Arabisch oder Hebräisch) durch Umkehren der Spaltenreihenfolge der Tabelle, sodass Spalte 0 die Spalte ganz rechts und die letzte Spalte die Spalte ganz links ist.

Dies wirkt sich nicht auf den Spaltenindex in den zugrunde liegenden Daten aus, sondern nur auf die Reihenfolge der Anzeige. Auch bei dieser Option wird die vollständige bidirektionale Sprachanzeige (BiDi) von der Tabellenvisualisierung nicht unterstützt. Diese Option wird ignoriert, wenn Sie Paging aktivieren (über die Seitenoption) oder wenn die Tabelle Bildlaufleisten enthält, weil Sie Höhen- und Breitenoptionen angegeben haben, die kleiner als die erforderliche Tabellengröße sind. Standardmäßig ist die linksläufige Unterstützung deaktiviert.

Parameter

NameTypBeschreibung
rtlEnabledBooleantrue, wenn die Unterstützung von rechts nach links aktiviert werden soll, andernfalls false.

Return

TableChartBuilder: Dieser Builder wird für Verkettungen verwendet.


enableSorting(enableSorting)

Legt fest, ob Spalten sortiert werden sollen, wenn der Nutzer auf eine Spaltenüberschrift klickt.

Wenn die Sortierung aktiviert ist und Nutzer auf die Spaltenüberschrift klicken, werden die Zeilen automatisch sortiert. Standardmäßig ist die Sortierung aktiviert.

Parameter

NameTypBeschreibung
enableSortingBooleantrue, um die Sortierung durch Klicken auf Spaltenüberschriften zu aktivieren, andernfalls false.

Return

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

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

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

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

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

TableChartBuilder: Dieser Builder wird für Verkettungen verwendet.


setFirstRowNumber(number)

Legt die Zeilennummer für die erste Zeile in der Datentabelle fest.

Die Standardzeilennummer der ersten Zeile ist 1.

// Creates a table chart builder and sets the first row to be 2.
var builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

Parameter

NameTypBeschreibung
numberIntegerDie Zeilennummer der ersten Zeile in der Datentabelle.

Return

TableChartBuilder: Dieser Builder wird für Verkettungen verwendet.


setInitialSortingAscending(column)

Legt den Index der Spalte fest, nach der die Tabelle anfänglich (aufsteigend) sortiert werden soll.

Die Spalte „os“ ist in aufsteigender Reihenfolge sortiert und mit einem kleinen Pfeil markiert.

// Creates a table chart builder and sorts it by the second column (ascending).
var builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

Parameter

NameTypBeschreibung
columnIntegerDie Nummer der Spalte, nach der die Tabelle anfänglich sortiert werden soll.

Return

TableChartBuilder: Dieser Builder wird für Verkettungen verwendet.


setInitialSortingDescending(column)

Legt den Index der Spalte fest, nach der die Tabelle anfänglich sortiert (absteigend) sein soll.

Die Spalte „os“ ist in absteigender Reihenfolge sortiert und mit einem kleinen Pfeil gekennzeichnet, der dies anzeigt.

// Creates a table chart builder and sorts it by the second column (descending).
var builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

Parameter

NameTypBeschreibung
columnIntegerDie Nummer der Spalte, nach der die Tabelle anfänglich sortiert werden soll.

Return

TableChartBuilder: 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 table chart which renders HTML.
var builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
var chart = builder.build();

Parameter

NameTypBeschreibung
optionStringDie festzulegende Option.
valueObjectDer festzulegende Wert.

Return

TableChartBuilder: Dieser Builder wird für Verkettungen verwendet.


showRowNumberColumn(showRowNumber)

Legt fest, ob die Zeilennummer als erste Spalte der Tabelle angezeigt werden soll.

Standardmäßig werden keine Zeilennummern angezeigt.

Parameter

NameTypBeschreibung
showRowNumberBooleantrue, wenn die erste Spalte der Tabelle die Zeilennummer anzeigen soll, andernfalls false.

Return

TableChartBuilder: Dieser Builder wird für Verkettungen verwendet.


useAlternatingRowStyle(alternate)

Legt fest, ob ungeraden und geraden Zeilen in einem Tabellendiagramm ein abwechselnder Farbstil zugewiesen wird.

Das Standardverhalten entspricht den Zeilen mit abwechselnden Farben.

Parameter

NameTypBeschreibung
alternateBooleantrue, wenn die Farbstile abwechselnd sein sollen, andernfalls false.

Return

TableChartBuilder: Dieser Builder wird für Verkettungen verwendet.