Class TableChartBuilder

TabellenDiagrammTool

Ein Tool zum Erstellen von Tabellendiagrammen. Weitere Informationen finden Sie in der Google Tabellen-Dokumentation.

Hier ist ein Beispiel für ein Tabellendiagramm. Die Daten werden aus einer Google-Tabelle importiert.

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

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

const chart = chartBuilder.build();

Methoden

MethodeRückgabetypKurzbeschreibung
build()ChartDas Diagramm wird erstellt.
enablePaging(enablePaging)TableChartBuilderHier legen Sie fest, ob die Daten geblättert werden können.
enablePaging(pageSize)TableChartBuilderHiermit wird die Paginierung aktiviert und die Anzahl der Zeilen auf jeder Seite festgelegt.
enablePaging(pageSize, startPage)TableChartBuilderHiermit wird die Paginierung aktiviert. Außerdem wird die Anzahl der Zeilen auf jeder Seite und die erste Seite der Tabelle festgelegt (Seitennummern beginnen bei null).
enableRtlTable(rtlEnabled)TableChartBuilderEs wird eine grundlegende Unterstützung für rechtsläufige Sprachen wie Arabisch oder Hebräisch hinzugefügt, indem die Spaltenreihenfolge der Tabelle umgekehrt wird, sodass Spalte 0 die äußerste rechte Spalte und die letzte Spalte die äußerste linke Spalte ist.
enableSorting(enableSorting)TableChartBuilderHiermit wird festgelegt, ob Spalten sortiert werden, wenn der Nutzer auf eine Spaltenüberschrift klickt.
setDataSourceUrl(url)TableChartBuilderHiermit wird die URL der Datenquelle festgelegt, über die Daten aus einer externen Quelle wie Google Tabellen abgerufen werden.
setDataTable(tableBuilder)TableChartBuilderLegt mithilfe eines DataTableBuilders die Datentabelle fest, die für das Diagramm verwendet werden soll.
setDataTable(table)TableChartBuilderHier legen Sie die Datentabelle fest, die die Linien für das Diagramm sowie die Beschriftungen der X-Achse enthält.
setDataViewDefinition(dataViewDefinition)TableChartBuilderHier legen Sie die Datenansichtsdefinition fest, die für das Diagramm verwendet werden soll.
setDimensions(width, height)TableChartBuilderHier legen Sie die Dimensionen für das Diagramm 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 zuerst sortiert werden soll (aufsteigend).
setInitialSortingDescending(column)TableChartBuilderLegt den Index der Spalte fest, nach der die Tabelle zuerst sortiert werden soll (absteigend).
setOption(option, value)TableChartBuilderHier legen Sie erweiterte Optionen für dieses Diagramm fest.
showRowNumberColumn(showRowNumber)TableChartBuilderHiermit wird festgelegt, ob die Zeilennummer als erste Spalte der Tabelle angezeigt werden soll.
useAlternatingRowStyle(alternate)TableChartBuilderHier legen Sie fest, ob ungeraden und geraden Zeilen eines Tabellendiagramms ein abwechselnder Farbstil zugewiesen wird.

Detaillierte Dokumentation

build()

Das Diagramm wird erstellt.

Rückflug

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


enablePaging(enablePaging)

Hier legen Sie fest, ob die Daten geblättert werden können.

Standardmäßig ist das Auslagern deaktiviert. Wenn die Paginierung aktiviert ist, ist die Standardseitengröße 10.

Parameter

NameTypBeschreibung
enablePagingBooleantrue, wenn die Auslagerung aktiviert werden soll, false andernfalls.

Rückflug

TableChartBuilder – Dieser Builder eignet sich für die Verkettung.


enablePaging(pageSize)

Hiermit wird die Paginierung aktiviert und die Anzahl der Zeilen auf jeder Seite festgelegt.

Die Standardseitengröße ist 10.

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

Parameter

NameTypBeschreibung
pageSizeIntegerDie Anzahl der Zeilen auf jeder Seite der Tabelle.

Rückflug

TableChartBuilder – Dieser Builder eignet sich für die Verkettung.


enablePaging(pageSize, startPage)

Hiermit wird die Paginierung aktiviert. Außerdem wird die Anzahl der Zeilen auf jeder Seite und die erste Seite der Tabelle festgelegt (Seitennummern beginnen bei null).

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

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

Parameter

NameTypBeschreibung
pageSizeIntegerDie Anzahl der Zeilen auf jeder Seite der Tabelle.
startPageIntegerDie erste Tabelleseite, die angezeigt werden soll (Seitennummern beginnen bei null).

Rückflug

TableChartBuilder – Dieser Builder eignet sich für die Verkettung.


enableRtlTable(rtlEnabled)

Es wird eine grundlegende Unterstützung für rechtsläufige Sprachen wie Arabisch oder Hebräisch hinzugefügt, indem die Spaltenreihenfolge der Tabelle umgekehrt wird, sodass Spalte 0 die äußerste rechte Spalte und die letzte Spalte die äußerste linke Spalte ist.

Dies wirkt sich nicht auf den Spaltenindex in den zugrunde liegenden Daten aus, sondern nur auf die Reihenfolge der Anzeige. Die vollständige bidirektionale (BiDi) Sprachanzeige wird von der Tabellenvisualisierung auch mit dieser Option nicht unterstützt. Diese Option wird ignoriert, wenn Sie die Seitenfunktion (über die Option „Seite“) aktivieren oder die Tabelle Scrollbalken hat, weil Sie für Höhe und Breite Optionen angegeben haben, die kleiner als die erforderliche Tabellengröße sind. Standardmäßig ist die Unterstützung für die RTL-Schriftrichtung deaktiviert.

Parameter

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

Rückflug

TableChartBuilder – Dieser Builder eignet sich für die Verkettung.


enableSorting(enableSorting)

Hiermit wird festgelegt, ob Spalten sortiert werden, wenn der Nutzer auf eine Spaltenüberschrift klickt.

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

Parameter

NameTypBeschreibung
enableSortingBooleantrue, um das Sortieren durch Klicken auf Spaltenüberschriften zu aktivieren, false andernfalls.

Rückflug

TableChartBuilder – Dieser Builder eignet sich für die Verkettung.


setDataSourceUrl(url)

Hiermit wird die URL der Datenquelle festgelegt, über die Daten aus einer externen Quelle wie Google Tabellen abgerufen werden. 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 Tabellen-Dokumentation.

Parameter

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

Rückflug

TableChartBuilder – Dieser Builder eignet sich für die Verkettung.


setDataTable(tableBuilder)

Legt mithilfe eines DataTableBuilders die Datentabelle fest, die für das Diagramm verwendet werden soll. Dies ist eine praktische Methode, um die Datentabelle festzulegen, ohne build() aufrufen zu müssen.

Parameter

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

Rückflug

TableChartBuilder – Dieser Builder eignet sich für die Verkettung.


setDataTable(table)

Hier legen Sie 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 Labels der horizontalen Achse enthalten. Es kann eine beliebige Anzahl von Spalten folgen, die alle numerisch sein müssen. Jede Spalte wird als separate Zeile angezeigt.

Parameter

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

Rückflug

TableChartBuilder – Dieser Builder eignet sich für die Verkettung.


setDataViewDefinition(dataViewDefinition)

Hier legen Sie die Datenansichtsdefinition fest, die für das Diagramm verwendet werden soll.

Parameter

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

Rückflug

TableChartBuilder – Dieser Builder eignet sich für die Verkettung.


setDimensions(width, height)

Hier legen Sie die Dimensionen für das Diagramm fest.

Parameter

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

Rückflug

TableChartBuilder – Dieser Builder eignet sich für die Verkettung.


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.
const builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

Parameter

NameTypBeschreibung
numberIntegerDie Zeilennummer der ersten Zeile in der Datentabelle.

Rückflug

TableChartBuilder – Dieser Builder eignet sich für die Verkettung.


setInitialSortingAscending(column)

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

Die Spalte ist in aufsteigender Reihenfolge sortiert und wird durch einen kleinen Pfeil gekennzeichnet.

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

Parameter

NameTypBeschreibung
columnIntegerDie Nummer der Spalte, nach der die Tabelle zuerst sortiert werden soll.

Rückflug

TableChartBuilder – Dieser Builder eignet sich für die Verkettung.


setInitialSortingDescending(column)

Legt den Index der Spalte fest, nach der die Tabelle zuerst sortiert werden soll (absteigend).

Die Spalte ist in absteigender Reihenfolge sortiert und wird durch einen kleinen Pfeil gekennzeichnet.

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

Parameter

NameTypBeschreibung
columnIntegerDie Nummer der Spalte, nach der die Tabelle zuerst sortiert werden soll.

Rückflug

TableChartBuilder – Dieser Builder eignet sich für die Verkettung.


setOption(option, value)

Hier legen Sie 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.
const builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
const chart = builder.build();

Parameter

NameTypBeschreibung
optionStringDie Option, die festgelegt werden soll.
valueObjectDer festzulegende Wert.

Rückflug

TableChartBuilder – Dieser Builder eignet sich für die Verkettung.


showRowNumberColumn(showRowNumber)

Hiermit wird festgelegt, 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 enthalten soll, false andernfalls.

Rückflug

TableChartBuilder – Dieser Builder eignet sich für die Verkettung.


useAlternatingRowStyle(alternate)

Hier legen Sie fest, ob ungeraden und geraden Zeilen eines Tabellendiagramms ein abwechselnder Farbstil zugewiesen wird.

Standardmäßig haben die Zeilen einen abwechselnden Farbstil.

Parameter

NameTypBeschreibung
alternateBooleantrue, wenn die Farbstile abwechselnd verwendet werden sollen, false andernfalls.

Rückflug

TableChartBuilder – Dieser Builder eignet sich für die Verkettung.